将其他html文档集成到sphinx文档中

Question

如何将其他工具（如nose，coverage和pylint报告）生成的html文档包含在Sphinx文档中。他们应该进入_static目录吗？如果是这样，你如何链接到他们？

我正在尝试将所有代码开发工具文档的简洁包构建为.pdf或html。

Answer 1

我有类似的问题，我可以通过执行以下操作来解决它。请注意，这仅适用于HTML输出。

1. 使用以下内容创建index.rst字段：

====================== Javadoc of the API XXX ======================

当我使用扩展名“sphinx.ext.autosectionlabel”时，这将成为“1级”部分。

1. 修改Make文件，这样，一旦生成HTML，它就会用“我的API的Javadoc”替换“API XXX的Javadoc”部分的index.html。

在此更改之后，在toctree上我有一个指向“API XXX的Javadoc”的链接，当您单击它时，您会看到Javadoc。

我知道这不是正确的方式这样做，但它是我在许多Google搜索后提出的唯一方法。