VuePress的使用心得

TIPS

记录博客搭建过程中的大坑小坑

问题

1. 中文文件名生成路由

   描述：VuePress 会把所有的 markdown 文件根据文件名处理成 html 文件，如果文件名中包含中文，在通过 url 转码之后会出现一系列怪问题，比如路由没法跳转，侧边栏的导航生成不了

   解决：

   1. 全部文件命名成英文的，有助于提升英语能力，但是对英语不好的很不友好，文件多了找起来也麻烦
   2. 安装插件，把中文名称转成拼音

   # 中文转拼音
   npm install vuepress-plugin-permalink-pinyin -D
   # 美化转换后的样式 剔除特殊字符等
   npm install vuepress-plugin-rpurl -D
   

2. markdown中的数学公式解析

   想在里面写点数学公式，比如分数，根号，对数，矩阵，积分那些

   安装 vuepress-plugin-mathjax ，但是我使用起来死活没效果，矩阵也解析不了，可能是打开方式不对

   使用 vuepress-plugin-md-enhance

   npm install vuepress-plugin-md-enhance -D
   

   // docs/.vuepress/config.js
   [
     'md-enhance',
     {
       sup: true,
       sub: true,
       footnote: true,
       mark: true,
       tex: true,
       align: true,
     },
   ],
   

   WARNING

   但是 vuepress-plugin-md-enhance 会带来后续一些影响不大的影响，比如在使用 tip warning等所有的容器中，前面会有一个图标，并且上面会默认有文字，感觉就贼蠢