Building Your Academic Website | Hugo Academic 建站指南

Thu, 30 Oct 2025 00:00:00 +0000

📖 Language / 語言

English Version

Building Your Academic Website: A Complete Guide

🎓 About This Guide

As a researcher seeking academic positions, I needed a professional website to showcase my research accomplishments. This guide documents my complete journey of building this website using Hugo Academic (Hugo Blox) with the assistance of Claude AI (Anthropic).

This is a real story - someone with limited website experience successfully building a professional academic website.

📖 Why This Guide?

After spending considerable time exploring different approaches, I want to share:

Essential AI tips - How to effectively use AI assistants and what to do when stuck
Key decisions that save time
Common pitfalls to avoid
Practical solutions that work
Backup strategies that prevent data loss

💡 AI Can Help You Build This

Modern AI assistants like Claude, ChatGPT, and others can help you solve virtually any technical problem you encounter.

🔧 Pro Tip: When AI Gets Stuck

If you find the AI going in circles,

Open a new conversation window
Organize your problem clearly:
- What you’re trying to achieve
- What you’ve tried
- Error messages you’re seeing
- Links to previous conversations
Give the AI the big picture - Let it approach the problem from a fresh, holistic perspective

This “reset and reorganize” strategy often breaks through technical bottlenecks. It worked when I met persistent GitHub Actions deployment failures.

⚠️⚠️⚠️

1. Understanding Hugo Academic

Hugo Academic (now Hugo Blox) is a static site generator specifically designed for academics and researchers.

What is a Static Site Generator?

Converts Markdown files → HTML websites
No database needed
Fast loading, easy hosting
Perfect for academic portfolios

Key Advantages:

✅ Professional academic design
✅ Publication management
✅ CV/Resume integration
✅ Research project showcase
✅ Active community support

2. Deployment Platform: Why Netlify

The Critical Decision

Platform	Setup Time	Difficulty	Recommendation
Netlify	10 minutes	⭐ Easy	⭐⭐⭐⭐⭐
GitHub Pages	2-8 hours	⭐⭐⭐ Hard	⭐⭐

My Experience:

Initial attempt: GitHub Pages
↓
Encountered TailwindCSS compilation errors
↓
Spent 6+ hours debugging
↓
Switched to Netlify
↓
Deployed successfully in 10 minutes ✅

Understanding the Workflow:

Both approaches require GitHub for code hosting, but differ in deployment:

Your Code (Local)
 ↓
GitHub Repository (Required for both)
 ↓
 ┌─────────────────┬─────────────────┐
 │ │ │
GitHub Pages OR Netlify
(Direct deploy) (Better build system)
 ↓ ↓
Your Website Your Website
yourname.github.io yourname.netlify.app

Why Netlify Works Better:

Same GitHub account needed - Your code still lives on GitHub
Official Hugo Blox recommendation - Tested and supported
Automatic dependency handling - Solves TailwindCSS issues
Zero configuration needed - Just connect and deploy
Free tier sufficient - Perfect for academic sites
Continuous deployment - Auto-updates when you push to GitHub

Key Point: You’ll still use GitHub to store and manage your code. Netlify simply reads from your GitHub repository and builds your website with better tools.

3. Step-by-Step Setup

Phase 1: Prerequisites

# Install Hugo (macOS with Homebrew)
brew install hugo

# Verify installation
hugo version # Should be >= 0.148.0

Phase 2: Local Setup

# Clone the official template
git clone https://github.com/HugoBlox/theme-academic-cv.git my-academic-site
cd my-academic-site

# Remove template git history
rm -rf .git

# Initialize your own repository
git init
git branch -M main

# Connect to your GitHub repository
git remote add origin https://github.com/YourUsername/YourUsername.github.io.git

# First commit
git add .
git commit -m "Initial commit: Hugo Academic site"
git push -u origin main

Phase 3: Basic Configuration

Edit config/_default/hugo.yaml:

title: 'Your Name, PhD'
baseURL: 'https://yourname.netlify.app/'

Edit content/authors/admin/_index.md with your information.

Phase 4: Deploy to Netlify

Step 1: Sign up at using GitHub

Step 2: Import your repository

Step 3: Configure build settings:

Branch: main
Build command: hugo --gc --minify
Publish directory: public

Step 4: Add environment variables:

HUGO_VERSION = 0.152.1
NODE_VERSION = 20

Step 5: Deploy! Your site will be live at https://random-name.netlify.app

Step 6: Customize your URL in Site Settings → Domain Management

4. Common Issues & Solutions

Issue 1: TailwindCSS Error

Error Message:

Error: TAILWINDCSS: failed to transform
binary with name "tailwindcss" not found

Solution:

# If error occurs locally, simply ignore it
# Push to Netlify - it will work there
git push origin main

# Or install dependencies locally
npm install

Issue 2: Content Not Updating

Cause: Changes not pushed to GitHub

Solution:

git status
git add .
git commit -m "Update content"
git push origin main
# Wait 2-3 minutes for Netlify to redeploy

Issue 3: Lost Local Files

This is preventable! See the next section on backup strategy.

Issue 4: Content Folder Ignored by Git

Symptoms:

Local hugo server displays pages correctly ✅
Netlify deployment shows “Page Not Found” ❌
git status shows “nothing to commit, working tree clean”
You know the files exist locally

Root Cause:

Your content folder name matches a pattern in .gitignore, causing Git to ignore it entirely.

Example:

# .gitignore contains
resources/

# Your content structure
content/
 └── resources/ # ❌ Accidentally ignored!
 └── hugo-guide/
 └── _index.md

Diagnosis:

# Check if files are being ignored
git status --ignored

# Check specific file
git check-ignore -v content/resources/_index.md
# Output: .gitignore:10:resources/ content/resources/_index.md

Solution Options:

Option 1: Rename the folder (Simplest) ✅ Recommended

# Rename to avoid the pattern
git mv content/resources content/resource
# or
git mv content/resources content/guides

# Update your menus.yaml accordingly
url: '/resource/hugo-guide/' # Updated path

# Commit and push
git add .
git commit -m "Rename folder to avoid .gitignore conflict"
git push origin main

Option 2: Make .gitignore more specific

# Edit .gitignore
# Change: resources/
# To: /resources/ # Only ignores root-level resources/

# Force add the previously ignored files
git add -f content/resources/

# Commit and push
git commit -m "Fix: Update .gitignore and add content/resources"
git push origin main

Option 3: Add exception to .gitignore

# Add to .gitignore
resources/ # Ignore Hugo's resources
!content/resources/ # But allow content/resources

# Force add
git add -f content/resources/
git commit -m "Add content/resources with .gitignore exception"
git push origin main

Prevention Tips:

Check common .gitignore patterns before naming folders:
- Avoid: resources/, public/, static/, node_modules/
- Safe: guides/, tutorials/, docs/, posts/

Verify files are tracked:

# After creating new content folders
git status
# Should show new files, not empty

Use descriptive, unique names:

✅ content/research-guides/
✅ content/tutorials/
✅ content/documentation/
❌ content/resources/ (conflicts with Hugo's resources/)

5. ⚠️ CRITICAL: Backup Strategy

This section might save you hours of frustration.

The Problem

During development, you might accidentally:

Overwrite files with git reset --hard
Lose content during merge conflicts
Delete files unintentionally

Without backups, your content is gone.

The Solution: Multiple Backup Layers

Layer 1: Local Folder Backups 💾

THIS IS THE MOST IMPORTANT❗

After every significant editing session, backup your entire project folder:

# Basic backup command (recommended)
cp -r my-academic-site my-academic-site-backup-$(date +%Y%m%d-%H%M)

# If you get "Permission denied" error, use rsync:
rsync -av --exclude='.git' my-academic-site/ my-academic-site-backup-$(date +%Y%m%d-%H%M)/

Why this matters:

Most direct and reliable backup method
Complete snapshot independent of Git
Takes 10 seconds, can save hours of work
Easy to browse and restore

Recommended Backup Schedule:

✅ After each major content addition
✅ Before any risky Git operations
✅ At the end of each editing session
✅ Before updating Hugo or dependencies

Where to store backups:

# Create a dedicated backup folder
mkdir -p ~/Desktop/website-backups

# Backup there
cp -r my-academic-site ~/Desktop/website-backups/backup-$(date +%Y%m%d-%H%M)

Layer 2: Git Commits 📦

Commit frequently:

# After editing 1-3 files
git add .
git commit -m "Update: specific description"
git push origin main

Benefits:

Version history tracking
Can roll back to any point
Automatically synced to GitHub

Layer 3: Backup Branches 🌿

Create periodic backup branches before major changes:

# Weekly backup
git branch backup-weekly-$(date +%Y%m%d)
git push origin backup-weekly-$(date +%Y%m%d)

# Before major redesign
git branch backup-before-redesign
git push origin backup-before-redesign

Layer 4: AI Conversation Archives 🤖

When everything else fails, AI conversations can be a lifesaver.

If you’re using AI assistance extensively:

Create milestone snapshots:

When you complete a major phase (e.g., “Initial setup complete”)
Start a new conversation with: “This is a backup conversation for [date]”
Paste your complete current working version
Store outside your project folder to avoid accidental deletion

Why this works:

AI chat history persists even if local files are lost
Can reconstruct your project from conversation history
Documents your decision-making process
Useful reference when similar issues arise

Pro Tip: Don’t save every small code snippet. Instead, create comprehensive milestone backups when you reach stable states.

Backup Workflow Summary

# === Daily Workflow ===

# 1. Start editing
cd ~/my-academic-site

# 2. Make changes to content

# 3. Test locally (optional)
hugo server -D

# 4. Local backup (PRIORITY #1 - DO NOT SKIP!)
cp -r ~/my-academic-site ~/Desktop/website-backups/backup-$(date +%Y%m%d-%H%M)

# 5. Git commit (PRIORITY #2)
git add .
git commit -m "Update: what you changed"
git push origin main

# 6. Verify deployment on Netlify

# 7. (Optional) Create backup branch before major changes
git branch backup-before-major-change
git push origin backup-before-major-change

# 8. (Milestone) Archive complete version in AI conversation if needed

Remember: Backups are cheap, recreating lost work is expensive. Local backups are your first and most reliable safety net.

6. Key Lessons Learned

1. Follow Official Recommendations

Use Netlify (not GitHub Pages)
Use official templates
Don’t over-customize initially

2. Commit Frequently

# After editing 1-3 files
git add . && git commit -m "description" && git push

3. AI is Your Co-Pilot

Don’t hesitate to ask for help
Organize your questions clearly
Start fresh conversations when stuck
Keep chat histories as documentation

4. Multiple Backups Are Essential

Local folder copies (use cp or rsync)
Git commits
Backup branches
AI conversation history

5. Content > Technology

80% time: Quality content
20% time: Website styling

6. Incremental Progress

Small steps
Continuous validation
Don’t try to do everything at once

7. Success Checklist

Initial Setup:

Hugo and Git installed
GitHub repository created
Template cloned and configured
First backup created
Deployed to Netlify
Custom URL set

Content Development:

Personal profile updated
Research content added
Publications listed
CV/Resume page created
All links tested
Regular backups maintained

Maintenance:

Backup strategy established
AI conversation history organized
Mobile version tested
Peer feedback collected

Conclusion

Building an academic website is an investment:

💼 Showcase your research
🌐 Establish online presence
📚 Organize your work
🤝 Network with colleagues

Key Takeaways:

AI tools make this accessible - You don’t need to be a developer
Start fresh when stuck - New AI conversations offer new perspectives
Backup religiously - Use cp -r or rsync after every session
Organize your AI chats - They’re documentation and backups
Done > Perfect - Launch and iterate

Good luck! 🚀

About This Guide

Author: Yu-Ting Sun, PhD
Built with: Claude AI (Anthropic)
Last Updated: October 30, 2025

Source Code:

Hugo Documentation:
Hugo Blox Docs:
Netlify Docs:

中文版本

Hugo Academic 建站完整指南

🎓 關於本指南

作為求職中的研究者，我需要一個專業網站來展示研究成果。本指南記錄了我使用 Hugo Academic (Hugo Blox) 並在 Claude AI (Anthropic) 協助下建立本網站的完整歷程。

這是本人的故事 – 一個編程經驗有限的人成功建立專業學術網站。

📖 為什麼寫這份指南？

在探索了多種方案後，我想分享：

AI 使用要點 - 如何有效使用 AI 助手以及遇到瓶頸時的應對方法
節省時間的關鍵決策
常見的坑和避免踩坑的方法
真正有效的解決方案
防止資料丟失的備份策略

💡 AI 可以幫你建站

現代 AI 助手如 Claude、ChatGPT 等，可以幫你解決幾乎任何技術問題。

🔧 進階技巧：當 AI 鬼打牆時

新開一個對話窗口
有條理地整理你的問題：
- 你的目的
- 你已經嘗試的方法
- 你看到的錯誤訊息和困境
- 之前相關對話的連結
給 AI 完整的大局觀 - 讓它從一個全新的、更高的維度來解決問題

這個策略通常能突破技術瓶頸。當我遇到持續的 GitHub Actions 部署失敗時，這個方法起了作用。

1. 理解 Hugo Academic

Hugo Academic（現稱 Hugo Blox）是專為學術研究者設計的靜態網站生成器。

什麼是靜態網站生成器？

將 Markdown 文件 → 轉換為 HTML 網站
不需要資料庫
載入快速，容易託管
非常適合學術作品集

核心優勢：

✅ 專業的學術設計
✅ 論文管理功能
✅ CV/簡歷整合
✅ 研究專案展示
✅ 活躍的社群支持

2. 部署平台：為何選 Netlify

最關鍵的決策

平台	設置時間	難度	推薦度
Netlify	10分鐘	⭐ 簡單	⭐⭐⭐⭐⭐
GitHub Pages	2-8小時	⭐⭐⭐ 困難	⭐⭐

我的經驗：

初次嘗試：GitHub Pages
↓
遇到 TailwindCSS 編譯錯誤
↓
花費 6+ 小時調試
↓
改用 Netlify
↓
10 分鐘成功部署 ✅

理解工作流程：

兩種方式都需要 GitHub 來存放程式碼，但部署方式不同：

你的程式碼（本地）
 ↓
GitHub Repository（兩種方式都需要）
 ↓
 ┌─────────────────┬─────────────────┐
 │ │ │
GitHub Pages 或 Netlify
（直接部署） （更好的建置系統）
 ↓ ↓
你的網站 你的網站
yourname.github.io yourname.netlify.app

Netlify 的優勢：

同樣需要 GitHub 帳號 - 你的程式碼仍然存放在 GitHub
Hugo Blox 官方推薦 - 經過測試和支援
自動處理依賴 - 解決 TailwindCSS 問題
零配置需求 - 只需連接即可部署
免費方案足夠 - 非常適合學術網站
持續部署 - 推送到 GitHub 時自動更新

重點： 你仍然使用 GitHub 來存放和管理程式碼。Netlify 只是從你的 GitHub repository 讀取資料，並用更好的工具建置你的網站。

3. 完整建站步驟

階段 1：準備工作

# 安裝 Hugo（macOS + Homebrew）
brew install hugo

# 驗證安裝
hugo version # 應該 >= 0.148.0

階段 2：本地設置

# Clone 官方模板
git clone https://github.com/HugoBlox/theme-academic-cv.git my-academic-site
cd my-academic-site

# 移除模板的 git 歷史
rm -rf .git

# 初始化你自己的 repository
git init
git branch -M main

# 連接到 GitHub repository
git remote add origin https://github.com/YourUsername/YourUsername.github.io.git

# 首次提交
git add .
git commit -m "Initial commit: Hugo Academic site"
git push -u origin main

階段 3：基本配置

編輯 config/_default/hugo.yaml：

title: '你的名字, PhD'
baseURL: 'https://yourname.netlify.app/'

編輯 content/authors/admin/_index.md 填入你的資訊。

階段 4：部署到 Netlify

步驟 1： 在用 GitHub 註冊

步驟 2： 導入你的 repository

步驟 3： 配置構建設定：

Branch: main
Build command: hugo --gc --minify
Publish directory: public

步驟 4： 添加環境變數：

HUGO_VERSION = 0.152.1
NODE_VERSION = 20

步驟 5： 部署！網站會上線到 https://random-name.netlify.app

步驟 6： 在 Site Settings → Domain Management 自訂網址

4. 常見問題與解決

問題 1：TailwindCSS 錯誤

錯誤訊息：

Error: TAILWINDCSS: failed to transform
binary with name "tailwindcss" not found

解決方案：

# 如果本地出現此錯誤，直接忽略
# 推送到 Netlify，那邊會正常運行
git push origin main

# 或者本地安裝依賴
npm install

問題 2：內容沒有更新

原因： 變更沒有推送到 GitHub

解決方案：

git status
git add .
git commit -m "更新內容"
git push origin main
# 等 2-3 分鐘讓 Netlify 重新部署

問題 3：本地文件丟失

這是可以預防的！ 請參考下一節的備份策略。

問題 4：內容資料夾被 Git 忽略

症狀：

本地 hugo server 正常顯示頁面 ✅
Netlify 部署後顯示 “Page Not Found” ❌
git status 顯示 “nothing to commit, working tree clean”
你確定檔案存在於本地

根本原因：

你的內容資料夾名稱符合 .gitignore 中的規則，導致 Git 完全忽略它。

範例：

# .gitignore 包含
resources/

# 你的內容結構
content/
 └── resources/ # ❌ 被意外忽略了！
 └── hugo-guide/
 └── _index.md

診斷方法：

# 檢查檔案是否被忽略
git status --ignored

# 檢查特定檔案
git check-ignore -v content/resources/_index.md
# 輸出：.gitignore:10:resources/ content/resources/_index.md

解決方案：

方案 1：重新命名資料夾（最簡單） ✅ 推薦

# 重新命名以避開規則
git mv content/resources content/resource
# 或
git mv content/resources content/guides

# 相應更新 menus.yaml
url: '/resource/hugo-guide/' # 更新後的路徑

# 提交並推送
git add .
git commit -m "重新命名資料夾以避免 .gitignore 衝突"
git push origin main

方案 2：讓 .gitignore 更精確

# 編輯 .gitignore
# 將：resources/
# 改為：/resources/ # 只忽略根目錄的 resources/

# 強制添加之前被忽略的檔案
git add -f content/resources/

# 提交並推送
git commit -m "修正：更新 .gitignore 並添加 content/resources"
git push origin main

方案 3：在 .gitignore 中添加例外

# 在 .gitignore 中添加
resources/ # 忽略 Hugo 的 resources
!content/resources/ # 但允許 content/resources

# 強制添加
git add -f content/resources/
git commit -m "添加 content/resources 與 .gitignore 例外規則"
git push origin main

預防技巧：

命名資料夾前檢查常見的 .gitignore 規則：
- 避免：resources/、public/、static/、node_modules/
- 安全：guides/、tutorials/、docs/、posts/

驗證檔案被追蹤：

# 創建新內容資料夾後
git status
# 應該顯示新檔案，而不是空的

使用描述性、獨特的名稱：

✅ content/research-guides/
✅ content/tutorials/
✅ content/documentation/
❌ content/resources/ (與 Hugo 的 resources/ 衝突)

5. ⚠️ 關鍵：備份策略

這一節可能會為你節省數小時的挫折感。

問題所在

在開發過程中，你可能會不小心：

用 git reset --hard 覆蓋文件
在合併衝突中丟失內容
不小心刪除文件

沒有備份，你的內容就沒了。

解決方案：多層備份

第一層：本地資料夾備份 💾

這個很重要❗這個很重要❗這個很重要❗

每次重要的編輯完成後，備份你的整個專案資料夾：

# 基本備份指令（推薦）
cp -r my-academic-site my-academic-site-backup-$(date +%Y%m%d-%H%M)

# 如果遇到「Permission denied」錯誤，使用 rsync：
rsync -av --exclude='.git' my-academic-site/ my-academic-site-backup-$(date +%Y%m%d-%H%M)/

為什麼這很重要：

最直接、最可靠的備份方法
完整的快照，不依賴 Git
只需要 10 秒，能節省數小時工作
容易瀏覽和還原

建議的備份時間表：

✅ 每次重大內容新增後
✅ 任何危險的 Git 操作前
✅ 每次編輯結束時
✅ 更新 Hugo 或branch之前

備份儲存位置：

# 創建專門的備份資料夾
mkdir -p ~/Desktop/website-backups

# 備份到那裡
cp -r my-academic-site ~/Desktop/website-backups/backup-$(date +%Y%m%d-%H%M)

第二層：Git 提交 📦

頻繁提交：

# 編輯 1-3 個文件後
git add .
git commit -m "更新：具體描述"
git push origin main

好處：

版本歷史追蹤
可以回滾到任何時間點
自動同步到 GitHub

第三層：備份分支 🌿

重大變更前創建定期備份分支：

# 每週備份
git branch backup-weekly-$(date +%Y%m%d)
git push origin backup-weekly-$(date +%Y%m%d)

# 重大改版前
git branch backup-before-redesign
git push origin backup-before-redesign

第四層：AI 對話存檔 🤖

當其他方法都失效時，AI 對話可以是救命稻草。

如果你大量使用 AI 協助：

創建里程碑快照：

完成重要階段時（例如：「初始設置完成」）
開啟新對話並註明：「這是 [日期] 的備份對話」
貼上你目前完整的工作版本
存放在專案資料夾外 以避免誤刪

為什麼有效：

即使本地文件丟失，AI 聊天記錄仍然存在
可以從對話歷史重建專案
記錄你的決策過程
遇到類似問題時可參考

進階技巧： 不要保存每個小程式碼片段。相反地，在達到穩定狀態時創建完整的里程碑備份。

備份工作流程總結

# === 日常工作流程 ===

# 1. 開始編輯
cd ~/my-academic-site

# 2. 修改內容

# 3. 本地測試（可選）
hugo server -D

# 4. 本地備份（優先級 #1 - 千萬不要跳過！）
cp -r ~/my-academic-site ~/Desktop/website-backups/backup-$(date +%Y%m%d-%H%M)

# 5. Git 提交（優先級 #2）
git add .
git commit -m "更新：你改了什麼"
git push origin main

# 6. 在 Netlify 上驗證部署

# 7.（可選）重大變更前創建備份分支
git branch backup-before-major-change
git push origin backup-before-major-change

# 8.（里程碑）必要時在 AI 對話中存檔完整版本

記住： 備份很便宜，重建丟失的工作很昂貴。本地備份是你的第一道也是最可靠的安全網。

6. 核心經驗教訓

1. 跟隨官方推薦

使用 Netlify（不是 GitHub Pages）
使用官方模板
初期不要過度客製化

2. 頻繁提交

# 編輯 1-3 個文件後
git add . && git commit -m "描述" && git push

3. AI 是你的副駕駛

不要猶豫尋求幫助
清楚地組織你的問題
卡住時開啟新對話
保留聊天記錄作為文檔

4. 多重備份是必須的

本地資料夾副本（使用 cp 或 rsync）
Git 提交
備份分支
AI 對話歷史

5. 內容 > 技術

80% 時間：優質內容
20% 時間：網站樣式

6. 小步快跑

分階段進行
持續驗證
不要一次做太多

7. 成功檢查清單

初始設置：

Hugo 和 Git 已安裝
GitHub repository 已創建
模板已 clone 並配置
已創建第一個備份
已部署到 Netlify
已設置自訂網址

內容開發：

個人資料已更新
研究內容已添加
論文列表已完成
CV/簡歷頁面已創建
所有連結已測試
保持定期備份

維護：

備份策略已建立
AI 對話歷史已整理
手機版已測試
已收集同儕反饋

結語

建立學術網站是一項投資：

💼 展示你的研究
🌐 建立線上存在
📚 整理你的工作
🤝 與同行交流

核心要點：

AI 工具讓這變得可及 - 你不需要是開發者
卡住時重新開始 - 新的 AI 對話提供新視角
虔誠地備份 - 每次編輯後使用 cp -r 或 rsync
整理你的 AI 聊天 - 它們是文檔也是備份
完成 > 完美 - 先上線，再迭代

祝建站順利！🚀

關於本指南

作者： 孫玉婷博士
協助工具： Claude AI (Anthropic)
最後更新： 2025年10月30日

網站原始碼：

Web Development | Dr. Yu-Ting Sun - Biophysicist & Researcher

Building Your Academic Website | Hugo Academic 建站指南

English Version

Building Your Academic Website: A Complete Guide

🎓 About This Guide

📖 Why This Guide?

💡 AI Can Help You Build This

Table of Contents

1. Understanding Hugo Academic

2. Deployment Platform: Why Netlify

3. Step-by-Step Setup

Phase 1: Prerequisites

Phase 2: Local Setup

Phase 3: Basic Configuration

Phase 4: Deploy to Netlify

4. Common Issues & Solutions

Issue 1: TailwindCSS Error

Issue 2: Content Not Updating

Issue 3: Lost Local Files

Issue 4: Content Folder Ignored by Git

5. ⚠️ CRITICAL: Backup Strategy

The Problem

The Solution: Multiple Backup Layers

Layer 1: Local Folder Backups 💾

Layer 2: Git Commits 📦

Layer 3: Backup Branches 🌿

Layer 4: AI Conversation Archives 🤖

Backup Workflow Summary

6. Key Lessons Learned

7. Success Checklist

Conclusion

About This Guide

Related Resources

中文版本

Hugo Academic 建站完整指南

🎓 關於本指南

📖 為什麼寫這份指南？

💡 AI 可以幫你建站

目錄

1. 理解 Hugo Academic

2. 部署平台：為何選 Netlify

3. 完整建站步驟

階段 1：準備工作

階段 2：本地設置

階段 3：基本配置

階段 4：部署到 Netlify

4. 常見問題與解決

問題 1：TailwindCSS 錯誤

問題 2：內容沒有更新

問題 3：本地文件丟失

問題 4：內容資料夾被 Git 忽略

5. ⚠️ 關鍵：備份策略

問題所在

解決方案：多層備份

第一層：本地資料夾備份 💾

第二層：Git 提交 📦

第三層：備份分支 🌿

第四層：AI 對話存檔 🤖

備份工作流程總結

6. 核心經驗教訓

7. 成功檢查清單

結語

關於本指南

相關資源