部署
htmlpress build 会在
.htmlpress/build/ 中生成一个完全静态的站点：每个页面对应一个
.html 文件，路径与其源文件相同；此外还有
404.html、robots.txt、 sitemap.xml（设置了
site 时）、_headers 文件、某种语言没有自己首页时的
_redirects 文件、 供智能体使用的
Markdown 副本和 llms.txt、 位于
_htmlpress/
下的主题与组件脚本，以及项目中的其他所有文件。把这个目录放到任意静态托管平台上，站点就上线了。
以下指南涵盖最常见的部署目标。任选其一即可：每篇指南都是独立完整的，同时给出手动命令和 CI 工作流。
托管平台
静态托管
任何能提供文件目录服务的主机：nginx、S3 + CloudFront、Caddy 等。
GitHub Pages
免费、原生集成 git，非常适合部署在 /repo-name/ 路径下的项目站点。
Cloudflare
Workers + 静态资源。htmlpress.dev 本身就采用这种方案。
Vercel
与 Git 连接，每个拉取请求都有预览，域名零配置。
Netlify
与 Git 连接，支持分支部署、原子发布和内置表单处理。
各指南的共同前提
-
你在项目根目录运行
htmlpress build，输出位于.htmlpress/build/。在 CI 中，npx gethtmlpress build无需预先安装即可运行同一个二进制文件；其他安装渠道见 简介。 -
如果你需要
sitemap.xml、robots.txt中的 sitemap 行、规范 URL 和绝对路径的社交标签，需要在htmlpress.yaml中设置site；见 站点元数据。 -
只有当站点挂载在子路径下时（例如 GitHub Pages 项目站点）才需要
base。只有 GitHub Pages 指南涉及这一点。
用 ❤ 和 Htmlpress 构建