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

Question

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

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

Answer 1

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

1. 使用以下内容创建一个 index.rst 字段:

======================
API XXX 的 Javadoc
======================

因为我使用的是扩展名“sphinx.ext.autosectionlabel”，所以这变成了“1 级”部分。

1. 修改 Make 文件，以便在生成 HTML 后，将“API XXX 的 Javadoc”部分的 index.html 替换为我的 API 的 Javadoc。

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

我知道这不是正确的方法，但这是我在多次 Google 搜索后想到的唯一方法。