介绍
docsite 是一款开源站点搭建工具,依据其提供的功能,能够快速搭建一个开源站点。是程序员搭建静态博客的绝佳利器。
相关地址
文档地址:https://docsite.js.org/zh-cn/docs/installation.html
github:https://github.com/txd-team/docsite
安装
安装需要确保nodejs版本node >= 6.9.0,然后执行下面的命令进行全局安装
npm install docsite -g
然后执行版本验证,看是否安装成功
docsite -V
当前版本是1.3.9
项目搭建
两种方式都可以,这里使用第一种方式进行本地测试
$ cd my-project
$ docsite init
# or
$ docsite init my-project
初始化成功后项目结构如下
官网对每个文件夹的作用进行了详细的介绍,如下图所示
我们先启动项目看下效果图
docsite start
PC端:
移动端效果(浏览器模拟移动端)
总的来说效果非常的好,界面简洁,和官网本身的docsite文档就是一样的效果,实际上有动画效果,我没有截取gif,现在网站的骨架搭建完成,可以进行网站的自定义和内容填充了。
发布站点
首先,需要配置下站点的根路径,修改site_config/site.js中的rootPath字段。规则如下:当部署根路径为/,则设置为''空字符串即可。当部署根路径不为/,则设置为具体的根路径,注意需以/开头,但不能有尾/。至此,整个站点的开发已经完成,在项目根目录下执行docsite build 进行项目构建。
项目搭建好后我们需要发布站点,这里我们需要将站点托管到自己的服务器或者github pages。
Github page托管:
服务器托管
我们最直截了当的方法就是托管到github page,这样就不需要自己的服务器了,节省了很多成本。
详细教程
详细教程大家可以参考官方文档,非常的简单,从安装到部署,到如何创建博客文档等都有详细的教程,也非常简单。我们只是关注我们的内容即可,其余的都已经帮我们做好了。
总结
总的来说DOCSITE是一个非常不错的工具,让我们节省了很多人力成本,让搭建博客更加简单,现在有很多博客或者文档都是采用的静态站点的方式,非常人性化,而且易用,说实话阿里的一些开源产品真的非常的不错,感兴趣的小伙伴赶紧去试试吧,希望本文对你有所帮助!