用 Hexo 建立自己的部落格(一) - 如何安裝

Hexo 是一個基於 Node.js 所建立的網誌框架，這次參考 iT邦幫忙 的文章來初步架設屬於自己的部落格。

如何安裝 Hexo

安裝 Hexo 之前必須先準備開發環境，所以需要安裝 Node.js 以及 Git。
首先，進入到 Node.js 與 Git 官方網站去下載安裝。
接著，開啟電腦中的終端機，執行以下指令，確定 Node.js 版本以及 npm 是否已經正確安裝(npm 會隨著 Node.js 安裝時一起安裝)。

node -v
npm -v

跳出版本號，就是成功安裝。
下一步輸入以下指令安裝 Hexo

npm install -g hexo-cli

安裝完，一樣透過以下指令確認是否已經安裝成功

hexo -v

開始建立文章

使用 Visual Studio Code 開啟 Hexo 專案，建立部落格文章。
這時會需要開啟 VSCode 的終端機，開啟的方式是 CTRL + ESC 下的頓號。
然後下方終端機輸入 hexo new '文章名稱'
輸入完畢之後會出現一段訊息
INFO Created: ~/itHelp/itHelpHexo/source/_posts/文章名稱.md
這代表已經成功建立文章。
文章的撰寫格式是使用 Markdown。

部署到 GitHub

架設網誌之前，還必須準備一個存放網站的空間，這裡就使用 GitHub。

1. 登入 GitHub
2. 點選 New 新增一個 Repository（專案）
3. 專案名稱命名為 username.github.io ，這樣就成功建立了一個網域
4. 回到 hexo 資料夾，在終端機輸入下列指令安裝套件：
   $ npm install hexo-deployer-git --save
5. 修改 _config.yml 設定檔中，有關 deploy 的設定

    deploy:
   type: git #選擇部屬模式
   repo: https://github.com/username/username.github.io.git #GitHub repository 的連結
   branch: master #選擇分支，預設是master

6. 輸入部署指令 hexo deploy

常用的 Hexo 指令

• 新增文章: hexo new '文章名稱'

• 產生靜態檔案: hexo generate

  • 可簡寫成 hexo g

• 開啟模擬伺服器: hexo server

  • 在本地端啟動 Hexo 伺服器，預設路徑為：http://localhost:4000/
  • Ctrl + C 即可關閉

• 清除暫存檔案: hexo clean

  • 可簡寫成 hexo cl

• 部署靜態檔案: hexo deploy

  • 可簡寫成hexo d

• 在完成每次修改後，會依序輸入 clean -> generate -> deploy 三行指令，避免更新不完全。

• 或是合併第二、三行指令：hexo g -d 即可在產生靜態頁面後立刻部署。