前置准备
- GitHub 账号
- Git
- Markdown 文本编辑器
建议配置 SSH 密钥以验证身份，避免每次拉取/推送代码时输入账号密码，且 SSH 传输比 HTTP 更安全。
博客编写及配置文件均使用 Markdown 语法，建议使用 Typora、Obsidian 或 VSCode 等编辑器，支持实时预览和格式化工具。
Hugo 安装
Hugo 是一个由 Go 语言实现的静态网站生成器，具有简单、易用、高效、易扩展的特点。
下载与配置
从 GitHub 官方发布页面下载最新版本的 Hugo（Extended 版本）。将解压后的 hugo.exe 所在目录添加到系统环境变量 PATH 中。
在命令行输入 hugo version 测试安装是否成功。输出包含版本号即表示安装成功。
创建新站点
在目标目录下执行以下命令创建站点：
hugo new site <site_name>
进入站点目录并初始化 Git 仓库：
cd <site_name>
git init
添加主题
推荐使用 Stack 主题。在站点目录下执行以下命令将主题作为子模块添加：
git submodule add https://github.com/CaiJimmy/hugo-theme-stack/ themes/hugo-theme-stack
若遇到超时问题，可使用 Git Bash 工具重新执行。
配置主题
从主题的 exampleSite 文件夹中复制 content 文件夹和 hugo.yaml 配置文件到站点根目录，删除原有的默认配置文件 hugo.toml。
注意：请删除
content/post/rich-content文件夹，避免运行失败。
本地调试运行：
hugo server -D
访问 http://localhost:1313/ 查看效果。修改文件后保存刷新即可更新。
创建第一篇博客：
hugo new post/first-blog/index.md
修改配置文件
编辑 hugo.yaml 文件，主要配置项如下：
baseurl: https://your-domain.pages.dev/
languageCode: zh-cn
theme: hugo-theme-stack
title: 博客名称
copyright: 著作权信息
DefaultContentLanguage: zh-cn
hasCJKLanguage: true
