Hugo

為了集中創作能量與技術資源，原獨立的「2026 台灣河流探索」網站正式併入「哈爸筆記」，未來將作為本站的核心系列持續更新。

當靈感遇上 AI：一個上午的加速實踐 這篇文章不是遊記，而是關於這個網站與這個計畫是如何誕生的紀錄。 過去，當我們萌生一個「想去探索台灣河流」的念頭時，往往會卡在繁瑣的規劃、資料蒐集，甚至是架設網站的技術門檻上。但這次，我嘗試了一種全新的工作模式——與 Agentic AI (Antigravity) 協作規劃。 以下是我們在短短時間內，從「一個想法」到「網站上線」的歷程筆記。 第一階段：從模糊到具象 (The Brainstorming) 1. 結構化龐雜資訊 一開始，我只有「想探索河流」這個模糊的概念。我請 AI 扮演研究分析師，快速梳理了台灣北部、中部、南部、東部的主要河川。 關鍵產出：AI 幫我列出了一份包含 11 條主要河川的清單，並針對每一條河列出了「景觀」、「生態」與「人文」的探索重點。這份清單成為了後續所有行程的骨架。 2. 定義探索方法論 我們不只是去玩，而是希望帶入**「流域治理」與「開放資料」**的視角。AI 協助我將這些硬核的知識轉化為一篇名為〈數位河流學〉的方法論文章，確立了這個部落格「知性與感性兼具」的基調。 第二階段：技術苦工的自動化 (The Infrastructure) 有了內容，需要載體。我選擇了 Hugo 這個靜態網站產生器，但技術細節往往是最磨人的。 GenAI 解決了什麼？ 環境建置：從 hugo.yml 的基礎設定，到 PaperMod 主題的調整。 功能客製化： Google Maps 嵌入：解決了 Hugo 預設擋掉 iframe 的安全性設定。 自動目錄 (TOC)：協助開啟全站的文章導覽，解決了不同頁面顯示不一致的問題。 系列分類 (Series Taxonomy)：建立特殊的「Series」頁面，讓針對同一條河流（如大甲溪）的不同文章能自動聚合，並擁有專屬的介紹首頁。 除錯 (Debugging)：最經典的是 “Future Date” 問題。當我看不到新文章時，AI 迅速指出是因为我的文章日期設在「明天」，並教我設定 buildFuture: true 來解決。 第三階段：內容深度的擴充 (The Content) 在撰寫《大甲溪車宿攻略》與《后里環保公園指南》時，AI 扮演了編輯與資料庫的角色。 它記住了我要去「后里」，並能提醒我那邊是合法的車泊點，甚至補充了「洗澡要去附近游泳池」這種在地細節。 當我需要針對「歷史文化」做補充時，它能迅速生成一段關於大甲溪流域開發史的背景介紹，讓我能專注於個人體驗的書寫，而非重複查閱維基百科。 第四階段：連結真實社群 (The Connection) 最後，為了讓這個計畫落地，我們建立了一個 “Planning” (旅程規劃) 頁面。 ...