geckou

new-locale

i18n 翻訳キーの追加

geckou 0 Actualitzat fa 2 mesos
GitHub

Instal·la

npx skillscat add geckou/project-starter/new-locale

Instal·la des del registre de SkillsCat.

SKILL.md

new-locale

翻訳キーを追加する。

手順

1. ja.ts と en.ts に同時追加

翻訳ファイルは packages/shared/src/i18n/locales/ にある。
必ず両方のファイルに同じキー構造で追加すること。

  • 日本語: packages/shared/src/i18n/locales/ja.ts
  • 英語: packages/shared/src/i18n/locales/en.ts

2. セクションの追加ルール

既存セクション(common, auth, navigation)に追加する場合はそのセクション内に。
新しい機能用のセクションが必要な場合はセクションごと追加する。

翻訳は セクション.キー の2階層まで。
ja.ts の satisfies Record<string, Record<string, string>> と
packages/shared/tests/i18n.test.ts のキー比較ロジックが2階層前提のため、
3階層以上にする場合は両方の変更が必要。

// ja.ts に追加
posts: {
  title: '投稿',
  create: '新規投稿',
  edit: '投稿を編集',
  delete: '投稿を削除',
  empty: '投稿がありません',
},
// en.ts にも同じキー構造で追加
posts: {
  title: 'Posts',
  create: 'New Post',
  edit: 'Edit Post',
  delete: 'Delete Post',
  empty: 'No posts found',
},

3. 使い方

import { getTranslation, ja } from '@geckou/shared/i18n'

const text = getTranslation(ja, 'posts.title') // → '投稿'

4. テストが通ることを確認

packages/shared/tests/i18n.test.ts にキー一致テストがあるので、
ja と en のキーが揃っていないとテストが落ちる。

yarn test --filter=@geckou/shared