vitepress这或许是开源系统中,最好用的开源文档工具了吧

大家好,我是小麦,一名服务端开发工程师,今天给大家分享的内容是一款超级好用的文档用具。

不知道大家在日常的学习或者办公中,有这样的需求。

1、想搭建一个博客系统,用来记录自己在日常学习中的笔记。

2、想搭建一个wiki网站,用来分享自己的产品介绍文档、开发接口等内容。

在这样的需求驱动下,你可能会在网上搜索各种开源工具。我个人也是这样,在早期想搭建一个博客系统,用来记录自己的学习笔记,但又不想自己去重新开发一套这样的系统。虽然市面上也有很多符合需求的前后端开源项目,但自己又不想单独在去弄一套环境,感觉没必要也很麻烦,是不是感觉很挑剔。

兔兔答题开源系统

在这个过程中,我也体验过很多的前后端系统,最终都在使用一段时间后,全部放弃了。例如大名鼎鼎的WordPress,以及后期的mrdoc、mindoc,虽然这几款工具在安装或者使用上都非常的便捷。但个人还想要更简单一些,减少去部署后端服务的过程,直接能够像纯HTML一样部署即可。关于文档系统,我之前也分享过几篇,感兴趣的同学可以了解一下。

1、2分钟带你 搭建一个开源的轻量级笔记服务应用

2、开源MrDoc,一个适合个人和小型团队的文档、知识、笔记在线管理系统

3、WordPress最受欢迎的主题模板

经过反复的折腾了N次,最终发现一款宝藏级别的文档工具,也是非常多的开源产品、博客系统在使用的一个开源文档工具。这就是大名鼎鼎的Vue.js作者开发的VitePress。

VitePress 是一个静态站点生成器 (SSG),专为构建快速、以内容为中心的站点而设计。简而言之,VitePress 获取用 Markdown 编写的内容,对其应用主题,并生成可以轻松部署到任何地方的静态 HTML 页面。

我这里做一个简单的总结吧,可能不全,主要从我使用下来的整体体验。

1、VitePress是完全支持markdown语法,并且你编写的markdown内容能够直接复制到其他的技术平台。这也是markdown非常受欢迎的原因之一。

2、VitePress对SEO的友好支持,作为Vue技术栈,很多人可能担心不能做SEO,毕竟自己搭建一个网站还是希望更多的看见。VitePress完全支持全局、单页面配置SEO内容,同时也支持sitemap的生成。所以你完全不用担心SEO问题。

3、国际化支持,如果你的网站涉及到多种语言,VitePress支持你按照规定的方式去自动适配多语言。

4、多主题的支持,VitePress默认提供主题,也支持对默认主题的扩展;同时也支持自定义主题,你完全可以根据自己的需要来定制化一套适合你的主题。

5、连接CMS,如果你的网站部分内容涉及到鉴权,或者需要通过其他系统获取到内容,VitePress是完全支持你通过调用其他系统的接口,来生成页面内容。

7、强大的搜索能力,好的网站一定会主动用户体验性,例如搜索功能就是其中之一,用户通过搜索能够快捷的搜索自己所需要的内容。VitePress支持本地化搜索,同时也支持algolia搜索,仅仅配置几行代码即可。

从使用下来,从我个人的体验而言。VitePress最大的优点在于不依赖任何环境就能运行,你可以将它当做前端纯HTML、CSS和JavaScript。

vitepress功能汇总图

在部署方面也非常的简单,你只需要在你的服务器端部署一个NGINX服务即可。在部署时,推荐使用静态化部署,几个命令即可完成。

1、本地编译打包,会生成一个dist目录的文件,直接部署该文件目录即可。

代码语言:shell
复制
npm run docs:build

2、NGINX部署,直接使用下面短短几行配置即可。

代码语言:shell
复制
server
{
    listen 80;
    server_name  wiki.baidu.com;
    index index.html index.htm;
    root  /path/dist;
location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$
{
    expires      30d;
}

location ~ .*\.(js|css)?$
{
    expires      12h;
}
access_log  /path/wiki.baidu.com.log;

}

3、最后就可以看到效果啦,下图就是我部署后的效果图。

兔兔答题开放平台