MkDocs 获得完整的站点地图

Question

我是 Nasix.js.org 的所有者，我想知道如何获取站点地图。它应该自动生成，但似乎不起作用。请参阅 nasix.js.org/sitemap.xml。所有的文档都说它会在那里，但事实并非如此。谢谢！

Answer 1

您需要在mkdocs.yml 配置文件中设置site_url 配置设置：

site_url: https://nasix.js.org/

传统上，站点地图中的链接应包含页面的完全限定 URL。因此，站点地图是使用每个页面的canonical_url 构建的。但是，如果没有 site_url，MkDocs 不知道要使用哪个域，并且未设置 canonical_url。因此，站点地图将包含空白条目。

请注意，mkdocs/mkdocs#1783 中讨论了在未设置 site_url 时引发某种警告的讨论。