一、搭建#
docsify 是一個類似 vuepress、gitbook 等靜態文件生成器,但相比之前,我個人更喜歡 docsify 的風格和源碼。我不需要太多附帶功能,只需要能夠寫文章和生成目錄的功能就可以了。
點擊查看demo。
在終端中輸入以下指令,搭建本地環境:
npm install docsify-cli -g
初始化文檔:
docsify init ./docs
本地運行:
docs serve
然後在瀏覽器中打開localhost:3000
就可以查看了。
二、頁面#
我認為最基本的頁面有三個:
- _navbar.md
導航欄
* [關於](/)
然後在 index.html 中調用。
window.$docsify = {
...
loadNavbar: true,
...
}
如圖:
- _sidebar.md
側邊欄
* [使用docsify搭建文檔](使用docsify搭建文檔.md)
在 index.html 中調用。
window.$docsify = {
...
loadSidebar: true,
...
}
如圖:
- README.md
主頁
## 關於
博客地址:[https://imhan.cn](https://imhan.cn)
作者:shuxhan
時間:2021.04.20
本文檔作為博客文章的備份,如果對文章有其他評論,可以直接點擊鏈接到原地址。
如圖: