python - sphinx で sitemap.xml ファイルを生成するにはどうすればよいですか?

Question

「特別なエントリ名 self は、toctree ディレクティブを含むドキュメントを表します。これは、toctree から「サイトマップ」を生成する場合に役立ちます。」そして、私はこのスレッドを見てきました - Using self to create a sitemap with toctree in sphinx は壊れているようですか? . 私はこれを機能させることができないようです。

私が見ることができるスフィンクスによって生成されたサイトマップの詳細な例がある場所はありますか?

Answer 1

このテーマのサイトマップジェネレーターを自分のテーマで使用することになりました。 https://github.com/guzzle/guzzle_sphinx_theme

# Import guzzle theme https://github.com/guzzle/guzzle_sphinx_theme
# Not actually using the theme but intead using the
# sitemap functionality and overriding the theme/templates in source/
html_translator_class = 'guzzle_sphinx_theme.HTMLTranslator'
html_theme_path = guzzle_sphinx_theme.html_theme_path()
html_theme = 'guzzle_sphinx_theme'
extensions.append("guzzle_sphinx_theme")
html_theme_options = {
    "base_url": "YOURSITEURL"
}

ソース ディレクトリ内のすべてをオーバーライドしています。サイトマップ ジェネレーター以外のテーマの他の部分は使用していません。かなりずさんな解決策ですが、私にとってはうまくいきました。