Netlify

Netlify 读取项目根目录下一个小小的 netlify.toml 来获取构建命令和发布目录。其余部分（Git 预览、原子部署、自定义域名）都会自动处理。Netlify 还会读取每次构建写出的 _headers 文件，并用构建产出的 404.html 响应未知路径。

构建站点

htmlpress build

输出位于 .htmlpress/build/。

配置 netlify.toml

[build]
command = "npx gethtmlpress build"
publish = ".htmlpress/build"

Netlify 只需要这些。如果你想在本地模拟平台的边缘行为，同一个文件还能启用 netlify dev。

通过 git 集成部署

推荐方式：在 app.netlify.com/start 连接你的仓库。Netlify 会读取 netlify.toml、运行构建，并把每次推送到 main 的提交发布到生产环境。其他分支和 PR 会自动获得独立的部署预览 URL。

通过 CLI 部署

用于一次性或脚本化部署：

htmlpress build
netlify deploy --prod --dir=.htmlpress/build

首次运行时会提示执行 netlify login，并把目录关联到一个站点。

使用 GitHub Actions 部署

Netlify 的 git 集成通常已经足够，但工作流可以让你先测试再部署：

name: deploy

on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5
      - uses: actions/setup-node@v4
        with:
          node-version: 24
      - run: npx gethtmlpress build
      - uses: nwtgck/actions-netlify@v3
        with:
          publish-dir: .htmlpress/build
          production-deploy: true
        env:
          NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_AUTH_TOKEN }}
          NETLIFY_SITE_ID: ${{ secrets.NETLIFY_SITE_ID }}

在 User settings → Applications → Personal access tokens 中获取认证令牌，在 Site settings → General 中获取站点 ID。

自定义域名

在站点控制台中，进入 Domain management → Add a domain。Netlify 会配置 DNS 和证书。在 htmlpress.yaml 中把同一域名设为 site。

另请参阅

• 站点元数据：site 用于填充 sitemap 中的 URL。
• 部署：返回托管平台索引。