{"canonical_url":"https://engineer.company/ja/portfolio/built-an-english-danish-i18n-system/","content_markdown":"# 英語・デンマーク語のi18nシステムを構築\n\n458個の名前空間ファイルに言語ごと12,027件のメッセージを持つ英語・デンマーク語の国際化基盤を構築し、用語と1ファイル400行の上限を静的検査で守った。\n\n2025\n\n**状況.** 英語とデンマーク語で動く基盤の翻訳管理は、無秩序になりやすかった。ファイルが際限なく増え、片方にしかキーがなくなり、言語固有の慣行がばらつくと、互いに話していない委員会が訳したような文章になる。専門的な製品では、単なる小さな欠点でなく、不注意と読まれる。\n\n**課題.** 両言語の一貫性と正確さを保ち、1年後にも人が保守できるファイルとして、国際化の仕組みを拡張可能にする必要があった。\n\n**行動.** next‑intlを基盤に、ツールで実際に守る規則を設けた。デンマーク語はæøåの字形、くだけたdu、命令形の正しいアクセント、複合名詞の語ごとでなく意味による訳を含む語彙・文体を固定し、静的検査した。名前空間の各ファイルを最大400行に制限し、分割した入れ子ファイルをきちんと再統合する方式とした。言語ごとの12,027件を巨大な少数ファイルでなく458ファイルへ分けたのは、この上限のためだった。キーを言語間で比較し、漏れを防いだ。保存済み上書き値は、脆い最上位のフォールバックでなく、設定と同じカタログ中心のディープマージで統合した。\n\n**結果.** 計24,054メッセージでも両言語が正確で一貫し、増加しても保守可能になった。ツールは、各コミットで文書化された語彙・文体・カタログの規則を適用する。各翻訳の意味や自然さの評価には、引き続き文脈に沿った読み直しが必要である。1ファイルの上限こそ要であり、なければ458ファイルが12ファイルになり、誰も開かなくなっていた。\n\n---\n\n- 役割: フルスタックエンジニア\n- カテゴリー: [フロントエンド開発](https://engineer.company/ja/categories/frontend/), [フルスタック開発](https://engineer.company/ja/categories/full-stack/), [自動化・CI/CD](https://engineer.company/ja/categories/automation/), [国際化](https://engineer.company/ja/categories/i18n/), [文書作成](https://engineer.company/ja/categories/documentation/)\n- サービス: [フロントエンド開発](https://engineer.company/ja/services/frontend-development/), [国際化・ローカライズ](https://engineer.company/ja/services/i18n-localization/)\n\n\u003chttps://engineer.company/ja/portfolio/built-an-english-danish-i18n-system/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"458ファイルに言語ごと12,027メッセージを持つ英語・デンマーク語i18n基盤を構築し、用語とサイズ上限を静的検査で適用した。","formats":{"gemtext":"https://engineer.company/ja/portfolio/built-an-english-danish-i18n-system/index.gmi","gopher":"https://engineer.company/ja/portfolio/built-an-english-danish-i18n-system/gophermap","html":"https://engineer.company/ja/portfolio/built-an-english-danish-i18n-system/","json":"https://engineer.company/ja/portfolio/built-an-english-danish-i18n-system/index.json","markdown":"https://engineer.company/ja/portfolio/built-an-english-danish-i18n-system/index.md","pdf":"https://engineer.company/ja/portfolio/built-an-english-danish-i18n-system/index.pdf"},"kind":"page","language":"ja","title":"英語・デンマーク語のi18nシステムを構築","url":"https://engineer.company/ja/portfolio/built-an-english-danish-i18n-system/","version":1}