コンテンツにスキップ

CLI コマンド

新しい Tyndale プロジェクトを初期化します。適切なデフォルト値で tyndale.config.json を作成します。

Terminal window
npx tyndale init

AI プロバイダーの認証情報を設定します。

Terminal window
npx tyndale auth

翻訳可能な文字列を抽出し、設定済みのすべてのロケール向けに翻訳を生成します。

Terminal window
npx tyndale translate [options]
FlagDescription
--locale <code>特定のロケールのみを翻訳
--force変更分だけでなく、すべての文字列を再翻訳
--dry-runファイルを書き込まずに、何が翻訳されるかを表示
--token-budget <n>AI バッチごとのトークン予算(デフォルト: 50000)
--concurrency <n>並列翻訳セッションの最大数(自動検出)

すべてのロケールに完全で整形式の翻訳があるかを確認します。AI への呼び出しは行われません。

Terminal window
npx tyndale validate

問題が見つかった場合は終了コード 1 で終了します。CI パイプラインに最適です。

翻訳は行わずに翻訳可能な文字列を抽出します。AI プロバイダーに送信される内容を確認するのに役立ちます。

Terminal window
npx tyndale extract

サポートされている任意のフレームワーク向けにドキュメントファイル(MDX/MD)を翻訳します。ドキュメントフレームワークを自動検出するか、tyndale.config.json の設定を使用します。

Terminal window
npx tyndale translate-docs [options]
FlagDescription
--content-dir <path>docs コンテンツディレクトリを上書き
--force不足しているファイルだけでなく、すべての docs を再翻訳
--concurrency <n>並列翻訳セッションの最大数(自動検出)

サポートされているフレームワーク: Starlight, Docusaurus, VitePress, MkDocs, Nextra。

translate-docs は、ソースドキュメントのハッシュを追跡するために、プロジェクトルートに .tyndale-docs-state.json を書き込みます。新しいクローンで変更のない docs を再翻訳せずにスキップできるよう、このファイルをコミットしてください。

ドキュメントフレームワークを検出し、設定を tyndale.config.json に保存します。

Terminal window
npx tyndale translate-docs setup

プロジェクトをスキャンしてフレームワークのシグナル(パッケージ依存関係と設定ファイル)を検出し、検出したフレームワークを確認して、設定に docs セクションを書き込みます。

翻訳に使用する AI モデルを変更します。

Terminal window
npx tyndale model