Localize the app into Traditional Chinese and Japanese - #59
Merged
Conversation
String Catalogs (app, widgets, InfoPlist) with English text as the key; every user-visible sheet, alert, menu, notification, guide, FAQ and release-note string goes through String(localized:), while the TALLY micro chrome (DONE, ESC, LIVE, telemetry) stays English by design. Language is chosen per app in Settings.app; Multiplex Settings gains a LANGUAGE row that deep-links there. `./Tools/build.sh strings` folds the build's .stringsdata into the catalogs (the IDE-only sync step); StringCatalogTests fails when a key lacks a zh-Hant or ja value. Integer interpolations that must not be locale-grouped (ports, line numbers) interpolate String(...). Every translated row is needs_review pending a native pass; zh-Hant was linted with zhtw-mcp. Decisions and glossary: docs/agents/i18n.md.
No spaces between full- and half-width characters, full-width colons, no spaces around slashes/brackets, spaced em dashes; textlint is now the recorded ja lint step in docs/agents/i18n.md.
ReleaseNotes.swift reverts to plain literals; its 93 catalog keys are gone. Versioned copy is rewritten every release, so the per-release translation pass buys little — the App Store release notes are localized instead.
jhen0409
force-pushed
the
i18n-zh-hant-ja
branch
from
August 18, 2026 07:17
2dcc02d to
9f57910
Compare
…g reset Conflict resolutions keep main's new Guide wording wrapped in String(localized:); the i18n TestFlight bullet moves into the fresh post-1.4.0 section. New/reworded strings synced into the catalog with zh-Hant/ja drafts marked needs_review.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Multiplex/Localizable.xcstrings,MultiplexWidgets/Localizable.xcstrings,Multiplex/InfoPlist.xcstrings) with English text as the key — 1,057 app keys + 40 widget keys, all withzh-Hant(Taiwan wording) andjavalues, every rowneeds_reviewpending a native pass.docs/agents/i18n.md): A prose / sheets / alerts / notifications / Guide / FAQ (the in-app release-notes card stays English by decision) and B menus, section headers, row titles are localized; C TALLY micro chrome (DONE,CANCEL,ESC,LIVE, telemetry) stays English by design../Tools/build.sh stringsruns thexcstringstool syncthe IDE would (xcodebuild only emits.stringsdata);StringCatalogTestsfails when any non-stale key lacks a zh-Hant/ja value or the bundle lacks eitherlproj.String(localized:)locale-groups integer interpolations (port 2,222) — ports and line numbers now interpolateString(...); recorded in the doc.zhtw-mcp lint --translationese-domain technical; glossary decisions (工作階段 / 連接·中斷連接 / Deck·Agent·Shell unchanged, Apple's 拷貝 for Copy) applied throughout.Proof
visionOS + iPad simulator under
-AppleLanguages "(zh-Hant)"/"(ja)": Deck + release card, Settings, Add Host, Pro paywall, FAQ, terminal GUIDE — CJK falls back to PingFang/Hiragino cleanly, no clipping observed; chrome stays English../Tools/build.sh lintclean · visionOS unit tests green (incl. the new catalog test) · iPad build green.Follow-up
PR 2 (stacked): App Store metadata for zh-Hant / ja + CJK-range rule in
Tools/metadata_limits.rb.