【问题标题】:ERROR - Config value: 'theme'. Error: Unrecognised theme name:错误 - 配置值:“主题”。错误:无法识别的主题名称:
【发布时间】:2020-02-07 22:41:28
【问题描述】:

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

  1. 使用 pip(不是包管理器)安装 MkDocs
  2. 使用 pip 安装了 n 个 MkDocs 主题
  3. 更新了 mkdocs.yaml 以添加:
theme:
   name: '{name_of_theme}'
  1. 那么
mkdocs serve
  1. 结果
ERROR   -  Config value: 'theme'. Error: Unrecognised theme name: '{name_of_theme}'. The available installed themes are: mkdocs, readthedocs 

我错过了什么?

【问题讨论】:

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

标签: mkdocs


【解决方案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 扩展的帖子。
    猜你喜欢
    • 1970-01-01
    • 1970-01-01
    • 2015-03-23
    • 2020-09-05
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 2019-03-22
    • 2021-02-18
    相关资源
    最近更新 更多