如何在没有服务器的本地计算机上使用Mkdocs？

Posted 2021-04-13

我安装了Mkdocs（Python 3.6.5）并编辑和构建了Markdown文件。

我试图用浏览器打开主index.html文件，但我无法直接打开链接到其他HTML文件的HTML页面。

使用命令提示符并输入“mkdocs serve”，我可以打开链接页面。我知道这是没有服务器的Mkdocs的正常功能。

我可以在本地计算机上使用Mkdocs吗？

答案

根据doc，你可以在use_directory_urls: false添加mkdocs.yml并重建它。

use_directory_urls: true的默认样式创建了更多用户友好的URL，通常是您想要使用的。如果您希望在直接从文件系统打开页面时保持文档正确链接，则备用样式（编辑：use_directory_urls: false）偶尔会很有用，因为它会创建直接指向目标文件而非目标目录的链接。

另一答案

根据官方文档，您可以使用mkdocs build生成html文件。它们将存储在名为site的文件夹中。您无需运行mkdocs serve即可打开构建的文件。