#8488: Building latex fails in the docs-refactor branch
------------------------------------+---------------------------------------
Reporter: programmerq | Owner: nobody
Status: new | Milestone:
Component: Documentation | Version: other branch
Resolution: | Keywords:
Stage: Unreviewed | Has_patch: 0
Needs_docs: 0 | Needs_tests: 0
Needs_better_patch: 0 |
------------------------------------+---------------------------------------
Changes (by ramiro):
* needs_better_patch: => 0
* needs_tests: => 0
* needs_docs: => 0
Old description:
> I can build the html docs just fine. I'm using [EMAIL PROTECTED], and
> sphinx 0.3. I'm using the docs-refactor branch from Jacob's git repo at
> 8c4f062f (current HEAD as of opening this ticket)
>
> It fails when I try to build the latex docs.
>
> I'm still trying to diagnose this, but figured I'd open a ticket in case
> someone else's eyes can pick out what's wrong faster than mine could.
>
> Here is the output:
>
> {{{
>
> [EMAIL PROTECTED]:~/docrf/django/docs$ make latex
> mkdir -p _build/latex _build/doctrees
> sphinx-build -b latex -d _build/doctrees . _build/latex
> Sphinx v0.3, building latex
> trying to load pickled env... failed: ('__new__() takes at least 2
> arguments (1 given)', <class 'docutils.nodes.Text'>, ())
> building [latex]: all documents
> updating environment: 123 added, 0 changed, 0 removed
> reading... contents faq/admin faq/contributing faq/general faq/help
> faq/index faq/install faq/models faq/usage glossary howto/apache-auth
> howto/custom-file-storage howto/custom-management-commands howto/custom-
> model-fields howto/custom-template-tags howto/deployment/fastcgi
> howto/deployment/index howto/deployment/modpython howto/error-reporting
> howto/index howto/initial-data howto/legacy-databases howto/outputting-
> csv howto/outputting-pdf howto/static-files index internals/contributing
> internals/documentation internals/index intro/index intro/install
> intro/overview intro/tutorial01 intro/tutorial02 intro/tutorial03
> intro/tutorial04 intro/whatsnext misc/api-stability misc/design-
> philosophies misc/distributions misc/index obsolete/admin-css
> obsolete/forms obsolete/index obsolete/newforms-migration
> ref/contrib/admin ref/contrib/auth ref/contrib/contenttypes
> ref/contrib/csrf ref/contrib/databrowse ref/contrib/flatpages
> ref/contrib/formtools/form-preview ref/contrib/formtools/form-wizard
> ref/contrib/formtools/index ref/contrib/humanize ref/contrib/index
> ref/contrib/localflavor ref/contrib/redirects ref/contrib/sitemaps
> ref/contrib/sites ref/contrib/syndication ref/contrib/webdesign
> ref/databases ref/django-admin ref/files/file ref/files/index
> ref/files/storage ref/forms/api ref/forms/fields ref/forms/index
> ref/forms/widgets ref/generic-views ref/index ref/middleware
> ref/models/fields ref/models/index ref/models/instances
> ref/models/options ref/models/querysets ref/models/relations ref/request-
> response ref/settings ref/templates/api ref/templates/authors
> ref/templates/builtins ref/templates/index ref/unicode releases/0.95
> releases/0.96 releases/1.0-alpha-1 releases/1.0-alpha-2 releases/1.0-beta
> releases/index topics/auth topics/cache topics/db/index
> topics/db/managers topics/db/models topics/db/queries topics/db/sql
> topics/db/transactions topics/email topics/files topics/forms/formsets
> topics/forms/index topics/forms/media topics/forms/modelforms topics/http
> /file-uploads topics/http/generic-views topics/http/index
> topics/http/middleware topics/http/sessions topics/http/shortcuts
> topics/http/urls topics/http/views topics/i18n topics/index
> topics/install topics/pagination topics/serialization topics/settings
> topics/templates topics/testing
> WARNING:
> /users/home1/admin/jefferya/docrf/django/docs/ref/contrib/admin.txt:610:
> (ERROR/3) Unknown target name: "forms".
> pickling the env... done
> checking consistency...
> WARNING: /users/home1/admin/jefferya/docrf/django/docs/index.txt::
> document isn't included in any toctree
> processing django.tex... index
> resolving references...
> WARNING: /users/home1/admin/jefferya/docrf/django/docs/index.txt::
> (WARNING/2) undefined label: howto-outputting-PDF
> writing... WARNING: encountered rubric node not used for footnotes,
> content will be lost
> Exception occurred:
> File "/users/admin/jefferya/sandbox/docutils/nodes.py", line 1589, in
> unknown_departure
> if (node.document.settings.strict_visitor
> AttributeError: 'NoneType' object has no attribute 'settings'
> The full traceback has been saved in /tmp/sphinx-err-x80mK9.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!
> make: *** [latex] Error 1
>
> }}}
New description:
I can build the html docs just fine. I'm using [EMAIL PROTECTED], and
sphinx 0.3. I'm using the docs-refactor branch from Jacob's git repo at
8c4f062f (current HEAD as of opening this ticket)
It fails when I try to build the latex docs.
I'm still trying to diagnose this, but figured I'd open a ticket in case
someone else's eyes can pick out what's wrong faster than mine could.
Here is the output:
{{{
[EMAIL PROTECTED]:~/docrf/django/docs$ make latex
mkdir -p _build/latex _build/doctrees
sphinx-build -b latex -d _build/doctrees . _build/latex
Sphinx v0.3, building latex
trying to load pickled env... failed: ('__new__() takes at least 2
arguments (1 given)', <class 'docutils.nodes.Text'>, ())
building [latex]: all documents
updating environment: 123 added, 0 changed, 0 removed
reading... contents faq/admin faq/contributing faq/general faq/help
faq/index faq/install faq/models faq/usage glossary howto/apache-auth
howto/custom-file-storage howto/custom-management-commands howto/custom-
model-fields howto/custom-template-tags howto/deployment/fastcgi
howto/deployment/index howto/deployment/modpython howto/error-reporting
howto/index howto/initial-data howto/legacy-databases howto/outputting-csv
howto/outputting-pdf howto/static-files index internals/contributing
internals/documentation internals/index intro/index intro/install
intro/overview intro/tutorial01 intro/tutorial02 intro/tutorial03
intro/tutorial04 intro/whatsnext misc/api-stability misc/design-
philosophies misc/distributions misc/index obsolete/admin-css
obsolete/forms obsolete/index obsolete/newforms-migration
ref/contrib/admin ref/contrib/auth ref/contrib/contenttypes
ref/contrib/csrf ref/contrib/databrowse ref/contrib/flatpages
ref/contrib/formtools/form-preview ref/contrib/formtools/form-wizard
ref/contrib/formtools/index ref/contrib/humanize ref/contrib/index
ref/contrib/localflavor ref/contrib/redirects ref/contrib/sitemaps
ref/contrib/sites ref/contrib/syndication ref/contrib/webdesign
ref/databases ref/django-admin ref/files/file ref/files/index
ref/files/storage ref/forms/api ref/forms/fields ref/forms/index
ref/forms/widgets ref/generic-views ref/index ref/middleware
ref/models/fields ref/models/index ref/models/instances ref/models/options
ref/models/querysets ref/models/relations ref/request-response
ref/settings ref/templates/api ref/templates/authors
ref/templates/builtins ref/templates/index ref/unicode releases/0.95
releases/0.96 releases/1.0-alpha-1 releases/1.0-alpha-2 releases/1.0-beta
releases/index topics/auth topics/cache topics/db/index topics/db/managers
topics/db/models topics/db/queries topics/db/sql topics/db/transactions
topics/email topics/files topics/forms/formsets topics/forms/index
topics/forms/media topics/forms/modelforms topics/http/file-uploads
topics/http/generic-views topics/http/index topics/http/middleware
topics/http/sessions topics/http/shortcuts topics/http/urls
topics/http/views topics/i18n topics/index topics/install
topics/pagination topics/serialization topics/settings topics/templates
topics/testing
WARNING:
/users/home1/admin/jefferya/docrf/django/docs/ref/contrib/admin.txt:610:
(ERROR/3) Unknown target name: "forms".
pickling the env... done
checking consistency...
WARNING: /users/home1/admin/jefferya/docrf/django/docs/index.txt::
document isn't included in any toctree
processing django.tex... index
resolving references...
WARNING: /users/home1/admin/jefferya/docrf/django/docs/index.txt::
(WARNING/2) undefined label: howto-outputting-PDF
writing... WARNING: encountered rubric node not used for footnotes,
content will be lost
Exception occurred:
File "/users/admin/jefferya/sandbox/docutils/nodes.py", line 1589, in
unknown_departure
if (node.document.settings.strict_visitor
AttributeError: 'NoneType' object has no attribute 'settings'
The full traceback has been saved in /tmp/sphinx-err-x80mK9.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!
make: *** [latex] Error 1
}}}
Comment:
I'd recommend trying with Sphinx 0.4.2. From what can be seen
[http://sphinx.pocoo.org/changes.html#release-0-4-3-in-development here],
it's a somewhat fast moving target itself and there are a few entries in
the changelog related to fixes in the LaTeX output. There are reports of
people already creating PDF versions of the Django documentation, so this
would indicate you ''outdated'' Sphinx is likely the cause of problems you
are experiencing.
This could also dictate the minimum Sphinx version we need to document is
needed to create local copies of the Django docs.
--
Ticket URL: <http://code.djangoproject.com/ticket/8488#comment:1>
Django Code <http://code.djangoproject.com/>
The web framework for perfectionists with deadlines
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"Django updates" 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/django-updates?hl=en
-~----------~----~----~----~------~----~------~--~---
