Using Sphinx for documenting projects and modules on demand

Question

Hello:

I use Sphinx for documenting a Python module. I have a master doc directory, where I put individual *.rst files (on for each module component) to be included in the index.rst main file. That works great (please check the source of the Python Library Reference to see exactly how I do it).

My problem is when I need to create a standalone PDF for a given module component (as opposed to the whole module).

Say you have the same structure as in the Python Library Reference for your full module (library), and you then one to create a standalone PDF for the documentation of, say, the crypto component. What would you do?

1. Create a different index (index_2.rst) and include only that file (crypto.rst)
2. Comment the other files from the original index.rst
3. Create a whole new doc directory inside the crypto with standalone Sphinx documentation

None of these approaches seem straightforward.

Advice, please.