快速入门
在本教程中，您将：
- 创建网站
- 添加内容
- 配置网站
- 发布网站
前提条件
开始本教程之前，您必须：
您还必须熟悉使用命令行界面。
创建网站
命令
运行以下命令，使用 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/posts/my-first-post.md
Hugo 会在 content/posts 目录中创建该文件。使用编辑器打开该文件。
---
title: "我的第一篇文章"
date: 2022-11-20T09:03:20-08:00
draft: true
---
注意 [front matter] 中的 draft 值为 true。默认情况下，Hugo 在构建网站时不会发布草稿内容。了解更多关于草稿、将来和过期内容的信息。
在文章正文中添加一些 [markdown]，但不要更改 draft 值。
---
title: "我的第一篇文章"
date: 2022-11-20T09:03:20-08:00
draft: true
---
## 简介
这是 **粗体** 文本，这是 *斜体* 文本。
访问 [Hugo](https://gohugo.io) 网站！
保存文件，然后启动 Hugo 的开发服务器以查看网站。您可以运行以下命令之一来包含草稿内容。
hugo server --buildDrafts
hugo server -D
在终端中显示的 URL 中查看您的网站。随着继续添加和更改内容，请保持开发服务器运行。
配置网站
使用编辑器打开项目根目录下的 网站配置 文件（hugo.toml）。
baseURL = 'https://example.org/'
languageCode = 'en-us'
title = '我的新 Hugo 网站'
theme = 'ananke'
进行以下更改：
-
为您的生产网站设置
baseURL。该值必须以协议开头，并以斜杠结尾，如上所示。 -
将
languageCode设置为您的语言和地区。 -
为您的生产网站设置
title。
启动 Hugo 的开发服务器以查看您的更改，记得包含草稿内容。
hugo server -D
发布网站
在此步骤中，您将“发布”网站，但不会 “部署”它。
当您“发布”网站时，Hugo 会在项目根目录的 public 目录中创建整个静态网站。其中包括 HTML 文件和像图像、CSS 文件和 JavaScript 文件这样的资源。
当您发布网站时，通常不希望包含[草稿、将来或过期内容]。命令很简单。
hugo
要了解如何“部署”您的网站，请参阅托管和部署部分。
寻求帮助
Hugo 的 论坛 是一个活跃的用户和开发者社区，他们解答问题，分享知识并提供示例。在超过 20,000 个主题上进行快速搜索通常可以回答您的问题。在提问之前，请务必阅读寻求帮助的相关信息。
其他资源
有关帮助您学习 Hugo 的其他资源，包括书籍和视频教程，请参阅外部学习资源页面。