Separate sphinx build assemblies and source directories for version control

Question

I have a working directory containing my project, and it is in the version control system. I would like to create a doc directory in my project containing only the modified text files for sphinx .

That is, I do not want sphinx create html files inside my project, but put them outside so that they do not fall into version control.

Answer 1

So, if you ask the question: “How can I create documentation outside the source tree”, the documentation helps:

 sphinx-build -b html sourcedir builddir 

Just point builddir to a location outside the source tree.

Or, depending on your version control system, add the directory in which you create your documentation to the ignore file (e.g. .gitignore , .hgignore , ...)