python-sphinx - 使用 Sphinx 将 reST 文档替换为整个目录

Question

我的项目的主要文档是 Sphinx。我还有大量想要集成的 JavaDocs。基本设置是：

sphinx_source/

javadocs_built/

在构建 Sphinx 文档之前，我可以将 JavaDocs 复制到sphinx_source.

如何从 Sphinx 中引用包含非 reST 文件的目录，并在构建过程中将它们带入？

Answer 1

您可能需要使用该:download:指令引用文件。

见：这里。

请注意，您需要单独引用这些文件，因此您可能需要设置某种脚本来为您生成引用。