Account Options

  1. Sign in
The old Google Groups will be going away soon, but your browser is incompatible with the new version.
Google Groups Home
Ģ Groups Home
A book typeset using sphinx and rst2pdf
There are currently too many topics in this group that display first. To make this topic appear first, remove this option from another topic.
There was an error processing your request. Please try again.
flag
  18 messages - Collapse all  -  Translate all to Translated (View all originals)
The group you are posting to is a Usenet group. Messages posted to this group will make your email address visible to anyone on the Internet.
Your reply message has not been sent.
Your post was successful
 
From:
To:
Cc:
Followup To:
Add Cc | Add Followup-to | Edit Subject
Subject:
Validation:
For verification purposes please type the characters you see in the picture below or the numbers you hear by clicking the accessibility icon. Listen and type the numbers you hear
 
Roberto Alsina  
View profile  
 More options Sep 7 2009, 2:43 pm
From: Roberto Alsina <rals...@netmanagers.com.ar>
Date: Mon, 7 Sep 2009 15:43:52 -0300
Local: Mon, Sep 7 2009 2:43 pm
Subject: A book typeset using sphinx and rst2pdf
It may be a bit offtopic, but it's something I am very proud about ;-)

Here are a few images of a book that was typeset using sphinx and rst2pdf.

The binding and printing are (intentionally!) cheap, because it's meant as an
experiment to produce programming books for those who can't afford traditional
books: The cost may be as low as U$S 2 per 120-page book, while most
"traditional" 400-page programming books cost, in Argentina, about U$S 50.

Best regards,

--
 ("\''/").__..-''"`-. .         Roberto Alsina
 `9_ 9  )   `-. (    ).`-._.`)  KDE Developer (MFCH)
 (_Y_.)' ._   ) `._`.  " -.-'  http://lateral.netmanagers.com.ar
  _..`-'_..-_/ /-'_.'     The 6,855th most popular site of Slovenia  
(l)-'' ((i).' ((!.'       according to alexa.com (27/5/2007)


 
You must Sign in before you can post messages.
To post a message you must first join this group.
Please update your nickname on the subscription settings page before posting.
You do not have the permission required to post.
Santiago Suarez Ordoņez  
View profile  
 More options Sep 7 2009, 2:53 pm
From: Santiago Suarez Ordoņez <santi...@gmail.com>
Date: Mon, 7 Sep 2009 15:53:41 -0300
Local: Mon, Sep 7 2009 2:53 pm
Subject: Re: [sphinx-dev] A book typeset using sphinx and rst2pdf

Hm, looks like the images didn't reach the list. Could you upload them
somewhere and share the links?

Saludos
Santi

On Mon, Sep 7, 2009 at 3:43 PM, Roberto Alsina
<rals...@netmanagers.com.ar>wrote:


 
You must Sign in before you can post messages.
To post a message you must first join this group.
Please update your nickname on the subscription settings page before posting.
You do not have the permission required to post.
Roberto Alsina  
View profile  
 More options Sep 7 2009, 5:01 pm
From: Roberto Alsina <rals...@netmanagers.com.ar>
Date: Mon, 7 Sep 2009 18:01:31 -0300
Local: Mon, Sep 7 2009 5:01 pm
Subject: Re: [sphinx-dev] Re: A book typeset using sphinx and rst2pdf
On Monday 07 September 2009 15:53:41 Santiago Suarez Ordoņez wrote:

> Hm, looks like the images didn't reach the list. Could you upload them
> somewhere and share the links?

Just forgot to paste them :-)

http://www.flickr.com/photos/ralsina/tags/libro/

--
 ("\''/").__..-''"`-. .         Roberto Alsina
 `9_ 9  )   `-. (    ).`-._.`)  KDE Developer (MFCH)
 (_Y_.)' ._   ) `._`.  " -.-'  http://lateral.netmanagers.com.ar
  _..`-'_..-_/ /-'_.'     The 6,855th most popular site of Slovenia  
(l)-'' ((i).' ((!.'       according to alexa.com (27/5/2007)


 
You must Sign in before you can post messages.
To post a message you must first join this group.
Please update your nickname on the subscription settings page before posting.
You do not have the permission required to post.
Georg Brandl  
View profile  
 More options Sep 7 2009, 5:21 pm
From: Georg Brandl <ge...@python.org>
Date: Mon, 07 Sep 2009 23:21:17 +0200
Local: Mon, Sep 7 2009 5:21 pm
Subject: Re: [sphinx-dev] Re: A book typeset using sphinx and rst2pdf
Roberto Alsina schrieb:

> On Monday 07 September 2009 15:53:41 Santiago Suarez Ordoņez wrote:
>> Hm, looks like the images didn't reach the list. Could you upload them
>> somewhere and share the links?

> Just forgot to paste them :-)

> http://www.flickr.com/photos/ralsina/tags/libro/

Wow!  I think I'm just a little bit proud as well...

I also like that it is a really affordable book, and hope that it will
help spread Python in Argentina beyond our expectations :)

cheers,
Georg


 
You must Sign in before you can post messages.
To post a message you must first join this group.
Please update your nickname on the subscription settings page before posting.
You do not have the permission required to post.
Tim Michelsen  
View profile  
 More options Sep 7 2009, 5:56 pm
From: Tim Michelsen <timmichel...@gmx-topmail.de>
Date: Mon, 07 Sep 2009 23:56:09 +0200
Local: Mon, Sep 7 2009 5:56 pm
Subject: Re: A book typeset using sphinx and rst2pdf
> Here are a few images of a book that was typeset using sphinx and rst2pdf.

So, is this builder already stable?

 
You must Sign in before you can post messages.
To post a message you must first join this group.
Please update your nickname on the subscription settings page before posting.
You do not have the permission required to post.
Roberto Alsina  
View profile  
 More options Sep 7 2009, 8:18 pm
From: Roberto Alsina <rals...@netmanagers.com.ar>
Date: Mon, 7 Sep 2009 21:18:17 -0300
Local: Mon, Sep 7 2009 8:18 pm
Subject: Re: [sphinx-dev] Re: A book typeset using sphinx and rst2pdf
On Monday 07 September 2009 18:56:09 Tim Michelsen wrote:

> > Here are a few images of a book that was typeset using sphinx and
> > rst2pdf.

> So, is this builder already stable?

It is stable in the sense that if it processes your docs, it should not stop
doing it (if I know about them).

Other than that... YMWV.

--
 ("\''/").__..-''"`-. .         Roberto Alsina
 `9_ 9  )   `-. (    ).`-._.`)  KDE Developer (MFCH)
 (_Y_.)' ._   ) `._`.  " -.-'  http://lateral.netmanagers.com.ar
  _..`-'_..-_/ /-'_.'     The 6,855th most popular site of Slovenia  
(l)-'' ((i).' ((!.'       according to alexa.com (27/5/2007)


 
You must Sign in before you can post messages.
To post a message you must first join this group.
Please update your nickname on the subscription settings page before posting.
You do not have the permission required to post.
Gael Varoquaux  
View profile  
 More options Sep 8 2009, 4:04 am
From: Gael Varoquaux <gael.varoqu...@normalesup.org>
Date: Tue, 8 Sep 2009 10:04:20 +0200
Local: Tues, Sep 8 2009 4:04 am
Subject: Re: [sphinx-dev] Re: A book typeset using sphinx and rst2pdf

On Mon, Sep 07, 2009 at 06:01:31PM -0300, Roberto Alsina wrote:
> On Monday 07 September 2009 15:53:41 Santiago Suarez Ordoņez wrote:
> > Hm, looks like the images didn't reach the list. Could you upload them
> > somewhere and share the links?
> Just forgot to paste them :-)
> http://www.flickr.com/photos/ralsina/tags/libro/

This is superb. Do you have any tricks that you learned with regards to
the formatting or composing the text and that you could share?

Also, is there a schedule for merging in rst2pdf? I am sure that
everybody will want to use it after seeing that book.

Cheers,

Gaël


 
You must Sign in before you can post messages.
To post a message you must first join this group.
Please update your nickname on the subscription settings page before posting.
You do not have the permission required to post.
Georg Brandl  
View profile  
 More options Sep 8 2009, 5:37 am
From: Georg Brandl <ge...@python.org>
Date: Tue, 08 Sep 2009 11:37:44 +0200
Local: Tues, Sep 8 2009 5:37 am
Subject: Re: [sphinx-dev] Re: A book typeset using sphinx and rst2pdf
Gael Varoquaux schrieb:

> On Mon, Sep 07, 2009 at 06:01:31PM -0300, Roberto Alsina wrote:

>> On Monday 07 September 2009 15:53:41 Santiago Suarez Ordoņez wrote:
>> > Hm, looks like the images didn't reach the list. Could you upload them
>> > somewhere and share the links?

>> Just forgot to paste them :-)

>> http://www.flickr.com/photos/ralsina/tags/libro/

> This is superb. Do you have any tricks that you learned with regards to
> the formatting or composing the text and that you could share?

> Also, is there a schedule for merging in rst2pdf? I am sure that
> everybody will want to use it after seeing that book.

I think a merging is not required.  rst2pdf can be an external dependency
like docutils (but optional), and the Sphinx builder will be contained in
rst2pdf.

Georg


 
You must Sign in before you can post messages.
To post a message you must first join this group.
Please update your nickname on the subscription settings page before posting.
You do not have the permission required to post.
Roberto Alsina  
View profile  
 More options Sep 8 2009, 6:18 am
From: Roberto Alsina <rals...@netmanagers.com.ar>
Date: Tue, 8 Sep 2009 07:18:55 -0300
Local: Tues, Sep 8 2009 6:18 am
Subject: Re: [sphinx-dev] Re: A book typeset using sphinx and rst2pdf
On Tuesday 08 September 2009 05:04:20 Gael Varoquaux wrote:

> On Mon, Sep 07, 2009 at 06:01:31PM -0300, Roberto Alsina wrote:
> > On Monday 07 September 2009 15:53:41 Santiago Suarez Ordoņez wrote:
> > > Hm, looks like the images didn't reach the list. Could you upload them
> > > somewhere and share the links?

> > Just forgot to paste them :-)

> > http://www.flickr.com/photos/ralsina/tags/libro/

> This is superb. Do you have any tricks that you learned with regards to
> the formatting or composing the text and that you could share?

Yes, that printers want things rst2pdf doesn't do yet (like "break chapters to
an odd page" or "start counting from the 12th page", so I will be adding
those.

> Also, is there a schedule for merging in rst2pdf? I am sure that
> everybody will want to use it after seeing that book.

It is now included with rst2pdf in SVN.

I don't expect it to be merged into sphinx. The thinking is, you are going to
need rst2pdf for it to do anything, so it can be a sphinx extension shipped
with rst2pdf.

--
 ("\''/").__..-''"`-. .         Roberto Alsina
 `9_ 9  )   `-. (    ).`-._.`)  KDE Developer (MFCH)
 (_Y_.)' ._   ) `._`.  " -.-'  http://lateral.netmanagers.com.ar
  _..`-'_..-_/ /-'_.'     The 6,855th most popular site of Slovenia  
(l)-'' ((i).' ((!.'       according to alexa.com (27/5/2007)


 
You must Sign in before you can post messages.
To post a message you must first join this group.
Please update your nickname on the subscription settings page before posting.
You do not have the permission required to post.
Ian Cottee  
View profile  
 More options Sep 8 2009, 6:26 am
From: Ian Cottee <icot...@bluefountain.com>
Date: Tue, 8 Sep 2009 11:26:02 +0100
Local: Tues, Sep 8 2009 6:26 am
Subject: Re: [sphinx-dev] A book typeset using sphinx and rst2pdf

On Mon, Sep 7, 2009 at 7:43 PM, Roberto Alsina
<rals...@netmanagers.com.ar>wrote:

> It may be a bit offtopic, but it's something I am very proud about ;-)

> Here are a few images of a book that was typeset using sphinx and rst2pdf.

That is awesome! Congrats!

Ian


 
You must Sign in before you can post messages.
To post a message you must first join this group.
Please update your nickname on the subscription settings page before posting.
You do not have the permission required to post.
Georg Brandl  
View profile  
 More options Sep 8 2009, 6:27 am
From: Georg Brandl <ge...@python.org>
Date: Tue, 08 Sep 2009 12:27:16 +0200
Local: Tues, Sep 8 2009 6:27 am
Subject: Re: [sphinx-dev] Re: A book typeset using sphinx and rst2pdf
Roberto Alsina schrieb:

Exactly. I didn't even think of distributing it this way, but now it seems to
me to be the most natural one :)

Georg


 
You must Sign in before you can post messages.
To post a message you must first join this group.
Please update your nickname on the subscription settings page before posting.
You do not have the permission required to post.
Gael Varoquaux  
View profile  
 More options Sep 8 2009, 7:54 am
From: Gael Varoquaux <gael.varoqu...@normalesup.org>
Date: Tue, 8 Sep 2009 13:54:14 +0200
Local: Tues, Sep 8 2009 7:54 am
Subject: Re: [sphinx-dev] Re: A book typeset using sphinx and rst2pdf

On Tue, Sep 08, 2009 at 12:27:16PM +0200, Georg Brandl wrote:
> Exactly. I didn't even think of distributing it this way, but now it seems to
> me to be the most natural one :)

Sounds great. Both of you have done an excellent job.

Gaël


 
You must Sign in before you can post messages.
To post a message you must first join this group.
Please update your nickname on the subscription settings page before posting.
You do not have the permission required to post.
Roberto Alsina  
View profile  
 More options Sep 8 2009, 3:47 pm
From: Roberto Alsina <rals...@netmanagers.com.ar>
Date: Tue, 8 Sep 2009 16:47:06 -0300
Local: Tues, Sep 8 2009 3:47 pm
Subject: Re: [sphinx-dev] Re: A book typeset using sphinx and rst2pdf
On Monday 07 September 2009 21:18:17 Roberto Alsina wrote:

> On Monday 07 September 2009 18:56:09 Tim Michelsen wrote:
> > > Here are a few images of a book that was typeset using sphinx and
> > > rst2pdf.

> > So, is this builder already stable?

> It is stable in the sense that if it processes your docs, it should not
>  stop doing it (if I know about them).

> Other than that... YMWV.

Some data points:

* It's stable enough to process the Python docs from SVN, including a 1000+
page library reference guide.

http://www.freedrive.com/folder/236380

* It can process the Django manual, which is over 800 pages.

http://www.freedrive.com/folder/236385 [I will be adding more manuals here]

This is without wordaxe, which has some issues right now, so there is no
hyphenation or kerning.

--
 ("\''/").__..-''"`-. .         Roberto Alsina
 `9_ 9  )   `-. (    ).`-._.`)  KDE Developer (MFCH)
 (_Y_.)' ._   ) `._`.  " -.-'  http://lateral.netmanagers.com.ar
  _..`-'_..-_/ /-'_.'     The 6,855th most popular site of Slovenia  
(l)-'' ((i).' ((!.'       according to alexa.com (27/5/2007)


 
You must Sign in before you can post messages.
To post a message you must first join this group.
Please update your nickname on the subscription settings page before posting.
You do not have the permission required to post.
Tim Michelsen  
View profile  
 More options Sep 8 2009, 5:04 pm
From: Tim Michelsen <timmichel...@gmx-topmail.de>
Date: Tue, 08 Sep 2009 23:04:28 +0200
Local: Tues, Sep 8 2009 5:04 pm
Subject: Re: A book typeset using sphinx and rst2pdf
>>> So, is this builder already stable?
>> It is stable in the sense that if it processes your docs, it should not
>>  stop doing it (if I know about them).

Thanks. Cool.
Where could I find a tutorial on how to activate this builder?

Thanks,
Timmie


 
You must Sign in before you can post messages.
To post a message you must first join this group.
Please update your nickname on the subscription settings page before posting.
You do not have the permission required to post.
Roberto Alsina  
View profile  
 More options Sep 8 2009, 5:26 pm
From: Roberto Alsina <rals...@netmanagers.com.ar>
Date: Tue, 8 Sep 2009 18:26:07 -0300
Local: Tues, Sep 8 2009 5:26 pm
Subject: Re: [sphinx-dev] Re: A book typeset using sphinx and rst2pdf
On Tuesday 08 September 2009 18:04:28 Tim Michelsen wrote:

> >>> So, is this builder already stable?

> >> It is stable in the sense that if it processes your docs, it should not
> >>  stop doing it (if I know about them).

> Thanks. Cool.
> Where could I find a tutorial on how to activate this builder?

Get rst2pdf from SVN at http://rst2pdf.googlecode.com, then check the manual
(use manual.txt, manual.pdf is only generated on releases), specifically the
"Sphinx" section.

--
 ("\''/").__..-''"`-. .         Roberto Alsina
 `9_ 9  )   `-. (    ).`-._.`)  KDE Developer (MFCH)
 (_Y_.)' ._   ) `._`.  " -.-'  http://lateral.netmanagers.com.ar
  _..`-'_..-_/ /-'_.'     The 6,855th most popular site of Slovenia  
(l)-'' ((i).' ((!.'       according to alexa.com (27/5/2007)


 
You must Sign in before you can post messages.
To post a message you must first join this group.
Please update your nickname on the subscription settings page before posting.
You do not have the permission required to post.
Tim Michelsen  
View profile  
 More options Sep 8 2009, 6:10 pm
From: Tim Michelsen <timmichel...@gmx-topmail.de>
Date: Wed, 09 Sep 2009 00:10:25 +0200
Local: Tues, Sep 8 2009 6:10 pm
Subject: Re: A book typeset using sphinx and rst2pdf
> Get rst2pdf from SVN at http://rst2pdf.googlecode.com, then check the manual
> (use manual.txt, manual.pdf is only generated on releases), specifically the
> "Sphinx" section.

Great. I will try in the next days.

Thanks.


 
You must Sign in before you can post messages.
To post a message you must first join this group.
Please update your nickname on the subscription settings page before posting.
You do not have the permission required to post.
Guenter Milde  
View profile  
 More options Sep 9 2009, 2:36 am
From: Guenter Milde <mi...@users.berlios.de>
Date: Wed, 9 Sep 2009 06:36:55 +0000 (UTC)
Local: Wed, Sep 9 2009 2:36 am
Subject: Re: A book typeset using sphinx and rst2pdf
On 2009-09-08, Roberto Alsina wrote:

> On Tuesday 08 September 2009 05:04:20 Gael Varoquaux wrote:
>> On Mon, Sep 07, 2009 at 06:01:31PM -0300, Roberto Alsina wrote:
>> > On Monday 07 September 2009 15:53:41 Santiago Suarez Ordoņez wrote:
>> This is superb. Do you have any tricks that you learned with regards to
>> the formatting or composing the text and that you could share?
> Yes, that printers want things rst2pdf doesn't do yet (like "break
> chapters to an odd page" or "start counting from the 12th page", so I
> will be adding those.

This is why for "large" projects like a book I still recommend the way
via LaTeX. You get more than 20 years of expertise in desktop
publishing for free.

Günter


 
You must Sign in before you can post messages.
To post a message you must first join this group.
Please update your nickname on the subscription settings page before posting.
You do not have the permission required to post.
Roberto Alsina  
View profile  
 More options Sep 9 2009, 6:38 am
From: Roberto Alsina <rals...@netmanagers.com.ar>
Date: Wed, 9 Sep 2009 07:38:16 -0300
Local: Wed, Sep 9 2009 6:38 am
Subject: Re: [sphinx-dev] Re: A book typeset using sphinx and rst2pdf
On Wednesday 09 September 2009 03:36:55 Guenter Milde wrote:

> On 2009-09-08, Roberto Alsina wrote:
> > On Tuesday 08 September 2009 05:04:20 Gael Varoquaux wrote:
> >> On Mon, Sep 07, 2009 at 06:01:31PM -0300, Roberto Alsina wrote:
> >> > On Monday 07 September 2009 15:53:41 Santiago Suarez Ordoņez wrote:

> >> This is superb. Do you have any tricks that you learned with regards to
> >> the formatting or composing the text and that you could share?

> > Yes, that printers want things rst2pdf doesn't do yet (like "break
> > chapters to an odd page" or "start counting from the 12th page", so I
> > will be adding those.

> This is why for "large" projects like a book I still recommend the way
> via LaTeX. You get more than 20 years of expertise in desktop
> publishing for free.

Right. However, it's not as if those things are horribly hard, and I think
there is a niche for a non-latex typesetting tool in the free software world,
and I really don't think open office is it ;-)

--
 ("\''/").__..-''"`-. .         Roberto Alsina
 `9_ 9  )   `-. (    ).`-._.`)  KDE Developer (MFCH)
 (_Y_.)' ._   ) `._`.  " -.-'  http://lateral.netmanagers.com.ar
  _..`-'_..-_/ /-'_.'     The 6,855th most popular site of Slovenia  
(l)-'' ((i).' ((!.'       according to alexa.com (27/5/2007)


 
You must Sign in before you can post messages.
To post a message you must first join this group.
Please update your nickname on the subscription settings page before posting.
You do not have the permission required to post.
End of messages
« Back to Discussions « Newer topic     Older topic »