Problems building documentation (example with Zope)
recently I began trying to customize the look of documentation Sphinx generates. Reading documentation was not of much use for it.
I went on to finding examples in some open source projects. This has been particularly frustrasting because the look of the generated HTML pages or PDF files I see is not on the source files themselves, and are neither in the conf.py.
If I understood the are imported from the conf.py files. But how to locate these files? Can the reside in the documentation directory, so documentation can compile with all files only in its dir?
Compiling the documentation has been a challenge for me in some projects. And I feel I'm far from my primary objective: understand how to customize some of the look of the generated docs, mainly in latex and html outputs.
I don't know Python, and this also seem to have added to my difficulty.
The example I choose to show my problem is Zope documentation. They have made some guide to compile the documentation, but it didn't work me:
Building the HTML Documentation for Zope (from http://docs.zope.org/developer/sphinx-documentation.html)
svn co svn://svn.zope.org/repos/main/zope.event/trunk event-trunk
In the last step I have this in my terminal:
$ make html sphinx-build -b html -d _build/doctrees . _build/html Making output directory... Running Sphinx v1.0.1
Exception occurred: File "/usr/lib/python2.7/dist-packages/pkg_resources.py", line 552, in resolve raise DistributionNotFound(req) DistributionNotFound: zope.event The full traceback has been saved in /tmp/sphinx-err-D4GnFh.log, if you want to report the issue to the developers. Please also report this if it was a user error, so that a better error message can be provided next time. Either send bugs to the mailing list at http://groups.google.com/group/sphinx-dev/, or report them in the tracker at http://bitbucket.org/birkenfeld/sphinx/issues/. Thanks! make: ** [html] Erro 1