安装 Hugo (macOS)

brew install hugo

不用 homebrew 的话预编译的安装包也是有的。

查看版本

hugo version

升级 Hugo

brew update
brew upgrade hugo

创建网站

此处 helloworld 指定的是所在目录名

hugo new site helloworld

添加主题

如果以后用 CI 发布站点,那么整个站点目录是一个 git repository。再用 git 添加主题的话,两个 git repository 会冲突。虽然可以用 git submodule 解决,但是看起来很麻烦的样子。可以先简单处理,手工下载,按需手工更新。

以官方文档推荐的 ananke 为例,到 themes.gohugo.io 下载,解压到 /themes

配置文件

站点生成后,根目录下有一个几乎空白的配置文件 config.toml

要启用主题,需要在 config.toml 里添加一行指向主题目录

theme = "gohugo-theme-ananke"

不同的主题支持不同的功能,所以一般主题的 exampleSite 目录下会有包含该主题可配置项的 config.toml,你可以拿它直接覆盖根目录的配置文件,或者参照它一点点添加。

查看网站

Hugo 内置 Web 服务器,可以用它本地预览网站,默认访问地址是 localhost:1313

hugo server

以下命令在 /public 生成可用于发布的静态文件

hugo

虽然到目前为止我们还没有添加任何内容,网站还只是个空架子。