1. 安裝 Github Desktop

優點

  • 在 Windows 環境下使用
  • 可以自動建立 SSH Keys

裝純粹 Git 的話需要自己手動建立 SSH Key

2. 安裝 Node.js

照著安裝步驟走就好，沒啥好說的。

3. 選擇 Git Shell 類型

  1. 打開 Github Desktop
  2. 設定 > options > Default Shell > 選擇 Git Bash

    步驟2可不做，我挑 Git Bash 只是因為介面比較順眼而已XD
  3. 設定 > Open in Git shell
  4. 然後 Github Desktop 就可以功成身退惹

這個 Git shell 只是 GitHub Desktop 由指令建出來的捷徑，並沒有實體位置。
真正的 git.exe 放在 C:\Users\[username]\AppData\Local\GitHub\PortableGit_...\ 底下，
需由此處才能右鍵以管理員身份開啟。
若以管理員身份開啟 git-bash.exe，因為不是透過 GitHub Desktop 打開的，
它不會記得你的身分認證，在做 push 的時候會需要重新輸入帳號密碼。

4. 建立 Hexo 環境

  1. 安裝 Hexo

    1
    2
    3
    4
    $ npm install -g hexo-cli 	# 安裝 Hexo
    $ hexo init <folder> 		# 在指定資料夾中建立所需文件
    $ cd <folder>			# 移至指定資料夾
    $ npm install			# 安裝 Hexo plugin

  2. Hello World!

    1
    $ hexo server 	# = hexo s, 進行 compile

    到這邊基本已經安裝好 hexo 了，可以在執行上述指令後到 http://localhost:4000 檢視基本頁面。

  3. 設定 hexo 根目錄下的 _config.yml

    /_config.yml
    1
    2
    3
    4
    5
    6
    7
    8
    # 選擇主題
    theme: theme-name
    # 設定要 deploy 到 github repo
    deploy:
        type: git
        repo: git@github.com:[your_account]/[your_account].github.io.git
        branch: master

  4. 設置 Github pages


    需要在 Github 上開一個名為 [your_account].github.io 的 repo，這樣在推出去之後網頁(http://[your_account].github.io)才會動。

  5. 產生靜態網頁並推到 github 上

    1
    2
    $ hexo generate # = hexo g, 建立 publish 檔案
    $ hexo deploy	# = hexo d, 將 publish 的檔案推到第二點設定的 repo 上

    接下來就可以到 http://[your_account].github.io 檢視成果囉～

5. 進階設定


若此處項目連結失效可至 #Hexo 搜尋該主題

  1. 把 Hexo 原始碼也放到 github 遠端保存

    延伸: 在別的地方 clone 既有的 hexo repo

    1
    2
    3
    4
    5
    6
    # clone repo 到指定目錄
    $ git clone http://github.com/[your_account]/[your_account].github.io target_dir
    # 切換到保存 hexo 原始碼的 branch
    $ git checkout hexo_branch
    # 將該裝的東西都裝一裝
    $ npm install

  2. 修改 Hexo 主題

    若遇到 deploy 完 style 卻不對的情況: (deploy后style.css不对)

    1
    2
    3
    4
    # Make theme changes & deploy
    $ hexo clean
    $ hexo generate
    $ hexo deploy