On 2010-04-22, Jacob Kaplan-Moss wrote:

> 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. 
...
> 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?

Create a *.tex "master file" that includes all your volumes.

Include the volumes as Parts.

This should make it possible to configure the cross-volume references
to show up as intended.

Either create a huge PDF and split it up with some PDF tool or 
search for "latex export to several PDF documents" (or ask at
comp.text.tex).

Günter

-- 
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