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

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

2025

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

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

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

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

---

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

<https://engineer.company/ja/portfolio/built-an-english-danish-i18n-system/>
