快速入门
本教程将指导您:
- 创建站点
- 添加内容
- 配置站点
- 发布站点
预备条件
在开始本教程之前,您必须:
您还必须能够熟练使用命令行。
创建站点
命令
验证您已安装 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
+++
请注意 前置 matter 中的 draft
值为 true
。默认情况下,当您构建站点时,Hugo 不会发布草稿内容。了解更多关于 草稿、未来和过期内容 的信息。
向文章正文添加一些 Markdown 内容,但不要更改 draft
值。
+++
title = 'My First Post'
date = 2024-01-14T07:07:07+01:00
draft = true
+++
## Introduction {#introduction}
这是 **粗体** 文本,这是 *强调* 文本。
访问 [Hugo](https://gohugo.io) 网站!
保存文件,然后启动 Hugo 的开发服务器以查看站点。您可以运行以下任一命令以包含草稿内容。
hugo server --buildDrafts
hugo server -D
在终端显示的 URL 中查看您的站点。在继续添加和更改内容时,请保持开发服务器运行。
对新内容满意后,将前置 matter 的 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 的其他资源,包括书籍和视频教程,请参阅 外部学习资源 页面。