[Live-demo] create pdf documentation

Cameron Shorter cameron.shorter at gmail.com
Wed Sep 26 04:46:54 PDT 2012

On 26/09/2012 12:48 AM, Luca Delucchi wrote:
> 2012/9/25 Luca Delucchi <lucadeluge at gmail.com>:
>> yes, I know. I just upload the new png images (without removing the old gif).
Once all image references are to .png instead of .gif files, please 
remove the .gif files.
It is dangerous having two versions of the same file in a directory, as 
a user might correct one, and the other remains out of date.
>> Later or tomorrow I'll upload also the files with the new references
>> (including translations)
> in r9171 I fix the references to png, please try to compile the html
> documentation (I tried and I didn't have any problem)
> I also renamed some images files
> (52n_sos_test_client_v1.0.0_GetCapabilities.png,
> viking-0.9.8-europe.jpg, geomoose-2.4-screenshot*.jpg) replacing the
> dots inside the name with underscore and fix the references in the
> files (r9172).
> This [0] is a first version of PDF output (please download it only if
> you are really interested, the file is 50MB), it has a lot work yet
> (some errors are still in compilation) but it is a good starting
> point.

I agree, it is a good starting point.

What would be really valuable if you can achieve it is to work out how 
to have images from the project overview embedded in the text (eg: 
moving the icon to the right rather than having the icon on its own line)
>> 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?

And which index.rst are you referring to? doc/index.rst ? doc/en/index.rst ?

Hamish often weighs in on these discussions about scripting decisions 
with valuable advice, and may have something to contribute here.

> I wait a answer about this before to commit the last changes to abtain
> a pdf file
> [0] http://gis.cri.fmach.it/uploads/OSGeo-Live.pdf

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

More information about the Osgeolive mailing list