ChiYu Code Journey

【文章最終整合版】

想快速打造個人部落格?試試 HugoBlogTemplate,極簡、開源,讓你專注寫作!

你是不是也曾想過,要建立一個屬於自己的小天地,放些技術筆記、生活隨筆,或是作品集?但一想到要租主機、搞定複雜的後台設定、擔心網站速度,頭就開始痛了?

別擔心!今天就是要來跟你介紹一個我完成的開源專案:HugoBlogTemplate,它能讓你幾乎零成本、超快速地建立一個美觀又實用的個人部落格。

點我前往 HugoBlogTemplate 的 GitHub 專案頁面

這到底是什麼?適合誰用?

簡單來說,HugoBlogTemplate 是一個基於 Hugo 這個靜態網站生成器所打造的「部落格模板」。

你可能聽過 WordPress,但 Hugo 不一樣。它不會動態去讀取資料庫,而是在你寫完文章後,直接「生成」一整個網站的 HTML 靜態檔案。這樣做有幾個超強的優點:

  1. 快!快到飛起! 因為使用者瀏覽的都只是純粹的 HTML,沒有後端處理、沒有資料庫查詢,載入速度幾乎是瞬間完成。
  2. 安全! 沒有後台登入頁面、沒有資料庫,自然就少了很多被攻擊的風險。
  3. 便宜(甚至免費)! 你可以把生成好的網站檔案,輕鬆部署到像是 GitHub Pages、Netlify 或 Vercel 這些提供免費託管服務的平台上。

所以,HugoBlogTemplate 就是幫你把 Hugo 的環境都設定好,給你一個「開箱即用」的部落格樣式。它特別適合:

HugoBlogTemplate 有哪些貼心的功能?

這個專案雖然主打極簡,但在基礎功能上一點也不馬虎。我已經幫你內建了許多實用的功能:

好!我想用!該如何開始?

整個過程比你想像的還要簡單,大概可以分成以下幾步:

第 1 步:準備環境 (若想在本機預覽) 如果你想在自己的電腦上看到網站的即時變化,需要先安裝兩樣東西:

  1. Git:用來抓取專案程式碼。
  2. Hugo:用來產生網站的核心工具。( 官方安裝說明

第 2 步:把專案抓下來 打開你的終端機,輸入以下指令:

git clone https://github.com/eric861129/HugoBlogTemplate.git 你的部落格資料夾名稱
cd 你的部落格資料夾名稱

第 3 步:個人化你的部落格 (hugo.toml 設定) 這是最重要的一步!打開專案裡的 hugo.toml 檔案,你會看到非常清楚的設定選項。你不需要懂複雜的程式碼,只要把裡面的內容改成你自己的資訊即可:

# hugo.toml

# 換成你未來要部署的網址
baseURL = 'https://<你的GitHub帳號>.github.io/<你的專案名稱>/'
languageCode = 'zh-TW'
# 換成你的部落格名稱
title = '我的個人部落格'

[params]
  # 換成你的名字
  author = "你的大名"
  # 換成你的部落格描述
  description = "這是一個記錄學習與生活的地方"

  [params.social]
    # 把連結換成你自己的
    GitHub = "https://github.com/..."
    LinkedIn = "https://www.linkedin.com/in/.../"

第 4 步:寫下你的第一篇文章 繼續在終端機輸入這個指令,建立一個新的文章檔案:

hugo new content posts/my-first-post.md

然後你就會在 content/posts/ 資料夾下看到 my-first-post.md 這個檔案。用 Markdown 語法開始寫作吧!

第 5 步:在本機預覽你的網站 想看看網站長什麼樣子?超簡單,在終端機輸入:

hugo server -D

然後打開瀏覽器,輸入 http://localhost:1313/,你熱騰騰的部落格就出現啦!

第 6 步:發布上線——手動與自動,任你選!

【方法一:傳統手動部署】 當你對網站感到滿意後,只要執行 hugo 這個指令,它就會在 public/ 資料夾中產生所有網站的靜態檔案。接下來,你只需要把這個 public 資料夾裡的內容,手動上傳到任何你喜歡的靜態網站託管平台即可。

【方法二:懶人自動化部署 ✨】 但是,如果你覺得每次都要手動上傳很麻煩,甚至根本不想自己動手部署怎麼辦?

別擔心!這個專案最棒的地方之一,就是已經幫你內建了超方便的 GitHub Actions 自動化部署流程!

整個流程會變成這樣:

  1. Fork 專案:將 HugoBlogTemplate 這個專案 Fork(複製一份)到你自己的 GitHub 帳號底下。
  2. 修改設定:直接在 GitHub 網站上,找到並編輯 hugo.toml 檔案,填上你在步驟 3 中設定好的個人資訊。
  3. 線上寫作:接著,在 content/posts 資料夾,直接新增一個 .md 檔案來寫你的新文章。
  4. 儲存並合併:文章寫完後,將變更儲存(Commit),並且合併(Merge)到你的 main 主分支。

然後呢?就沒有然後了!

當 GitHub 偵測到你的 main 分支有更新,GitHub Actions 就會自動在雲端幫你完成所有建置網站、發布到 GitHub 免費提供的 GitHub Pages 服務上。

你唯一要做的,就是在你 Fork 出去的專案 Settings > Pages 裡面,將部署來源(Source)設定為 gh-pages 分支。幾分鐘後,你就能擁有一個專屬於你的、會自動更新的部落格網址了!

結論

HugoBlogTemplate 是一個讓你回歸「分享」與「寫作」本質的專案。它不僅提供了極簡美觀的版型,更移除了部署上線的技術門檻。無論你是想在本機完整控制,還是想享受 Fork -> 設定 -> 寫作 -> 自動上線 的懶人流程,它都能滿足你。

如果你正想建立一個個人網站,但遲遲沒有行動,不妨給 HugoBlogTemplate 一個機會。動動手指,也許半小時後,你就能擁有一個專屬於你的、快速又美觀的網路小窩了!

最後,別忘了到 GitHub 專案頁面 給我一個 Star ⭐,這對開源專案是最大的鼓勵!

想快速打造個人部落格?試試 HugoBlogTemplate,極簡、開源,讓你專注寫作!

發布於 2025年6月11日 (更新於 2025年6月11日) · 約 2 分鐘閱讀 · Hugo


【文章最終整合版】

想快速打造個人部落格?試試 HugoBlogTemplate,極簡、開源,讓你專注寫作!

你是不是也曾想過,要建立一個屬於自己的小天地,放些技術筆記、生活隨筆,或是作品集?但一想到要租主機、搞定複雜的後台設定、擔心網站速度,頭就開始痛了?

別擔心!今天就是要來跟你介紹一個我完成的開源專案:HugoBlogTemplate,它能讓你幾乎零成本、超快速地建立一個美觀又實用的個人部落格。

點我前往 HugoBlogTemplate 的 GitHub 專案頁面

這到底是什麼?適合誰用?

簡單來說,HugoBlogTemplate 是一個基於 Hugo 這個靜態網站生成器所打造的「部落格模板」。

你可能聽過 WordPress,但 Hugo 不一樣。它不會動態去讀取資料庫,而是在你寫完文章後,直接「生成」一整個網站的 HTML 靜態檔案。這樣做有幾個超強的優點:

  1. 快!快到飛起! 因為使用者瀏覽的都只是純粹的 HTML,沒有後端處理、沒有資料庫查詢,載入速度幾乎是瞬間完成。
  2. 安全! 沒有後台登入頁面、沒有資料庫,自然就少了很多被攻擊的風險。
  3. 便宜(甚至免費)! 你可以把生成好的網站檔案,輕鬆部署到像是 GitHub Pages、Netlify 或 Vercel 這些提供免費託管服務的平台上。

所以,HugoBlogTemplate 就是幫你把 Hugo 的環境都設定好,給你一個「開箱即用」的部落格樣式。它特別適合:

  • 工程師/學生:想記錄技術筆記、學習心得,需要一個簡潔、支援程式碼高亮的平台。
  • 文字創作者:不想被複雜的編輯器綁架,希望專注在內容本身。
  • 任何人:想擁有一個「自己的」網站,不想付月費,也不想花大把時間在維護上。

HugoBlogTemplate 有哪些貼心的功能?

這個專案雖然主打極簡,但在基礎功能上一點也不馬虎。我已經幫你內建了許多實用的功能:

  • 內建亮色/暗色模式:自動偵測使用者系統的偏好設定,也可以讓訪客手動切換,非常貼心。
  • 社群連結整合:想放你的 GitHub、LinkedIn 等連結?只要在設定檔裡填上你的帳號,就會自動出現在個人介紹區塊。
  • SEO 友善:專案已經幫你處理好基礎的搜尋引擎優化(SEO),讓你的內容更容易被 Google 等搜尋引擎找到。
  • 響應式設計 (RWD):無論你的訪客用的是電腦、平板還是手機,網站版面都能自動適應,提供最佳的閱讀體驗。

好!我想用!該如何開始?

整個過程比你想像的還要簡單,大概可以分成以下幾步:

第 1 步:準備環境 (若想在本機預覽) 如果你想在自己的電腦上看到網站的即時變化,需要先安裝兩樣東西:

  1. Git:用來抓取專案程式碼。
  2. Hugo:用來產生網站的核心工具。( 官方安裝說明

第 2 步:把專案抓下來 打開你的終端機,輸入以下指令:

git clone https://github.com/eric861129/HugoBlogTemplate.git 你的部落格資料夾名稱
cd 你的部落格資料夾名稱

第 3 步:個人化你的部落格 (hugo.toml 設定) 這是最重要的一步!打開專案裡的 hugo.toml 檔案,你會看到非常清楚的設定選項。你不需要懂複雜的程式碼,只要把裡面的內容改成你自己的資訊即可:

# hugo.toml

# 換成你未來要部署的網址
baseURL = 'https://<你的GitHub帳號>.github.io/<你的專案名稱>/'
languageCode = 'zh-TW'
# 換成你的部落格名稱
title = '我的個人部落格'

[params]
  # 換成你的名字
  author = "你的大名"
  # 換成你的部落格描述
  description = "這是一個記錄學習與生活的地方"

  [params.social]
    # 把連結換成你自己的
    GitHub = "https://github.com/..."
    LinkedIn = "https://www.linkedin.com/in/.../"

第 4 步:寫下你的第一篇文章 繼續在終端機輸入這個指令,建立一個新的文章檔案:

hugo new content posts/my-first-post.md

然後你就會在 content/posts/ 資料夾下看到 my-first-post.md 這個檔案。用 Markdown 語法開始寫作吧!

第 5 步:在本機預覽你的網站 想看看網站長什麼樣子?超簡單,在終端機輸入:

hugo server -D

然後打開瀏覽器,輸入 http://localhost:1313/,你熱騰騰的部落格就出現啦!

第 6 步:發布上線——手動與自動,任你選!

【方法一:傳統手動部署】 當你對網站感到滿意後,只要執行 hugo 這個指令,它就會在 public/ 資料夾中產生所有網站的靜態檔案。接下來,你只需要把這個 public 資料夾裡的內容,手動上傳到任何你喜歡的靜態網站託管平台即可。

【方法二:懶人自動化部署 ✨】 但是,如果你覺得每次都要手動上傳很麻煩,甚至根本不想自己動手部署怎麼辦?

別擔心!這個專案最棒的地方之一,就是已經幫你內建了超方便的 GitHub Actions 自動化部署流程!

整個流程會變成這樣:

  1. Fork 專案:將 HugoBlogTemplate 這個專案 Fork(複製一份)到你自己的 GitHub 帳號底下。
  2. 修改設定:直接在 GitHub 網站上,找到並編輯 hugo.toml 檔案,填上你在步驟 3 中設定好的個人資訊。
  3. 線上寫作:接著,在 content/posts 資料夾,直接新增一個 .md 檔案來寫你的新文章。
  4. 儲存並合併:文章寫完後,將變更儲存(Commit),並且合併(Merge)到你的 main 主分支。

然後呢?就沒有然後了!

當 GitHub 偵測到你的 main 分支有更新,GitHub Actions 就會自動在雲端幫你完成所有建置網站、發布到 GitHub 免費提供的 GitHub Pages 服務上。

你唯一要做的,就是在你 Fork 出去的專案 Settings > Pages 裡面,將部署來源(Source)設定為 gh-pages 分支。幾分鐘後,你就能擁有一個專屬於你的、會自動更新的部落格網址了!

結論

HugoBlogTemplate 是一個讓你回歸「分享」與「寫作」本質的專案。它不僅提供了極簡美觀的版型,更移除了部署上線的技術門檻。無論你是想在本機完整控制,還是想享受 Fork -> 設定 -> 寫作 -> 自動上線 的懶人流程,它都能滿足你。

如果你正想建立一個個人網站,但遲遲沒有行動,不妨給 HugoBlogTemplate 一個機會。動動手指,也許半小時後,你就能擁有一個專屬於你的、快速又美觀的網路小窩了!

最後,別忘了到 GitHub 專案頁面 給我一個 Star ⭐,這對開源專案是最大的鼓勵!