快速开始
在本教程中，您将：
- 创建一个站点
- 添加内容
- 配置站点
- 发布站点
前提条件
开始本教程之前，您必须：
您还必须熟悉命令行操作。
创建站点
命令
如果您是 Windows 用户：
- 不要使用命令提示符（Command Prompt）
- 不要使用 Windows PowerShell
- 请从 PowerShell 或 Linux 终端（如 WSL 或 Git Bash）运行这些命令
PowerShell 和 Windows PowerShell 是不同的应用程序。
验证您已安装 Hugo v0.146.0 或更高版本。
hugo version运行以下命令创建一个使用 Ananke 主题的 Hugo 站点。下一节将解释每个命令。
hugo new site quickstart
cd quickstart
git init
git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke
echo "theme = 'ananke'" >> hugo.toml
hugo server在浏览器中访问终端显示的 URL 查看您的站点。按 Ctrl + C 停止 Hugo 开发服务器。
命令解释
在 quickstart 目录中创建项目的 站点骨架。
hugo new site quickstart将当前目录更改为项目根目录。
cd quickstart在当前目录中初始化一个空的 Git 仓库。
git init将 Ananke 主题克隆到 themes 目录中，作为 Git 子模块 添加到您的项目。
git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke将一行配置追加到站点配置文件中，指定当前主题。
echo "theme = 'ananke'" >> hugo.toml启动 Hugo 开发服务器以查看站点。
hugo server按 Ctrl + C 停止 Hugo 开发服务器。
添加内容
向您的站点添加新页面。
hugo new content content/posts/my-first-post.mdHugo 在 content/posts 目录中创建了文件。用编辑器打开它。
+++
title = '我的第一篇文章'
date = 2024-01-14T07:07:07+01:00
draft = true
+++注意 front matter 中的 draft 值为 true。默认情况下，Hugo 在构建站点时不会发布草稿内容。了解更多关于 草稿、未来和过期内容 的信息。
在文章正文中添加一些 Markdown 内容，但不要更改 draft 值。
+++
title = '我的第一篇文章'
date = 2024-01-14T07:07:07+01:00
draft = true
+++
## 介绍
这是 **粗体** 文本，这是 *斜体* 文本。
访问 [Hugo](https://www.hugodoc.com) 网站！保存文件，然后启动 Hugo 开发服务器查看站点。您可以运行以下任一命令来包含草稿内容。
hugo server --buildDrafts
hugo server -D在终端显示的 URL 查看您的站点。在继续添加和更改内容时保持开发服务器运行。
当您对内容满意时，将 front matter 中的 draft 参数设置为 false。
配置站点
使用编辑器打开项目根目录中的 站点配置 文件（hugo.toml）。
baseURL = 'https://example.org/'
languageCode = 'en-us'
title = '我的新 Hugo 站点'
theme = 'ananke'进行以下更改：
- 设置生产站点的
baseURL。此值必须以协议开头并以斜杠结尾，如上所示。 - 将
languageCode设置为您的语言和地区。 - 设置生产站点的
title。
启动 Hugo 开发服务器查看您的更改，记得包含草稿内容。
hugo server -D大多数主题作者会提供配置指南和选项。请务必查看您主题的仓库或文档站点以获取详细信息。
The New Dynamic，Ananke 主题的作者，提供了配置和使用的 文档。他们还提供了一个 演示站点。
发布站点
在这一步中，您将 发布 您的站点，但不会 部署 它。
当您 发布 站点时，Hugo 会在项目根目录的 public 目录中创建整个静态站点。这包括 HTML 文件以及图片、CSS 文件和 JavaScript 文件等资源。
发布站点时，您通常 不 希望包含 草稿、未来或过期内容。命令很简单：
hugo要了解如何 部署 您的站点，请参阅 托管和部署 部分。
寻求帮助
Hugo 的 论坛 是一个活跃的用户和开发者社区，他们回答问题、分享知识并提供示例。快速搜索超过 20,000 个主题通常就能找到答案。在提出第一个问题之前，请务必阅读 请求帮助 指南。
其他资源
有关学习 Hugo 的其他资源，包括书籍和视频教程，请参阅 外部学习资源 页面。