发布 · 主题版本

变更记录

在 Banyan 仓库的 content/articles/changelog/unreleased/index.md 及其中文译文记录用户可见的变化、配置要求和实际修复。 合并同类条目,不记录内部重构、测试细节或仅属于消费站点的变化。首次发布说明主要能力、使用要求和已知限制,不列开发期旧格式的迁移历史。后续版本只记录相对上一发布版的用户变化;需要操作时,说明受影响配置和处理步骤。

发布时将该 bundle 移至 Banyan 仓库的 content/articles/changelog/vX.Y.Z/,把 title 设为 vX.Y.Z、 url 设为 p/vX.Y.Z/,把 date 和 lastmod 设为发布日期。 新建 unreleased bundle,将 date 和 lastmod 设为新页面的首次发布日期;“未发布”指软件版本状态。集合布局会自动列出版本页面。 版本说明发布在 https://banyan.swaw.com/p/vX.Y.Z/,中文在 https://banyan.swaw.com/zh/p/vX.Y.Z/;内容目录移动不改变这些正文网址。

配套标签

在 Banyan 仓库更新 Skill 的 metadata.version 和 module/theme.toml 的 version, 使用同一本次版本号,将源码、文档和版本说明提交到同一个 Banyan 提交。 两个发布标签都创建在 Banyan 仓库,指向该提交。

进入 Banyan 仓库根目录后执行。命令从当前提交读取版本,校验 Theme、Skill 版本和 Module 标识,再向 origin 原子发布配套标签:

swban deploy/release/tag --check  #校验并查看标签计划
swban deploy/release/tag          #原子发布两个版本标签

命令读取已提交的版本文件。运行前提交本次源码和文档,并用 --check 核对版本与目标仓库。

以版本 0.1.0 为例,v0.1.0 用于项目发布和提取 Skill; module/v0.1.0 供 Go 将子目录 Module 识别为 v0.1.0。 因为 Module 根目录是 module/,仅有项目标签不能提供该 Module 的语义版本。 这是 Go 的子目录 Module 标签规则。 GitHub Release 使用 v0.1.0,无需再为 module/v0.1.0 创建 Release。 若附带 Skill ZIP,包含 Skill 目录和许可证,排除 .tools、node_modules 和缓存。

GitHub Release

需要 GitHub CLI 时再准备和登录:

ghbw.cmd .setup                #准备 GitHub CLI
ghbw.cmd auth login --web      #登录 GitHub

用该提交构建并发布 Banyan 参考站点,核对版本页面后,用上述命令发布标签,再创建 Release:

ghbw.cmd release create v0.1.0 --verify-tag --notes https://banyan.swaw.com/p/v0.1.0/  #链接发布说明

需要附件时,追加 Skill ZIP 路径。--verify-tag 防止命令隐式新建标签。

版本显示

Powered by 使用 Hugo 的 hugo.Deps 读取实际主题 Module 版本。 本地替换显示“Local development”;Module 的提交和未提交状态用于诊断。 站点基于时间戳的构建/PWA 版本与主题发布版本独立。

横向滚动 · 单击或按 Esc 退出