湯米羊

Tommy Yang

0%

架設 HEXO 網誌

發表於 更新於 分類於

懶人包

透過 Hexo，您可以輕鬆地建立和管理個人部落格，享受快速生成和部署的便利。

  1. 安裝 Hexo： 確保已安裝 Node.js 和 Git，然後在終端機中執行 npm install -g hexo-cli 安裝 Hexo。
  2. 初始化專案： 在目標資料夾中執行 hexo init，初始化 Hexo 專案結構。
  3. 撰寫文章： 使用 hexo new "文章標題" 指令建立新文章，文章檔案會儲存在 source/_posts 資料夾中。
  4. 生成靜態檔案： 執行 hexo generate（或簡寫為 hexo g），生成靜態網站檔案。
  5. 本地預覽： 透過 hexo server（或簡寫為 hexo s）啟動本地伺服器，預設在 http://localhost:4000/ 預覽網站。
  6. 部署網站： 配置部署資訊後，使用 hexo deploy（或簡寫為 hexo d）將網站部署到指定平台。

簡單介紹

Hexo 是一個基於 Node.js 的快速、簡單且強大的靜態網站生成器，特別適合用於建立個人部落格。
它使用 Markdown（或其他標記語言）來撰寫文章，並透過主題渲染，快速生成靜態檔案。

Hexo 的主要特點包括：

  • 超高速生成： 利用 Node.js 的高效能，Hexo 能在數秒內生成數百個檔案。
  • Markdown 支援： 全面支援 GitHub Flavored Markdown，讓撰寫和管理文章更加方便。
  • 豐富的主題和插件： 擁有大量精美且功能豐富的主題，可自訂網站外觀；同時，強大的 API 允許無限擴充功能。
  • 一鍵部署： 只需一個指令，即可將網站部署到 GitHub Pages、Heroku 等平台，簡化發布流程。

安裝

  1. 安裝必要環境

    • Git：後面的「快速安裝」需要使用。
    • Node.js：安裝透過 NPM 需要使用。

      Node.js 版本需不低於8.10，建議使用 Node.js 10.0 及以上版本

  2. 快速安裝

    • 安裝 Hexo

      他會安裝一個類似 hexo 套件，後面都使用 hexo 命令操作

      1
      npm install hexo-cli -g

    • 初始化

      在指定資料夾中建立所有您需要的檔案。
      該檔案可以放在 USB 到處帶著跑。

      1
      2
      3
      hexo init <folder>
      cd <folder>
      npm install

    • 資料夾結構

      1
      2
      3
      4
      5
      6
      7
      8
      .
      ├── _config.yml # 網站配置檔
      ├── package.json # 應用程式數據
      ├── scaffolds # 文章模板
      ├── source # 文章(網站內容, MD檔)
      |   ├── _drafts
      |   └── _posts
      └── themes # 主題

  3. 基本使用

    • 撰寫文章

      1
      2
      3
      4
      # 格式
      hexo new [layout] <title>
      # 範例
      hexo new post "Hello World"

    • 刪除文章

      如果您使用 Git 進行部署，可能需要額外刪除根目錄下的 .deploy_git 資料夾，然後重新執行上述步驟，以確保已刪除的文章不再出現在網站上。

      1
      2
      3
      4
      # 在 source/_posts 資料夾中，找到並刪除文章的 .md 檔案
      hexo clean
      hexo generate
      hexo deploy

    • 產生靜態文件

      生成靜態網站檔案，生成的檔案會在 public 目錄下

      1
      2
      3
      4
      5
      6
      7
      # 通常使用
      hexo generate
      # 或
      hexo g

      # 如果你想知道檔案異動
      hexo generate --watch

    • 清理快取或生成的靜態文件

      清理 快取檔(db.json) 和 生成的檔(public)。

      刪除文章或變更設定會需要使用

      1
      hexo clean

    • 啟動本地伺服器

      預設為 http://localhost:4000/，按 ctrl + c 結束本地伺服器。

      Node.js 會要開本機防火牆，但通常不需要防火牆也能運作！

      1
      hexo server

    • 部署網站

      將網站部署到指定平台

      1
      2
      3
      hexo deploy
      # 或
      hexo d