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

Question

Github 上类似问题的解决方案都指向使用包管理器安装 MkDocs 或主题，而不是 pip。不过，我已经用 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-material 也有同样的问题。就我而言，这源于主题安装错误。来自mkdocs-material 常见问题解答：

1. 检查 mkdoc 是否正确安装：mkdocs --version. 您应该获取版本和安装路径。
2. 检查主题是否正确安装：mkdocs serve --help。您应该获得参数列表。如果您的主题名称出现，请检查此条目：（ -t, --theme [material|mkdocs|readthedocs]在本例中为“ material”）

如果您的主题名称丢失，请尝试重新安装。就我而言，我使用了该python -m pip标志，mkdocs并且需要对主题执行相同的操作：

python -m pip install mkdocs
python -m pip install mkdocs-material

Answer 2

在您的 mkdocs.yaml 中，使用：

theme:
   name: mkdocs

或者

theme:
   name: readthedocs

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