vuepress-theme-vdoing使用体验
前言
今天在GitHub的trending上看vue项目，其中有个vuepress-theme-vdoing项目看起来挺有意思，于是下载下来使用一下。
看页面，感觉像是GitHub上的文档。比如vue官方文档就是用这种的。之前一直想弄，但没去尝试过。今天借着体验这个项目去了解文档库。
首先先使用这个项目，然后分析这个项目的原理，最后自定义。大致就这三步。
项目介绍：一款简洁高效的VuePress 知识管理&博客(blog) 主题
使用过程
步骤1：下载。下载zip，然后解压。2.9M大小。
步骤2：初始化。
用vscode打开解压后的文件夹；ctrl+`打开vscode的终端；输入npm install。下载有些慢。
added 1836 packages from 1406 contributors and audited 1838 packages in 925.376s
扫描二维码关注公众号，回复： 11670982 查看本文章
步骤3：运行。
在终端输入npm run dev。还是有些慢。不过成功了。
success [07:12:57] Build cbe37a finished in 192440 ms!
最后成功。
体验不错。没出现问题。
项目原理
由图可知。
这个项目由两个部分组成。一个是主题设置theme，一个是文档docs。theme中是设置文档转换以及主题切换。
感触
写开源项目，如果可以在每个代码第一行备注一下，会更有利于下一次开发以及多人开发。
更有利于开源项目的发展。
主要在docs上修改。theme中了解其中的结构即可。
theme-vdoing的项目结构原理：index.js自动生成结构化侧边栏；layouts的文件夹中的Layout.vue组件是图层组件，包括整个网站的所有组件，如首页、导航栏、页面、分类页面、标签页面、归档页面、侧边栏等等；
theme-vdoing的部分不用多管，默认即可。懂一点最好。
docs的项目结构：config/nav.js放了导航栏，用于路由；index.md设置首页的图片；dist文件夹存放着运行后生成的静态网页；剩下的主体就是markdown文件了。在开头需要设置标题，剩下就是正常的markdown文档笔记了。
补充：config.js中设置主题
我的使用过程
主要修改docs文档。在config.js中设置主题等；在nav.js中设置路由；在index.md中设置首页的图片；在@pages文件夹中设置分类、标签、归档的页面；在目录页设置文档；然后按规范写文档。
最后用npm run build 打个包，包在docs/dist中。将这个包放到服务器中即可。
我对博客网站的认识
博客网站有两种，一种是博客平台，一种是个人博客。用博客平台的好处是功能强大且推广好，缺点是受平台管制；个人博客的主要缺点就是不好搭建，所有衍生出原生和第三方。
原生的个人网站自由度高，但是工作量很大；个人开发一般是套用第三方的网站；同时网站还分静态网站和动态网站，静态网站简单些，但没交互，如评论、账户等功能。
动态博客系统的halo的原理是：数据库h2存储文章，后台使用springboot；有markdown解析器。和原生动态网站的开发一样，需要数据库，后台、前台；
静态博客系统hexo的原理是：一个静态站点生成器，将markdown转化为静态网页。然后像原生静态网站一样将静态网页放到服务器空间即可。
而vuepress-theme-vdoing属于哪一种呢。感觉和hexo相关。
使用体验
还不错。get一招。以后实践。不过我理想中的博客系统是把前台和后台都设计好，然后我只需要在登录后台写博客发表即可。而不是写好后打个包，再部署一下。这样有点麻烦。
这部分暂时写到这，后续看情况使用这个项目。
更新地址：GitHub