W传说法师 ARCANA WIKI搜索/
PUBLISHING / 发布准备

确认预览后，再发布。

本 Wiki 使用 Astro 生成静态页面。确认本地预览后，登录 Cloudflare 账号并连接独立的 GitHub 仓库，即可通过 Pages 自动构建、部署和更新。也可直接上传构建好的文件。

构建命令npm run build
输出目录dist
Node.js 版本24.19.0

独立仓库的根目录留空；若子项目放在较大仓库中，根目录填写 wizard-of-legend-wiki。

准备 GitHub 源码

建议新建一个专用于 Wiki 的 GitHub 仓库，并只把本子项目的源码、站点数据和必要资源放入仓库。单独仓库可以清楚界定部署源代码的范围，避免把父项目里的 gameDLL、整包资源或其他本地文件一并上传。

Cloudflare Pages 支持连接 GitHub 私有仓库和公开仓库。私有仓库不会因此变成公开仓库；部署后，构建生成的网站仍会通过其站点地址提供访问。

  1. 在 GitHub 创建一个新的私有仓库，用于保存 Wiki 子项目。
  2. 检查待提交文件，只包含 wizard-of-legend-wiki 子项目所需文件；确认没有 gameDLL、整包资源、账号凭据或本机生成的敏感文件。
  3. 提交并推送至少一个分支，之后在 Cloudflare Pages 创建项目时选择该仓库和生产分支。

Cloudflare 与 GitHub 授权

创建和管理 Pages 项目需要登录 Cloudflare 账号；连接 GitHub 时还需要在 GitHub 中授权 Cloudflare Workers & Pages 应用访问仓库。若仓库属于组织，安装应用通常需要组织所有者或具备相应 GitHub Apps 管理权限的成员。

GitHub 授权时建议选择“Only select repositories”，并仅勾选 Wiki 仓库。这样 Cloudflare 的 GitHub 应用只获得部署该仓库所需的范围。授权应在 Cloudflare 与 GitHub 的官方页面中由账号持有人直接完成；不要把密码、访问令牌、应用密钥或授权链接里的凭据发到聊天中。

  1. 登录 Cloudflare 控制台，进入 Workers & Pages，选择创建 Pages 项目并连接 Git。
  2. 在 GitHub 授权页面选择个人账号或有权限的组织，并将 Cloudflare Workers & Pages 应用的仓库范围设为仅选定仓库。
  3. 选择 Wiki 仓库并授权连接；如果组织仓库未显示，请由组织管理员检查应用安装和仓库访问范围。

选择部署方式

Git 集成会在推送代码后自动构建和部署，也提供分支预览和 Pull Request 预览，适合持续维护的 Wiki。Direct Upload 则上传已经在本机或其他 CI 系统构建好的静态文件，适合自行控制构建流程或手动上传。

Pages 项目创建后不能在 Git 集成与 Direct Upload 之间互相切换。选择 Direct Upload 后不能再把该项目接入 Git；选择 Git 集成后也不能改成 Direct Upload。需要更换方式时，Cloudflare 文档要求创建新的 Pages 项目。这个 Wiki 推荐使用 Git 集成。

  1. 创建项目时选择“Connect to Git”，连接专用 Wiki 仓库。
  2. 不要先用 Direct Upload 创建同一个 Pages 项目；它无法在之后转换成 Git 集成项目。

构建设置

Astro 的 Cloudflare Pages 构建设置为构建命令 npm run build，输出目录 dist。如果仓库只包含 Wiki 子项目，项目根目录使用仓库根目录；如果将来把子项目放进更大的仓库，应把 Pages 的 Root directory 设置为 Wiki 子项目目录。

Cloudflare Pages 的构建环境可通过项目根目录中的 .node-version 指定 Node.js 版本。本项目使用 Node.js 24.19.0，版本文件已经保存。部署时使用仓库提供的版本，不依赖平台默认值。

  1. Framework preset 选择 Astro（如控制台提供该选项）。
  2. Build command 填写 npm run build。
  3. Build output directory 填写 dist。
  4. 确认 Node.js 版本与项目根目录 .node-version 一致；如使用子目录根目录，也确认版本文件位于该构建根目录可读取的位置。

先检查预览，再发布

Git 集成可以为非生产分支生成预览部署。先检查首页、搜索、详情页、来源链接和移动端显示，再确认是否让生产分支部署到正式站点。首次创建或公开生产部署前，按项目的部署流程等待用户确认。

  1. 先推送一个用于检查的分支，并打开 Cloudflare 提供的预览地址。
  2. 确认页面和 Pagefind 搜索索引正常，再决定是否将该分支设为生产分支或合并到生产分支。

官方说明

核对日期：2026-10-11。部署时再检查平台设置。