Files
Anya Tokugawa c1175d389f Implement Knowledge City platform, organizer and DAV integration
Capture accumulated application, UI, CLI, regression tests and design documentation changes, including task project mapping and default CalDAV list naming.

Keep deployment data, backups, local credentials and build artifacts out of Git. Move the Compose enrollment token to an ignored local environment file.
2026-09-27 14:44:43 +09:00

32 lines
2.6 KiB
Markdown

# 19. 多言語と設計書の配信
状態:Revision言語とfallback、日英UIの基盤あり。全画面の言語選択・翻訳管理・公開版の対応は継続課題。
## 同じ知識、同じPath
Pageは言語中立で、RevisionにBCP 47言語tagを持たせます。同じ章の日本語と英語を別Pageとして増やすのではなく、同じPage UUIDの `ja` と `en` を将来の配信先とします。
UI locale、本文の言語、Campus/Domainの既定言語は同じ設定ではありません。本文が日本語でも英語UIを使えます。`und` は言語未指定・legacy互換であり、「全言語で同じ内容」という保証ではありません。
## 解決と権限
明示指定、Accept-Language、地域tagの基底、Campus/system既定、und等を考慮する既存基盤があります。明示選択のURLや全endpointでの一貫性は別の完成条件です。fallbackで別言語を返す場合には選択された言語を把握できるUIが必要です。
非公開の日本語Revisionを英語fallbackで漏らしたり、その逆を起こしてはいけません。公開承認は言語headと正確なRevisionの関係を含めて検査します。自動公開ルールでは各言語の現在headも対象になる点を管理者へ示します。
## 今回の設計書配置
リポジトリの `docs/design/ja/` に日本語の編集元を置き、章IDをファイル名で安定化します。Wikiは `/lab/pageswiki-dev` を総目次とし、その配下へ同じ章IDで配置します。章番号は題名の表示順であってURL identityにしません。
配信用にMarkdownをHTMLへ変換し、`ja` Revisionとして保存します。日本語版を理由に既存英語資料を削除しません。Wiki側の公開権限を追加・変更しません。
英語化は原資料を単に一括アップロードするのではなく、日本語版の章ID・現在状態・決定事項と対応させます。原資料には古い構想が残るため、そのまま最新英語版とは扱えません。
## 翻訳台帳の案
`chapter_id, source_lang, source_hash, target_lang, translated_from_hash, reviewed_at, status` を持ち、元章の変更でstaleを検出します。翻訳の自動生成とreview済み公開を分けます。言語を切り替えると別の章に移動しないことを検証します。
## TODO
言語選択UI、lang別history/diff、translation stale表示、明示指定とcanonical、Content-Language/Vary/cacheの整合、公開言語別の失効、英語版のreview。これらが整うまでは英語の中間資料はリポジトリで保持します。