快速入门
在本教程中，您将
- 创建一个站点
- 添加内容
- 配置站点
- 发布站点
先决条件
在开始本教程之前，您必须
您还必须能够熟练地从命令行工作。
创建一个站点
命令
验证您是否已安装 Hugo v0.128.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.md
Hugo 在 content/posts 目录中创建了该文件。使用编辑器打开该文件。
+++
title = 'My First Post'
date = 2024-01-14T07:07:07+01:00
draft = true
+++
请注意，前言中的 draft 值是 true。默认情况下，当您构建站点时，Hugo 不会发布草稿内容。了解有关草稿、未来和过期内容的更多信息。
将一些 Markdown 添加到帖子的正文中，但不要更改 draft 值。
+++
title = 'My First Post'
date = 2024-01-14T07:07:07+01:00
draft = true
+++
## Introduction
This is **bold** text, and this is *emphasized* text.
Visit the [Hugo](https://gohugo.com.cn) website!
保存文件，然后启动 Hugo 的开发服务器以查看站点。您可以运行以下任一命令以包含草稿内容。
hugo server --buildDrafts
hugo server -D
在终端中显示的 URL 上查看您的站点。在您继续添加和更改内容时，保持开发服务器运行。
对您的新内容感到满意后，将前言 draft 参数设置为 false。
配置站点
使用编辑器，打开项目根目录中的站点配置文件 (hugo.toml)。
baseURL = 'https://example.org/'
languageCode = 'en-us'
title = 'My New Hugo Site'
theme = 'ananke'
进行以下更改
-
为您生产的站点设置
baseURL。此值必须以协议开头，并以斜杠结尾，如上所示。 -
将
languageCode设置为您的语言和区域。 -
为您的生产站点设置
title。
启动 Hugo 的开发服务器以查看您的更改，并记住包含草稿内容。
hugo server -D
发布站点
在此步骤中，您将发布您的站点，但不会部署它。
当您发布您的站点时，Hugo 会在项目根目录的 public 目录中创建整个静态站点。这包括 HTML 文件以及图像、CSS 文件和 JavaScript 文件等资源。
当您发布您的网站时，通常不希望包含草稿、未来或过期内容。命令很简单。
hugo
要了解如何部署您的网站，请参阅托管和部署部分。
寻求帮助
Hugo的论坛是一个活跃的用户和开发者社区，他们会回答问题、分享知识并提供示例。快速搜索超过20,000个主题通常会解答您的问题。在您提出第一个问题之前，请务必阅读关于请求帮助的内容。
其他资源
有关其他可帮助您学习 Hugo 的资源，包括书籍和视频教程，请参阅外部学习资源页面。