Mkdocs超链接不是静态网页工作

Question

我试图建立与mkdocs一个文档。问题是，在静态创建的页面的链接不工作。我没有转到[folder] /index.html，而是看到下一页，如下图所示

问题然而，当我尝试mkdocs服务不存在

Answer 1

在您的配置文件中将use_directory_urls设置设置为：falsemkdocs.yml

use_directory_urls: false

该文档说明：

此设置控制用于链接到文档中页面的样式。

下表说明了设置use_directory_urls为true或时网站上使用的URL的不同之处false。

Source file  | Generated HTML       | use_directory_urls: true | use_directory_urls: false
------------ | -------------------- | ------------------------ | ------------------------
index.md     | index.html           | /                        | /index.html
api-guide.md | api-guide/index.html | /api-guide/              | /api-guide/index.html
about.md     | about/index.html     | /about/                  | /about/index.html

默认样式use_directory_urls: true会创建更多用户友好的URL，通常是您要使用的样式。

如果您希望直接从文件系统打开页面时希望文档保持正确链接，则备用样式有时会很有用，因为它会创建直接指向目标文件而非目标 目录的链接。

最后一段是为什么有所作为的关键。