How to use latex_appendices

104 views
Skip to first unread message

Sergio

unread,
Mar 9, 2010, 10:23:33 AM3/9/10
to sphinx-dev
I am trying to build a document using Sphinx 0.6.5 and want to
tell Latex that a collection of documents are to be treated as
appendices.

In the config.py file there is a parameter setting that seems to be
what I was looking for.

The root index has a toctree of the form:

.. toctree::
:maxdepth: 1

appendices/index


The appendices directory consists of a collection of documents with an
index file
containing:

Appendix
###########

.. toctree::
:maxdepth: 1
:glob:

*

I am finding the following issues:

1. If I set latex_appendices = ['appendices/*']
it does not work. OK, sphinx does not glob.


2. If I list the documents by hand using
latex_appendices = ['appendices/doc1', 'appendices/doc2']

This works for the listed documents but they appear duplicated,
as a regular
section and as an appendix.

3. When I try to include the index in the list

latex_appendices =['appendices/index', 'appendices/doc1']

The renderer blows up with an error:

Exception occurred:
File "c:\python26\lib\site-packages\Sphinx-0.6.5-py2.6.egg
\sphinx\writers\latex.py", line 1373, in unknown_visit
raise NotImplementedError('Unknown node: ' +
node.__class__.__name__)
NotImplementedError: Unknown node: toctree

Where it tells me that possibly you cannot include a toctree
in the apendix


I could not find much discussion of this feature on line. Any ideas on
how to make Sphinx more appendix friendly when producing LaTeX output?


Sergio

Reply all
Reply to author
Forward
0 new messages