前置准备
- 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

