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

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" 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/sphinx-dev?hl=en.

Reply via email to