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

Posted 2023-02-26

【中文标题】错误 - 配置值：“主题”。错误：无法识别的主题名称：

【英文标题】：ERROR - Config value: 'theme'. Error: Unrecognised theme name:

【发布时间】：2020-02-07 22:41:28

【问题描述】：

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

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

theme:
   name: 'name_of_theme'

那么

mkdocs serve

结果

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

我错过了什么？

【问题讨论】：

pip freeze 是否列出了您安装的主题？如果没有，那么它们实际上并没有安装。如果它们被列出，那么问题可能与版本不兼容或其他问题有关。我希望我们需要更多信息。

【参考方案1】：

在您的 mkdocs.yaml 中，使用：

theme:
   name: mkdocs

或

theme:
   name: readthedocs

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

【参考方案2】：

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

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

【讨论】：

您可以查看 (yaml.org)[yaml.org/faq.html].他们推荐.yaml。还可以查看 this 关于 yaml 扩展的帖子。