docs: publish OINK v1.1.0 documentation

Author: Vonng

README.md

@@ -13,8 +13,8 @@ Landing pages, and migration boundaries.
 Do not clone this regression repository as a project template. Use the small,
 public GitHub template at
 [`pgsty/oink-starter`](https://github.com/pgsty/oink-starter), then follow the
-[Starter tutorial](https://oink.pgsty.com/docs/start/starter/). It pins the
-current release and includes neutral Docs, Blog, Book, language profiles, and
+[Starter tutorial](https://oink.pgsty.com/docs/start/starter/). It pins a
+published release and includes neutral Docs, Blog, Book, language profiles, and
 GitHub Pages / Cloudflare Pages workflows without this site's test harness or
 project-specific configuration.
 

content/blog/release/1.1.0.md

@@ -3,26 +3,20 @@ title: OINK 1.1.0 — Native locales, navigation, and site extensions
 linkTitle: OINK v1.1.0
 date: 2026-09-20T00:00:00+08:00
 lastmod: 2026-09-20T00:00:00+08:00
-draft: true
+draft: false
 description: >-
-  Release preparation for OINK 1.1.0: 32 native interface catalogs, taxonomy
+  OINK 1.1.0 brings 32 native interface catalogs, taxonomy
   directories, reliable sidebar state, site-owned search actions, and fixes
   for printing, keyboard focus, and copying images.
 authors: [oink]
 categories: [release]
 tags: [Oink, Release]
 series: [oink-releases]
 series_weight: 31
+release_url: https://github.com/pgsty/oink/releases/tag/v1.1.0
 ---
 
-> [!IMPORTANT] Release preparation — 2026-09-20
-> This draft describes the implementation prepared on `main` for OINK 1.1.0.
-> Neither `v1.1.0` nor a release-candidate tag has been published. The current
-> public release and this site's module pin remain `v1.0.0`. Source acceptance
-> is complete; tag publication, the documentation site's dependency upgrade,
-> and deployment remain separate steps to complete.
-
-OINK 1.1.0 is prepared as the first minor release after the stable 1.0 contract.
+OINK 1.1.0 is the first minor release after the stable 1.0 contract.
 It completes the native interface catalogs, makes taxonomy roots useful as
 navigation directories, and addresses community feedback about sidebar state,
 keyboard focus, grouping, and search extensions. Existing 1.0 content and
@@ -176,9 +170,8 @@ passed the [pinned-toolchain theme CI](https://github.com/pgsty/oink/actions/run
 Hugo checks, browser-runtime tests, and Book publication checks. The earlier
 community-fix acceptance and the subsequent bilingual image-copy regression
 are recorded in the [upstream review](/docs/design/research/2026-09-19-upstream-review/).
-Those are source and test results, not evidence of a public 1.1.0 release.
 The additional initialization, action-concurrency, and keyboard-focus fixes
-and final candidate acceptance are recorded in the
+and source acceptance are recorded in the
 [release review](/docs/design/research/2026-09-20-release-review/).
 Local acceptance passed 44 JavaScript tests, 57 site tests, and 149 Chromium
 tests. Hugo Extended 0.160.1 also passed the selected compatibility checks and
@@ -189,20 +182,21 @@ is supplied. Checker-owned Hugo processes have a 120-second ceiling, and
 redundant warning-fatal builds were removed while retaining per-case
 diagnostic and fallback assertions.
 
-The source candidate has passed acceptance. Publication still needs a
-resolvable public tag, a matching consumer pin and checksum, a build using
-that published module, and deployed-page checks. This draft will be updated
-with the publication evidence when those steps complete.
+The published [`v1.1.0`](https://github.com/pgsty/oink/releases/tag/v1.1.0) tag
+points to [`3a18234`](https://github.com/pgsty/oink/commit/3a18234aa3af15ae12e2d53839ffd321ef4bcb62),
+which adds only the finalized changelog to the accepted implementation and
+passed all three [release-commit CI jobs](https://github.com/pgsty/oink/actions/runs/35482327047).
+A fresh-cache download from the [official Go module proxy](https://proxy.golang.org/github.com/pgsty/oink/@v/v1.1.0.info)
+resolved to that commit; the module archive and `go.mod` checksums were verified
+against [sum.golang.org](https://sum.golang.org/lookup/github.com/pgsty/oink@v1.1.0).
 
-## Upgrade {#upgrade}
+A theme release does not update consumer sites automatically. Each site still
+needs to pin the new module, build it without a filesystem replacement, and
+verify the deployed output.
 
-Until the tag is published, keep production on its current known-good pin.
-Maintainers can preview the prepared implementation with the sibling-checkout
-`make check`, `make browser`, and `make dev` targets described in the
-[local preview guide](/docs/admin/preview/); these do not change `go.mod`.
+## Upgrade {#upgrade}
 
-**After `v1.1.0` is published and resolves through the module proxy**, upgrade
-with:
+Pin the published version and run a strict production build:
 
 ```bash
 hugo mod get github.com/pgsty/oink@v1.1.0
@@ -217,4 +211,4 @@ alongside the site's language, light/dark, and subpath routes. Detailed steps
 are in the [1.0-to-1.1 upgrade checklist](/docs/admin/upgrade/#from-1-0).
 
 The repository-level change ledger remains in
-[CHANGELOG.md](https://github.com/pgsty/oink/blob/main/CHANGELOG.md).
+[CHANGELOG.md](https://github.com/pgsty/oink/blob/v1.1.0/CHANGELOG.md).

content/blog/release/1.1.0.zh.md

@@ -3,23 +3,19 @@ title: OINK 1.1.0：原生多语言界面、导航与站点扩展
 linkTitle: OINK v1.1.0
 date: 2026-09-20T00:00:00+08:00
 lastmod: 2026-09-20T00:00:00+08:00
-draft: true
+draft: false
 description: >-
-  OINK 1.1.0 发布准备：32 份原生界面目录、分类法目录、可靠的侧栏状态、站点自定义
+  OINK 1.1.0 带来 32 份原生界面目录、分类法目录、可靠的侧栏状态、站点自定义
   搜索动作，以及打印、键盘焦点和图片复制修复。
 authors: [oink]
 categories: [release]
 tags: [Oink, Release]
 series: [oink-releases]
 series_weight: 31
+release_url: https://github.com/pgsty/oink/releases/tag/v1.1.0
 ---
 
-> [!IMPORTANT] 发布准备 — 2026-09-20
-> 本草稿说明 `main` 上为 OINK 1.1.0 准备的实现。`v1.1.0` 与候选版本标签均未发布；
-> 当前公开版本与本站模块固定版本仍是 `v1.0.0`。源码验收已完成；发布标签、文档站
-> 升级依赖与部署仍是尚待完成的独立步骤。
-
-OINK 1.1.0 按稳定 1.0 契约之后的第一个次版本准备：补齐原生界面翻译，让分类法根页
+OINK 1.1.0 是稳定 1.0 契约之后的第一个次版本：补齐原生界面翻译，让分类法根页
 成为实用的导航目录，并处理社区对侧栏状态、键盘焦点、内容分组与搜索扩展的反馈。
 现有 1.0 内容与配置不需要迁移源码。
 
@@ -134,26 +130,30 @@ partial、受支持的搜索后端与迁移工具均继续保留。
 实现提交 [`08f6563`](https://github.com/pgsty/oink/commit/08f656303ba4b1299db92973bc02a4c5d3ba1ca3) 已通过
 [固定工具链主题 CI](https://github.com/pgsty/oink/actions/runs/35477171223) 的 Hugo 检查、
 浏览器运行时测试与 Book 出版检查。此前的社区修复验收，以及后续中英文图片复制回归，
-记录在[上游调研报告](/zh/docs/design/research/2026-09-19-upstream-review/)。这些是源码
-与测试结果，不能作为 1.1.0 已公开发布的证据。补充的初始化、动作并发与键盘焦点修复
-及最终候选验收记录在[发布审查报告](/zh/docs/design/research/2026-09-20-release-review/)。
+记录在[上游调研报告](/zh/docs/design/research/2026-09-19-upstream-review/)。补充的初始化、
+动作并发与键盘焦点修复，以及源码验收记录在
+[发布审查报告](/zh/docs/design/research/2026-09-20-release-review/)。
 本地验收通过 44 项 JavaScript 测试、57 项站点测试和 149 项 Chromium 测试。
 Hugo Extended 0.160.1 也通过定向兼容性检查与真实文档站的严格生产构建。
 
 输出检查器默认构建新 fixture，只有显式指定输出目录时才复用已有结果。检查器启动的
 每个 Hugo 进程都有 120 秒上限；重复的 warning-fatal 构建已去除，逐例诊断与回退断言
 仍然保留。
 
-源码候选已通过验收；发布阶段还要提供可解析的公开标签、固定消费站依赖及校验和、
-用公开模块构建，再检查部署后的页面。本草稿会在这些步骤完成后补齐发布证据。
+已发布的 [`v1.1.0`](https://github.com/pgsty/oink/releases/tag/v1.1.0) 标签指向
+[`3a18234`](https://github.com/pgsty/oink/commit/3a18234aa3af15ae12e2d53839ffd321ef4bcb62)，
+该提交仅在已验收实现上收口更新日志，并通过全部三项
+[发布提交 CI](https://github.com/pgsty/oink/actions/runs/35482327047)。
+通过全新缓存从[官方 Go 模块代理](https://proxy.golang.org/github.com/pgsty/oink/@v/v1.1.0.info)
+下载的版本准确解析到该提交；模块归档与 `go.mod` 的校验和均已通过
+[sum.golang.org](https://sum.golang.org/lookup/github.com/pgsty/oink@v1.1.0) 验证。
 
-## 升级 {#upgrade}
+主题发布不会自动更新消费站。各站点仍需固定新模块，在没有文件系统替换的情况下
+构建，并验证部署后的输出。
 
-标签发布前，生产站点继续使用当前已知可用的固定版本。维护者可按
-[本地预览指南](/zh/docs/admin/preview/) 使用同级 checkout 的 `make check`、
-`make browser` 与 `make dev` 验证准备中的实现；这些命令不会修改 `go.mod`。
+## 升级 {#upgrade}
 
-**`v1.1.0` 发布并能通过模块代理解析后**，再执行：
+固定公开版本并执行严格生产构建：
 
 ```bash
 hugo mod get github.com/pgsty/oink@v1.1.0
@@ -167,4 +167,4 @@ hugo --cleanDestinationDir --gc --minify --environment production \
 [1.0 → 1.1 升级核对项](/zh/docs/admin/upgrade/#from-1-0)。
 
 仓库级完整变更记录继续保存在
-[CHANGELOG.md](https://github.com/pgsty/oink/blob/main/CHANGELOG.md)。
+[CHANGELOG.md](https://github.com/pgsty/oink/blob/v1.1.0/CHANGELOG.md)。

content/docs/_index.md

@@ -43,7 +43,9 @@ OINK is a Hugo theme for technical documentation. Components are part of the
 Markdown syntax rather than a second template language; the fonts, icons,
 search and diagram runtimes the browser needs ship with the theme; the only
 build dependency is one Hugo Extended binary, with no Node.js and no CDN
-request. The current release is {{% param version %}}.
+request. The current release is {{% param version %}}; see the
+[OINK 1.1 release notes](/blog/release/1.1.0/) and
+[upgrade guide](/docs/admin/upgrade/#from-1-0).
 
 ## Five ways in {#five-entries}
 

content/docs/_index.zh.md

@@ -29,7 +29,7 @@ cascade:
   search_boost: 1.35
 ---
 
-OINK 是一款技术文档 Hugo 主题。组件是 Markdown 语法的一部分，不是另一套模板语言；浏览器需要的字体、图标、搜索与图表运行时随主题分发；构建依赖只有一个 Hugo Extended 二进制，不需要 Node.js，不请求 CDN。当前发布版本 {{% param version %}}。
+OINK 是一款技术文档 Hugo 主题。组件是 Markdown 语法的一部分，不是另一套模板语言；浏览器需要的字体、图标、搜索与图表运行时随主题分发；构建依赖只有一个 Hugo Extended 二进制，不需要 Node.js，不请求 CDN。当前发布版本 {{% param version %}}，详见 [OINK 1.1 发布注记](/zh/blog/release/1.1.0/)与[升级指南](/zh/docs/admin/upgrade/#from-1-0)。
 
 ## 五条入口 {#five-entries}
 

content/docs/admin/upgrade.md

@@ -1,7 +1,7 @@
 ---
 title: Upgrade
 linkTitle: Upgrade
-description: Pin a published theme version, prepare a 1.0-to-1.1 upgrade, migrate legacy content or a Docsy site, and roll back safely.
+description: Pin a published theme version, upgrade from 1.0 to 1.1, migrate legacy content or a Docsy site, and roll back safely.
 weight: 50
 search_keywords: [upgrade, migration, version, Hugo Module, hugo mod get, oink06, Docsy, jQuery, breaking changes]
 aliases:
@@ -34,13 +34,12 @@ guessing afterwards why a page looks different.
 ## Upgrading the Hugo Module {#hugo-module}
 
 A production site pins a published release tag or a deliberately selected
-immutable commit, follows no branch, and does not use `@latest`. As of
-2026-09-20, the public release is `v1.0.0`; `v1.1.0` is still in preparation.
-The example below uses the available tag. Use a later tag only after its
-publication and module resolution have been verified:
+immutable commit, follows no branch, and does not use `@latest`. The example
+below upgrades to the published `v1.1.0` tag. For a later release, verify its
+publication and module resolution before selecting that tag:
 
 ```bash {title="Terminal"}
-hugo mod get github.com/pgsty/oink@v1.0.0   # the verified published tag
+hugo mod get github.com/pgsty/oink@v1.1.0   # the published release tag
 hugo mod tidy
 hugo mod graph | grep github.com/pgsty/oink
 ```
@@ -56,7 +55,7 @@ module github.com/pgsty/oink.pgsty.com
 
 go 1.27.0
 
-require github.com/pgsty/oink v1.0.0
+require github.com/pgsty/oink v1.1.0
 ```
 
 > [!DANGER] A local module replacement overrides that pin
@@ -70,7 +69,7 @@ check out the exact published version rather than following its remote branch:
 
 ```bash {title="Terminal"}
 git -C themes/oink fetch origin --tags
-git -C themes/oink checkout --detach v1.0.0
+git -C themes/oink checkout --detach v1.1.0
 git add themes/oink
 ```
 
@@ -99,12 +98,12 @@ Once the build passes, look with your own eyes: the home page, a documentation
 page, a blog page, the 404, both languages, both colour schemes, the print view,
 and anywhere the site customized something.
 
-## Preparing the 1.0-to-1.1 upgrade {#from-1-0}
+## Upgrading from 1.0 to 1.1 {#from-1-0}
 
-> [!IMPORTANT] Implementation prepared; release pending
-> This checklist describes the implementation on `main` as of 2026-09-20.
-> `v1.1.0` is not yet a published module tag. It does not change the production
-> version pinned above or prove that a consumer has been deployed.
+> [!IMPORTANT] OINK 1.1.0 upgrade checklist
+> This checklist covers the published v1.1.0 release. Each consumer still needs
+> to update its dependency pin, rebuild and deploy; theme publication does not
+> upgrade an existing site automatically.
 
 No source migration is required from 1.0.0. Hugo Extended 0.160.1 remains the
 floor; CI uses the pinned 0.165.0 toolchain. The module's Go 1.27.0 directive is
@@ -134,7 +133,7 @@ Update or remove affected site-level copies of theme code after comparing
 them with the new implementation. A copied old image-zoom script or sidebar
 partial will otherwise continue to hide the upstream fix.
 
-To test a local candidate with the documentation site, use its sibling theme
+To test local theme changes with the documentation site, use its sibling theme
 checkout without committing a filesystem replacement:
 
 ```bash {title="Terminal — from oink.pgsty.com"}
@@ -143,8 +142,8 @@ make browser
 make dev
 ```
 
-These commands validate the local checkout. After publication, pin the exact
-release, build without a module replacement, then validate the deployed pages.
+These commands validate the local checkout. For release acceptance, pin the
+published version, build without a module replacement, then validate the deployed pages.
 The authoring and API details live in [content groups](/docs/write/organize/#group-only),
 the [sidebar contract](/docs/design/shell/#sidebar-runtime),
 [search actions](/docs/customize/panel/#search-tail), and

content/docs/admin/upgrade.zh.md

@@ -1,7 +1,7 @@
 ---
 title: 版本升级
 linkTitle: 版本升级
-description: 固定已发布的主题版本、准备从 1.0 升到 1.1、迁移旧内容或 Docsy 站点，并在出问题时安全回滚。
+description: 固定已发布的主题版本、从 1.0 升到 1.1、迁移旧内容或 Docsy 站点，并在出问题时安全回滚。
 weight: 50
 search_keywords: [升级, 迁移, 版本, Hugo Module, hugo mod get, oink06, Docsy, jQuery, 破坏性变更, upgrade, migration]
 aliases:
@@ -29,11 +29,11 @@ aliases:
 ## 升级 Hugo Module {#hugo-module}
 
 生产站点固定已发布标签或主动选定的不可变 commit，不跟随分支，也不用 `@latest`。
-截至 2026-09-20，公开版本是 `v1.0.0`，`v1.1.0` 仍在准备中。下面使用已可用的标签；
-更新版本需先确认已经发布且模块可以解析，再替换示例中的版本。
+下面升级到已发布的 `v1.1.0` 标签；选择后续版本时，先确认已经发布且模块可以解析，
+再替换示例中的版本。
 
 ```bash {title="终端"}
-hugo mod get github.com/pgsty/oink@v1.0.0   # 已确认发布的标签
+hugo mod get github.com/pgsty/oink@v1.1.0   # 已发布的版本标签
 hugo mod tidy
 hugo mod graph | grep github.com/pgsty/oink
 ```
@@ -47,7 +47,7 @@ module github.com/pgsty/oink.pgsty.com
 
 go 1.27.0
 
-require github.com/pgsty/oink v1.0.0
+require github.com/pgsty/oink v1.1.0
 ```
 
 > [!DANGER] 本地模块替换会盖掉这个固定版本
@@ -58,7 +58,7 @@ require github.com/pgsty/oink v1.0.0
 
 ```bash {title="终端"}
 git -C themes/oink fetch origin --tags
-git -C themes/oink checkout --detach v1.0.0
+git -C themes/oink checkout --detach v1.1.0
 git add themes/oink
 ```
 
@@ -80,11 +80,11 @@ hugo --gc --minify --printPathWarnings --panicOnWarning --logLevel info
 
 构建通过之后，人眼再过一遍：首页、一个文档页、一个博客页、404、两种语言、两种配色、打印视图，以及站点自己定制过的地方。
 
-## 准备从 1.0 升到 1.1 {#from-1-0}
+## 从 1.0 升到 1.1 {#from-1-0}
 
-> [!IMPORTANT] 实现已准备，版本尚未发布
-> 本清单说明截至 2026-09-20 的 `main` 实现。`v1.1.0` 还不是已发布的模块标签，
-> 这份清单不改变上面的生产版本固定，也不代表任何消费站已经部署。
+> [!IMPORTANT] OINK 1.1.0 升级清单
+> 本清单对应已发布的 v1.1.0。各消费站仍需更新依赖固定版本、重新构建和部署；
+> 主题发布不会自动升级既有站点。
 
 从 1.0.0 升级不需要迁移源码。Hugo Extended 0.160.1 仍是下限，CI 固定使用 0.165.0，
 模块的 Go 1.27.0 声明与 1.0.0 相同。在 Hugo 0.160.x 上，非默认通用 `zh` 与区域中文
@@ -111,15 +111,15 @@ hugo --gc --minify --printPathWarnings --panicOnWarning --logLevel info
 将受影响的站点级主题副本与新实现比较后再更新或移除。保留旧图片缩放脚本或侧栏
 partial，会让站点继续使用旧实现，无法获得上游修复。
 
-在文档站验证本地候选实现时，使用同级主题 checkout，不要提交文件系统模块替换：
+在文档站验证本地主题修改时，使用同级主题 checkout，不要提交文件系统模块替换：
 
 ```bash {title="终端 — 在 oink.pgsty.com 目录内"}
 make check
 make browser
 make dev
 ```
 
-这些命令验证的是本地 checkout。发布后，再固定精确版本，在没有模块替换的情况下
+这些命令验证的是本地 checkout。验收正式版本时，固定已发布标签，在没有模块替换的情况下
 构建，并验证部署后的页面。创作与 API 细节见[内容分组](/zh/docs/write/organize/#group-only)、
 [侧栏契约](/zh/docs/design/shell/#sidebar-runtime)、
 [搜索动作](/zh/docs/customize/panel/#search-tail) 与[图片缩放](/zh/docs/components/image/#zoom)。

content/docs/components/image/index.md

@@ -182,7 +182,7 @@ and gallery images that have alt text become clickable buttons that open the
 full image in a native `<dialog>` (Esc closes it, focus returns where it was).
 This page turns it on in its front matter, so every image above is clickable.
 
-The 1.1 implementation on main keeps the preview action in the button's
+Since OINK 1.1, the preview action is kept in the button's
 accessible name, alongside the image description. It adds no helper text to
 copied articles; the copied HTML retains images and authored captions for
 rich-text editors. In v1.0.0, a hidden preview label can appear after pasting.