Re:从零开始的博客生涯 #1 Hugo

全新安装

自行编译

下载源码自行编译二进制文件即可。
注意 Go 需要 1.3+ 版本，Windows 上编译的话 Go 要 1.4+ 版本。

所有平台都可以直接使用编译好的二进制文件，下载对应的版本就好。
不过这时需要确保二进制文件所在的目录，比如 .\workspace\lib\hugo.exe version；
如果用软件包管理器就能像 hugo version 这样直接用。

Windows 包管理器

用管理员权限在 Powershell 运行 Chocolatey：

1
$ choco install hugo-extended -confirm

或者用管理员权限在 Powershell 运行 Scoop：

1
$ scoop install hugo-extended

如何安装 Chocolatey / Scoop 自行搜索文档，此处不再赘述。

Mac 包管理器

在 Homebrew 运行：

1
$ brew install hugo

Linux 直接下载

我是直接下载（wget）官方仓库编译好的 releases 的。
不推荐用 hugo 直接跑 web 服务（尽管它可以做到而且很方便），主要是不方便运维管理。
我自己用也就在 wsl 的 localhost 上运行（作为动态重载的本地文档，修改文件立即呈现的效果真的很方便）。
有~~生之年~~ 空扩展一下写成自动化程度比较高的管理脚本吧。

升级

Windows

用管理员权限在 Powershell 运行 Chocolatey：

1
$ choco upgrade hugo-extended -confirm

或者用管理员权限在 Powershell 运行 Scoop：

1
$ scoop update hugo-extended

Mac

在 Homebrew 运行：

1
$ brew upgrade hugo

Linux

直接下载最新的二进制文件覆盖旧版本即可。

使用

生成新项目

1
2
$ hugo new site hugo-demo
$ cd hugo-demo

生成名为 hugo-demo 的 hugo 项目。
并切换当前工作目录到刚刚建好的项目路径下。

请确保当前工作目录位于 ...\你命名的 hugo 项目\ 路径下。

该目录下有：

archetypes/ 模版
content/    正文内容
data/       数据
layouts/    框架/样式
static/     静态资源
themes/     主题
config.toml 配置文件

生成新文章

1
$ hugo new posts/hello-world.md

以预设格式（hugo-demo\archetypes\default.md）在正文目录（hugo-demo\content\posts\）生成名为 hello-world.md 的新文章。

生成静态文件

1
$ hugo

然后将 public 文件夹直接放到任意 web 服务器（nginx/Apache/Caddy 等）即可成功运行。

在本地运行 web 服务

1
$ hugo server -p 9527

加上 -p 9527 是指定端口。
如果直接运行 hugo server 就是不含草稿并运行在默认端口（1313）的 web 服务。

然后用浏览器打开 http://localhost:9527 或者 http://127.0.0.1:9527 （「本地」= localhost = 127.0.0.1）就能看到本地运行的网站了。

加载所有文章

hugo 生成静态文件，默认 environment 为 production（生产环境）
hugo server 运行网站服务，默认 environment 为 development（开发环境）

简单地 hugo server 只会加载生产环境（production）会展示的文章。

加载 .\content\ 目录下所有 Markdown 文件（*.md）：

1
$ hugo server -D -E -F

每篇文章都有 meta header（官方称之为 Front Matter），可以定义该篇文章的元数据：
标题 / 标签 / 分类 / 是否为草稿 / 发表时间 / 过期时间等各种信息。

-D / --buildDrafts 加载草稿
-E / --buildExpired 加载过期的文章
-F / --buildFuture 加载未来的文章
即文章的发表时间（你想写成什么时候都行）比此时此刻晚

LiveReload

Hugo 自带 LiveReload，加上默认开启的 --watch 监视文件变动，一旦文件被修改就会自动热重载。
但如果在本地绑定了域名（比如 http://local.hugo），访问这个域名时 livereload.js 可能会（错误地）尝试连接 ws://local.hugo:[PORT]。

[PORT] 是 hugo server -p 指定的端口，不指定则默认为 1313。

这时可以用 --liveReloadPort 指定 livereload.js 连接 WebSocket 的端口：

1
$ hugo server -p 9527 --liveReloadPort 80

如果本地绑定的域名和我一样是反代端口出来的，那么再访问 http://local.hugo 就能正确地根据文件变动实时重载了。

Re:从零开始的博客生涯 #1 Hugo

相关文章：