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

Hamish hamish_b at yahoo.com
Mon Dec 5 01:27:49 PST 2011


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



More information about the Osgeolive mailing list