mkdocs - 错误 - 配置值：“主题”。错误：无法识别的主题名称：

Question

Github 上类似问题的解决方案都指向使用包管理器而不是 pip 安装 MkDocs 或主题。但是，我已经用 pip 安装了两者。

1. 使用 pip 安装 MkDocs（不是包管理器）
2. 使用 pip 安装了 n 个 MkDocs 主题
3. 更新 mkdocs.yaml 以添加：

theme:
   name: '{name_of_theme}'

4. 然后

mkdocs serve

5. 结果

ERROR   -  Config value: 'theme'. Error: Unrecognised theme name: '{name_of_theme}'. The available installed themes are: mkdocs, readthedocs 

我错过了什么？

Answer 1

在您的 mkdocs.yaml 中，使用：

theme:
   name: mkdocs

或者

theme:
   name: readthedocs

本质上，您实际安装的主题的名称。

Answer 2

我从未见过扩展名为“.yaml”的 yaml 文件。
您是否尝试将其更改为“.yml”，所以它是“mkdocs.yml”。

您绝对可以使用 pip 安装 mkdocs 和主题。