零成本搭建自己的站点,阿里开源站点搭建工具——DOCSITE

2019-06-09 12:52发布

介绍

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是一个非常不错的工具,让我们节省了很多人力成本,让搭建博客更加简单,现在有很多博客或者文档都是采用的静态站点的方式,非常人性化,而且易用,说实话阿里的一些开源产品真的非常的不错,感兴趣的小伙伴赶紧去试试吧,希望本文对你有所帮助!

文章来源: https://www.toutiao.com/group/6700177630731174404/