MIDA 系統安裝指南

本指南將引導您完成 MIDA 系統的完整安裝過程。

系統需求

基本要求

Hugo: v0.120.0 或更高版本
Git: 用於版本控制
Node.js: v18+ (可選，用於開發工具)
操作系統: Windows、macOS、Linux

安裝步驟

1. 安裝 Hugo

macOS (使用 Homebrew)

1brew install hugo

Windows (使用 Chocolatey)

1choco install hugo-extended

Linux (Ubuntu/Debian)

1sudo apt-get install hugo

2. 驗證安裝

1hugo version

應該看到類似輸出：

1hugo v0.120.4+extended linux/amd64 BuildDate=2024-01-01T00:00:00Z

3. 創建新專案

方式一：使用 Hugo 創建

1hugo new site my-mida-site
2cd my-mida-site

方式二：克隆範例專案

1git clone https://github.com/your-org/hugo-mida-template.git my-mida-site
2cd my-mida-site

4. 安裝 MIDA 主題

作為 Git Submodule (推薦)

1git submodule add https://github.com/your-org/hugo-mida.git themes/mida
2git submodule update --init --recursive

直接下載

1wget -O mida.zip https://github.com/your-org/hugo-mida/archive/main.zip
2unzip mida.zip -d themes/
3mv themes/hugo-mida-main themes/mida

5. 配置主題

編輯 hugo.toml 或 config.yaml：

 1baseURL = 'https://example.com/'
 2languageCode = 'zh-TW'
 3title = 'My MIDA Site'
 4theme = 'mida'
 5
 6[params]
 7  # MIDA 主題配置
 8  [params.mida]
 9    enableAlpineListPage = true
10    enableAnimations = true

6. 創建基本內容

1# 創建首頁
2hugo new _index.md
3
4# 創建第一篇文檔
5hugo new docs/getting-started.md
6
7# 創建第一篇部落格
8hugo new blogs/welcome.md

7. 啟動開發伺服器

1hugo server -D

訪問 http://localhost:1313 查看您的網站。

目錄結構

安裝完成後，您的專案結構應該如下：

 1my-mida-site/
 2├── archetypes/          # 內容模板
 3├── assets/             # 資源文件
 4├── content/            # 內容文件
 5│   ├── _index.md      # 首頁
 6│   ├── docs/          # 文檔
 7│   └── blogs/         # 部落格
 8├── data/              # 數據文件
 9├── layouts/           # 自定義佈局
10├── static/            # 靜態文件
11├── themes/            # 主題
12│   └── mida/         # MIDA 主題
13└── hugo.toml         # 配置文件

配置選項

基本配置

1[params]
2  # 網站資訊
3  description = "使用 MIDA 建立的網站"
4  author = "Your Name"
5  
6  # 功能開關
7  enableAlpineListPage = true
8  enableAnimations = true
9  enableSearch = true

MIDA 特定配置

 1[params.mida]
 2  # 效能設定
 3  [params.mida.performance]
 4    minify = true
 5    compress = true
 6    
 7  # 功能設定
 8  [params.mida.features]
 9    lightbox = true
10    toc = true
11    breadcrumbs = true

驗證安裝

檢查清單

Hugo 版本正確 (v0.120.0+)
主題已正確安裝
配置文件無錯誤
開發伺服器可正常啟動
網站可在瀏覽器中訪問

測試功能

頁面渲染: 確認首頁正常顯示
內容管理: 創建測試內容
響應式設計: 在不同設備上測試
導航功能: 測試選單和連結

常見問題

Hugo 版本問題

問題: 版本過舊導致功能異常解決: 升級到最新版本的 Hugo Extended

主題路徑錯誤

問題: 找不到主題文件解決: 檢查 themes/mida 目錄是否存在

配置文件錯誤

問題: TOML/YAML 語法錯誤解決: 使用線上工具驗證配置語法

下一步

安裝完成後，建議您：

需要幫助？查看我們的疑難排解指南或聯繫支援。

系統安裝指南