Skip to content

docs: translate the caching, backend and state guides into Traditional Chinese - #147

Merged
allen0099 merged 1 commit into
masterfrom
docs/zh-tw-guides
Sep 25, 2026
Merged

allen0099 merged 1 commit into
masterfrom
docs/zh-tw-guides

Conversation

@allen0099

Copy link
Copy Markdown
Owner

Part of #89 (PR 2 of 3: guides).

What

Five guides translated into i18n/zh-TW/docs/:

  • HTTP caching (HTTP_CACHING.md)
  • Cache flow (CACHE_FLOW.md)
  • Application cache (APP_CACHE.md)
  • Backends (BACKENDS.md)
  • State (STATE.md)

The zh-TW nav and home page now link to these instead of the English site. Session, JWT claims, the API reference and the development pages still link to English, marked "(英文)".

Conventions

These are now recorded in i18n/zh-TW/GLOSSARY.md.

  • Same anchors as English. Every translated heading carries its English anchor, e.g. ## 快取鍵 {#cache-keys}. Links such as CACHE_FLOW.md#2-cache-control-directives therefore work in both languages. For all five pages, the built heading ids are identical to the English site's.
  • No hard-wrapped Chinese paragraphs. A newline between two CJK characters renders as a stray space in Chrome and Safari, so each paragraph is on one line. This PR also unwraps the home page.
  • Glossary additions: the terms that came up while translating, e.g. 項目 (entry), 本文 (body), 重播 (replay), 行程 (process), 一次性 (one-shot), key builder and worker kept in English.

Code, identifiers, header and directive names stay unchanged; only code comments and the prose in the diagram blocks are translated.

Verified

  • zensical build --strict and zensical build --strict -f zensical.zh-TW.toml both report no issues.
  • Every translated page shows the "may be outdated" banner.

…l Chinese

Translate HTTP caching, Cache flow, Application cache, Backends and State
into i18n/zh-TW/docs/ and point the zh-TW navigation and home page at
them instead of the English site.

Every translated heading keeps its English anchor ({#id}), so section
links work the same in both languages. Chinese paragraphs are not
hard-wrapped, because a line break between two CJK characters renders as
a stray space. The glossary records these conventions and the terms that
came up while translating.

Part of #89
@allen0099
allen0099 merged commit 1bd28bf into master Sep 25, 2026
3 checks passed
@allen0099
allen0099 deleted the docs/zh-tw-guides branch September 26, 2026 11:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant