1panel内使用mkdocs更换第三方主题教程/无法更换主题问题解决

0.零帧起手

首先我遇到了安装主题后mkdocs无法加载的问题，然后查询日志发现显示1Panel-mkdocs-material-VDGR | ERROR – Config value ‘theme’: Unrecognised theme name: ‘lantana’. The available installed themes are: material, mkdocs, readthedocs
1Panel-mkdocs-material-VDGR | 

翻译成人话就是没有找到对应的主题，可是我使用pip list明明是存在的，经过思索发现是容器的问题。

首先，你需要了解一点1panel内的所有应用都是运行在容器中的，所以在使用相应的命令时需要到相应的容器下面进行操作，而不是在整个全局的系统下，这样容器内的应用是无法识别到的。

1.教程/解决办法

我们以simple-blog这个主题为例，来在1panel下进行操作。

首先我们肯定已经在1panel的应用商店安装了mkdocs，如果没安装肯定也不会来这找换主题的教程O(∩_∩)O哈哈~

找到simple-blog的wiki肯定是说安装主题需要使用下述命令，

pip install mkdocs-simple-blogp

我们需要在1panel中找到容器 选项，然后找到mkdocs所对应的容器，如下图：

然后点击他右侧的终端，连接之后在终端输入命令。如下图：

如果你的服务器在国内则需要更改镜像源，否则会连接超时：

pip install mkdocs-simple-blog -i http://mirrors.aliyun.com/pypi/simple --trusted-host mirrors.aliyun.com

将主题换成你自己想要安装的即可。

安装完成后我们进入mkdocs安装目录来切换主题使主题生效，如下图：

更改mkdocs.yml文件中的theme下的name一项

教程完毕，如果有用别忘了点个赞！留个言！

零一物语原创，https://www.docn.net

其他网站均为抄袭！首次发表于2024/9/28