Snow——为内容创作者和开发者打造的轻量级静态站点生成器

如果你想搭建一个博客、技术文档站、项目主页，或者一个可以长期维护的内容网站，你可能已经尝试过许多静态站点生成器。它们功能强大，但有时也意味着复杂的依赖、繁琐的配置和不够直观的扩展方式。

Snow 提供了另一种选择：一个用 Go 编写的、单二进制分发的静态站点生成器。它足够轻量，也足够灵活，适合从个人博客到多语言文档站的多种场景。

开箱即用，快速开始

Snow 的使用方式非常直接。你可以通过 Homebrew 安装：

1brew install honmaple/tap/snow

也可以直接从源码安装：

1go install github.com/honmaple/snow@latest

创建新站点只需要一条命令：

1snow init myblog

随后进入目录，启动本地预览：

1snow server --autoload

--autoload 会监听内容、模板和静态文件变化，自动重新构建并刷新浏览器。写文章、调模板、看效果，整个流程非常顺滑。

生产环境构建同样简单：

1snow build --mode publish --clean

Snow 支持通过 mode 管理不同环境配置，例如本地开发使用 127.0.0.1，发布时自动切换为正式域名。

支持 Markdown、Org-mode 和 HTML

Snow 不只支持常见的 Markdown，也内置支持 Org-mode 和 HTML 内容文件。对于习惯使用 Emacs/Org-mode 管理知识库的用户来说，这一点非常友好。

你可以在 content/ 目录下自由组织内容：

1content/
2├── about.md
3└── posts/
4    ├── hello.md
5    └── bundle/
6        ├── index.md
7        └── image.png

Snow 支持 Page Bundle，文章和图片等资源可以放在同一个目录中，便于迁移、备份和维护。

清晰的内容模型

Snow 的内容系统围绕三个核心概念构建：

• Page：单篇文章或页面
• Section：栏目或目录，用来组织文章
• Taxonomy：标签、分类、作者等归档系统

通过 FrontMatter，你可以轻松控制标题、日期、slug、草稿状态、自定义路径、模板、标签和分类：

 1---
 2title: "我的文章"
 3date: 2024-01-15
 4tags:
 5  - go
 6  - web
 7categories:
 8  - Programming/Go
 9draft: false
10---

对于博客、知识库、项目文档来说，这种模型既直观，也足够强大。

多语言、分页、RSS，一应俱全

Snow 内置多语言能力，支持通过目录、文件后缀或 FrontMatter 识别语言。你可以为不同语言配置独立内容目录、翻译文件和站点参数。

同时，Snow 支持 Section 和 Taxonomy 级别的分页，也支持 RSS、Atom、JSON 等自定义输出格式。无论你是在做个人博客、产品文档，还是需要生成机器可读的数据源，Snow 都能覆盖常见需求。

灵活的模板系统

Snow 使用 Pongo2 模板引擎，语法接近 Django：

1{% for page in pages.OrderBy("date desc") %}
2  <a href="{{ page.Path }}">{{ page.Title }}</a>
3{% endfor %}

模板中可以直接访问页面、栏目、分类、配置和多语言翻译函数。Snow 还提供了常用的列表操作能力，例如排序、分组、筛选、限制数量、上一篇/下一篇等。

这意味着你可以很轻松地构建文章列表、归档页、标签页、相关推荐和自定义首页。

主题可覆盖，站点可定制

Snow 支持主题系统。主题可以包含模板、静态资源和配置文件：

1themes/mytheme/
2├── theme.yaml
3├── templates/
4├── static/
5└── i18n/

站点本地模板优先级高于主题模板，因此你可以先使用主题快速启动，再按需覆盖某个页面模板，而不必复制整个主题。

这种设计既适合普通用户快速搭站，也适合开发者维护自己的主题体系。

插件 Hook，让构建流程可扩展

Snow 内置 Hook 插件系统，可以在内容处理、模板执行、资源处理、写入输出等阶段插入自定义逻辑。

目前内置插件包括：

• shortcode：在内容中嵌入可复用组件
• encrypt：内容加密
• assets：静态资源处理
• minify：输出压缩
• rewrite：FrontMatter 重写
• filter：页面筛选
• snakecase：模板上下文 snake_case 访问
• pelican：文档格式转换辅助

默认启用 assets、encrypt 和 shortcode，其他插件可以按需开启。你还可以通过权重控制插件执行顺序，让构建流程更可控。

单二进制，部署简单

Snow 使用 Go 编写，可以编译成单个二进制文件。没有复杂运行时，没有庞大的依赖链，也不需要在服务器上安装一整套前端工具。

对于静态站点来说，这非常实用：本地构建，产物上传，或者直接放进 CI/CD 流程，都很干净。

适合谁使用？

Snow 特别适合这些用户：

• 想搭建个人博客或技术博客的开发者
• 希望用 Markdown 或 Org-mode 管理内容的写作者
• 需要多语言文档站的项目维护者
• 想要轻量、可控、易部署静态站点工具的团队
• 喜欢 Go 单二进制工具链的用户

总结

Snow 的优势不在于把每件事都做得庞大复杂，而在于把静态站点生成中真正重要的能力做得清晰、直接、可扩展。

它支持多格式内容、多语言、分类归档、分页、自定义输出、主题覆盖、实时预览和插件扩展，同时保持了单二进制工具应有的简洁。

如果你正在寻找一个轻量但不简陋、灵活但不臃肿的静态站点生成器，Snow 值得一试。

项目地址：https://github.com/honmaple/snow