我安装了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
即可打开构建的文件。