[Live-demo] create pdf documentation

Jorge Gaspar Sanz Salinas jsanz at osgeo.org
Wed Oct 10 23:29:37 PDT 2012


On 27 September 2012 13:18, Jorge Gaspar Sanz Salinas <jsanz at osgeo.org> wrote:
> On 27 September 2012 13:02, Luca Delucchi <lucadeluge at gmail.com> wrote:
>> 2012/9/27 maning sambale <emmanuel.sambale at gmail.com>:
>>> I also tried converting the docs to pdf but never get around to
>>> finishing it.  Solutions I did on some issues:
>>>
>>> 1. Large icons - To guarantee equal size, the size must be specified
>>> in "real" units (cm, pt,
>>> inch) not in relative units (em, px). i.e.
>>>
>>> .. image:: image.png
>>>    :align: center
>>>    :width: 300 pt
>>>
>>
>> yes, but should be added in ".. only:: latex" and ".. only:: html" or
>> html escape the width?
>>
>>> 2. Manual page break for each application page - I add this to create
>>> manual page break at the end of each rst file:
>>>
>>> .. raw:: latex
>>>
>>>    \pagebreak[4]
>>>
>>
>> ok, again using ".. only:: latex" right?
>>
>> thanks
>>
>

Hi Luca,

Just in case it's someway useful, here there are some good advices
regarding sphinx and creating technical docs,

http://pedrokroger.net/2012/10/using-sphinx-to-write-books/

Best


-- 
Jorge Sanz
http://es.osgeo.org



More information about the Osgeolive mailing list