介紹

docsite 是一款開源站點(diǎn)搭建工具，依據(jù)其提供的功能，能夠快速搭建一個(gè)開源站點(diǎn)。是程序員搭建靜態(tài)博客的絕佳利器。

相關(guān)地址

文檔地址：https://docsite.js.org/zh-cn/docs/installation.html

github：https://github.com/txd-team/docsite

安裝

安裝需要確保nodejs版本node >= 6.9.0，然后執(zhí)行下面的命令進(jìn)行全局安裝

npm install docsite -g

然后執(zhí)行版本驗(yàn)證，看是否安裝成功

docsite -V

當(dāng)前版本是1.3.9

項(xiàng)目搭建

兩種方式都可以，這里使用第一種方式進(jìn)行本地測(cè)試

$ cd my-project$ docsite init# or$ docsite init my-project

初始化成功后項(xiàng)目結(jié)構(gòu)如下

官網(wǎng)對(duì)每個(gè)文件夾的作用進(jìn)行了詳細(xì)的介紹，如下圖所示

我們先啟動(dòng)項(xiàng)目看下效果圖

docsite start

PC端：

移動(dòng)端效果（瀏覽器模擬移動(dòng)端）

總的來說效果非常的好，界面簡(jiǎn)潔，和官網(wǎng)本身的docsite文檔就是一樣的效果，實(shí)際上有動(dòng)畫效果，我沒有截取gif，現(xiàn)在網(wǎng)站的骨架搭建完成，可以進(jìn)行網(wǎng)站的自定義和內(nèi)容填充了。

發(fā)布站點(diǎn)

首先，需要配置下站點(diǎn)的根路徑，修改site_config/site.js中的rootPath字段。規(guī)則如下：當(dāng)部署根路徑為/，則設(shè)置為''空字符串即可。當(dāng)部署根路徑不為/，則設(shè)置為具體的根路徑，注意需以/開頭，但不能有尾/。至此，整個(gè)站點(diǎn)的開發(fā)已經(jīng)完成，在項(xiàng)目根目錄下執(zhí)行docsite build 進(jìn)行項(xiàng)目構(gòu)建。

項(xiàng)目搭建好后我們需要發(fā)布站點(diǎn)，這里我們需要將站點(diǎn)托管到自己的服務(wù)器或者github pages。

Github page托管：

服務(wù)器托管

我們最直截了當(dāng)?shù)姆椒ň褪峭泄艿絞ithub page，這樣就不需要自己的服務(wù)器了，節(jié)省了很多成本。

詳細(xì)教程

詳細(xì)教程大家可以參考官方文檔，非常的簡(jiǎn)單，從安裝到部署，到如何創(chuàng)建博客文檔等都有詳細(xì)的教程，也非常簡(jiǎn)單。我們只是關(guān)注我們的內(nèi)容即可，其余的都已經(jīng)幫我們做好了。

總結(jié)

總的來說DOCSITE是一個(gè)非常不錯(cuò)的工具，讓我們節(jié)省了很多人力成本，讓搭建博客更加簡(jiǎn)單，現(xiàn)在有很多博客或者文檔都是采用的靜態(tài)站點(diǎn)的方式，非常人性化，而且易用，說實(shí)話阿里的一些開源產(chǎn)品真的非常的不錯(cuò)，感興趣的小伙伴趕緊去試試吧，希望本文對(duì)你有所幫助！