# 檢查 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

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.

my-website/
├── archetypes/          # 內容範本
│   └── default.md
├── assets/              # 需要處理的資源（SCSS、JS 等）
├── content/             # 網站內容（Markdown 文件）
├── data/                # 資料檔案（JSON、YAML、TOML）
├── layouts/             # 自訂版面配置
├── static/              # 靜態檔案（圖片、CSS、JS）
├── themes/              # 主題資料夾
└── hugo.toml           # 網站設定檔（或 config.toml）

# 初始化 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"

code .

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

hugo server -D

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

# 顯示草稿文章
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

hugo new 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 會自動重建網站，瀏覽器會自動重新整理顯示最新內容。

#### 開發流程圖

```mermaid
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: 顯示最新內容

# 確認在專案根目錄
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 Module
hugo mod init github.com/yourusername/my-website

# 在 hugo.toml 中加入
# [module]
#   [[module.imports]]
#     path = "github.com/adityatelange/hugo-PaperMod"

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

hugo new 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

---
title: "文章歸檔"
layout: "archives"
url: "/archives/"
summary: archives
---

/* 自訂顏色 */
: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;
    }
}

layouts/
├── _default/
│   └── single.html    # 覆寫單篇文章版面
├── partials/
│   └── footer.html    # 覆寫頁尾
└── shortcodes/
    └── youtube.html   # 自訂 shortcode

# 停止目前的 server (Ctrl+C)
# 重新啟動
hugo server -D

# 設定遠端 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

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'.

# 建立目錄
New-Item -ItemType Directory -Force -Path .github\workflows

# 建立 workflow 檔案
New-Item -ItemType File -Path .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

# 加入 GitHub Actions workflow
git add .github/workflows/hugo.yml

# 提交變更
git commit -m "Add GitHub Actions workflow for Hugo deployment"

# 推送到 GitHub
git push origin main

# 檢查本地 Hugo 版本
hugo version

# 在 hugo.yml 中設定相同版本
env:
  HUGO_VERSION: 0.121.1  # 與本地版本一致

# 在 Checkout 步驟中確保包含
- name: Checkout
  uses: actions/checkout@v4
  with:
    submodules: recursive  # 重要！
    fetch-depth: 0

# hugo.toml
baseURL = 'https://yourusername.github.io/'  # 結尾要有斜線

# 在 Build with Hugo 步驟中使用正確的 baseURL
run: |
  hugo \
    --gc \
    --minify \
    --baseURL "${{ steps.pages.outputs.base_url }}/"

- name: Cache Hugo resources
  uses: actions/cache@v3
  with:
    path: resources
    key: ${{ runner.os }}-hugo-resources-${{ hashFiles('content/**') }}

# 使用 Hugo 的圖片處理功能
# 在文章中使用 Hugo 的 image processing

# 建立新文章
hugo new posts/2025/my-new-post.md

# 或使用日期目錄結構
hugo new posts/2025-10-15-my-new-post.md

---
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 提供了簡潔且高效的集合處理方式...

# 如果 server 未啟動，執行
hugo server -D

# 在瀏覽器開啟 http://localhost:1313/

# 檢查變更
git status

# 加入所有變更
git add .

# 提交（使用有意義的訊息）
git commit -m "新增文章: 深入理解 Java Stream API"

# 推送到 GitHub
git push origin main

<類型>: <簡短描述>

<詳細描述（選用）>

<相關 Issue（選用）>

# 好的提交訊息
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"

---
title: "我的草稿文章"
date: 2025-10-15
draft: true  # 設為 true，不會出現在正式網站
---

# 包含草稿的預覽
hugo server -D

# 不包含草稿的預覽（模擬正式環境）
hugo server

---
title: "我的草稿文章"
date: 2025-10-15
draft: false  # 改為 false
---

static/
└── images/
    └── 2025/
        └── java-stream.png

![Java Stream](/images/2025/java-stream.png)

content/
└── posts/
    └── my-post/
        ├── index.md
        ├── featured.png
        └── diagram.png

![Diagram](diagram.png)

# 使用 Hugo 的圖片處理（需要 Extended 版本）

{{ $image := resources.Get "images/photo.jpg" }}
{{ $resized := $image.Resize "800x" }}
<img src="{{ $resized.RelPermalink }}" alt="Photo">

# 更新到最新版本
git submodule update --remote --merge

# 檢查更新
cd themes/PaperMod
git log --oneline -5

# 返回專案根目錄
cd ../..

# 提交主題更新
git add themes/PaperMod
git commit -m "chore: 更新 PaperMod 主題到最新版本"
git push origin main

# 建立本地備份
git clone https://github.com/yourusername/yourusername.github.io.git backup-$(Get-Date -Format "yyyy-MM-dd")

# 或定期下載整個 Repository

# 備份 content 資料夾
Copy-Item -Path "content" -Destination "D:\Backups\hugo-content-$(Get-Date -Format 'yyyy-MM-dd')" -Recurse

# 備份 static 資料夾
Copy-Item -Path "static" -Destination "D:\Backups\hugo-static-$(Get-Date -Format 'yyyy-MM-dd')" -Recurse

# 建立新分支
git checkout -b post/new-article

# 進行變更
# ... 編輯檔案 ...

# 提交變更
git add .
git commit -m "post: 新增文章草稿"

# 推送分支
git push -u origin post/new-article

# 在 GitHub 建立 Pull Request
# 審核後合併到 main 分支

# 建立 CNAME 檔案
echo "blog.example.com" | Out-File -FilePath static/CNAME -Encoding ascii -NoNewline

# 提交變更
git add static/CNAME
git commit -m "config: 新增自訂網域設定"
git push origin main

baseURL = 'https://blog.example.com/'

# 提交變更
git add hugo.toml
git commit -m "config: 更新 baseURL 為自訂網域"
git push origin main

# 檢查 DNS 記錄
nslookup blog.example.com

# 檢查 CNAME 記錄
nslookup -type=CNAME blog.example.com

# 測試網站連線
curl -I https://blog.example.com

PS> nslookup blog.example.com
Server:  dns.google
Address:  8.8.8.8

Non-authoritative answer:
Name:    yourusername.github.io
Address:  185.199.108.153
Aliases:  blog.example.com

# 建立新專案
hugo new site my-website

# 建立新文章
hugo new posts/my-post.md

# 本機預覽（含草稿）
hugo server -D

# 本機預覽（正式環境模擬）
hugo server

# 建置網站
hugo

# Git 操作
git add .
git commit -m "訊息"
git push origin main

# 更新主題（Git Submodule）
git submodule update --remote --merge

# 檢查 Hugo 版本
hugo version

# 檢查網站設定
hugo config