mkdocs 搜索栏在构建网站后无法工作

Question

构建 MKDOCS 后，网站上的 搜索栏 无法使用。而当我在本地主机中提供服务时，它正在工作。

是否有任何解决方法可以在构建 mkdocs 后使用搜索栏。

Answer 1

仅当站点由服务器提供服务时搜索才有效。当您使用

file://

查看文件时，它不起作用。这是浏览器安全设置施加的限制（JavaScript 代码无法通过

search-index.json

访问

file://

文件），我不建议您禁用这些设置。您可能会找到一个第三方插件和/或主题，它通过以不同的格式重新创建索引文件来提供解决方法，以便可以通过

<script>

标签而不是 ajax 请求加载它。

Answer 2

一个简单的解决方案，在 Apache 服务器上工作：

将包含以下行的文件

site/

添加到

.htaccess

的根目录：

AddType application/javascript .js

可以在此处找到适用于 Azure Web 应用程序的同类解决方案。

Answer 3

我发现如果您使用 Material for MkDocs，“离线”插件可以很好地解决这个问题：https://squidfunk.github.io/mkdocs-material/setup/building-for-offline-usage/