分类: 升级

  • 升级与迁移

    分类:

    本章内容 升级到 0.4.0：场景组件迁移与行为变化检查 升级 OINK：跨版本升级步骤与破坏性变更清单 从 Docsy 迁移：把既有 Docsy 站点切换到 OINK 升级原则 生产站点固定版本标签，不跟随 main 升级前先读目标版本的破坏性变更 在分支上升级并完整验证，再合并 本地构建通过不等于可以发布——预览部署和线上冒烟是独立的门禁

    本章内容 升级到 0.4.0：场景组件迁移与行为变化检查 升级 OINK：跨版本升级步骤与破坏性变更清单 从 Docsy 迁移：把既有 Docsy 站点切换到 OINK 升级原则 生产站点固定版本标签，不跟随 main 升级前先读目标版本的破坏性变更 在分支上升级并完整验证，再合并 本地构建通过不等于可以发布——预览部署和线上冒烟是独立的门禁

  • 迁移现有 Docsy 站点

    分类:

    OINK 旨在替换各站点复制的公共外壳、运行时与短代码，而无需批量重写普通正文。安全迁移应按依赖关系删除覆盖项，把产品专用行为留在站点，并在修改生产环境前先验证临时副本。 迁移原则 固定目标实现，不要把生产站点迁移到未固定版本的分支。 删除覆盖项之前先完成清点。 删除公共主题副本，不删除站点业务逻辑。 在 OINK API 兼容的地方，保持内容 URL、front matter 与短代码行为不变。 unsafe 或在线例外必须显式声明，并且只在过渡期使用。 分别测试构建产物、浏览器行为与托管站点 …

    OINK 旨在替换各站点复制的公共外壳、运行时与短代码，而无需批量重写普通正文。安全迁移应按依赖关系删除覆盖项，把产品专用行为留在站点，并在修改生产环境前先验证临时副本。 迁移原则 固定目标实现，不要把生产站点迁移到未固定版本的分支。 删除覆盖项之前先完成清点。 删除公共主题副本，不删除站点业务逻辑。 在 OINK API 兼容的地方，保持内容 URL、front matter 与短代码行为不变。 unsafe 或在线例外必须显式声明，并且只在过渡期使用。 分别测试构建产物、浏览器行为与托管站点 …

  • 升级 Oink Hugo Module

    分类:

    固定版本 生产站点应导入发布标签或不可变的 commit，绝不能跟随未固定版本的分支。在站点根目录，把 Oink 更新到指定 ref： BASH hugo mod get github.com/pgsty/oink@TARGET_VERSION hugo mod tidy 请把 TARGET_VERSION 替换为发布注记指定的不可变标签，例如 v0.4.1。生产升级策略不要使用未限定版本的模块路径或 @latest。 测试本地 checkout 如果要在不修改已提交模块版本的前提下测试本地 …

    固定版本 生产站点应导入发布标签或不可变的 commit，绝不能跟随未固定版本的分支。在站点根目录，把 Oink 更新到指定 ref： BASH hugo mod get github.com/pgsty/oink@TARGET_VERSION hugo mod tidy 请把 TARGET_VERSION 替换为发布注记指定的不可变标签，例如 v0.4.1。生产升级策略不要使用未限定版本的模块路径或 @latest。 测试本地 checkout 如果要在不修改已提交模块版本的前提下测试本地 …

  • 升级到 Oink 0.4.0

    分类:

    Oink 0.4.0 是统一交付的场景组件版本。Reading & Release、Landing 与 Book 最初按 0.4、0.5、0.6 三条路线设计，但全部随单一公开标签 v0.4.0 发布。不要固定那些历史设计编号。 普通 Docsy 兼容内容、既有首页数据与模块路径保持兼容。升级工作主要是检查新的默认外壳行为，并替换两个已移除的 ICP 专用页脚参数。 1. 固定不可变版本 创建升级分支并更新 Hugo 模块： BASH hugo mod get …

    Oink 0.4.0 是统一交付的场景组件版本。Reading & Release、Landing 与 Book 最初按 0.4、0.5、0.6 三条路线设计，但全部随单一公开标签 v0.4.0 发布。不要固定那些历史设计编号。 普通 Docsy 兼容内容、既有首页数据与模块路径保持兼容。升级工作主要是检查新的默认外壳行为，并替换两个已移除的 ICP 专用页脚参数。 1. 固定不可变版本 创建升级分支并更新 Hugo 模块： BASH hugo mod get …