configuration-files - 为什么 ReadTheDocs 不显示“上次更新时间”

Question

我有一个由 ReadTheDocs 呈现和托管的文档。它仍然显示 Git 提交哈希而不是“上次更新时间”行，而我的本地 HTML 文档显示今天的日期。

本地版本：

网络版：

在docs/conf.py文件中，我配置html_last_updated_fmt为非None值 -> 空字符串。
来源：https ://github.com/VLSI-EDA/PoC/blob/master/docs/conf.py#L173-L176

为什么 ReadTheDocs 会忽略我的设置？如何获取最后更新日期？

Answer 1

Last updated如果修订信息可用，则ReadTheDocs 默认主题将信息替换为修订信息（这是引入更改的提交）。

要解决此问题，您可以创建和使用自定义主题。这不是微不足道的。进行如下操作：

• Fork ReadTheDocs 主题。
• “撤消”我上面提到的提交的更改。
• 在您的文档文件中引用 fork requirements。在这里，您可以看到需求文件的示例。但是，该文件通常应位于存储库的根目录中，并且名称为requirements.txt.
• 确保您的项目配置为支持安装自定义要求。
• 将所有更改推送到 GitHub。
• 在 ReadTheDocs 上重建您的项目。