I have been trying to build the SA 0.6 docs on python2.6 on Mac, and Sphinx raised an error with a message asking me to post here, so I am doing so. Bear in mind that I haven't used Sphinx before (I do use WerkZeug and Jinja2 heavily, so am a big fan of Pocoo and very grateful to you guys), nor have I bothered to read the docs yet, so I am likely doing something obviously wrong.
I checked the 0.6 branch out of svn: $ svn checkout http://svn.sqlalchemy.org/sqlalchemy/branches/rel_0_6 sa06 Then I easy_installed sphinx and mako, created a dir for the output, and ran sphinx: $ cd sa06 $ mkdir docs $ sphinx-build doc/build/ docs The full trace back is below. Thanks Ed (py26)[singleto...@xander sa06]$ sphinx-build doc/build/ docs Running Sphinx v0.6.2 No builder selected, using default: html loading pickled environment... not found building [html]: targets for 42 source files that are out of date updating environment: 42 added, 0 changed, 0 removed reading sources... [100%] sqlexpression /Users/singletoned/src/sa06/doc/build/dbengine.rst:66: (WARNING/2) Bullet list ends without a blank line; unexpected unindent. /Users/singletoned/src/sa06/doc/build/dbengine.rst:76: (WARNING/2) Bullet list ends without a blank line; unexpected unindent. /Users/singletoned/src/sa06/doc/build/dbengine.rst:82: (WARNING/2) Bullet list ends without a blank line; unexpected unindent. /Users/singletoned/src/sa06/doc/build/intro.rst:: (WARNING/2) Duplicate explicit target name: "setuptools". /Users/singletoned/src/sa06/lib/sqlalchemy/sql/expression.py:docstring of sqlalchemy.sql.expression.delete:9: (WARNING/2) Field list ends without a blank line; unexpected unindent. /Users/singletoned/src/sa06/lib/sqlalchemy/sql/expression.py:docstring of sqlalchemy.sql.expression.insert:18: (WARNING/2) Field list ends without a blank line; unexpected unindent. /Users/singletoned/src/sa06/lib/sqlalchemy/sql/expression.py:docstring of sqlalchemy.sql.expression.insert:22: (WARNING/2) Field list ends without a blank line; unexpected unindent. /Users/singletoned/src/sa06/lib/sqlalchemy/sql/expression.py:docstring of sqlalchemy.sql.expression.update:9: (WARNING/2) Field list ends without a blank line; unexpected unindent. /Users/singletoned/src/sa06/lib/sqlalchemy/sql/expression.py:docstring of sqlalchemy.sql.expression.Select.correlate:5: (WARNING/2) Block quote ends without a blank line; unexpected unindent. /Users/singletoned/src/sa06/lib/sqlalchemy/sql/expression.py:docstring of sqlalchemy.sql.expression.Select.correlate:8: (WARNING/2) Block quote ends without a blank line; unexpected unindent. /Users/singletoned/src/sa06/lib/sqlalchemy/schema.py:docstring of sqlalchemy.schema.DDL.__init__:41: (WARNING/2) Inline strong start- string without end-string. /Users/singletoned/src/sa06/lib/sqlalchemy/types.py:docstring of sqlalchemy.types.UserDefinedType:19: (WARNING/2) Definition list ends without a blank line; unexpected unindent. /Users/singletoned/src/sa06/lib/sqlalchemy/types.py:docstring of sqlalchemy.types.UserDefinedType:24: (WARNING/2) Definition list ends without a blank line; unexpected unindent. looking for now-outdated files... none found pickling environment... done checking consistency... /Users/singletoned/src/sa06/doc/build/ copyright.rst:: WARNING: document isn't included in any toctree done preparing documents... done writing output... [ 2%] copyright Exception occurred: File "/Users/singletoned/.envs/py26/lib/python2.6/site-packages/ Mako-0.2.4-py2.6.egg/mako/lookup.py", line 87, in get_template raise exceptions.TopLevelLookupException("Cant locate template for uri '%s'" % uri) TopLevelLookupException: Cant locate template for uri 'page.mako' The full traceback has been saved in /var/folders/bK/ bKQXbEG7HeGZtuBOWFYvw++++TI/-Tmp-/sphinx-err-pCjAfa.log, if you want to report the issue to the author. Please also report this if it was a user error, so that a better error message can be provided next time. Send reports to [email protected]. Thanks! --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [email protected] For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en -~----------~----~----~----~------~----~------~--~---
