单独的sphinx构建和源目录以进行版本控制

Tim*_*Tim 9 python-sphinx

我有一个包含我的项目的工作目录,它位于版本控制系统中.我想doc在我的项目中创建一个包含重组文本文件的目录sphinx.

也就是说,我不想sphinx在我的项目中构建html文件,而是将它们放在外面,这样它们就不会被置于版本控制之下.

Tho*_*nzl 7

因此,如果您提出的问题是"我如何在源代码树之外构建文档",那么文档可以帮助:

sphinx-build -b html sourcedir builddir
Run Code Online (Sandbox Code Playgroud)

只需将builddir指向源树之外的位置即可.

或者,这取决于你的版本控制系统,你生成你的文档的目录添加到"忽略文件"(例如.gitignore,.hgignore,...)