发布与平台状态

本页记录部署状态,不能替代对线上站点的检查。

GitHub Pages——已上线

2026-10-26 针对 cloudQuant/fincore_cpp 的验证结果:

  • Pages 已启用,源类型为 "build_type": "workflow"。分支源(legacy)会让 deploy-pages 失败,因此源必须保持为“GitHub Actions”;任何界面改动之后都要重新读取 GET /repos/.../pages。

  • github-pages 环境带有 custom_branch_policies: true,只允许 master。在其他分支上,部署任务会以零步骤失败、日志为 404 收场,这是策略拒绝了它,而不是构建出了问题。本处使用的令牌只能通过界面维护白名单。

  • docs 工作流运行 40286395187 是第一次 build、pages、deploy 三步全绿;之后在 master 上的运行重复了这一结果。因此发布通过合并到 master 完成。

线上地址(2026-10-26 均返回 200):

  • 落地页:/fincore_cpp/

  • 英文:/fincore_cpp/en/latest/

  • 中文:/fincore_cpp/zh-cn/latest/

  • 两种语言都核对过的深页:installation.html、guides/metrics.html、api/metrics.html,中文侧另加 conventions.html

  • 静态资源:/fincore_cpp/en/latest/_static/css/theme.css

语言目录是 en/latest/ 与 zh-cn/latest/——访问 en/ 或 zh_CN/ 会返回 404,但这不能说明部署有问题。Pages 构建把版本放在路径段(latest)里,没有 Read the Docs 那样的版本切换器。

Read the Docs——已上线,单一项目

Read the Docs 承载一个项目 fincore_cpp(slug fincore-cpp),从 master 用 .readthedocs.yaml 构建英文源。不创建翻译项目:中文文档是 GitHub Pages 构建,右上角的语言切换会把中文读者带到同一页面。

2026-10-26 线上验证(构建 35413440,84 秒,提交 da90c0d):

地址

状态

字节

/en/latest/

200

51,969

/en/latest/installation.html

200

40,013

/en/latest/api/metrics.html

200

674,060

/en/latest/_static/css/theme.css

200

137,285

/en/latest/searchindex.js

200

926,324

RTD 每一页的 canonical 链接都指向它自己的 RTD 地址。切换器的中文入口在 API 页上解析为 https://cloudquant.github.io/fincore_cpp/zh-cn/latest/api/metrics.html —— 在线上 RTD 站点点击后落到该页面,标题为「指标」,lang="zh-CN"。

所有者说明:项目以默认分支 master、语言 English、无翻译的方式导入。build.os 与 Doxygen 预构建步骤都在 .readthedocs.yaml 里,因此以后修改配置就是仓库改动,并会在下一次构建中体现。

规则

本地 HTML 构建属于“可部署产物”;平台构建但未检查线上页面属于“线上检查待完成”;二者都不是发布 PASS。如果某个语言或平台失败,先前验证过的站点必须保持可用,并记录失败的组合。