Enhance config options - separate documents

[Lennonka]

Hello!

It would be very useful to have options in the conf.py to define a set of separate documents that would be generated from different "master" docs, similar to the built-in latex builder.

For example: Let's have this Sphinx project:

• conf.py, Makefile
• index.rst
• documentA.rst
• documentB.rst

I want document A and document B in separate output files and use different stylesheets.

I could define that in the conf.py as follows:

docx_documents = [
  ('documentA', 'Document01.docx', dotx_stylesheetA, toctree_only),
  ('documentB',  'Document02.docx', dotx_stylesheetB, toctree_only),
  ...
]

Then make docx would build Document01.docx from the file documentA.rst using docx_stylesheetA and Document02.docx from the file documentB.rst using docx_stylesheetB.

Perhaps code from the latex builder could be reused.

Thanks a lot for looking into this!

[hugobuddel]

Thanks @Lennonka. We made this tool to scratch our own itch, and it seems that others like it too so we should step up our game.