基於Github Pages + docsify，我花了一小時搭建好了個人博客還順手還寫了這篇文章

效果：

封面

內容頁

經驗之談：就個人博客來講，筆者已經折騰過很多了，用過WordPress、Typecho、Hexo等等，主機也用過基於免費的GitPages或者付費的VPS，最後都不了了之，原因要麼是VPS到期了懶得續費，要麼是數據遷移各種費心，博客要麼是基於動態的比如WordPress需要數據庫，要麼是基於靜態的比如Hexo，一遷移你將要面對的是一堆數據庫的數據或者是HTML代碼，移植都太麻煩。最後我挖掘了我兩個核心需求：免費，易移植，那麼Github Pages + docsify完全滿足了我的需求

免費：Github Pages本來就是免費的
易移植：docsify是基於js將md文檔轉換成html，計算在客戶端，不在服務器端，服務器只用存md，這個就很舒服了，以後你的博客數據不會是一堆數據庫數據或者html代碼，而是具有可讀性的md文檔，下面詳細介紹一下

docsify和一般的使用Hexo、Jekyll、Hugo等博客框不同的是，支持Markdown格式，對程序員的博主們是很友好的。不用生成html文件，寫完MD格式的博客直接往上一放，框架自己在運行時解析渲染成html頁面。

準備工作

1、git環境，github賬號

windows下安裝git可以看下這篇Git簡易教程之git簡介及安裝

因為我們要使用Github Pages來部署我們的應用，請先註冊下github的賬號，官網：Github

2、有node環境

Windows下安裝node環境

簡單而言

去官網下載nodejs：https://nodejs.org/en/，安裝好
npm設置代理或鏡像，不然因為周所周知的原因會慢到你可能無法想象設置代理，按照實際情況來# http代理
npm config set proxy=http://127.0.0.1:8087npm config set registry=http://registry.npmjs.org# https代理npm config set https-proxy http://server:port# 設置用戶名或密碼，沒有就不管npm config set proxy http://username:password@server:portnpm confit set https-proxy http://username:password@server:port# 取消代理npm config delete proxynpm config delete https-proxy設置鏡像（推薦），如果沒有代理，可以設置個國內鏡像# 設置淘寶鏡像
npm config set registry https://registry.npm.taobao.org# 驗證成功沒npm config get registry

3、簡要說明一下步驟

使用docsify命令生成文檔站點
在github上部署站點

docsify官網

地址：https://docsify.js.org/#/ docsify官網

使用docsify命令生成文檔站點

安裝docsify-cli 工具

推薦安裝 docsify-cli 工具，可以方便創建及本地預覽文檔網站。

npm i docsify-cli -g

因為我們已經安裝了node環境，所以直接打開CMD窗口執行上面的命令就好了。

初始化一個項目

docsify init ./docs

index.html 入口文件
README.md 會做為主頁內容渲染
.nojekyll 用於阻止 GitHub Pages 會忽略掉下劃線開頭的文件

啟動項目，預覽效果

到這裡，就可以啟動項目，然後看下效果了。使用下面命令啟動項目：

docsify serve docs

流程器輸入：http://localhost:3000

1、配置左側導航欄

不建議配置，配置了就不能顯示當前文章的目錄

在 docs目錄下新建一個_sidebar.md 的md文件，內容如下：

- 我的博客
  - [第一章節](blog/博客搭建.md)

在index.html文件中配置一下。在內嵌的js腳本中加上下面這句：

loadSidebar: true

2、配置個封面

套路和上面配置左側導航欄是一樣的。

首先新建一個 _coverpage.md 的md文件，這裡面的內容就是你封面的內容。

# Myblogs
> 我的博客

[CSDN](https://blog.csdn.net/xxx)
[滾動鼠標](#introduction)

然後在index.xml文件中修改js腳本配置，添加一句：

coverpage: true

3、配置首頁

其實就是 docs目錄下README.md` 文件的內容。

我們一直沒有管他，默認就是這個樣子的：

改一下，放上自己牛逼的經歷或者是標籤。

# 個人簡介

部署到Github上

登錄github賬號，建倉庫

創建本地倉庫，推送到github

右鍵Git Bash Here 打開git命令行初始化一個倉庫，並提交所有的博客文件到git本地倉庫。

涉及命令如下：

git init // 初始化一個倉庫
git add -A // 添加所有文件到暫存區，也就是交給由git管理着
git commit -m "myblogs first commit" // 提交到git倉庫，-m後面是注釋
git remote add origin https://github.com/xxx/myblogs.git
git push -u origin master // 推送到遠程myblogs倉庫

按上面的命令順序操作，不出意外的話，我們的本地myblogs已經同步到了github上面了。