docsite 是一款開源站點搭建工具,依據其提供的功能,能夠快速搭建一個開源站點。是程序員搭建靜態(tài)博客的絕佳利器。
相關地址文檔地址:https://docsite.js.org/zh-cn/docs/installation.html
github:https://github.com/txd-team/docsite
安裝安裝需要確保nodejs版本node >= 6.9.0,然后執(zhí)行下面的命令進行全局安裝
npm install docsite -g然后執(zhí)行版本驗證,看是否安裝成功
docsite -V當前版本是1.3.9
項目搭建兩種方式都可以,這里使用第一種方式進行本地測試
$ cd my-project$ docsite init# or$ docsite init my-project初始化成功后項目結構如下
官網對每個文件夾的作用進行了詳細的介紹,如下圖所示
我們先啟動項目看下效果圖
docsite startPC端:
移動端效果(瀏覽器模擬移動端)
總的來說效果非常的好,界面簡潔,和官網本身的docsite文檔就是一樣的效果,實際上有動畫效果,我沒有截取gif,現在網站的骨架搭建完成,可以進行網站的自定義和內容填充了。
發(fā)布站點首先,需要配置下站點的根路徑,修改site_config/site.js中的rootPath字段。規(guī)則如下:當部署根路徑為/,則設置為''空字符串即可。當部署根路徑不為/,則設置為具體的根路徑,注意需以/開頭,但不能有尾/。至此,整個站點的開發(fā)已經完成,在項目根目錄下執(zhí)行docsite build 進行項目構建。
項目搭建好后我們需要發(fā)布站點,這里我們需要將站點托管到自己的服務器或者github pages。
Github page托管:
服務器托管
我們最直截了當的方法就是托管到github page,這樣就不需要自己的服務器了,節(jié)省了很多成本。
詳細教程詳細教程大家可以參考官方文檔,非常的簡單,從安裝到部署,到如何創(chuàng)建博客文檔等都有詳細的教程,也非常簡單。我們只是關注我們的內容即可,其余的都已經幫我們做好了。
總結總的來說DOCSITE是一個非常不錯的工具,讓我們節(jié)省了很多人力成本,讓搭建博客更加簡單,現在有很多博客或者文檔都是采用的靜態(tài)站點的方式,非常人性化,而且易用,說實話阿里的一些開源產品真的非常的不錯,感興趣的小伙伴趕緊去試試吧,希望本文對你有所幫助!