vuepress-theme-vdoing使用体验

时间:2020-9-14 作者:admin

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

步骤3:运行。

在终端输入npm run dev。还是有些慢。不过成功了。

success [07:12:57] Build cbe37a finished in 192440 ms!

最后成功。

体验不错。没出现问题。

项目原理

由图可知。

vuepress-theme-vdoing使用体验

这个项目由两个部分组成。一个是主题设置theme,一个是文档docs。theme中是设置文档转换以及主题切换。

感触

写开源项目,如果可以在每个代码第一行备注一下,会更有利于下一次开发以及多人开发。

更有利于开源项目的发展。

主要在docs上修改。theme中了解其中的结构即可。

theme-vdoing的项目结构原理:index.js自动生成结构化侧边栏;layouts的文件夹中的Layout.vue组件是图层组件,包括整个网站的所有组件,如首页、导航栏、页面、分类页面、标签页面、归档页面、侧边栏等等;

theme-vdoing的部分不用多管,默认即可。懂一点最好。
vuepress-theme-vdoing使用体验

docs的项目结构:config/nav.js放了导航栏,用于路由;index.md设置首页的图片;dist文件夹存放着运行后生成的静态网页;剩下的主体就是markdown文件了。在开头需要设置标题,剩下就是正常的markdown文档笔记了。

vuepress-theme-vdoing使用体验

补充:config.js中设置主题

我的使用过程

主要修改docs文档。在config.js中设置主题等;在nav.js中设置路由;在index.md中设置首页的图片;在@pages文件夹中设置分类、标签、归档的页面;在目录页设置文档;然后按规范写文档。

最后用npm run build 打个包,包在docs/dist中。将这个包放到服务器中即可。

我对博客网站的认识

我对博客网站的认识

博客网站有两种,一种是博客平台,一种是个人博客。用博客平台的好处是功能强大且推广好,缺点是受平台管制;个人博客的主要缺点就是不好搭建,所有衍生出原生和第三方。

原生的个人网站自由度高,但是工作量很大;个人开发一般是套用第三方的网站;同时网站还分静态网站和动态网站,静态网站简单些,但没交互,如评论、账户等功能。

动态博客系统有halo;静态博客系统有hexo

动态博客系统的halo的原理是:数据库h2存储文章,后台使用springboot;有markdown解析器。和原生动态网站的开发一样,需要数据库,后台、前台;

静态博客系统hexo的原理是:一个静态站点生成器,将markdown转化为静态网页。然后像原生静态网站一样将静态网页放到服务器空间即可。

而vuepress-theme-vdoing属于哪一种呢。感觉和hexo相关。

使用体验

还不错。get一招。以后实践。不过我理想中的博客系统是把前台和后台都设计好,然后我只需要在登录后台写博客发表即可。而不是写好后打个包,再部署一下。这样有点麻烦。

这部分暂时写到这,后续看情况使用这个项目。

更新地址:GitHub

更多内容请关注:CSDNGitHub掘金

声明:本文内容由互联网用户自发贡献自行上传,本网站不拥有所有权,未作人工编辑处理,也不承担相关法律责任。如果您发现有涉嫌版权的内容,欢迎进行举报,并提供相关证据,工作人员会在5个工作日内联系你,一经查实,本站将立刻删除涉嫌侵权内容。