# 部署 生成的工作流面向 GitHub.com，并将不受信任的验证与受信任的 Pages 构建分开。宿主可以通过 `website/bin/integrate` 或 `website\bin\integrate.cmd` 创建或刷新工作流，无需在本地安装 Ruby 或 Node.js。 ## 拉取请求与推送 每个拉取请求和默认分支推送都会检出完整 Git 历史，运行无依赖的集成偏差检查，安装锁定的 Ruby 与 Node 依赖，并对配置的宿主内容执行真实的生产构建。该构建会编译前端资源、审计生成站点并校验 URL。 工作流会检查整份拉取请求差异，而不是只看最近一次推送，并据此选择两档验证之一： - **宿主验证**适用于内容、翻译和宿主配置变更。它保留生产宿主构建及其审计，但跳过 Chromium、模板与浏览器回归、视觉基线和示例矩阵。 - **完整回归**适用于 Jekyll Obsidian 实现变更。它会安装 Chromium，以浏览器覆盖运行 `website/bin/test`，并构建全部示例部署形态。项目自带的示例会分别在域名根路径构建两个主题，并在项目路径下再次构建 Minimal： 1. 域名根路径，例如 `https://owner.github.io/`。 2. 项目路径，例如 `https://owner.github.io/jekyll-obsidian/`。 `website/` 下的任何变更都会选择完整回归，唯一例外是源仓库自身的内容目录 `website/docs/**`。生成的 `.github/workflows/pages.yml` 一旦变化，也会选择完整回归。同一拉取请求只要同时包含内容和实现变更，就始终执行完整回归。手动运行、首次推送、无效 commit ID、历史缺失或 Git 比较失败都会安全回退到完整回归；工作流不会复用旧运行的分类结果。 拉取请求作业只有 `contents: read` 权限。它们不会调用 `configure-pages`、上传 Pages 构建产物或执行部署。 工作流会监视配置的内容目录、`website/**`、`.github/jekyll-obsidian.yml` 和自身文件。不要手工编辑这些触发路径；内容目录更改后，请重新运行集成命令。完整回归中的浏览器测试与视觉基线始终使用 `website/docs`；两档验证都会通过独立生产构建校验宿主内容，因此自定义文档不会被误判为视觉回归。默认分支上的纯内容推送通过验证后，仍会继续执行受信任的 Pages 构建与部署。 ## 受信任的 Pages 构建 默认分支收到受信任推送，或从默认分支手动运行工作流时，`build_pages` 会等待验证完成。`actions/configure-pages` 提供权威的 `origin` 和 `base_path`。工作流将两者传给 `website/bin/build`，后者在站点目录内写入临时 Jekyll 配置覆盖层。 作品集项目引用 GitHub Markdown 时，验证作业会把每个移动引用解析为 commit，并导出一份经过摘要校验的内容。受信任的 Pages 构建会使用同一份内容，不会再次读取分支，因此一次工作流中的验证与部署不会发布两个不同版本。 上传前，审计会检查 `website/_site/index.html` 是否存在、每个输出路径是否在允许范围内、链接是否为普通文件而不是符号链接或多硬链接文件，并确认站点没有超过 GitHub Pages 的 1 GB 发布限制。 只有部署作业获得 `pages: write` 和 `id-token: write` 权限。它使用 `github-pages` 环境，并报告部署操作返回的 URL。 ## 查找已部署站点 默认分支上的 **Verify and deploy Pages** 成功后，GitHub 会在工作流的 `deploy` 作业和 **Settings → Pages** 中显示公开 URL。部署作业的 `github-pages` 环境也会链接到同一地址。 未配置自定义域名时，名称为 `.github.io` 的仓库使用 `https://.github.io/`，其他仓库使用 `https://.github.io//`。 ## 根站点与项目路径 编译器不会把 `baseurl` 写入 permalink。统一的 URL builder 会把路由与配置的 base path 组合，用于 HTML、资源、canonical 链接、订阅源、站点地图和 JSON 请求。 拉取请求无法取得 Pages metadata 时，`website/bin/build` 会检查 `GITHUB_REPOSITORY`。名称为 `.github.io` 的仓库使用域名根路径，其他仓库使用 `/`。 ## 自定义域名 请在 Pages 设置或通过 GitHub Pages API 配置域名，并在 DNS 服务商处添加所需的 CNAME、A、ALIAS 或 ANAME 记录。使用 Actions 发布时，仓库中的 `CNAME` 文件会被忽略。部署后，应以 **Settings → Pages** 报告的自定义 URL 为准。 添加或删除域名后，请手动运行一次工作流。重新构建会更新 canonical URL、Open Graph 元数据、Atom 链接和站点地图。 本地命令请返回 [[docs/Getting Started|快速开始]]，构建内部实现请参阅 [[docs/development/architecture|架构]]。