將 Hexo 部署到 GitHub Pages

在本教程中，我們將會使用 Travis CI 將 Hexo 博客部署到 GitHub Pages 上。Travis CI 對於開源 repository 是免費的，但是這意味著妳的站點文件將會是公開的。如果妳希望妳的站點文件不被公開，請直接前往本文 Private repository 部分。

  1. 新建壹個 repository。如果妳希望妳的站點能通過 <妳的 GitHub 用戶名>.github.io 域名訪問，妳的 repository 應該直接命名為 <妳的 GitHub 用戶名>.github.io。
  2. 將妳的 Hexo 站點文件夾推送到 repository 中。默認情況下不應該 public 目錄將不會被推送到 repository 中，妳應該檢查 .gitignore 文件中是否包含 public 壹行，如果沒有請加上。
  3. 將 Travis CI 添加到妳的 GitHub 賬戶中。
  4. 前往 GitHub 的 Applications settings，配置 Travis CI 權限，使其能夠訪問妳的 repository。
  5. 妳應該會被重定向到 Travis CI 的頁面。如果沒有，請 手動前往。
  6. 在瀏覽器新建壹個標簽頁，前往 GitHub 新建 Personal Access Token，只勾選 repo 的權限並生成壹個新的 Token。Token 生成後請復制並保存好。
  7. 回到 Travis CI，前往妳的 repository 的設置頁面，在 Environment Variables 下新建壹個環境變量，Name 為 GH_TOKEN，Value 為剛才妳在 GitHub 生成的 Token。確保 DISPLAY VALUE IN BUILD LOG 保持 不被勾選 避免妳的 Token 泄漏。點擊 Add 保存。
  8. 在妳的 Hexo 站點文件夾中新建壹個 .travis.yml 文件：
sudo: false
language: node_js
node_js:
  - 10 # use nodejs v10 LTS
cache: npm
branches:
  only:
    - master # build master branch only
script:
  - hexo generate # generate static files
deploy:
  provider: pages
  skip-cleanup: true
  github-token: $GH_TOKEN
  keep-history: true
  on:
    branch: master
  local-dir: public
  1. 將 .travis.yml 推送到 repository 中。Travis CI 應該會自動開始運行，並將生成的文件推送到同壹 repository 下的 gh-pages 分支下
  2. 在 GitHub 中前往妳的 repository 的設置頁面，修改 GitHub Pages 的部署分支為 gh-pages。
  3. 前往 https://<妳的 GitHub 用戶名>.github.io 查看妳的站點是否可以訪問。這可能需要壹些時間。

Project page

如果妳更希望妳的站點部署在 <妳的 GitHub 用戶名>.github.io 的子目錄中，妳的 repository 需要直接命名為子目錄的名字，這樣妳的站點可以通過 https://<妳的 GitHub 用戶名>.github.io/<repository 的名字> 訪問。妳需要檢查妳的 Hexo 配置文件，將 url 修改為 https://<妳的 GitHub 用戶名>.github.io/<repository 的名字>、將 root 的值修改為 /<repository 的名字>/

Private repository

由於在 Private Repository 啟用 Travis CI 需要付費，因此妳可能需要自己構建。

  1. 新建壹個 repository。如果妳希望妳的站點能通過 <妳的 GitHub 用戶名>.github.io 域名訪問，妳的 repository 應該直接命名為 <妳的 GitHub 用戶名>.github.io。如果妳不想上傳妳的 Hexo 站點文件夾到 GitHub 請直接跳到第三步。
  2. 將妳的 Hexo 站點文件夾推送到 GitHub，默認情況下不應該 public 目錄將不會被推送到 repository 中，妳應該檢查 .gitignore 文件中是否包含 public 壹行，如果沒有請加上。
  3. 執行 hexo g 生成站點目錄，並將生成的 public 復制到別處。
  4. 在 Hexo 站點目錄下新建壹個 gh-pages 分支，我們推薦創建壹個 orphan 分支（壹個幹凈的、沒有任何 commit 歷史的分支）：
$ git checkoud --orphan gh-pages
  1. 將 Hexo 站點文件夾下除了 .git 以外的任何文件和目錄全部刪除（不要擔心，它們還能被找回來的）
  2. 找到之前復制到別處的的 public 目錄，將其中的的所有文件復制回 Hexo 站點文件夾。
  3. 使用以下指令發布站點
$ git add .
$ git commit -a -m "Initial commit"
$ git push origin gh-pages
  1. 前往妳的 GitHub 的 repository 設置頁面，將 GitHub Pages 的部署分支設置為 gh-paghes 分支。
  2. 前往 https://<妳的 GitHub 用戶名>.github.io 查看妳的站點是否可以訪問。這可能需要壹些時間。
  3. 回到妳的 Hexo 站點文件夾，使用下面指令
$ git checkout master
  1. 妳的 Hexo 站點文件就回來了。
Windows 用戶

請註意，以上教程翻譯自 Hexo 文檔英文版，僅做參考；譯者在翻譯過程中發現很多語焉不詳的內容。
在 Awesome Hexo 中收錄有壹些在 GitHub 部署 Hexo 的教程。通過搜索引擎可以找到更多教程。
也歡迎更多有誌之士前來改善 Hexo 文檔，不勝感激。

有用的參考鏈接