# 使用和改造vuepress-theme-antdocs主题

之前一直想要在VuePress里引入Ant Design Vue,使用它的UI组件来自己搭建一个antd风格的博客主题。奈何多次尝试都失败了,遇到了一堆错误,后面有其它的事就抛之脑后。

后面偶然间发现已经有老哥搞出了一套,那就不用造轮子了,直接用就好了。😁

当然这套轮子并不完全满足需要,本文还包括了如何改造它

主题相关文档传送门在参考资料[1]

注意

  • 建议从头开始搭建一个新的vuepress项目安装该主题,我这边在使用默认主题的老项目基础上尝试多次都没有成功。

  • 另外该主题需要core-js依赖版本为2.6.11,高于此版本会出现错误。

    命令:cnpm i core-js@2.6.11 --save

# 一、安装并使用主题

安装

yarn add vuepress-theme-antdocs
# OR npm i vuepress-theme-antdocs
1
2

使用

.vuepress/config.js中配置:

module.exports = {
  ...
  theme: "antdocs",
  ...
}
1
2
3
4
5

# 二、改造主题

安装成功后,如果想要修改主题怎么办?毕竟自己有动手能力肯定不会满足于仅仅使用轮子,还想改造轮子。

vuepress-theme-antdocs的作者在文档中并没有写明想要修改主题该怎么做

但是vuepress文档[2]和[3]中给出了开发主题的方法。

只需要进行如下操作👇

  • 1.进入安装的依赖文件夹node_modules,找到vuepress-theme-antdocs

  • 2.将下图红圈中的文件拷贝到.vuepress/theme/

  • 3.去掉上面的.vuepress/config.js配置中的theme: "antdocs"

  • 4.重新运行项目。

theme-antdocs-02 => theme-antdocs-01

这样就有了该主题的全部源码,可以根据自己的需要来改造。

# 三、参考资料

Last Updated: 2 years ago