快速入门

Step 1: 安装 Hugo

brew install hugo

验证安装是否成功，请执行：

hugo version

Step 2: 创建一个新站点

hugo new site quickstart

执行上述操作之后将在 quickstart 目录下创建一个新的 Hugo 站点。

Step 3: 添加主题

请参阅 themes.gohugo.io 查看可用的主题列表。此快速入门教程使用的是漂亮的 Ananke 主题。

首先，从 Github 下载主题并将其添加到站点的 theme 目录中：

cd quickstart
git init
git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke

非 git 用户请注意：

如果你没有安装 git，你可以从以下地址下载此主题的最新版本： https://github.com/budparr/gohugo-theme-ananke/archive/master.zip
解压 .zip 文件，获得 “gohugo-theme-ananke-master” 目录。
将该目录重命名为 “ananke”，并将其移动到 “themes/” 目录。

然后，将主题添加到站点的配置文件中：

echo 'theme = "ananke"' >> config.toml

Step 4: 添加内容

你可以手动创建文件（例如 content/<CATEGORY>/<FILE>.<FORMAT>）并在文件开始处添加元数据（metadata），当然，你也可以使用 new 命令辅助工作（例如添加标题和日期）：

hugo new posts/my-first-post.md

新创建的文件默认包含如下内容，根据需要修改即可：

---
title: "My First Post"
date: 2019-03-26T08:47:11+01:00
draft: true
---

Step 5: 启动 Hugo 服务器

现在，启动 Hugo 服务器。drafts 处于开启状态：

▶ hugo server -D

                   | EN
+------------------+----+
  Pages            | 10
  Paginator pages  |  0
  Non-page files   |  0
  Static files     |  3
  Processed images |  0
  Aliases          |  1
  Sitemaps         |  1
  Cleaned          |  0

Total in 11 ms
Watching for changes in /Users/bep/quickstart/{content,data,layouts,static,themes}
Watching for config changes in /Users/bep/quickstart/config.toml
Environment: "development"
Serving pages from memory
Running in Fast Render Mode. For full rebuilds on change: hugo server --disableFastRender
Web Server is available at http://localhost:1313/ (bind address 127.0.0.1)
Press Ctrl+C to stop

打开新站点 http://localhost:1313/。

您可以随意编辑或添加新内容，只需在浏览器中刷新即可快速查看修改的内容（可能需要强制刷新浏览器中，一般使用组合键 Ctrl-R）。

Step 6: 自定义主体

你新创建的站点看起来已经很棒了，但是在你向公众发布它之前，需要稍微调整一下。

站点设置

用文本编辑器打开 config.toml 文件：

baseURL = "https://example.org/"
languageCode = "en-us"
title = "My New Hugo Site"
theme = "ananke"

你可以用个性化的文字替换上面的 title 配置项。另外，如果你已经拥有了一个域名，可以设置到 baseURL 配置项上。请注意，baseURL 配置项在本地运行的服务器上不需要。

对于特定于主题的配置参数，请参阅此主题的站点。

F有关进一步的自定义主题，请参阅自定义主题。

Step 7: 构建静态页面

执行如下命令：

hugo -D

默认情况下，输出的内容位于 ./public/ 目录中（可以通过 -d/--destination 参数修改输出位置，或者在配置文件中设置 publishdir 参数）。