经过了激烈的讨论,终于弄明白了,VitePress 的正确打开方式。
步骤
- 把源码弄下来,https://github.com/vuejs/vitepress。 因为抽风问题,之前没弄下来,导致盲人摸象。
- yarn 初始化
- yarn docs 运行显示文档的代码,http://localhost:3000 可以看到本地的 VitePress 的文档。
分析结构
文档结构相当于文档网站的根目录,
- .vitepress 里面的 config.ts 里面存放导航、菜单等信息。
- guide 存放菜单对应的文件。
- components 存放vue的组件,在md里面可以引入
这样我们可以有一个基本结构,不会那么抓瞎了。
如何编辑?
纠结了半天,发现自己被误导了,可以选择自己喜欢的编辑器,比如 vsCode,打开项目文件夹,然后编辑配置文件,建立对应的文档名称,添加 md文件 即可。
运行 yarn dev (看 package.json 里的配置情况)即可看到效果。
哎,白折腾了好几天。
不过,都需要手写吗?我是说 config.ts 里面的配置,需要和 guide 里的文件名称对应上,否则会报404错误。这个,有点繁琐吧。
我比较懒,还是希望能够更简洁一点。
网友评论