[Live-demo] create pdf documentation

Cameron Shorter cameron.shorter at gmail.com
Wed Sep 26 14:41:29 PDT 2012


On 26/09/2012 11:05 PM, Luca Delucchi wrote:
>
>>>> I already try something but I have to work on it.
>>>> Right now the simple way (that I see) to create a good html and pdf
>>>> (pdf only for one language) documentation is:
>>>> - rename index.rst to index.template and copy index.template to
>>>> index.rst during compilation (I already try it and it works well)
>>>> - create a index_pdf.template, copy it to index.rst and substitute a
>>>> variable to set the language required for PDF file during compilation
>>>> (I'm trying this but sed doesn't work)
>>>>
>>>> what do you think about this solution?
>>>>
>> This solution might be suitable, but I'm failing to understand the need to
>> rename index.rst
>> What is wrong with having a index_pdf.rst alongside index.rst?
>>
> because sphinx read index.rst and not index_pdf.rst. Your idea was
> also mine but I discover that it doesn't work. If someone as a better
> idea or working solution he is welkome

Ok, if you can't pass in the filename of the starting page into RST as a 
parameter, then your suggestion above of replacing doc/index.rst above 
makes sense. Please go ahead and implement if you wish.

Frank has been helping with the RST doc generation process, and might 
have some suggestions too.

-- 
Cameron Shorter
Geospatial Solutions Manager
Tel: +61 (0)2 8570 5050
Mob: +61 (0)419 142 254

Think Globally, Fix Locally
Geospatial Solutions enhanced with Open Standards and Open Source
http://www.lisasoft.com



More information about the Live-demo mailing list