Hi folks --
I'm working on converting Django's docs to PDF via the latex builder
with the eventual goal of producing physical printed media.
The first problem I've run into is a simple matter of scale: Django
docs, all told, cover more than 2300 printed pages, so printing a
single book is unreasonable.
So, I'm trying to figure out a way to divide things up into multiple
volumes. This starts off easy enough -- I've just got multiple entries
in my ``latex_documents`` option::
latex_documents = [
('_latex/vol1-intro', 'django-vol1-intro.tex', ...),
('_latex/vol2-using', 'django-vol2-using.tex', ...),
('_latex/vol3-ref', 'django-vol3-ref.tex', ...),
('_latex/vol4-contrib', 'django-vol4-contrib.tex', ...),
('_latex/vol5-gis', 'django-vol5-gis.tex', ...),
('_latex/vol6-misc', 'django-vol6-misc.tex', ...),
]
I stick each partial toctree in the various ``_latex/*.txt`` files,
and, bingo, multiple PDFs.
But. These documents aren't actually useful, because all the
references that go across multiple documents are broken. That is, any
references in the same volume work fine but references to material
that ends up in other documents don't.
I'd like to get references like "see _the model API reference_,
(Volume 3, pp. 123)".
Any hints?
I'm using Sphinx pre-1.0 from HG, up-to-date as of this morning. The
work I've done so far can be found on Github:
http://github.com/jacobian/django/tree/pdf-docs/docs/.
Thanks!
Jacob
--
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.
