文档章节
入门
从零开始搭建并运行一个 Hugo 站点:快速开始、安装、基本用法、目录结构与配置。
开始之前,你需要
- 一台可以安装软件的电脑,以及打开终端的权限;不需要任何编程经验。
- 能照着命令敲、并读懂报错里的文件路径即可——本页不会假设你熟悉命令行。
读完之后你能
- 在自己的操作系统上把 Hugo 装好,并用
hugo version确认版本可用; - 用几条命令创建站点、添加内容、在浏览器里预览;
- 说清
content/、layouts/、assets/、static/各自的职责,判断一份文件该放哪里; - 区分发布(渲染出静态文件)与部署(把文件送上线),独立产出
public/目录; - 通过
hugo.toml(或config/目录)配置站点,并知道按环境覆盖配置的方法。
这一部分对应 Hugo 官方文档的 Getting started 章节,面向第一次接触 Hugo 的读者。这里不假设你会写模板,也不假设你熟悉命令行:每一页都会把「命令执行完应该看到什么」写出来,你照着对照就能判断自己有没有走对。
读完本章你应该能够
- 在自己的操作系统上把 Hugo 装好,并用
hugo version确认版本可用; - 用几条命令创建站点、添加内容、在本地浏览器里预览;
- 说明
content/、layouts/、assets/、static/等目录各自的职责,并判断一份文件该放哪里; - 区分发布(publish,渲染出静态文件)与部署(deploy,把文件送上线),独立产出
public/目录; - 通过
hugo.toml(或config/目录)配置站点,并知道按环境覆盖配置的方法。
建议阅读顺序
按下面的顺序读,后面的页会用到前面页里建好的项目:
- 快速开始 —— 最短路径跑通一个站点,约 15–20 分钟。先做这一页,其余页面才有可以动手的对象。
- 安装 Hugo —— 各平台安装方式、版本差异与验证方法。已经装好 Hugo 的读者也值得看一遍,确认自己的安装方式会不会漏掉
extended版本或环境变量。 - 基本用法 —— 构建、预览、发布三条主线命令,以及草稿/过期/将来内容的开关。
- 目录结构 —— 站点骨架与
content/的组织方式,是排查「文件放错地方」类问题的第一站。 - 配置 Hugo —— 配置文件的查找顺序、拆分与环境覆盖。