Mkdocs超链接在静态页面中不起作用

Question

我正在尝试使用mkdocs构建文档。 问题是静态创建的页面中的链接不起作用。 我没有前往[文件夹] /index.html，而是提供了以下页面，如下面的image

当我尝试使用mkdocs服务时，问题并不存在

Answer 1

在false配置文件中将use_directory_urls设置为mkdocs.yml：

use_directory_urls: false

文档说明：

  

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

     

下表演示了网站上使用的网址的不同之处   将use_directory_urls设置为true或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，通常是您想要使用的。

     

如果你想要你的话，替代风格偶尔会有用   直接打开页面时保持正确链接的文档   从文件系统，因为它创建直接指向的链接   目标文件而不是目标   目录

最后一段是影响其原因的关键。