[Live-demo] osgeo live documentation as a booklet/handout

maning sambale emmanuel.sambale at gmail.com
Mon Dec 5 05:47:19 EST 2011


Testing further:

I modified the conf.py to include the following:

## -- Options for PDF output --------------------------------------------------


pdf_documents = [
        ('index', u'MyProject', u'My Project', u'Author Name')
    ]

pdf_language = "en_US"

pdf_break_level = 1

    # Show Table Of Contents at the beginning?
pdf_use_toc = True

    # How many levels deep should the table of contents be?
pdf_toc_depth = 9999

    # Add section number to section references
pdf_use_numbered_links = False

    # Background images fitting mode
pdf_fit_background_mode = 'scale'

# ----------

Then created a new index.rst

.. meta::
   :http-equiv=refresh: 0;url=en/index.html

|osgeo-live-version|
================================================================================

.. toctree::
   :maxdepth: 2

   en/index
   en/overview/qgis_overview
   en/quickstart/qgis_quickstart
   en/overview/grass_overview
   en/quickstart/grass_quickstart


This is the result: http://dl.dropbox.com/u/607635/osgeo_live/test_osgeolive.pdf

So far so good.  Is this the right approach?  I may have to create a
new stylesheet, but my plan is to minimize creating separate rst for
the pdf generation so that everything are in sync with osegeo-live's
documentation process.  Any pointers to creating pdf template.


On Mon, Dec 5, 2011 at 5:27 PM, Hamish <hamish_b at yahoo.com> wrote:
> maning wrote:
>> Excellent! I tried creating a pdf
>> using rst2pdf.  This is the process:
>>
>> # get rst docs from svn
>> svn co https://svn.osgeo.org/osgeo/livedvd/gisvm/trunk/doc/
>
> try also:
>
> $ cd doc/
> $ make help
> Please use `make <target>' where <target> is one of
>  html      to make standalone HTML files
>  dirhtml   to make HTML files named index.html in directories
>  pickle    to make pickle files
>  json      to make JSON files
>  htmlhelp  to make HTML files and a HTML help project
>  qthelp    to make HTML files and a qthelp project
>  latex     to make LaTeX files, you can set PAPER=a4 or PAPER=letter
>  changes   to make an overview of all changed/added/deprecated items
>  linkcheck to check all external links for integrity
>  doctest   to run all doctests embedded in the documentation (if enabled)
>
>
> $ make latex
> ...
> reading sources... [ 16%] de/quickstart/ushahidi_quickstart
> reading sources... [ 16%] de/quickstart/virtualbox_quickstart
> reading sources... [ 17%] de/quickstart/zoo-project_quickstart
> reading sources... [ 17%] de/sponsors
>
> reST markup error:
> .../trunk/doc/de/sponsors.rst:33: (SEVERE/4) Problems with "include" directive path:
> IOError: [Errno 2] No such file or directory: 'contributors.rst'.
> make: *** [latex] Error 1
>
> (so I get the similar problems as you)
>
> # if that had worked you could then do LaTeX to dvi/postscript/pdf,
> # with any of the classic tools.
> $ pdflatex ...
>
>
> Hamish



-- 
cheers,
maning
------------------------------------------------------
"Freedom is still the most radical idea of all" -N.Branden
wiki: http://esambale.wikispaces.com/
blog: http://epsg4253.wordpress.com/
------------------------------------------------------


More information about the Live-demo mailing list