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

ReadTheDocs の既定のテーマはLast updated、リビジョン情報が利用可能な場合、情報をリビジョン情報に置き換えます (変更を導入したコミットはこちら)。

これを修正するには、カスタム テーマを作成して使用します。これは簡単なことではありません。次のように進めます。

• ReadTheDocs テーマをフォークします。
• 上記で参照したコミットの変更を「元に戻す」。
• requirementsドキュメントのファイルでフォークを参照してください。ここに、要件ファイルの例を示します。ただし、ファイルは通常、リポジトリのルート ディレクトリにあり、名前はrequirements.txt.
• プロジェクトがカスタム要件のインストールをサポートするように構成されていることを確認してください。
• すべての変更を GitHub にプッシュします。
• ReadTheDocs でプロジェクトを再構築します。