我安装了 Mkdocs (Python 3.6.5) 并编辑和构建了 Markdown 文件。
我尝试使用浏览器打开主 index.html 文件,但无法直接打开链接到其他 HTML 文件的 HTML 页面。
使用命令提示符并输入“mkdocs serve”,我可以打开链接页面。我知道这是没有服务器的 Mkdocs 的正常功能。
我可以只在本地计算机上使用 Mkdocs 吗?
我安装了 Mkdocs (Python 3.6.5) 并编辑和构建了 Markdown 文件。
我尝试使用浏览器打开主 index.html 文件,但无法直接打开链接到其他 HTML 文件的 HTML 页面。
使用命令提示符并输入“mkdocs serve”,我可以打开链接页面。我知道这是没有服务器的 Mkdocs 的正常功能。
我可以只在本地计算机上使用 Mkdocs 吗?
根据文档,您可以添加use_directory_urls: false
并mkdocs.yml
重建它。
默认样式
use_directory_urls: true
创建更用户友好的 URL,通常是您想要使用的。如果您希望文档在直接从文件系统打开页面时保持正确链接,则备用样式(编辑use_directory_urls: false
:)有时会很有用,因为它创建的链接直接指向目标文件而不是目标目录。
根据官方文档,您可以使用mkdocs build
. 它们将存储在名为site
. 您可以打开构建的文件而无需运行mkdocs serve
.