Vue3 前端framework教學

Vue 3.x 前端 Framework 教學手冊 📘 適用對象:完全沒有學過 Vue 3 的新進開發同仁 🎯 學習目標:循序漸進掌握 Vue 3.x 開發技能,並具備專案實戰能力 🏆 認證準備:涵蓋 Vue 3 官方認證考試重點 📖 目錄 第一章:Vue 3 基礎入門 1.1 什麼是 Vue.js? 1.2 開發環境建置 1.3 第一個 Vue 3 應用 1.4 專案應用指引 1.5 認證考點提示 第二章:Composition API 深入 2.1 setup() 函數詳解 2.2 組合式函數 (Composables) 2.3 進階組合式函數範例 2.4 專案應用指引 2.5 認證考點提示 第三章:響應式系統 3.1 ref() 與 reactive() 詳解 3.2 深度響應式與淺層響應式 3.3 computed() 計算屬性 3.4 watch() 與 watchEffect() 3.5 響應式工具函數 3.6 專案應用指引 3.7 認證考點提示 第四章:模板語法與指令 ...

October 31, 2025 · 56 min · 11798 words · Eric Cheng

物件導向分析與設計 (OOAD) 教學

物件導向分析與設計 (OOAD) 教學手冊 作者:系統架構師團隊 更新日期:2026 年 10 月 12 日 版本:v3.0 適用對象:新進開發同仁、資深工程師、技術主管、Code Reviewer 技術基準:OMG UML 2.5.1、ISO/IEC 25010:2023、Java 25、JUnit 6.1、ArchUnit 1.5、Mermaid 11 目錄 0. 文件資訊與使用方式 0.1 文件資訊 0.2 如何使用本手冊 0.3 指引條目的格式與編號 0.4 範例的驗證方式 1. 前言與學習目標 1.1 為什麼要學習 OOAD 1.2 學習目標 1.3 學習路徑與建議時數 1.4 前置知識與環境準備 1.5 本章自我檢核 2. 物件導向基礎概念 2.1 物件與類別 2.2 封裝 2.3 抽象 2.4 繼承與組合 2.5 多型 2.6 值物件、實體與相等性 2.7 介面與抽象類別 2.8 實務案例:學生管理模型 2.9 練習題 2.10 章節小結 3. 設計原則:SOLID、GRASP 與契約式設計 3.1 單一職責原則(SRP) 3.2 開放封閉原則(OCP) 3.3 里氏替換原則(LSP) 3.4 介面隔離原則(ISP) 3.5 依賴反轉原則(DIP) 3.6 GRASP:職責指派的九個模式 3.7 迪米特法則、KISS 與 YAGNI 3.8 契約式設計 3.9 以自動化測試守護設計原則 3.10 練習題 3.11 章節小結 4. OOAD 開發流程 4.1 流程概覽:迭代與增量 4.2 需求分析 4.3 領域分析與領域模型 4.4 Use Case 分析 4.5 強健性分析 4.6 架構設計 4.7 詳細設計:從系統事件到物件互動 4.8 實作:從設計到程式碼 4.9 測試與驗證 4.10 追溯性 4.11 練習題 4.12 章節小結 5. UML 2.5.1 建模實務 5.1 UML 簡介與標準現況 5.2 UML 2.5.1 的 14 種圖形 5.3 Use Case 圖 5.4 類別圖 5.5 物件圖 5.6 套件圖 5.7 循序圖 5.8 通訊圖 5.9 活動圖 5.10 狀態機圖 5.11 元件圖與部署圖 5.12 其他圖形 5.13 OCL 基礎 5.14 Mermaid、PlantUML 與 UML 標準記法的差異 5.15 UML 工具選型 5.16 建模最佳實務與圖形審查清單 5.17 練習題 5.18 章節小結 6. 專案實務:大學選課系統 6.1 專案背景與需求 6.2 Use Case 6.3 領域模型與詞彙表 6.4 架構設計 6.5 設計類別圖 6.6 關鍵循序圖 6.7 實作 6.8 測試 6.9 已知限制與演進方向 6.10 章節小結 7. 領域驅動設計(DDD)戰術模式與 OOAD 的銜接 7.1 通用語言與限界上下文 7.2 實體與值物件 7.3 聚合 7.4 領域服務與應用服務 7.5 儲存庫 7.6 工廠 7.7 領域事件 7.8 練習題 7.9 章節小結 8. 設計模式實務 8.1 GoF 模式分類 8.2 Strategy 模式 8.3 Observer 模式與事件通知 8.4 Factory Method 與靜態工廠方法 8.5 Template Method 與 Strategy 的選擇 8.6 Decorator 模式 8.7 Adapter 模式 8.8 State 模式 8.9 Singleton 的風險 8.10 審查模式的使用 8.11 練習題 8.12 章節小結 9. 常見錯誤與最佳實務 9.1 分析階段常見錯誤 9.2 設計階段常見錯誤 9.3 實作階段常見錯誤 9.4 程式碼可讀性 9.5 安全設計 9.6 效能考量 9.7 練習題 9.8 章節小結 10. AI 輔助 OOAD 的實務與審查 10.1 適用與不適用的情境 10.2 AI 輔助的 OOAD 流程 10.3 結構化提示 10.4 資料保護與合規 10.5 AI 產出的程式碼 10.6 練習題 10.7 章節小結 11. UML 認證(OCUP 2)準備 11.1 認證概述 11.2 Foundation 考試範圍 11.3 Intermediate 與 Advanced 考試範圍 11.4 重點知識整理 11.5 模擬題與解析 11.6 準備計畫 11.7 學習資源 11.8 章節小結 12. 能力評量與成長路徑 12.1 能力模型與評量量表 12.2 知識與技能自我檢核 12.3 實作評量 12.4 成長路徑 12.5 學習紀錄範本 12.6 章節小結 13. 專案交付與審查檢查清單 13.1 需求分析檢查清單 13.2 設計審查檢查清單 13.3 實作檢查清單 13.4 Code Review 檢查清單 13.5 專案交付檢查清單 13.6 章節小結 14. 延伸閱讀與參考資料 14.1 OOAD 與 UML 經典書籍 14.2 設計原則、模式與領域驅動設計 14.3 架構與軟體工程 14.4 國際標準與規格 14.5 線上資源與工具 14.6 本站相關教學與指引 14.7 結語 附錄 A 指引總表 附錄 B v2.1 至 v3.0 章節對照 附錄 C 修正紀錄 附錄 D 驗證紀錄 附錄 E 待確認事項 附錄 F 版本歷程 0. 文件資訊與使用方式 0.1 文件資訊 項目 內容 文件名稱 物件導向分析與設計 (OOAD) 教學手冊 版本 v3.0(全面改版,變更內容見附錄 B與附錄 C) 更新日期 2026-10-12 作者 系統架構師團隊 適用對象 新進開發同仁、資深工程師、技術主管、Code Reviewer 文件定位 企業內部技術白皮書等級的教學手冊:教會「怎麼做」,也教會「怎麼審查與驗證別人做得對不對」 本版技術基準(所有程式範例皆以此基準實際編譯與執行,結果見附錄 D): ...

October 31, 2025 · 115 min · 24461 words · Eric Cheng

統一建模語言(UML)教學

統一建模語言(UML)教學手冊 作者:系統架構師團隊 更新日期:2026 年 10 月 13 日 版本:v2.0 適用對象:新進開發同仁、系統分析師、架構師、測試工程師、Code Reviewer 技術基準:OMG UML 2.5.1(ISO/IEC 19505:2012 對應 UML 2.4.1)、OCL 2.4、PlantUML 1.2026.8、Mermaid 11、Java 25、JUnit 6.1 目錄 0. 文件資訊與使用方式 0.1 文件資訊 0.2 適用對象與學習路徑 0.3 與其他手冊的分工 0.4 指引條目的格式與編號 0.5 範例的驗證方式 0.6 圖例與記法慣例 1. UML 概論與標準體系 1.1 什麼是 UML 1.2 發展歷程 1.3 標準體系與版本現況 UML-GEN-001 引用 UML 時標明規格版本 1.4 模型、圖與後設模型 1.5 14 種圖的分類 1.6 建模的目的與抽象層級 UML-GEN-002 每張圖都要標明目的、讀者與抽象層級 UML-GEN-003 一張圖只表達一個主題並控制元素數量 1.7 常見誤解 1.8 練習題 2. 共通記法元素 2.1 名稱與命名空間 2.2 可見性 2.3 多重性 UML-GEN-004 多重性使用 UML 標準語法 2.4 型別、資料型別與列舉 2.5 註解、約束、關鍵字與構造型 UML-GEN-005 構造型限用團隊登錄清單 UML-GEN-006 重要業務規則以約束表達並可轉成測試 2.6 依賴與抽象關係 2.7 練習題 3. 類別圖 3.1 用途與觀點 3.2 類別的記法 3.3 介面與抽象類別 3.4 關聯 UML-CLS-001 關聯兩端都要標示多重性 UML-CLS-002 導航方向只在設計與實作觀點標示 3.5 聚合與組合 UML-CLS-003 組合與聚合的菱形畫在整體端 UML-CLS-004 只在生命週期確實綁定時使用組合 3.6 泛化與泛化集合 UML-CLS-005 泛化只表達 is-a 關係 3.7 依賴與實現在類別圖中的使用 3.8 同一模型的三種觀點 3.9 常見錯誤 3.10 審查清單 3.11 練習題 4. 物件圖 4.1 用途 4.2 記法 4.3 以物件圖驗證類別圖 UML-OBJ-001 物件以「名稱 : 類別」表示,連結不標多重性 UML-OBJ-002 以邊界情境的物件圖驗證多重性與約束 4.4 審查清單與練習 5. 套件圖 5.1 用途 5.2 記法 5.3 依賴規則與循環依賴 UML-PKG-001 套件之間不可有循環依賴 UML-PKG-002 套件圖與程式套件一致並以架構測試守護 5.4 Mermaid 的近似畫法 5.5 審查清單與練習 6. 組合結構圖 6.1 用途 6.2 記法 6.3 協作 UML-CSD-001 連接器兩端的埠必須介面相容 6.4 練習 7. 元件圖 7.1 用途與元件的定義 7.2 記法 7.3 黑箱與白箱視圖 UML-CMP-001 元件之間只透過介面相依 UML-CMP-002 元件圖不畫類別層級的細節 7.4 Mermaid 的近似畫法與 C4 模型 7.5 審查清單與練習 8. 部署圖 8.1 用途 8.2 記法 8.3 元件、成品與節點的關係 UML-DEP-001 明確區分節點、執行環境與成品 UML-DEP-002 通訊路徑標示協定、埠號與安全邊界 UML-DEP-003 標示軟體版本時確認仍在支援期 8.4 雲端與容器環境的對應 8.5 Mermaid 的近似畫法 8.6 審查清單與練習 9. Profile 圖 9.1 用途 9.2 記法 UML-PRF-001 自訂構造型必須定義在 Profile 並附說明 9.3 練習 10. Use Case 圖 10.1 用途 10.2 記法 10.3 Use Case 的粒度 UML-UC-001 Use Case 以「動詞+受詞」命名並代表使用者目標 UML-UC-002 Actor 與 Use Case 以無箭頭的實線關聯 UML-UC-003 include 由基礎指向被包含者,extend 由擴充指向基礎 UML-UC-004 登入不畫成被 include 的 Use Case 10.4 Use Case 規格 UML-UC-005 每個 Use Case 都有文字規格 10.5 Mermaid 的近似畫法 10.6 審查清單與練習 11. 活動圖 11.1 用途與語意 11.2 記法 11.3 範例:選課流程 UML-ACT-001 決策節點的守衛條件必須互斥且完整 UML-ACT-002 fork 與 join 成對,且 join 只結合並行路徑 UML-ACT-003 區分活動終點與流程終點 UML-ACT-004 泳道代表負責的角色或系統 11.4 進階元素 11.5 審查清單與練習 12. 狀態機圖 12.1 用途 12.2 記法 12.3 範例:選課紀錄的生命週期 UML-STM-001 轉換標示遵循「觸發 [守衛] / 效果」語法 UML-STM-002 同一狀態、同一事件的多條轉換,守衛必須互斥 UML-STM-003 每個狀態都可到達,每個非最終狀態都可離開 12.4 從狀態機圖到程式與測試 UML-STM-004 狀態機圖必須轉成轉換表與測試 UML-STM-005 狀態以形容詞或過去分詞命名,事件以動詞或名詞片語命名 12.5 進階元素 12.6 審查清單與練習 13. 循序圖 13.1 用途 13.2 記法 13.3 範例:選修課程的設計循序圖 UML-SEQ-001 訊息箭頭依同步、非同步、回覆正確區分 UML-SEQ-002 生命線以「角色 : 型別」命名並維持同一抽象層級 UML-SEQ-003 組合片段的守衛條件必須明確 13.4 組合片段 UML-SEQ-004 一張循序圖描述一個情境,長流程以 ref 拆分 13.5 以測試驗證循序圖 UML-SEQ-005 關鍵的呼叫順序以 InOrder 測試守護 13.6 審查清單與練習 14. 通訊圖 14.1 用途 14.2 記法 UML-COM-001 通訊圖的訊息以階層式序號表示順序 14.3 練習 15. 時序圖 15.1 用途 15.2 記法 UML-TIM-001 時間約束必須標示單位與起訖事件 15.3 練習 16. 互動概觀圖 16.1 用途 16.2 記法 UML-IOV-001 每個 ref 都必須能找到對應的互動 16.3 練習 17. OCL 實務 17.1 為什麼需要 OCL 17.2 基本語法 17.3 範例:選課約束 UML-OCL-001 OCL 約束必須有 context 與名稱 17.4 從 OCL 到程式與測試 17.5 約束追溯表 UML-OCL-002 每條 OCL 約束都要對應程式檢查與測試 18. 模型與程式碼的對應 18.1 類別圖元素與 Java 的對應 18.2 範例:組合與多重性的實作 UML-MAP-001 組合在程式中必須體現生命週期擁有 UML-MAP-002 多重性必須對應型別與驗證 18.3 架構圖與程式的自動比對 UML-MAP-003 架構圖以可執行的規則守護 18.4 類別圖與 ER 模型的差異 18.5 練習 19. 工具鏈與 Docs-as-Code 19.1 工具比較 19.2 PlantUML 安裝與使用 UML-TOOL-001 圖以文字原始碼納入版本控制 UML-TOOL-002 機敏的圖不使用公開的線上渲染服務 19.3 Mermaid、PlantUML 與 UML 標準的差異 UML-TOOL-003 以非標準記法近似時必須在圖上註明 19.4 Docs-as-Code 目錄與設定 19.5 自動檢查:check_uml.py 19.6 CI 自動驗證 UML-TOOL-004 CI 中的繪圖工具與 Action 固定版本 20. 生命週期、團隊協作與審查流程 20.1 專案生命週期中的 UML 20.2 依專案類型選擇的最小圖組 20.3 敏捷開發中的建模 UML-PRC-001 建模深度依風險與變更頻率決定 20.4 與不同角色溝通 20.5 圖的審查流程 UML-PRC-002 圖與程式在同一個 Pull Request 中依清單審查 UML-PRC-003 每張正式圖都有負責人與最後驗證日期 20.6 練習 21. 綜合案例 21.1 學生選課系統:從需求到程式的模型鏈 21.2 追溯矩陣 21.3 其他領域的精簡範例 21.4 跨領域的共同模式 21.5 練習 22. AI 輔助建模 22.1 適合與不適合的用途 22.2 AI 產出的典型錯誤 22.3 建議的工作流程 UML-AI-001 AI 產生的圖必須通過工具驗證與人工審查 UML-AI-002 不把機敏資訊提供給未核准的 AI 工具 23. OCUP 2 認證準備 23.1 認證概述 23.2 Foundation 考試範圍 23.3 Intermediate 與 Advanced 考試範圍 23.4 模擬題與解析 23.5 準備計畫與資源 24. 審查與驗證清單總表 24.1 每張圖的共通檢查 24.2 各圖的重點檢查 24.3 模型與程式一致性檢查 24.4 專案階段檢查 24.5 團隊協作檢查 附錄 A 指引總表 附錄 B 符號速查 附錄 C v1.0 至 v2.0 章節對照 附錄 D 修正紀錄 附錄 E 驗證紀錄 附錄 F 待確認事項 附錄 G 參考文獻 附錄 H 版本歷程 0. 文件資訊與使用方式 0.1 文件資訊 項目 內容 文件名稱 統一建模語言(UML)教學手冊 版本 v2.0(2026-10-13) 前一版 v1.0(2025-09-01 內容,2025-10-31 發布) 文件性質 企業標準技術白皮書:記法規範、審查準則與教學 規範基準 OMG UML 2.5.1(formal/17-12-05);國際標準引用 ISO/IEC 19505-1/19505-2:2012 輔助規範 OCL 2.4、XMI 2.5.1、fUML 1.5、Alf 1.1、PSSM 1.0 驗證工具 PlantUML 1.2026.8、mermaid-cli 11(網站載入 mermaid@11)、Java 25、JUnit 6.1、ArchUnit 1.5、Python 3 指引條目 58 條(必須 35 條),總表見附錄 A 本手冊是公司內部 UML 記法的權威文件:圖該怎麼畫、每個符號代表什麼、怎麼審查一張圖是否正確,都以本手冊為準。 ...

October 31, 2025 · 85 min · 18012 words · Eric Cheng

資料流程圖(DFD)教學

資料流程圖 (Data Flow Diagram, DFD) 教學手冊 作者:系統分析與架構團隊 更新日期:2026 年 10 月 12 日 版本:v2.0 適用對象:系統分析師、需求分析人員、後端與資料工程師、資安與個資人員、技術主管、設計審查者 技術基準:DeMarco/Yourdon/Gane-Sarson 結構化分析、IIBA BABOK v3、ISO/IEC/IEEE 29148:2018、STRIDE-per-element、Mermaid 11、Python 3.12(check_dfd.py) 目錄 0. 文件資訊與使用方式 0.1 文件資訊 0.2 如何使用本手冊 0.3 指引條目的格式與編號 0.4 本手冊的層次命名約定 1. 學習目標與能力等級 1.1 學完本手冊應具備的能力 1.2 能力自我檢核 1.3 建議學習時程 2. 基礎概念與發展歷史 2.1 什麼是資料流程圖 DFD-CON-001 資料流必須表達資料,不可表達控制訊號或執行順序 DFD-CON-002 資料流只能是資料,實體物品與金錢要轉成代表它的資料 2.2 DFD 的用途與價值 2.3 發展歷史與記法演進 2.4 DFD 與其他圖的比較與選用 DFD-CON-003 先寫出這張 DFD 要回答的問題,再選擇層次與範圍 2.5 DFD 在開發生命週期中的位置 3. DFD 元素、記法與命名 3.1 外部實體 DFD-NOT-001 團隊必須統一一套記法,並在文件開頭寫明 DFD-NOT-002 外部實體以「角色」命名,不以人名、職稱個人或技術元件命名 3.2 處理程序 DFD-NOT-003 處理程序以「動詞+受詞」命名,並有模型內唯一的編號 3.3 資料流 DFD-NOT-004 外部實體之間不可畫資料流 DFD-NOT-005 外部實體不可直接讀寫資料儲存 DFD-NOT-006 資料儲存之間不可直接流動 DFD-NOT-007 同名資料流在整個模型中代表相同內容,不同內容必須不同名 3.4 資料儲存 DFD-NOT-008 一張圖的處理程序數量控制在 7±2 個以內 DFD-NOT-009 雙向箭頭必須拆成兩條各自命名的單向資料流 3.5 三套常用記法對照 3.6 用 Mermaid 繪製 DFD DFD-NOT-010 Mermaid 圖以 classDef 標示元素類別,不以逐一 style 上色 3.7 版面與視覺規範 4. 分層、編號與平衡 4.1 分層分解的原理 DFD-LVL-001 文件開頭必須寫明層次命名約定 4.2 Context 圖 DFD-LVL-002 Context 圖只能有一個處理程序,且不可包含資料儲存 4.3 Level 0 圖 4.4 編號規則 DFD-LVL-003 子圖處理程序的編號必須以父處理程序編號為前綴 4.5 平衡:父子圖的資料守恆 DFD-LVL-004 子圖的淨輸入與淨輸出必須與父處理程序平衡 DFD-LVL-005 子圖拆分或合併父圖資料流時,組合關係必須寫在資料字典 4.6 資料儲存在分層中的位置 DFD-LVL-006 只被一個處理程序使用的資料儲存,應下移到該處理程序的子圖 4.7 何時停止分解 DFD-LVL-007 分解到功能基元即停止,每個功能基元都要有處理規格 5. 資料字典與處理規格 5.1 為什麼 DFD 一定要搭配資料字典 5.2 資料字典記法 DFD-DIC-001 每條資料流與資料儲存都必須在資料字典定義,並展開到資料元素 DFD-DIC-002 組合定義必須使用統一記法,且可以被工具解析 5.3 資料元素的定義 DFD-DIC-003 資料元素至少定義型別、格式或值域,以及是否為個資 5.4 處理規格:結構化英文 DFD-DIC-004 功能基元的處理規格以結構化英文、決策表或決策樹撰寫,並寫明輸入、輸出與前後置條件 5.5 處理規格:決策表與決策樹 DFD-DIC-005 決策表必須完整且互斥,並以工具或窮舉驗證 6. 繪製方法 6.1 需求蒐集與資料流識別 6.2 事件分割法 DFD-MTH-001 Level 0 圖以事件清單推導,事件清單與 Context 圖的邊界資料流必須一一對應 6.3 由外而內的八步驟繪製流程 6.4 從表單、報表與介面推導資料流 DFD-MTH-002 每份輸入表單、輸出報表與外部介面,都必須對應到 Context 圖的一條資料流 6.5 常見錯誤型錄 6.6 走查與確認 DFD-MTH-003 每條跨越系統邊界的資料流都要經業務代表走查確認,並留下紀錄 7. 邏輯與實體 DFD、現況與未來、現代架構 7.1 邏輯 DFD 與實體 DFD DFD-MTH-004 每張 DFD 都必須標示為邏輯或實體,邏輯 DFD 不得出現技術名詞 7.2 現況與未來 DFD-MTH-005 訊息佇列與事件主題依用途畫成資料儲存或資料流,不畫成處理程序 DFD-MTH-006 現況與未來分開建模,每個模型都要標示狀態 7.3 實體 DFD 的寫法 7.4 即時系統延伸:控制流與控制處理程序 7.5 在微服務、事件驅動與資料管線中使用 DFD 8. 品質審查與自動驗證 8.1 DFD 品質的三個層面 8.2 守恆檢查:黑洞、奇蹟與灰洞 DFD-QA-001 每個處理程序都必須有輸入與輸出,且輸出可由輸入、讀取的資料儲存或宣告的推導取得 8.3 自動驗證工具 check_dfd.py 8.4 其他檢查工具 8.5 資料儲存的使用完整性 DFD-QA-002 完整模型中的每個資料儲存都必須同時有寫入與讀取,外部維護的只讀儲存必須明確宣告 8.6 語意審查:層次一致與命名 DFD-QA-003 同一張圖上的處理程序必須處於相同的抽象層次 8.7 審查流程與紀錄 DFD-QA-004 審查意見必須引用指引編號,並附上工具檢查結果 9. 以 DFD 進行威脅建模 9.1 為什麼威脅建模使用 DFD 9.2 信任邊界 DFD-SEC-001 威脅建模必須使用實體 DFD,並標示所有信任邊界 9.3 STRIDE-per-element DFD-SEC-002 每個 DFD 元素都要依 STRIDE-per-element 評估,結果記錄在威脅登錄表 DFD-SEC-003 跨越信任邊界的資料流必須評估竄改、資訊洩漏與阻斷服務,並寫明防護方式 DFD-SEC-004 威脅模型必須與架構一起納入版本控制,架構變更時同步更新 9.4 威脅建模工具 9.5 隱私威脅:LINDDUN 10. 以 DFD 進行個資盤點與資料治理 10.1 為什麼個資盤點要用 DFD 10.2 DFD 與個資處理活動紀錄的對照 10.3 個資標記與自動追蹤 DFD-PRV-001 資料字典必須標示每個資料元素的個資等級,並以工具追蹤個資經過的元素 DFD-PRV-002 存放個資的資料儲存必須寫明蒐集目的、保存期限與刪除方式 DFD-PRV-003 送往外部實體的個資資料流必須寫明利用目的,跨境傳輸必須標示 DFD-PRV-004 資料流只能帶著接收方完成目的所需的個資欄位 10.4 資料血緣與資料治理 10.5 個資相關審查重點 11. 專案實務:文件、追溯、版本控制與團隊協作 11.1 DFD 在需求文件中的位置 11.2 需求追溯 DFD-PRJ-001 每個功能基元與每條邊界資料流都必須追溯到需求編號與測試案例 11.3 從 DFD 到設計與程式 DFD-PRJ-002 每個資料儲存都要有 CRUD 矩陣,確認寫入者與讀取者都已設計 11.4 版本控制與 CI DFD-PRJ-003 DFD 模型以文字格式納入版本控制,合併前由 CI 執行全部檢查 11.5 變更管理與影響分析 DFD-PRJ-004 變更 DFD 前先做影響分析,列出受影響的圖、介面、測試與文件 11.6 團隊角色與審查會議 11.7 敏捷開發中的 DFD 12. 與 ER 模型、UML、BPMN、C4 與 DDD 的整合 12.1 三種觀點互補 12.2 DFD 與 ER 模型 DFD-PRJ-005 資料儲存的資料字典定義必須與 ER 模型的屬性一致 12.3 DFD 與 UML 12.4 DFD 與 BPMN 12.5 DFD 與 C4 模型 12.6 DFD 與領域驅動設計(DDD) 12.7 跨模型對照總表 13. 繪圖與建模工具 13.1 選擇工具的原則 13.2 工具比較 13.3 Mermaid 繪製 DFD 的實務技巧 14. AI 輔助繪製與審查 14.1 AI 能做什麼、不能做什麼 14.2 建議的工作流程 14.3 AI 產出的檢查 DFD-AI-001 AI 產生的 DFD 必須轉成可檢查的模型,並通過工具檢查後才能進入審查 DFD-AI-002 AI 產生的每條資料流都必須標示需求來源,並由分析師逐條對照 DFD-AI-003 不得將個資、客戶機密或內部架構細節輸入未經組織核准的 AI 服務 15. 完整案例 15.1 案例一:ATM 提款系統 需求描述與範圍 事件清單 模型 驗證結果 資料字典 每日限額的決策表 本案例的學習重點 15.2 案例二:圖書館管理系統 需求與事件 15.3 案例三:學生選課系統 15.4 案例四:中小企業進銷存系統 15.5 練習題 練習 1:診所掛號與看診系統 練習 2:停車場自動繳費系統 練習 3:員工差旅報帳系統 16. 認證與自我評量 16.1 與 DFD 相關的認證 16.2 必備知識點與對應章節 16.3 自我評量:選擇題 16.4 自我評量:實作題 實作題 1:找出錯誤 實作題 2:補成平衡的子圖 實作題 3:決策表 16.5 參考解答與解析 17. 檢查清單 17.1 快速檢查表(Quick Checklist) 17.2 Context 圖 17.3 Level 0 圖與子圖 17.4 資料字典與處理規格 17.5 實體 DFD 與威脅建模 17.6 個資 17.7 文件、追溯與協作 17.8 AI 輔助 18. 參考資料 18.1 原始方法與教科書 18.2 標準與知識體系 18.3 威脅建模與隱私 18.4 工具與相關模型 18.5 本站相關手冊 附錄 A 指引總表 附錄 B 符號與模型格式速查 B.1 記法符號 B.2 資料字典記法 B.3 YAML 模型區段 B.4 工具檢查代碼 附錄 C v1.1 → v2.0 章節對照 附錄 D 修正說明 附錄 E 驗證紀錄 E.1 驗證環境 E.2 模型範例驗證 E.3 工具的自我測試 E.4 Mermaid 圖 E.5 程式範例 E.6 目錄與錨點 E.7 Markdown 格式 E.8 外部資訊查證 E.9 如何重現 附錄 F 待確認事項 附錄 G 版本歷史 0. 文件資訊與使用方式 0.1 文件資訊 項目 內容 文件名稱 資料流程圖 (Data Flow Diagram, DFD) 教學手冊 版本 v2.0(全面改版,章節對照見附錄 C,修正內容見附錄 D) 更新日期 2026-10-12 作者 系統分析與架構團隊 適用對象 新進系統分析師、需求分析人員、後端與資料工程師、資安人員(威脅建模)、個資管理人員、技術主管與設計審查者 文件定位 企業內部技術白皮書等級的教學手冊。目標是教會讀者「畫出正確的 DFD」,也教會讀者「審查與驗證別人畫的 DFD 是否正確」 前置知識 看得懂業務流程描述即可。第 8 章的檢查工具需要能執行 Python 3.10 以上版本 本版技術基準:下表是本手冊查證過的來源與版本(查證日 2026-10-12)。所有 YAML 模型範例都由第 8 章的 check_dfd.py 實際檢查過,所有 Mermaid 圖都以 mermaid-cli 11 實際渲染過,結果見附錄 E。 ...

October 31, 2025 · 122 min · 25854 words · Eric Cheng

GitHub使用Hugo建立個人網頁教學

GitHub使用Hugo建立個人網頁教學 文件版本: 1.0 最後更新: 2025年10月15日 適用環境: Windows 10/11 難度等級: ⭐⭐ (初級-中級) 📋 教學大綱 前置條件與工具安裝 建立 Hugo 專案 本機預覽網站 選擇與設定 Hugo Theme 部署到 GitHub Pages 維護與更新內容的流程 設定自訂網域(選用) 檢查清單(Checklist) 🎯 學習目標 完成本教學後,您將能夠: ✅ 在 Windows 環境安裝與設定 Hugo 開發環境 ✅ 建立並預覽 Hugo 靜態網站 ✅ 選擇與客製化 Hugo 主題 ✅ 使用 GitHub Actions 自動部署網站到 GitHub Pages ✅ 維護與更新網站內容 ✅ (選用)設定自訂網域名稱 1. 前置條件與工具安裝 1.1 環境需求 在開始之前,請確認您的環境符合以下需求: 作業系統: Windows 10 或更新版本 網路連線: 穩定的網際網路連線 磁碟空間: 至少 500MB 可用空間 系統權限: 能夠安裝應用程式的權限 1.2 安裝 Git Git 是版本控制工具,用於管理專案程式碼與部署到 GitHub。 1.2.1 安裝步驟 下載 Git for Windows 前往官方網站: https://git-scm.com/download/win 下載最新版本的 Git for Windows 安裝程式 執行安裝程式 雙擊下載的 .exe 檔案 建議使用預設設定,一路點選「Next」 重要選項: 編輯器選擇:建議選擇 “Use Visual Studio Code as Git’s default editor” PATH 環境變數:選擇 “Git from the command line and also from 3rd-party software” 換行字元轉換:選擇 “Checkout Windows-style, commit Unix-style line endings” 驗證安裝 開啟 PowerShell,執行以下指令: git --version 預期輸出類似: git version 2.43.0.windows.1 設定 Git 使用者資訊 git config --global user.name "您的名字" git config --global user.email "your.email@example.com" 1.2.2 流程圖 graph TD A[下載 Git 安裝程式] --> B[執行安裝程式] B --> C[選擇安裝選項] C --> D[完成安裝] D --> E[開啟 PowerShell] E --> F[驗證 git --version] F --> G{版本顯示正確?} G -->|是| H[設定使用者資訊] G -->|否| I[重新安裝] I --> B H --> J[Git 安裝完成] ⚠️ 注意事項 安裝後需要重新開啟 PowerShell 才能使用 git 指令 使用者名稱與 Email 會顯示在您的 Git 提交記錄中 建議使用與 GitHub 帳號相同的 Email 1.3 安裝 Hugo Hugo 是一個快速的靜態網站產生器,使用 Go 語言開發。 安裝方式(使用 Chocolatey) 方法一:使用 Chocolatey(推薦) 安裝 Chocolatey 套件管理器 以系統管理員權限開啟 PowerShell,執行: Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1')) 安裝 Hugo Extended 版本 choco install hugo-extended -y 💡 為什麼選擇 Extended 版本? Extended 版本支援 SCSS/SASS 處理,許多現代主題需要此功能。 驗證安裝 關閉並重新開啟 PowerShell(一般權限即可),執行: hugo version 預期輸出類似: hugo v0.121.1-00b46fed8e47f7bb0a85d7cfc2d9f1356379dca7+extended windows/amd64 BuildDate=2023-12-08T08:47:45Z VendorInfo=gohugoio 方法二:手動下載安裝 前往 Hugo GitHub Releases: https://github.com/gohugoio/hugo/releases 下載 hugo_extended_x.xx.x_windows-amd64.zip 解壓縮到 C:\Hugo\bin 將 C:\Hugo\bin 加入系統 PATH 環境變數 1.3.1 設定流程圖 graph LR A[選擇安裝方式] --> B{Chocolatey 或 手動?} B -->|Chocolatey| C[安裝 Chocolatey] B -->|手動| D[下載 Hugo ZIP] C --> E[choco install hugo-extended] D --> F[解壓縮到 C:\Hugo\bin] F --> G[設定 PATH 環境變數] E --> H[驗證: hugo version] G --> H H --> I{安裝成功?} I -->|是| J[完成] I -->|否| K[檢查 PATH 設定] 1.3.2 注意事項 務必安裝 Extended 版本,而非標準版本 手動安裝時,確認 PATH 環境變數設定正確 某些防毒軟體可能會阻擋 Chocolatey 安裝,需暫時停用 1.4 安裝 VS Code Visual Studio Code 是微軟開發的輕量級程式碼編輯器。 1.4.1 安裝步驟 下載 VS Code 前往官方網站: https://code.visualstudio.com/ 點選 “Download for Windows” 執行安裝程式 雙擊下載的 .exe 檔案 建議勾選的選項: ☑️ 將「透過 Code 開啟」加入 Windows 檔案總管目錄內容功能表 ☑️ 將「透過 Code 開啟」加入 Windows 檔案總管檔案內容功能表 ☑️ 將 Code 註冊為支援的檔案類型編輯器 ☑️ 將 Code 加入 PATH 安裝推薦的擴充套件 開啟 VS Code 後,安裝以下擴充套件(Extensions): Hugo Language and Syntax Support (作者: budparr) Markdown All in One (作者: Yu Zhang) Git Graph (作者: mhutchie) 安裝方式:按 Ctrl+Shift+X 開啟擴充套件面板,搜尋並安裝。 1.4.2 注意事項 VS Code 會自動偵測系統已安裝的 Git 建議啟用自動儲存功能:File > Auto Save 1.5 申請 GitHub 帳號 如果您還沒有 GitHub 帳號,請依照以下步驟申請。 申請步驟 前往 GitHub 官網 網址: https://github.com/ 註冊帳號 點選右上角的 “Sign up” 輸入 Email、密碼、使用者名稱 完成驗證(Captcha) 選擇免費方案(Free) 驗證 Email 登入您的 Email 信箱 點選 GitHub 寄送的驗證連結 完成個人資料設定 建議上傳大頭照 填寫簡介(Bio) 1.5.1 注意事項 GitHub 使用者名稱將成為您的網站網址的一部分:https://username.github.io 使用者名稱一旦設定後更改較為繁瑣,請謹慎選擇 建議使用與工作相關的專業名稱 1.6 環境檢查總覽 完成所有安裝後,請執行以下指令檢查環境: # 檢查 Git git --version # 檢查 Hugo hugo version # 檢查 VS Code(開啟 VS Code) code --version 預期輸出範例: PS C:\Users\YourName> git --version git version 2.43.0.windows.1 PS C:\Users\YourName> hugo version hugo v0.121.1-00b46fed8e47f7bb0a85d7cfc2d9f1356379dca7+extended windows/amd64 BuildDate=2023-12-08T08:47:45Z VendorInfo=gohugoio PS C:\Users\YourName> code --version 1.85.0 0ee08df0cf4527e40edc9aa28f4b5bd38bbff2b2 x64 系統架構圖 graph TB subgraph "開發環境" A[Windows 10/11] B[Git] C[Hugo Extended] D[VS Code] end subgraph "雲端服務" E[GitHub Account] F[GitHub Repository] G[GitHub Pages] end A --> B A --> C A --> D B --> F C --> H[本地網站] H --> F F --> G E --> F style A fill:#e1f5ff style E fill:#fff4e1 style G fill:#e8f5e9 2. 建立 Hugo 專案 2.1 建立專案資料夾 首先,選擇一個適當的位置建立您的 Hugo 專案。 操作步驟 開啟 PowerShell 導航到適當的目錄 # 例如:在 D 槽建立專案 cd D:\developer\repos 使用 Hugo 建立新專案 hugo new site my-website 其中 my-website 是您的專案名稱,可自行更改。 進入專案資料夾 cd my-website 預期輸出結果 Congratulations! Your new Hugo site is created in D:\developer\repos\my-website. Just a few more steps and you're ready to go: 1. Download a theme into the same-named folder. Choose a theme from https://themes.gohugo.io/ or create your own with the "hugo new theme <THEMENAME>" command. 2. Perhaps you want to add some content. You can add single files with "hugo new <SECTIONNAME>\<FILENAME>.<FORMAT>". 3. Start the built-in live server via "hugo server". Visit https://gohugo.io/ for quickstart guide and full documentation. 2.2 專案結構說明 Hugo 專案建立後,會產生以下目錄結構: my-website/ ├── archetypes/ # 內容範本 │ └── default.md ├── assets/ # 需要處理的資源(SCSS、JS 等) ├── content/ # 網站內容(Markdown 文件) ├── data/ # 資料檔案(JSON、YAML、TOML) ├── layouts/ # 自訂版面配置 ├── static/ # 靜態檔案(圖片、CSS、JS) ├── themes/ # 主題資料夾 └── hugo.toml # 網站設定檔(或 config.toml) 各目錄功能說明 目錄/檔案 用途 是否必要 archetypes/ 定義新內容的預設前置資料(Front Matter) ⭐⭐⭐ content/ 存放網站的所有內容文章(Markdown) ⭐⭐⭐⭐⭐ data/ 存放結構化資料供模板使用 ⭐⭐ layouts/ 自訂 HTML 模板覆寫主題 ⭐⭐⭐ static/ 直接複製到網站根目錄的靜態檔案 ⭐⭐⭐⭐ themes/ 安裝的主題 ⭐⭐⭐⭐⭐ hugo.toml 網站主要設定檔 ⭐⭐⭐⭐⭐ 2.3 初始化 Git 儲存庫 將專案加入版本控制管理。 # 初始化 Git git init # 建立 .gitignore 檔案 @" # Hugo 產生的檔案 /public/ /resources/_gen/ /.hugo_build.lock # 作業系統檔案 .DS_Store Thumbs.db # 編輯器檔案 .vscode/ .idea/ *.swp *.swo *~ "@ | Out-File -FilePath .gitignore -Encoding utf8 # 加入所有檔案 git add . # 第一次提交 git commit -m "Initial commit: Hugo site created" 2.3.1 流程圖 graph LR A[hugo new site my-website] --> B[建立專案結構] B --> C[cd my-website] C --> D[git init] D --> E[建立 .gitignore] E --> F[git add .] F --> G[git commit] G --> H[專案建立完成] style H fill:#c8e6c9 2.4 設定基本網站資訊 編輯 hugo.toml(或 config.toml)設定檔。 使用 VS Code 開啟專案 code . 編輯 hugo.toml 找到並編輯 hugo.toml 檔案: baseURL = 'https://yourusername.github.io/' languageCode = 'zh-tw' title = '我的個人網站' theme = '' # 稍後設定 [params] description = "這是我的個人網站,分享技術文章與生活點滴" author = "您的名字" [menu] [[menu.main]] name = "首頁" url = "/" weight = 1 [[menu.main]] name = "文章" url = "/posts/" weight = 2 [[menu.main]] name = "關於" url = "/about/" weight = 3 2.4.1 注意事項 baseURL 需要改成您的 GitHub Pages 網址:https://您的GitHub使用者名稱.github.io/ languageCode 設定為 zh-tw 可支援繁體中文 theme 欄位在安裝主題後填入 2.4.2 實務建議 安全性: 不要在設定檔中儲存敏感資訊(API Keys、密碼等) 效能: 保持設定檔簡潔,避免過多不必要的參數 可維護性: 為每個設定項目加上註解說明用途 3. 本機預覽網站 3.1 啟動 Hugo 開發伺服器 Hugo 內建開發伺服器,支援即時預覽(Live Reload)。 啟動指令 hugo server -D 參數說明: server: 啟動開發伺服器 -D: 顯示草稿(Draft)狀態的文章 3.1.1 預期輸出 Start building sites … hugo v0.121.1-00b46fed8e47f7bb0a85d7cfc2d9f1356379dca7+extended windows/amd64 BuildDate=2023-12-08T08:47:45Z VendorInfo=gohugoio | ZH-TW -------------------+-------- Pages | 3 Paginator pages | 0 Non-page files | 0 Static files | 0 Processed images | 0 Aliases | 0 Sitemaps | 1 Cleaned | 0 Built in 45 ms Environment: "development" Serving pages from memory Running in Fast Render Mode. For full rebuilds on change: hugo server --disableFastRender Web Server is available at http://localhost:1313/ (bind address 127.0.0.1) Press Ctrl+C to stop 3.2 在瀏覽器中預覽 開啟瀏覽器 前往 http://localhost:1313/ 您應該會看到一個空白或基本的網站(尚未安裝主題) 常用的開發伺服器參數 # 顯示草稿文章 hugo server -D # 指定埠號 hugo server --port 8080 # 允許外部存取(區域網路) hugo server --bind 0.0.0.0 --baseURL http://你的IP:1313 # 停用 Fast Render(完整重建) hugo server --disableFastRender # 開啟詳細日誌 hugo server --verbose 3.3 建立第一篇文章 使用指令建立文章 hugo new posts/my-first-post.md 這會在 content/posts/ 目錄下建立 my-first-post.md 檔案。 編輯文章內容 使用 VS Code 開啟 content/posts/my-first-post.md: --- title: "我的第一篇文章" date: 2025-10-15T10:00:00+08:00 draft: false tags: ["Hugo", "部落格"] categories: ["教學"] --- ## 歡迎來到我的部落格! 這是我使用 Hugo 建立的第一篇文章。 ### Hugo 的優點 - 🚀 建置速度極快 - 📝 使用 Markdown 撰寫 - 🎨 豐富的主題選擇 - 🔧 高度可客製化 ### 程式碼範例 ```python def hello_hugo(): print("Hello, Hugo!") hello_hugo() 祝大家使用愉快! Front Matter 說明 Front Matter 是文章開頭的 YAML/TOML 區塊,定義文章的詮釋資料: 欄位 說明 範例 title 文章標題 “我的第一篇文章” date 發布日期 2025-10-15T10:00:00+08:00 draft 是否為草稿 true / false tags 標籤 [“Hugo”, “部落格”] categories 分類 [“教學”] author 作者 “Your Name” description 摘要 “本文介紹…” 3.4 即時預覽更新 儲存文章後,Hugo 會自動重建網站,瀏覽器會自動重新整理顯示最新內容。 開發流程圖 sequenceDiagram participant Dev as 開發者 participant VSCode as VS Code participant Hugo as Hugo Server participant Browser as 瀏覽器 Dev->>VSCode: 編輯 .md 檔案 VSCode->>VSCode: 自動儲存 VSCode->>Hugo: 檔案變更通知 Hugo->>Hugo: 重新建置網站 Hugo->>Browser: WebSocket 推送更新 Browser->>Browser: 自動重新整理 Browser-->>Dev: 顯示最新內容 3.5 停止開發伺服器 在 PowerShell 中按下 Ctrl + C 即可停止伺服器。 3.5.1 注意事項 開發伺服器僅供本地開發使用,不適合正式部署 預設僅監聽 localhost,外部無法存取 修改 hugo.toml 後需要重新啟動伺服器 3.5.2 實務建議 開發習慣: 保持開發伺服器運行,善用即時預覽功能 效能: 大型網站可使用 --disableFastRender 確保完整重建 安全性: 不要在開發伺服器上使用正式環境的 API Key 4. 選擇與設定 Hugo Theme 4.1 選擇適合的主題 Hugo 擁有豐富的主題生態系統,您可以從官方主題庫選擇。 主題推薦 主題名稱 特色 適用情境 難度 PaperMod 極簡、快速、SEO 友善 個人部落格 ⭐⭐ Hugo-Theme-Stack 現代化、多功能 技術部落格 ⭐⭐⭐ Ananke 官方推薦、簡潔 初學者 ⭐ LoveIt 功能豐富、中文支援佳 個人網站 ⭐⭐⭐ Academic/Wowchemy 學術型網站 研究人員、教師 ⭐⭐⭐⭐ 瀏覽主題 前往 Hugo 官方主題庫:https://themes.gohugo.io/ 選擇考量因素 mindmap root((Hugo 主題選擇)) 設計風格 極簡主義 多彩豐富 專業商務 個人創意 功能需求 部落格 作品集 文件網站 電商展示 技術要求 是否需要 Extended 版本 相依套件複雜度 客製化難易度 維護狀態 最後更新時間 Star 數量 Issue 處理速度 文件完整性 4.2 安裝主題(以 PaperMod 為例) 方法一:使用 Git Submodule(推薦) 使用 Git Submodule 可以方便地更新主題。 # 確認在專案根目錄 cd D:\developer\repos\my-website # 加入主題作為 Submodule git submodule add --depth=1 https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod # 更新 Submodule git submodule update --init --recursive 方法二:直接下載主題 # 下載並解壓縮到 themes 資料夾 # 手動從 GitHub 下載 ZIP 並解壓縮到 themes/PaperMod/ 方法三:使用 Hugo Modules(進階) # 初始化 Hugo Module hugo mod init github.com/yourusername/my-website # 在 hugo.toml 中加入 # [module] # [[module.imports]] # path = "github.com/adityatelange/hugo-PaperMod" 安裝流程圖 graph TD A[選擇安裝方式] --> B{Git Submodule?} B -->|是| C[git submodule add] B -->|否| D{Hugo Modules?} D -->|是| E[hugo mod init + 設定] D -->|否| F[手動下載 ZIP] C --> G[更新 hugo.toml] E --> G F --> G G --> H[設定 theme = 'PaperMod'] H --> I[重啟 hugo server] I --> J[檢查網站外觀] style J fill:#c8e6c9 4.3 設定主題 4.3.1 編輯 hugo.toml baseURL = 'https://yourusername.github.io/' languageCode = 'zh-tw' title = '我的技術部落格' theme = 'PaperMod' # 啟用 emoji 支援 enableEmoji = true # 設定摘要長度 summaryLength = 70 # 設定分頁 paginate = 10 [params] # 網站描述 description = "分享程式開發、技術學習與生活心得" # 作者資訊 author = "Your Name" # 顯示閱讀時間 ShowReadingTime = true # 顯示分享按鈕 ShowShareButtons = true # 顯示文章目錄 ShowToc = true TocOpen = false # 顯示程式碼複製按鈕 ShowCodeCopyButtons = true # 首頁資訊 [params.homeInfoParams] Title = "歡迎來到我的部落格 👋" Content = """ 這裡分享我的技術學習筆記、專案經驗與生活點滴。 - 🔧 主要技術: Java, Python, Go - 📚 專注領域: 後端開發、DevOps - 💡 持續學習中... """ # 社群媒體連結 [[params.socialIcons]] name = "github" url = "https://github.com/yourusername" [[params.socialIcons]] name = "linkedin" url = "https://linkedin.com/in/yourprofile" [[params.socialIcons]] name = "email" url = "mailto:your.email@example.com" # 選單設定 [menu] [[menu.main]] identifier = "home" name = "首頁" url = "/" weight = 10 [[menu.main]] identifier = "posts" name = "文章" url = "/posts/" weight = 20 [[menu.main]] identifier = "archives" name = "歸檔" url = "/archives/" weight = 30 [[menu.main]] identifier = "tags" name = "標籤" url = "/tags/" weight = 40 [[menu.main]] identifier = "about" name = "關於" url = "/about/" weight = 50 # 語法高亮設定 [markup] [markup.highlight] style = "monokai" lineNos = true lineNumbersInTable = true noClasses = false 4.4 建立必要頁面 建立關於頁面 hugo new about.md 編輯 content/about.md: --- title: "關於我" date: 2025-10-15 draft: false ShowToc: false --- ## 👨‍💻 自我介紹 哈囉!我是 [Your Name],是一位熱愛技術的軟體工程師。 ### 技能 - **程式語言**: Java, Python, JavaScript - **框架**: Spring Boot, Django, React - **工具**: Git, Docker, Jenkins ### 興趣 - 📖 閱讀技術書籍 - 🏃‍♂️ 慢跑 - 📷 攝影 ### 聯絡方式 - Email: your.email@example.com - GitHub: [@yourusername](https://github.com/yourusername) 建立歸檔頁面 hugo new archives.md 編輯 content/archives.md: --- title: "文章歸檔" layout: "archives" url: "/archives/" summary: archives --- 4.5 客製化主題樣式(選用) 覆寫 CSS 建立 assets/css/extended/custom.css: /* 自訂顏色 */ :root { --primary: #1e88e5; --secondary: #424242; } /* 自訂標題樣式 */ .post-title { font-size: 2rem; font-weight: 700; } /* 自訂程式碼區塊 */ .highlight { border-radius: 8px; padding: 1rem; } /* 響應式調整 */ @media (max-width: 768px) { .post-title { font-size: 1.5rem; } } 覆寫部分模板 如需客製化 HTML 結構,可在 layouts/ 資料夾中覆寫主題檔案: layouts/ ├── _default/ │ └── single.html # 覆寫單篇文章版面 ├── partials/ │ └── footer.html # 覆寫頁尾 └── shortcodes/ └── youtube.html # 自訂 shortcode 4.6 驗證主題設定 重啟開發伺服器 # 停止目前的 server (Ctrl+C) # 重新啟動 hugo server -D 檢查項目 ✅ 網站外觀符合主題風格 ✅ 選單項目正確顯示 ✅ 社群媒體圖示正常 ✅ 文章列表正確顯示 ✅ 語法高亮運作正常 ✅ 響應式設計在手機上正常 主題設定流程總覽 graph TB A[瀏覽主題庫] --> B[選擇適合主題] B --> C[使用 Git Submodule 安裝] C --> D[編輯 hugo.toml 設定] D --> E[建立必要頁面] E --> F{需要客製化?} F -->|是| G[建立自訂 CSS/Template] F -->|否| H[完成主題設定] G --> H H --> I[重啟 hugo server 驗證] style H fill:#c8e6c9 4.6.1 注意事項 不同主題的設定參數可能不同,請參考主題的官方文件 使用 Git Submodule 時,更新主題需使用 git submodule update --remote 客製化前建議先備份原始主題檔案 過度客製化可能導致主題更新困難 4.6.2 實務建議 選擇策略: 優先選擇維護活躍、文件完整的主題 效能考量: 避免選擇過於臃腫、載入緩慢的主題 SEO 優化: 確認主題支援 Open Graph、Twitter Cards 等 meta 標籤 可維護性: 使用覆寫(override)方式客製化,而非直接修改主題檔案 5. 部署到 GitHub Pages 5.1 建立 GitHub Repository 步驟說明 登入 GitHub 前往 https://github.com 並登入 建立新的 Repository 點選右上角的 + 號 選擇 “New repository” Repository 設定 Repository name: yourusername.github.io ⚠️ 必須使用 使用者名稱.github.io 格式 Description: “My personal website built with Hugo” Public: 選擇 Public(免費用戶只能使用 Public repo 的 GitHub Pages) 不要勾選: Initialize this repository with a README 建立 Repository 點選 “Create repository” Repository 命名規則 graph LR A[GitHub 使用者名稱] --> B[yourusername] B --> C[Repository 名稱] C --> D[yourusername.github.io] D --> E[網站網址] E --> F[https://yourusername.github.io] style F fill:#e1f5ff 5.2 連結本地專案與遠端 Repository 在專案目錄中執行以下指令: # 設定遠端 Repository git remote add origin https://github.com/yourusername/yourusername.github.io.git # 檢查遠端設定 git remote -v # 建立主分支(如果尚未建立) git branch -M main # 第一次推送 git push -u origin main 5.2.1 預期輸出 Enumerating objects: 15, done. Counting objects: 100% (15/15), done. Delta compression using up to 8 threads Compressing objects: 100% (10/10), done. Writing objects: 100% (15/15), 2.50 KiB | 2.50 MiB/s, done. Total 15 (delta 0), reused 0 (delta 0), pack-reused 0 To https://github.com/yourusername/yourusername.github.io.git * [new branch] main -> main Branch 'main' set up to track remote branch 'main' from 'origin'. 5.3 設定 GitHub Actions 自動部署 GitHub Actions 可以自動建置並部署 Hugo 網站。 建立 Workflow 檔案 建立 .github/workflows/hugo.yml 檔案: # 建立目錄 New-Item -ItemType Directory -Force -Path .github\workflows # 建立 workflow 檔案 New-Item -ItemType File -Path .github\workflows\hugo.yml 編輯 hugo.yml 使用 VS Code 開啟 .github/workflows/hugo.yml 並貼上以下內容: name: Deploy Hugo site to Pages on: # 當推送到 main 分支時觸發 push: branches: - main # 允許手動觸發 workflow_dispatch: # 設定 GitHub Pages 的權限 permissions: contents: read pages: write id-token: write # 避免同時執行多個部署 concurrency: group: "pages" cancel-in-progress: false # 預設使用 bash defaults: run: shell: bash jobs: # 建置工作 build: runs-on: ubuntu-latest env: HUGO_VERSION: 0.121.1 steps: - name: Install Hugo CLI run: | wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb \ && sudo dpkg -i ${{ runner.temp }}/hugo.deb - name: Install Dart Sass run: sudo snap install dart-sass - name: Checkout uses: actions/checkout@v4 with: submodules: recursive fetch-depth: 0 - name: Setup Pages id: pages uses: actions/configure-pages@v4 - name: Install Node.js dependencies run: "[[ -f package-lock.json || -f npm-shrinkwrap.json ]] && npm ci || true" - name: Build with Hugo env: # For maximum backward compatibility with Hugo modules HUGO_ENVIRONMENT: production HUGO_ENV: production run: | hugo \ --gc \ --minify \ --baseURL "${{ steps.pages.outputs.base_url }}/" - name: Upload artifact uses: actions/upload-pages-artifact@v2 with: path: ./public # 部署工作 deploy: environment: name: github-pages url: ${{ steps.deployment.outputs.page_url }} runs-on: ubuntu-latest needs: build steps: - name: Deploy to GitHub Pages id: deployment uses: actions/deploy-pages@v3 Workflow 檔案說明 區段 說明 on.push.branches 觸發條件:推送到 main 分支 permissions 授予 workflow 必要的權限 jobs.build 建置工作:安裝 Hugo、建置網站 jobs.deploy 部署工作:將產生的檔案部署到 GitHub Pages HUGO_VERSION 指定 Hugo 版本(建議與本地相同) 5.4 設定 GitHub Pages 在 GitHub 網站上設定 前往您的 Repository 頁面 點選 Settings 在左側選單選擇 Pages 在 “Build and deployment” 區段: Source: 選擇 “GitHub Actions” 儲存設定 5.4.1 設定流程圖 graph TD A[進入 Repository Settings] --> B[選擇 Pages] B --> C[Source 選擇 GitHub Actions] C --> D[儲存設定] D --> E[等待 Workflow 執行] E --> F{部署成功?} F -->|是| G[訪問 username.github.io] F -->|否| H[檢查 Actions 錯誤訊息] H --> I[修正問題] I --> J[重新推送] J --> E style G fill:#c8e6c9 5.5 推送並觸發部署 # 加入 GitHub Actions workflow git add .github/workflows/hugo.yml # 提交變更 git commit -m "Add GitHub Actions workflow for Hugo deployment" # 推送到 GitHub git push origin main 5.6 監控部署狀態 查看 Actions 執行狀態 前往 Repository 頁面 點選 Actions 標籤 查看最新的 workflow 執行狀態 部署成功標誌 ✅ build 工作完成 ✅ deploy 工作完成 ✅ 顯示綠色勾勾 訪問您的網站 部署成功後,前往 https://yourusername.github.io/ 查看您的網站! 5.7 部署流程完整視圖 sequenceDiagram participant Dev as 開發者 participant Local as 本地 Git participant GitHub as GitHub Repo participant Actions as GitHub Actions participant Pages as GitHub Pages participant User as 訪客 Dev->>Local: git commit & push Local->>GitHub: 推送程式碼 GitHub->>Actions: 觸發 Workflow Actions->>Actions: 安裝 Hugo Actions->>Actions: 建置網站 (hugo build) Actions->>Actions: 產生 public/ 目錄 Actions->>Pages: 部署靜態檔案 Pages->>Pages: 網站上線 User->>Pages: 訪問網站 Pages->>User: 回傳網頁內容 5.8 常見部署問題與解決方案 問題 1: Workflow 執行失敗 原因: Hugo 版本不匹配或主題問題 解決方案: # 檢查本地 Hugo 版本 hugo version # 在 hugo.yml 中設定相同版本 env: HUGO_VERSION: 0.121.1 # 與本地版本一致 問題 2: 主題無法載入 原因: Git Submodule 未正確同步 解決方案: # 在 Checkout 步驟中確保包含 - name: Checkout uses: actions/checkout@v4 with: submodules: recursive # 重要! fetch-depth: 0 問題 3: baseURL 設定錯誤 原因: hugo.toml 中的 baseURL 不正確 解決方案: # hugo.toml baseURL = 'https://yourusername.github.io/' # 結尾要有斜線 問題 4: CSS/JS 無法載入 原因: 相對路徑問題 解決方案: # 在 Build with Hugo 步驟中使用正確的 baseURL run: | hugo \ --gc \ --minify \ --baseURL "${{ steps.pages.outputs.base_url }}/" 5.9 效能優化建議 啟用快取 在 workflow 中加入快取步驟: - name: Cache Hugo resources uses: actions/cache@v3 with: path: resources key: ${{ runner.os }}-hugo-resources-${{ hashFiles('content/**') }} 圖片優化 # 使用 Hugo 的圖片處理功能 # 在文章中使用 Hugo 的 image processing 在 Markdown 中: 啟用 CDN(選用) 考慮使用 Cloudflare Pages 或其他 CDN 服務提升全球存取速度。 5.7.1 注意事項 GitHub Pages 有 1GB 儲存空間限制 每月頻寬限制 100GB 部署次數建議不要過於頻繁(每小時不超過 10 次) 私有 Repository 需要 GitHub Pro 方案才能使用 Pages 5.7.2 實務建議 安全性: 不要在 Repository 中儲存敏感資訊(API Keys、密碼) 效能: 使用圖片壓縮工具減少檔案大小 SEO: 確保 sitemap.xml 和 robots.txt 正確設定 可維護性: 定期更新 Hugo 版本和主題 6. 維護與更新內容的流程 6.1 日常更新工作流程 建立文章並部署的標準流程如下: 標準工作流程 graph TD A[開啟 VS Code] --> B[啟動 hugo server -D] B --> C[建立新文章] C --> D[撰寫內容] D --> E[本機預覽] E --> F{內容滿意?} F -->|否| D F -->|是| G[設定 draft: false] G --> H[git add .] H --> I[git commit -m 訊息] I --> J[git push origin main] J --> K[GitHub Actions 自動部署] K --> L[網站更新完成] style L fill:#c8e6c9 詳細步驟 步驟 1: 建立新文章 # 建立新文章 hugo new posts/2025/my-new-post.md # 或使用日期目錄結構 hugo new posts/2025-10-15-my-new-post.md 步驟 2: 編輯文章內容 --- title: "深入理解 Java Stream API" date: 2025-10-15T14:30:00+08:00 draft: false tags: ["Java", "Stream API", "函數式編程"] categories: ["程式設計"] author: "Your Name" description: "本文詳細介紹 Java 8 引入的 Stream API,包含常用操作與最佳實踐" cover: image: "images/java-stream.png" alt: "Java Stream API" caption: "Stream API 讓集合操作更優雅" --- ## 前言 Java 8 引入的 Stream API 徹底改變了集合處理的方式... ## 基本概念 Stream 是一個資料序列,支援各種操作來處理資料... ### 建立 Stream \`\`\`java // 從集合建立 List<String> list = Arrays.asList("a", "b", "c"); Stream<String> stream = list.stream(); // 從陣列建立 String[] array = {"a", "b", "c"}; Stream<String> stream2 = Arrays.stream(array); \`\`\` ## 常用操作 ### Filter(過濾) \`\`\`java list.stream() .filter(s -> s.startsWith("a")) .collect(Collectors.toList()); \`\`\` ## 總結 Stream API 提供了簡潔且高效的集合處理方式... 步驟 3: 本機預覽 # 如果 server 未啟動,執行 hugo server -D # 在瀏覽器開啟 http://localhost:1313/ 步驟 4: 提交並部署 # 檢查變更 git status # 加入所有變更 git add . # 提交(使用有意義的訊息) git commit -m "新增文章: 深入理解 Java Stream API" # 推送到 GitHub git push origin main 步驟 5: 等待部署完成 前往 GitHub Repository 的 Actions 頁面 確認 workflow 執行成功 訪問網站確認更新 6.2 Git 提交訊息最佳實踐 提交訊息格式 <類型>: <簡短描述> <詳細描述(選用)> <相關 Issue(選用)> 常用類型 類型 說明 範例 feat 新功能 feat: 新增留言功能 post 新文章 post: 新增 Java Stream API 教學 fix 修正錯誤 fix: 修正文章日期顯示問題 style 樣式調整 style: 更新首頁配色 docs 文件更新 docs: 更新 README refactor 重構 refactor: 重新組織文章分類 config 設定變更 config: 更新 hugo.toml 設定 範例 # 好的提交訊息 git commit -m "post: 新增 Docker 容器化部署教學" git commit -m "fix: 修正文章中程式碼區塊的語法高亮" git commit -m "style: 調整文章標題字體大小" # 不好的提交訊息(避免) git commit -m "update" git commit -m "fix bug" git commit -m "change" 6.3 管理草稿文章 草稿工作流程 stateDiagram-v2 [*] --> 草稿: hugo new post.md 草稿 --> 預覽: hugo server -D 預覽 --> 草稿: 繼續編輯 預覽 --> 發布: draft: false 發布 --> 線上: git push 線上 --> [*] 草稿文章不會被部署 --- title: "我的草稿文章" date: 2025-10-15 draft: true # 設為 true,不會出現在正式網站 --- 本機預覽草稿 # 包含草稿的預覽 hugo server -D # 不包含草稿的預覽(模擬正式環境) hugo server 將草稿變為正式文章 只需將 draft: true 改為 draft: false: ...

October 15, 2025 · 21 min · 4413 words · Eric Cheng

Maven 使用教學

Maven 使用教學手冊 文件資訊 版本: 3.0.0 建立日期: 2025年8月29日 最後更新: 2025年7月 適用對象: 新進開發同仁 目的: 協助快速熟悉並在專案中正確使用 Maven 目錄 Maven 基本介紹 1.1 什麼是 Maven? 1.2 Maven 的用途與優勢 1.3 在專案中的角色 環境建置 2.1 前置條件 2.2 Maven 安裝 2.3 驗證安裝成功 2.4 IDE 整合 2.5 設定檔配置 Maven 專案結構 3.1 標準目錄結構 3.2 目錄結構詳細說明 3.3 在專案中的實際應用 3.4 自訂目錄結構 pom.xml 說明 4.1 什麼是 POM? 4.2 基本結構 4.3 常用標籤詳細說明 4.4 如何新增與管理依賴 4.5 建置配置 4.6 我們專案的完整 pom.xml 分析 常用指令 5.1 Maven 生命週期 5.2 基本指令詳解 5.3 依賴管理指令 5.4 執行指令 5.5 資訊查詢指令 5.6 進階指令 5.7 我們專案中的常用工作流程 5.8 VS Code 中的 Maven 整合 5.9 Maven Wrapper 使用 5.10 與 CI/CD 整合 專案最佳實務 6.1 依賴管理建議 6.2 Docker 整合 6.3 安全性管理 6.4 效能監控 6.5 現代化開發實務 6.6 效能優化策略 6.7 微服務架構支援 6.8 避免版本衝突的方法 6.9 建置優化策略 6.10 程式碼品質管理 6.11 使用公司內部 Nexus/Artifactory 6.12 環境特定設定 常見問題排解 FAQ 7.1 編譯相關問題 7.2 依賴相關問題 7.3 測試相關問題 7.4 IDE 整合問題 7.5 效能相關問題 7.6 網路相關問題 7.7 專案中注意事項 附錄 8.1 官方文件與教學資源連結 8.2 常用插件參考 8.3 Maven 生命週期詳細說明 8.4 常用 Maven 屬性 8.5 範例設定檔 8.6 團隊協作指南 檢查清單 Checklist 9.1 環境設定檢查清單 9.2 日常開發檢查清單 9.3 問題排解檢查清單 9.4 發布準備檢查清單 9.5 新人上手檢查清單 9.6 定期維護檢查清單 快速參考手冊 10.1 常用指令速查表 10.2 常用參數速查表 10.3 POM 檔案基本結構速查 10.4 常見問題快速解決 10.5 開發工作流程檢查清單 10.6 實用技巧 進階主題 11.1 自定義 Maven Archetype 11.2 Maven 插件開發 11.3 Maven 與 Spring Boot 整合 11.4 Maven 與容器化部署 11.5 企業級 Maven 倉庫管理 團隊協作與規範 12.1 程式碼審查規範 12.2 版本管理策略 12.3 分支管理與 Maven 12.4 自動化測試策略 Maven 與現代 Java 開發 13.1 Java 模組系統(JPMS)與 Maven 13.2 Maven 與 JDK 版本管理 13.3 Maven 與記錄(Records)和文字區塊 13.4 Maven 與虛擬執行緒 13.5 Maven 4 預覽與未來展望 效能調校與監控 14.1 Maven 建置效能優化 14.2 依賴解析效能調校 14.3 建置時間監控與分析 14.4 記憶體使用最佳化 錯誤處理與除錯技巧 15.1 常見錯誤診斷流程 15.2 除錯工具與技巧 15.3 日誌分析與解讀 15.4 遠端除錯設定 實戰專案範例 16.1 簡單控制台應用程式 16.2 Spring Boot Web 應用程式 16.3 多模組企業級專案 16.4 微服務架構專案 1. Maven 基本介紹 1.1 什麼是 Maven? Apache Maven 是一個專案管理和建置自動化工具,主要用於 Java 專案(也支援其他語言如 C#、Ruby、Scala 等)。Maven 使用專案物件模型(Project Object Model, POM)來管理專案的建置、報告和文件。 ...

July 15, 2025 · 38 min · 8024 words · Eric Cheng