英語・デンマーク語のi18nシステムを構築
458個の名前空間ファイルに言語ごと12,027件のメッセージを持つ英語・デ
ンマーク語の国際化基盤を構築し、用語と1ファイル400行の上限を静的検査
で守った。
2025

状況.
英語とデンマーク語で動く基盤の翻訳管理は、無秩序になりやすかった。
ファイルが際限なく増え、片方にしかキーがなくなり、言語固有の慣行がば
らつくと、互いに話していない委員会が訳したような文章になる。専門的な
製品では、単なる小さな欠点でなく、不注意と読まれる。

課題. 両言語の一貫性と正確さを保ち、1年後にも人が保守できるファイル
として、国際化の仕組みを拡張可能にする必要があった。

行動.
next‑intlを基盤に、ツールで実際に守る規則を設けた。デンマーク語はæøå
の字形、くだけたdu、命令形の正しいアクセント、複合名詞の語ごとでなく
意味による訳を含む語彙・文体を固定し、静的検査した。名前空間の各ファ
イルを最大400行に制限し、分割した入れ子ファイルをきちんと再統合する
方式とした。言語ごとの12,027件を巨大な少数ファイルでなく458ファイル
へ分けたのは、この上限のためだった。キーを言語間で比較し、漏れを防い
だ。保存済み上書き値は、脆い最上位のフォールバックでなく、設定と同じ
カタログ中心のディープマージで統合した。

結果.
計24,054メッセージでも両言語が正確で一貫し、増加しても保守可能になっ
た。ツールは、各コミットで文書化された語彙・文体・カタログの規則を適
用する。各翻訳の意味や自然さの評価には、引き続き文脈に沿った読み直し
が必要である。1ファイルの上限こそ要であり、なければ458ファイルが12
ファイルになり、誰も開かなくなっていた。

カテゴリー:
1フロントエンド開発	/ja/categories/frontend/	software.engineer.company	70
1フルスタック開発	/ja/categories/full-stack/	software.engineer.company	70
1自動化・CI/CD	/ja/categories/automation/	software.engineer.company	70
1国際化	/ja/categories/i18n/	software.engineer.company	70
1文書作成	/ja/categories/documentation/	software.engineer.company	70

サービス:
1フロントエンド開発	/ja/services/frontend-development/	software.engineer.company	70
1国際化・ローカライズ	/ja/services/i18n-localization/	software.engineer.company	70

hこのページのウェブ版	URL:https://software.engineer.company/ja/portfolio/built-an-english-danish-i18n-system/	software.engineer.company	70
