本文詳細描述瞭如何在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
。