Ah thanks, that seems to work fine now. Very grateful.
For anyone googling this, "use the Makefile" means:
$ cd doc/build
$ make html
Ed
On 29 Jul 2009, at 16:26, Michael Bayer wrote:
>
> 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
-~----------~----~----~----~------~----~------~--~---
