跳转至

Hugo

简介

Hugo 是个静态网站生成器,用 Go 实现

对比

相比 Mkdocs 等 SSG,Hugo 有很大的不同

  • 构建速度很快。这可能是 Hugo 最大的特点。
  • 配置比较麻烦,但同时更灵活。Hugo 通过把别人的整个 Git 仓库复制到 themes 目录下来使用主题,这样修改起来可能比较麻烦,但也提供了更高的灵活度。
  • 不太适合高度结构化的内容。Hugo 相对而言更适合 博客 而不是 书籍。虽然说 Hugo 也有适合 书籍 的主题,但对此选择专门生成文档的 SSG 可能会更好。

由于我的这些笔记内容是高度结构化的,且我希望配置简单而不太在意构建速度,因此我选择了用 MkDocs 构建这个网站。

安装

# Windows
scoop install hugo-extended

使用

这个示例来自 官方快速入门教学,不过我换了个主题。官网上可以查看 更多主题

# 初始化目录并进入
hugo new site quickstart
cd quickstart
# 初始化仓库
git init
# 复制别人的主题并写入配置文件
git submodule add https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod
echo "theme = 'PaperMod'" >> hugo.toml
# 启动本地服务器
hugo server
# 添加一篇贴文,在编辑器里修改它
hugo new content content/posts/my-first-post.md
# 启动包含草稿的本地服务器
hugo server -D