I'm trying to build the docs for SA 0.6 on python2.6 on Mac. I've assumed I need to use Sphinx (which obvously may be quite wrong of me), so I've easy_installed Sphinx and Mako, and then I run the command:
mkdir docs sphinx-build doc/build/ docs It appears to read in fine but then raises an error when writing the output. Full stack trace below, and any suggestions greatfully received. 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 sphinx-...@googlegroups.com. Thanks! --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "sqlalchemy" group. To post to this group, send email to sqlalchemy@googlegroups.com To unsubscribe from this group, send email to sqlalchemy+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/sqlalchemy?hl=en -~----------~----~----~----~------~----~------~--~---