本文詳細描述瞭如何在Github上，使用hexo部署博客。
安裝Hexo
安裝node.js
- node.js官方下載地址
- 從上面的鏈接下載node.js，並安裝。
- 注意：官方鏈接可能需要翻牆
- 注意：我的操作系統是Windows 7 (64bit)
設置npm淘寶鏡像站
- npm默認的源的下載速度可能很慢，建議使用淘寶鏡像替換。
- 執行下面的命令，將npm的源設置成淘寶鏡像站。
npm config set registry "https://registry.npm.taobao.org"
申請Github賬號
- Github註冊頁面
- 輸入用戶名，Email，密碼，註冊賬號。比如我的用戶名是：xuezhisd
創建博客倉庫
- 注意，倉庫名應該爲：用戶名.github.io。比如，我的倉庫名是：xuezhisd.github.io。
安裝git
- git下載地址
- 下載git安裝文件，雙擊執行安裝。
配置ssh
- 打開git bash終端。
- 設置user.name和user.email。
git config --global user.name "你的GitHub用戶名"
git config --global user.email "你的GitHub註冊郵箱"
- 生成ssh密匙
ssh-keygen -t rsa -C "你的GitHub註冊郵箱"
- 此時，在用戶文件夾下就會有一個新的文件夾.ssh，裏面有剛剛創建的ssh密鑰文件id_rsa和id_rsa.pub。
將公匙添加到github上
- 詳細教程自行baidu。
- 用戶頭像→Settings→SSH and GPG keys→New SSH key→將id_rsa.pub中的內容複製到Key文本框中，然後點擊Add SSH key(添加SSH)按鈕。
安裝hexo
- 執行以下命令安裝hexo。
# 安裝hexo
npm install hexo-cli g
# 初始化博客文件夾
hexo init blog
# 切換到該路徑
cd blog
# 安裝hexo的擴展插件
npm install
# 安裝其它插件
npm install hexo-server --save
npm install hexo-admin --save
npm install hexo-generator-archive --save
npm install hexo-generator-feed --save
npm install hexo-generator-search --save
npm install hexo-generator-tag --save
npm install hexo-deployer-git --save
npm install hexo-generator-sitemap --save
初探hexo
- 第一次使用hexo，在本地創建服務器使用。
# 生成靜態頁面
hexo generate
# 開啓本地服務器
hexo s
- 打開瀏覽器，地址欄中輸入：http://localhost:4000/,應該可以看見剛剛創建的博客了。
- 問題：爲什麼訪問http://localhost:4000/，無反應？
- 解決方法：可能是由於端口問題引起的。使用Ctrl+C中斷本地服務，使用命令
hexo s -p 5000重新開啓本地服務，訪問**http://localhost:5000/**可以看到博客頁面了。
- 解決方法：可能是由於端口問題引起的。使用Ctrl+C中斷本地服務，使用命令
將hexo博客部署到github上
- 修改配置文件blog/_config.yml，修改deploy項的內容，如下所示：
# Deployment 註釋
## Docs: https://hexo.io/docs/deployment.html
deploy:
# 類型
type: git
# 倉庫
repo: [email protected]:xuezhisd/xuezhisd.github.io.git
# 分支
branch: master
- 注意：type: git中的冒號後面由空格。
- 注意：將[email protected]:xuezhisd/xuezhisd.github.io.git中的用戶名換成自己的用戶名[email protected]:github_username/github_username.github.io.git。
部署hexo
- 輸入下面的命令將hexo博客部署到github中：
# 清空靜態頁面
hexo clean
# 生成靜態頁面
hexo generate
# 部署
hexo deploy
- 打開網頁，輸入http://github_username.github.io，打開github上託管的博客。如我的博客地址是：http://xuezhisd.github.io。
hexo命令縮寫
- hexo支持命令縮寫，如下所示。
hexo g等價於hexo generate
hexo g：hexo generate
hexo c：hexo clean
hexo s：hexo server
hexo d：hexo deploy
hexo組合命令
# 清除、生成、啓動
hexo clean && hexo g -s
# 清除、生成、部署
hexo clean && hexo g -d
常見問題
hexo deploy沒有反應？
- 修改配置文件：_config.yml時，冒號後面沒加空格。
hexo s 網站打不開？
- 端口占用，換個端口就好了。執行命令
hexo s -p 5000，並在瀏覽器地址欄輸入http://localhost:5000，回車訪問。
如何換主題？
- 將主題下載後，放到themes文件夾中即可。例如，下面命令安裝next主題：
git clone https://github.com/iissnan/hexo-theme-next themes/next。