如何使用sphinx生成sitemap.xml文件？

Question

Here它说：“特殊条目名称self代表包含toctree指令的文档。如果你想从toctree生成一个”站点地图“，这很有用。”我一直在看这个thred - Using self to create a sitemap with toctree in sphinx seem broken?。我似乎无法让这个工作。

是否有任何地方有一个详细的例子，我可以看看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"
}

我覆盖了我的源目录中的所有内容我没有使用除了站点地图生成器之外的主题的任何其他部分。相当邋solution的解决方案，但它对我有用。