# Hugo 与 Htmlpress 对比
> 两款单一二进制的静态站点生成器：文档优先的纯 HTML 与通用的 Go。
[Hugo](https://gohugo.io) 是一款用 Go 编写的通用静态站点生成器。它以单一二进制文件发布，构建速度极快，借助 [Docsy](https://www.docsy.dev) 和 [Hugo Book](https://github.com/alex-shpak/hugo-book) 等社区主题，从博客、作品集到文档站点都能胜任。
## 概览
| 维度 | Htmlpress | Hugo |
| -------- | ------------------------------------ | -------------------- |
| 语言 / 运行时 | Rust（单一二进制文件，无运行时） | Go（单一二进制文件，无运行时） |
| UI 框架 | 无（纯 HTML + CSS，`htmlpress-*` Web 组件） | Go 模板（HTML + CSS） |
| 构建工具 | htmlpress 二进制文件 | Hugo 二进制文件 |
| 内容格式 | HTML 和 Markdown 页面 | 带 Hugo 短代码的 Markdown |
| 许可证 | MIT，自托管 | Apache-2.0，自托管 |
| 输出模式 | 预渲染静态页面 | 预渲染静态页面 |
## 架构
htmlpress 是一个 Rust 二进制文件，可从 npm（`gethtmlpress`）、PyPI 或 crates.io 安装。它用一个布局包裹每个 HTML 页面，并配上导航和主题；没有打包器、没有 UI 框架，也没有插件 API。每个内置文件——布局、样式、脚本以及每个组件——都可以被覆盖：在 `.htmlpress/` 下的相同路径放一个文件即可替换它。
Hugo 是单一的 Go 二进制文件——没有运行时依赖，也没有安装依赖包的步骤。站点结构基于约定：`content/`、`layouts/`、`static/`、`themes/`、`config.toml`（或 `.yaml`/`.json`）。布局使用 Go 的 `html/template` 语法。主题以 git 子模块的方式引入或复制到 `themes//` 中。htmlpress 的布局是不含模板语法的纯 HTML：由二进制文件填充其中的 `htmlpress-*` 占位元素。
Hugo 并非专为文档而生。同一个二进制文件可以驱动博客、营销站点、作品集和文档——文档场景是通过主题来支持的，而不是一等的栏目类型。
在 htmlpress 这边，内容布局不受约束：它按 glob 扫描（`htmlpress.yaml` 中的 `include`/`exclude`，默认扫描所有 `.html` 文件），页面的 URL 取决于它在 glob 基础目录下的文件路径，因此 `docs/**/*.html` 会把 `docs/guide.html` 发布在 `/guide/`。不要求存在 `docs/` 文件夹。导航由文件夹结构和每个页面的 `` 构建；文件夹的 `index.html` 为其分组命名。Hugo 从 `content/` 读取内容，URL 结构与目录树一致（并可通过各栏目的 frontmatter 覆盖）。
## 内容层面
Hugo 接受带 frontmatter 的 Markdown；htmlpress 同样接受 HTML 页面和带 frontmatter 的 Markdown。
Hugo 通过**短代码**嵌入组件——这是一种以 Go 模板编写的函数，在 Markdown 中以 `{{< shortcode-name arg="value" >}}` 调用。短代码定义在 `layouts/shortcodes/*.html` 中，是 Go 模板片段，直接输出 HTML。htmlpress 中最接近的对应物是项目组件：`.htmlpress/components//.html` 会在构建时填充每一个 `>`。
Hugo 支持基于 Goldmark 的 Markdown 扩展（脚注、表格、定义列表，以及借助插件实现的数学公式）。如需更丰富的交互，通常的做法是嵌入 `