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

Question

我的项目主要文档是Sphinx。我还有大量的JavaDocs，我想整合它们。基本设置是：

sphinx_source/

javadocs_built/

在构建Sphinx文档之前，我可以将JavaDocs复制到sphinx_source下的目录中。

如何在Sphinx中使用非reST文件引用此目录，并在构建过程中引入它们？

Answer 1

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

请参阅：here。

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