离线构建¶

如果您希望将文档与产品一同发布，MkDocs 能够满足您的需求 - 借助主题的支持， MkDocs 可以构建支持离线的文档。值得注意的是，Material-for-MkDocs 为其众多功能提供了离线支持。

配置¶

内置离线插件确保在您将站点目录的内容作为下载包分发时，站内搜索功能仍然可以正常工作。只需在 mkdocs.yml 文件中添加以下几行代码：

plugins:
  - offline

要了解所有设置的列表，请参阅插件文档。

自动打包所有依赖资源

内置隐私插件使得在构建用于离线使用的文档时，能够轻松地使用外部资源，因为它会自动下载所有外部资源，并将它们与您的文档一起分发。

Material-for-MkDocs 提供了许多交互式功能，但由于现代浏览器的限制，其中一些功能在从文件系统直接打开时可能无法正常工作。特别是，所有使用 fetch API 的功能都会出错。

因此，在构建用于离线使用的文档时，请确保禁用以下配置设置：即时加载、站点分析、Git 仓库、版本控制和评论系统。