Hugo是一个优秀的静态网页生成框架，适合博客或小型文档之类的没有动态数据交互的网页应用。 一直打算翻新博客，尝试过朴素三大件、也试过一些其他框架，但因为水平太次最终还是回来投奔Hugo。本篇介绍hugo的基本结构及用法。

安装Hugo

所需内容：

• Git
• Go
• Hugo

Hugo分为standard和extended两个版本。区别是extended版本会把图片处理成WebP格式的，还有自带的sass处理器。两者的占用相差也不大，一般情况都选择extended即可。

目录结构

完成安装後，选择合适的路径，输入:

hugo new site my-site
cd my-site/
git init

这样就创建了一个名为my-site的新项目，
目录结构如图所示：

my-site/
├── archetypes/         <-- 文章模板，统一文章格式
├── assets/             <-- 全局资源，图片、样式、脚本之类
├── content/            <-- 网站内容，组织网站主要内容
├── data/               <-- 通用数据，存放来自站内站外的资源
├── i18n/               <-- 国际化，多语言适配
├── layouts/            <-- 布局模板，不同页面呈现不同样式
├── static/             <-- 静态资源
├── themes/             <-- 主题
└── hugo.toml           <-- 配置文件，网站的全局配置

现在可以启动hugo自带的网页服务器，方便在本地调试网站。访问默认地址127.0.0.1:1313观察网页效果：

hugo serve

安装主题

不出意外的话，访问hugo服务首先映入眼帘的，只有page not found一行。 新建项目没有任何的预设布局，网站的DOM结构基本是空的，无法正常呈现内容。

这就轮到theme出马，使用主题避免自己写样式的劳苦， Hugo官方的主题仓库有许多不同类型不同风格的主题可供挑选。
我之前使用stack，很干净的主题， 不过这一次我想自己做主题，试图锻炼我的审美。

主题使用Git的子模块管理，把中意的主题作为子模块拉到theme/<theme-name>文件夹，再修改一行配置文件即可：

git submodule add https://github.com/CaiJimmy/hugo-theme-stack.git theme/stack
echo "theme = 'stack'" >> hugo.toml

现在应该能正常呈现网站内容了。

内容管理

Hugo的所有内容都放在content/之中管理，根据内容的分层结构处理路由等事务。 先来介绍一个重要概念，Page bundles。 分两种，leaf bundle 和 branch bundle。

leaf bundle

把内容及其所需的资源统放到一个文件夹里，其中包含一个index.md，形成一个leaf bundle。譬如一个about/文件夹，其中有一篇文章和一张图片。

content/
└── leaf/
    ├── index.md
    └── cover.jpg

leaf喻为植物形态的末端，不再有后继，是内容管理的基本单元。

branch bundle

而branch bundle则更高一层，可用作目录，包含任意数量的子文件夹，其中包含一个_index.md。

content/
├── branch/
│   ├── leaf-a/
│   │   └── index.md
│   ├── leaf-b/
│   │   └── index.md
│   └── _index.md
└── _index.md

这里面有几个branch bundle？
content/作为顶层文件夹，肯定是一个brach bundle，其中的branch/有_index.md，所以答案是两个。

page bundle组织彼此相关联的内容，避免什么东西都往static/或assets/这两个公共资源文件夹里放。

配置文件

Hugo默认在新的项目生成一个全局配置文件hugo.toml：

# hugo.toml
baseURL = 'https://example.org/'
languageCode = 'en-us'
title = 'My New Hugo Site'
theme = 'stack'

title是浏览器标签页的标题，随意修改；
baseURL定义网站的基本url，作为所有相对链接的绝对参照点，乱填可能会导致资源无法正确定位。 我使用Github Action部署网站，所以写"https://proxyerium.github.io/"，注意尾部一定要有斜杠。

部署网站

部署网站有许多方法，参考官方文档。我还没尝试过Github Action以外的方法，暂且只写这一种 :P

Github Actions

1. 远程仓库，找到Settings -> Pages -> Source，改成"Github Actions"。
2. 本地仓库，创建工作流脚本.github/workflows/hugo.yaml，用官方提供的工作流模板即可，唯独留心里面的HUGO_VERSION对应自己正在使用的版本，免得兼容问题。
3. 整理好所有内容後推送到远程仓库。
4. 找到远程仓库顶部Actions标签页，观赏action流程，完成後便能访问部署好的网站，大功告成！

挖坑

暂时先这样，还有很多核心功能我都还没摸过：shortcodes、templates、i18n、archetypes……应该会填完的吧？

changelog