无法运行 mkdocs - 同名主题

Question

我安装了一个主题，这样做之后，当我从命令行运行和mkdocs命令时，我得到以下错误：

Traceback (most recent call last):
  File "/usr/local/bin/mkdocs", line 5, in <module>
    from mkdocs.__main__ import cli
  File "/usr/local/lib/python2.7/site-packages/mkdocs/__main__.py", line 78, in <module>
    theme_choices = utils.get_theme_names()
  File "/usr/local/lib/python2.7/site-packages/mkdocs/utils/__init__.py", line 413, in get_theme_names
    return get_themes().keys()
  File "/usr/local/lib/python2.7/site-packages/mkdocs/utils/__init__.py", line 397, in get_themes
    "with the same name".format(theme.name, theme.dist.key))
mkdocs.exceptions.ConfigurationError: The theme readthedocs is a builtin theme but -kdocs provides a theme with the same name

我在mac上运行的是:Python: 2.7.15 PIP: 20.0.2

对于如何解决此错误的任何建议，我们将不胜感激。

Answer 1

最后一行的错误消息解释了此问题：

mkdocs.exceptions.ConfigurationError: The theme readthedocs is a builtin theme but -kdocs provides a theme with the same name

MkDocs包含一个名为readthedocs的内置主题。并且内置主题名称是保留的。但是，MkDocs检测到另一个包已将具有相同保留名称的主题注册到mkdocs.themes组。显然，该包被命名为-kdocs，这很奇怪，因为python包通常不会以连字符（-）开头。

在任何情况下，解决方案都是删除带有非法主题名称的包。如果您最近安装了任何第三方主题，请尝试使用命令< code > pip uninstall package name 逐个卸载它们，直到错误不再出现，其中< code>packagename是要卸载的软件包的名称。要获得所有已安装软件包的列表，您可以使用< code>pip freeze。

Answer 2

Waylan提供的信息是正确的，应该删除< code>-kdocs包。这里有一些额外的信息。

mkdocs.exceptions。配置错误：主题readthedocs是一个内置主题，但-kdocs提供了一个同名主题。

如果您运行< code>$ pip list，您可能会看到如下内容。< code>mkdocs是一个定期安装的软件包，而< code>-kdocs是一个删除失败后重命名的软件包。删除< code>-kdocs是安全的。

Package                        Version
------------------------------ ----------
-kdocs                         1.1.2
mkdocs                         1.1.2

但是，如果您运行pip uninstall-kdocs或pip uninstall"-kdocs"，您可能会收到以下错误：

$ pip uninstall "-kdocs"

Usage:   
  pip uninstall [options] <package> ...
  pip uninstall [options] -r <requirements file> ...

no such option: -k

您可以直接从文件系统中删除包，而不是使用＜code＞pip卸载。

如果列出站点包目录，则可能会看到如下所示的子目录。请注意，这以波浪号 ~开头，而不是连字符 -。

< code > ~ kdocs-1 . 1 . 2 . dist-info

所以使用：

$ cd /path/to/site-packages
$ ls
$ rm -rf ~kdocs-1.1.2.dist-info