Error building Trac API docs in PDF format

[Olemis Lang]

How could I generate API docs in PDF format . At present I noticed the
following error . Is this possible at all ? Do I need to install
something else ? ... Or is it that api apidoc-pdf make target is not
working ?

{{{
#!sh

$ make apidoc-pdf
It looks like you don't have a Makefile.cfg file yet.
You can get started by doing `cp Makefile.cfg.sample Makefile.cfg'
and then adapt it to your environment.
Running Sphinx v1.0.1
loading pickled environment... done
loading intersphinx inventory from http://docs.python.org/2.7/objects.inv...
building [pdf]: targets for 34 source files that are out of date
updating environment: 0 added, 0 changed, 0 removed
looking for now-outdated files... none found
processing trac_dev... index api/index api/trac_attachment
api/trac_cache api/trac_core api/trac_db_api api/trac_db_util
api/trac_env api/trac_mimeview api/trac_ticket_roadmap api/trac_util
api/trac_util_datefmt api/trac_util_html api/trac_util_presentation
api/trac_util_text api/trac_util_datefmt api/trac_util_html
api/trac_util_presentation api/trac_util_text
api/trac_versioncontrol_api api/trac_versioncontrol_diff
api/trac_versioncontrol_svn_fs api/trac_web_api api/trac_web_auth
api/trac_web_chrome api/trac_web_href api/trac_web_main
api/trac_wiki_api api/trac_wiki_macros api/tracopt_mimeview
dev/testing dev/testing-intro dev/testing-core dev/testing-environment
dev/testing-database dev/testing-plugins glossary todo <string>::
(WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.svn_fs.subversionrepository method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.env.environment method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.api.repositorymanager attribute)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.db.util.connectionwrapper method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.svn_fs.subversionrepository method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.api.repository method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.svn_fs.subversionrepository method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.svn_fs.subversionrepository method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.svn_fs.subversionrepository method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.db.api.idatabaseconnector method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.svn_fs.subversionnode method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.svn_fs.subversionnode method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.svn_fs.subversionnode method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.svn_fs.subversionnode method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.api.node method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.svn_fs.subversionnode method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.mimeview.api.mimeview method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.svn_fs.subversionrepository method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.svn_fs.subversionrepository method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.svn_fs.subversionrepository method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.svn_fs.subversionrepository method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.api.node method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.svn_fs.subversionchangeset method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.svn_fs.subversionnode method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.svn_fs.subversionrepository method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.api.repositorymanager method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.mimeview.api.mimeview method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.api.repositorymanager method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.svn_fs.subversionrepository method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.svn_fs.subversionrepository method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.web.api.request attribute)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.mimeview.api.mimeview method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.env.environment method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.api.node method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.api.repository method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.svn_fs.subversionrepository method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.svn_fs.subversionrepository method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.svn_fs.subversionrepository method)".
<string>:: (WARNING/2) Duplicate explicit target name: "testing on".
<string>:: (WARNING/2) Duplicate explicit target name: "testing on".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.svn_fs.subversionrepository method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.mimeview.api.mimeview method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.wiki.api.wikisystem attribute)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.svn_fs.subversionrepository method)".
<string>:: (WARNING/2) Duplicate explicit target name: "tests".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.versioncontrol.api.repositorymanager method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.mimeview.api.mimeview method)".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.mimeview.api.mimeview method)".
<string>:: (WARNING/2) Duplicate explicit target name: "trac_test_db_uri".
<string>:: (WARNING/2) Duplicate explicit target name: "[1]".
<string>:: (WARNING/2) Duplicate explicit target name:
"(trac.env.environment method)".
[ERROR] pdfbuilder.py:108 BuildEnvironment instance has no attribute 'modules'
Traceback (most recent call last):
File "/usr/lib/pymodules/python2.6/rst2pdf/pdfbuilder.py", line 100, in write
appendices=opts.get('pdf_appendices', self.config.pdf_appendices) or [])
File "/usr/lib/pymodules/python2.6/rst2pdf/pdfbuilder.py", line 191,
in assemble_doctree
if self.config.pdf_use_modindex and self.env.modules:
AttributeError: BuildEnvironment instance has no attribute 'modules'
FAILED
build succeeded.

$ ls build/doc/pdf/
}}}

--
Regards,

Olemis.

Apache™ Bloodhound contributor
http://issues.apache.org/bloodhound

Blog ES: http://simelo-es.blogspot.com/
Blog EN: http://simelo-en.blogspot.com/

Featured article:

[Christian Boos]

On 5/2/2013 12:37 AM, Olemis Lang wrote:
> How could I generate API docs in PDF format . At present I noticed the
> following error . Is this possible at all ? Do I need to install
> something else ? ... Or is it that api apidoc-pdf make target is not
> working ?
>

I just tried ...

Sphinx error:
Builder name pdf not registered

Then I easy_install'ed rst2pdf (0.93 is current):

Running Sphinx v1.1.3
...
build succeeded, 4 warnings.

$ ls build/doc/pdf/
trac_dev.pdf

It looks fine and nicer than the last time I tried.

-- Christian

[Olemis Lang]

On 5/2/13, Christian Boos <cb...@bct-technology.com> wrote:
> On 5/2/2013 12:37 AM, Olemis Lang wrote:
>> How could I generate API docs in PDF format . At present I noticed the
>> following error . Is this possible at all ? Do I need to install
>> something else ? ... Or is it that api apidoc-pdf make target is not
>> working ?
>>
>
>
> I just tried ...
>
> Sphinx error:
> Builder name pdf not registered
>
> Then I easy_install'ed rst2pdf (0.93 is current):
>
> Running Sphinx v1.1.3
> ...
> build succeeded, 4 warnings.
>

Thanks for the pointer . It worked for me . Nevertheless jftr , it
will not work with Sphinx==1.2b1 (<=latest @ PyPI) . Another kind of
error is raised .

[...]

> It looks fine and nicer than the last time I tried.
>

;)