ReadTheDocsに「最終更新日時」が表示されない理由

Question

ReadTheDocsによってレンダリングされ、ホストされているdocumentationがあります。ローカルのHTMLドキュメントには今日の日付が表示されていますが、 "最後に更新された"行の代わりにGitコミットハッシュが表示されます。

ローカルバージョン：

オンラインバージョン：docs/conf.pyファイルで

、私は非None値にhtml_last_updated_fmtを設定し - >空の文字列。
出典：https://github.com/VLSI-EDA/PoC/blob/master/docs/conf.py#L173-L176

なぜReadTheDocsは自分の設定を無視していますか？最終更新日はどのように取得できますか？

Answer 1

リビジョン情報が利用可能であれば（here's the commit that introduced the change）、ReadTheDocsのデフォルトテーマはLast updatedの情報をリビジョン情報に置き換えます。

これを修正するには、カスタムテーマを作成して使用することができます。 これは自明ではありません。次のように実行します。

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