我有一个包含我的项目的工作目录，它位于版本控制系统中。我想在我的项目中创建一个doc目录，其中包含仅重组文本文件sphinx。
也就是说，我不希望sphinx在我的项目中构建html文件，而是将它们放在外面，这样它们就不会被置于版本控制之中。
答案 0 :(得分：5)
因此，如果您质疑'我如何在源树之外构建文档'，documentation会有所帮助：
sphinx-build -b html sourcedir builddir
只需将builddir指向源树之外的位置即可。
或者，根据您的版本控制系统，将生成文档的目录添加到“忽略文件”（例如.gitignore，.hgignore，...）