怎样基于VitePress(Vite官网主题)写自己文档

最近又要写技术文档了,查看了一下市面上的一些文档生成器,如

docsify http://vuepress.com/、 Vite & Vue Powered Static Site Generator

综合比较还是比较倾向vitepress,vuepress之前用过界面不是很直接,docsify界面布局也不是很理想。vitepress不叫好看的主题就是vite的官网了。

8716cec4405e1519b565645bcb9b32e0.jpeg

是不是简洁,还带着一些小清新?

32bbe2d643a54118a32555dc891af039.jpeg

二级标题和三级标题更直接明了。

所以打算白嫖vite网站了。

1.找到开源地址

地址:github.com/vitejs/vite (英文版实时最新的)

dac1298cfbed2e3f9c1dac22d30952a1.jpeg

地址:github.com/vitejs/docs- (中文版有有时间延迟)

2.git pull代码

3.修改里面额MD文档形成自己的

4.怎样杜绝原有赞助广告?

查看network,可以查看到对应的广告文件请求

434409c833dac9cdd2193f6195f23903.jpeg

5ee8587f6e0d78d705e9fed5a433ffbf.png

上面的json就是对应的广告数据

382790928338b00707e3ab705d904443.jpeg

69de6bd12ae884c31922f0c314fb8484.jpeg

找到对应文件,请求去掉,注释data

c6156361a421a8e789a81208bdbaf57f.png

5.全文搜索

此处的搜索是用的algolia的docsearch组件,需要algolia注册账号,并获取对应的key,创建database,和index

3bcf9667b96900a03e73b7733dd5e9d8.png

6a9714805b5d9ef40923bc62746ae818.jpeg

1bd7f48fb46425c2fdc934eac6b3bb3d.jpeg

这样你就拥有一个md文档生成器了

评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值