How to generate one page per module with sphinx

Question

We are using Sphinx to generate our Python documentation. This is the command line we use: ``` sphinx-apidoc -F -o %WORKSPACE%\docs_rst %PACKAGE% sphinx-build -b html %WORKSPACE%\docs_rst %WORKSPACE%\docs ``` The problem is that we get one page per package. What we would really need though is one page per module as the page gets way too long otherwise. How would I set this up please?

Accepted Answer

I have submitted a patch to Sphinx to do exactly what you are asking for -- it adds a commandline option to apidoc that will put each module on its own page.

Patch can be viewed here: https://bitbucket.org/birkenfeld/sphinx/pull-request/161/added-option-to-apidoc-to-write-each

It's currently pending a merge into Sphinx, the command will add a separate tag that will work thusly:

`sphinx-apidoc -o [output_dir] [package_dir] --separate`

How to generate one page per module with sphinx

Solution

Problem