use the Makefile included in the dist
Ed Singleton wrote:
>
> 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 [email protected]. Thanks!
>
>
> >
>
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"sqlalchemy" 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/sqlalchemy?hl=en
-~----------~----~----~----~------~----~------~--~---
