使用Docsify搭建文檔類型網(wǎng)站

docsify 可以快速幫你生成文檔網(wǎng)站。不同于 GitBook、Hexo 的地方是，它不會生成靜態(tài)的 .html 文件，所有轉(zhuǎn)換工作都是在運(yùn)行時。如果你想要開始使用它，只需要創(chuàng)建一個 index.html 就可以開始編寫文檔并直接部署在 GitHub Pages。

Docsify官方文檔：https://docsify.js.org/#/zh-cn/

安裝 docsify-cli 工具

推薦全局安裝 docsify-cli 工具，可以方便地創(chuàng)建及在本地預(yù)覽生成的文檔。

npm i docsify-cli -g

初始化項目

# 初始化目錄 docsify init docs # 啟動一個本地服務(wù)器，可以方便地實(shí)時預(yù)覽效果。默認(rèn)訪問地址 http://localhost:3000 docsify serve docs

初始化成功后，可以看到 ./docs 目錄下創(chuàng)建的幾個文件

• index.html 入口文件
• README.md 會做為主頁內(nèi)容渲染
• .nojekyll 用于阻止 GitHub Pages 忽略掉下劃線開頭的文件
• 直接編輯 docs/README.md 就能更新文檔內(nèi)容，當(dāng)然也可以添加更多頁面。

部署到服務(wù)器

若在linux部署，不需要安裝docsify，只需將服務(wù)器的訪問根目錄設(shè)定為 index.html 文件即可。

修改nginx配置后，reload一下：

./nginx -s reload

---

效果演示

win10 本地 Typora 目錄結(jié)構(gòu)

筆記記在 Typora 中，注意設(shè)置一下圖片存儲路徑，這樣就可以在粘貼圖片的之后自動生成相對路徑，便于部署

設(shè)置方式：

相對路徑效果：

整個目錄結(jié)構(gòu)：

服務(wù)器上運(yùn)行效果

在本地修改之后，直接 push 到 github，可以在linux服務(wù)器上寫一個自動拉取腳本，即可同步更新頁面，非常方便。

---

附：Linux 安裝 npm 方法（部署不需要安裝npm）

###### 安裝npm（實(shí)際上，部署不需要安裝npm...） ###### # 淘寶鏡像，下載node，解壓 wget https://npm.taobao.org/mirrors/node/latest-v14.x/node-v14.15.3-linux-x64.tar.gz tar -zxvf node-v14.15.3-linux-x64.tar.gz # 添加軟鏈接 ln -s /usr/local/node/node-v14.15.3-linux-x64/bin/npm /usr/local/bin/npm ln -s /usr/local/node/node-v14.15.3-linux-x64/bin/node /usr/local/bin/node # 安裝成功，查看版本 npm -v

總結(jié)

以上是生活随笔為你收集整理的本地 MarkDown 怎么部署到服务器上？教你使用 Docsify 搭建个人博客的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。