# 英語・デンマーク語のi18nシステムを構築

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

2025

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

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

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

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

役割: フルスタックエンジニア
=> /ja/categories/frontend/ カテゴリー: フロントエンド開発
=> /ja/categories/full-stack/ カテゴリー: フルスタック開発
=> /ja/categories/automation/ カテゴリー: 自動化・CI/CD
=> /ja/categories/i18n/ カテゴリー: 国際化
=> /ja/categories/documentation/ カテゴリー: 文書作成
=> /ja/services/frontend-development/ サービス: フロントエンド開発
=> /ja/services/i18n-localization/ サービス: 国際化・ローカライズ

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