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