Makeまたはnpmスクリプトから翻訳をチェックする

Makefile

チェッカーを pip install kaeris で一度インストールします。レシピ行はタブで始まります。test を i18n-check に依存させることで、テストの前にチェックを実行します。

.PHONY: i18n-check test

i18n-check:
	kaeris check --source locales/en.json --langs de,fr --ci

test: i18n-check
	./run-tests.sh

npmスクリプト

スクリプトはPATHから kaeris を呼び出すだけなので、チェッカーは pip install kaeris からのPythonパッケージです。pretest は test の前に実行され、チェックが失敗するとそれを停止します。

{
  "scripts": {
    "i18n:check": "kaeris check --source locales/en.json --langs de,fr --ci",
    "pretest": "npm run i18n:check",
    "test": "jest"
  }
}

npm テスト

上記のスクリプトを使用した npm test の出力（この実行では test スクリプトは echo でした）。左：問題のないファイル。右：{name} の代わりに {nam} を持つ de.json と、checkout キーが欠落しています。npm は test の前に停止します。

$ npm test

> [email protected] pretest
> npm run i18n:check


> [email protected] i18n:check
> kaeris check --source locales/en.json --langs de,fr --ci

✓ de: complete & placeholder-safe
✓ fr: complete & placeholder-safe
✓ all locales complete & placeholder-safe

> [email protected] test
> echo tests would run here

tests would run here
exit code: 0

$ npm test

> [email protected] pretest
> npm run i18n:check


> [email protected] i18n:check
> kaeris check --source locales/en.json --langs de,fr --ci

✗ de: 1 missing key(s): checkout
✗ de: 1 placeholder mismatch(es):
    greeting: missing ['{name}'], added ['{nam}']
✗ de: 2 translation fault(s):
    greeting: lost placeholder {name}
    greeting: invented placeholder {nam} (not in source)
✓ fr: complete & placeholder-safe
✗ 1 missing key, 1 placeholder mismatch, 2 translation faults
exit code: 1

Makefileのレシピ行

i18n-check ターゲットが実行するコマンドと同じコマンドと、その終了コード。

$ kaeris check --source locales/en.json --langs de,fr --ci
✓ de: complete & placeholder-safe
✓ fr: complete & placeholder-safe
✓ all locales complete & placeholder-safe
exit code: 0

$ kaeris check --source locales/en.json --langs de,fr --ci
✗ de: 1 missing key(s): checkout
✗ de: 1 placeholder mismatch(es):
    greeting: missing ['{name}'], added ['{nam}']
✗ de: 2 translation fault(s):
    greeting: lost placeholder {name}
    greeting: invented placeholder {nam} (not in source)
✓ fr: complete & placeholder-safe
✗ 1 missing key, 1 placeholder mismatch, 2 translation faults
exit code: 1

1. チェッカーをインストールする

   テストを実行するマシンまたはCIイメージで pip install kaeris を実行します。

2. ターゲットまたはスクリプトを追加する

   Makefileに i18n-check ターゲットを追加するか、package.json に i18n:check および pretest スクリプトを追加し、独自の --source と --langs を設定します。

3. 通常のコマンドを実行する

   make test または npm test は、最初にチェックを実行し、翻訳が壊れている場合は非ゼロの終了コードで停止します。

• 実行された内容

  上記のスクリプトを使用した npm test。ただし、test は echo でした（npm 11.17、Node 24）。PATHにはPyPIから kaeris 0.2.35 がありました。クリーンなファイル：終了コード 0、テスト実行済み。壊れた de.json：終了コード 1、テストは実行されませんでした。

• 実行されなかった内容

  make は、これがチェックされたマシンにはインストールされていません。レシピ行はシェル経由で実行されました。これはmakeが行うことなので、上記の終了コードは本物ですが、Makefile自体はmakeによって実行されませんでした。

• npm

  npmレジストリにはまだkaerisパッケージがないため、このページはnpmへのリンクを送信しません。Nodeプロジェクトは、上記のようにPythonパッケージを呼び出します。

• 古いキーでも失敗する

  --strict は、翻訳にソースに存在しないキーがある場合にも失敗します。

• ブランド名をそのまま保持する

  --glossary 'KAERIS,GitHub' は、いずれかの用語が欠落しているターゲットを失敗させます。同じリストは kaeris.json の keep の下に置くこともできます。

• 異なるファイルレイアウト

  --out は翻訳が含まれるフォルダで、--pattern '{lang}/common.json' はファイル名です。デフォルト：kaeris translate が書き出すレイアウト。

• フラグなし

  プロジェクトに kaeris.json がある場合（kaeris init が作成します）、kaeris check はそこからソース、言語、フォルダを取得します。

その他のレシピ：GitHub Actions · GitLab CI · pre-commit

CLIリファレンス · Checkリファレンス · GitHub Actionリファレンス · ブラウザでの無料チェック · ブラウザでの翻訳