我现在用的这个文档系统,一直有点小毛病 – 无法搜索

昨天看到别人的文档用的 vuepress ,体验了一下,感觉还不错,想着找个休息时间,尽快将内容整理过去,因为随着文档的增多,折腾会越来越麻烦。

然后昨天晚上,10点左右,我就开始着手开始测试一下新的文档系统。

下面是我遇到的一些问题:

无法启动

我真没有想到,第一步就把我卡住了,按照官方文档一步一步走的,创建了很多目录,然并卵。我开始搜索别人搭建的过程记录,按照记录,先命令行创建一个 package.json ,然后就可以启动了。

侧边栏创建

然后我就开始研究,侧边栏生成技术了,官方文档的分组啥啥写的,让我看起来非常的懵逼,copy 下来,放到我那里,根本不是我想要的样子,我只能继续搜索了,晚上两个小时过去了,依然没有解决,实在熬不住睡觉了。

白天起来,还得肝啊,在一番检索后,终于发现了一种写法,照葫芦画瓢,连懵带猜的终于实现了我想要的侧边栏功能,但是样式有点不敢恭维,没办法,技术菜,将就看吧。

添加内容

这个添加过程,有点折磨人,嵌套了几层列表和花括号,我每添加一页导航,心情烦躁+1,尤其是当你一直在考虑这个要不要加括号,填完一页,需要重新加载预览,每次修改都要结束进程,再次生成~

个别侧边栏无法展开

一开始,我认为,可能是语法有错误,所以我一直在修改语法,后来发现是找不到对应文件造成的,一栏内容,只要有一个找不到,整个组都打不开。~ 没办法,我将原来留着待补充的一些文件(主要是这个嵌套列表让我太烦了,我想多留一些地方,方便后面补内容。) 删除了。

安装插件

内容基本补充完了,搜索功能用主题自带的也勉强够用了,生成预览,我发现,代码不能快速复制,好在随后搜到了一个复制的插件,那剩下就是要实现了,下载对应的插件,按照语法格式,添加进配置文件,重启~

emmm ~ 没有效果 ~ 再试一次 ~ emmm ~ 还是没有效果 ~

官方文档?没有的 ~ 官方不支持复制 ~

我只好继续问度娘了,此时我已经快暴走了,虽然我的耐心有限,好在时间不长,搜到了一条可能对我有用的记录。

Q:vuepress插件不加载是怎么回事?

A:可能是 vuepressbug ,你再重新安装一次 vuepress 试试。

安装了一遍,果然加载成功了。~

复制代码效果丑出天际

生成预览后,我发现我的代码块被加高了!这大黑边 ~ 复制代码按钮跑到了右下角 ~

拉黑、卸载、删除

我是真的不想继续用这样的文档系统了,体验非常差,我很好奇,这些弊病,难道开发人员没有发现?

我已经无力吐槽了,多看一眼,都很气!