Sphinx用于多个独立文档的文档生成。

Question

我对Sphinx（一种文档生成工具）比较陌生，现在我需要在服务器上记录我的项目。我的一个同事看到了我所做的事情，并希望做同样的事情——在同一台服务器上记录她的项目。

这两个项目并不相关（它们不属于单个TOCtree），我不知道如何帮助她。我能否配置Sphinx以构建单独的文档树？是否只需复制Makefile两次并将其设置为不同的源/生成目录即可？

谢谢， --Tim

- Tim

Answer 1

是的，我认为你希望将它们作为独立的项目处理。因此，您应该像您所说的那样复制当前的构建树，并编辑config.py文件。另一种选项是通过运行sphinx-quickstart从头开始。

此外，请记住，您可以使用Intersphinx插件在两个文档之间引用主题。

- cmcginty