sphinx 用于多个单独的文档

Question

我是 Sphinx 的新手，我在服务器上记录我的项目。现在一位同事看到了我一直在做的事情，她想做同样的事情——在同一台服务器上记录她的项目。

这些项目不相关（它们不属于单个 TOCtree），我不知道如何帮助她。我可以配置 sphinx 来构建单独的文档树吗？是否像制作两个 Makefile 副本并设置不同的源/构建目录一样简单？

谢谢， --蒂姆

Answer 1

是的，我认为您希望将它们视为单独的项目。为此，您应该按照您的说明复制当前的构建树，并编辑 config.py 文件。其他选项只是通过运行sphinx-quickstart 从头开始​​。

另外，请记住，您可以使用 Intersphinx plugin 引用两个文档之间的主题。