リソーストランスレーター

参考文献

入力と出力

すべての入力はオプションのリポジトリ設定ファイルでも受け入れられます。両方が設定されると、アクション入力が勝ちます。

このページで

YAMLスキーマとロード順序については構成を参照してください。

必要な入力

必要な入力
名称	概要
`sourceLocale`	ソースロケート(例:`en`)は、`*/.en.resx`などのリソースファイルを見つけるために使われます。また、`from=<locale>`としてトランスレーターにも転送されました。
`subscriptionKey`	Azure AI Translator subscription key.`secrets`を通って。
`endpoint`	トランスレーターエンドポイントURL(例:`https://api.cognitive.microsofttranslator.com/`)。

一般的なオプション入力

一般的なオプション入力
名称	デフォルト	概要
`region`	なし	翻訳リソース領域(グローバルリソースは省略)。
`toLocales`	すべてサポート	翻訳する場所。JSON配列(`["fr","de"]`)またはカンマ区切られた値を受け入れます。
`include`	なし	ニューライン分離球状パターン;翻訳されるのは一致するファイルのみです。
`exclude`	なし	ニューライン分離球状パターン;マッチングファイルはスキップされます(include後に適用されます)。
`configPath`	`.github/resource-translator.yml`	YAML設定ファイルへのパス(ワークスペースルートに対して)。
`dryRun`	`false`	`true`時は翻訳を実行し、サマリーを発行しますが、ファイルを書き込みません。
`failOnError`	`true`	`true`すると予期せぬエラーが動作に失敗します。`false`時はエラーが警告となります。

トランスレーター要求入力

これらはAzure AI Translator v3のクエリパラメータに直接マッピングされます。すべては任意です。トランスレーターのデフォルトは設定されていないときに適用されます。

トランスレーター要求入力
名称	デフォルト	概要
`categoryId`	general	Azure Custom Translator category — the industry/domain/tone knob.`?category=...`として転送されました。
`textType`	`plain`	`plain`か`html`。リソース値が実際のHTMLフラグメントである場合にのみ`html`を使ってください。
`profanityAction`	`NoAction`	`NoAction`、`Marked`、または`Deleted`。翻訳における下品な言葉の発せ方を制御します。
`profanityMarker`	`Asterisk`	`Asterisk`か`Tag`。それが意味のあるのは`Marked` `profanityAction`時だけです。
`allowFallback`	true(トランスレーターのデフォルト)	`false`すると、`categoryId`がターゲットロケーションにデプロイしていない場合、トランスレーターはエラーを返します。一般的なシステムに戻るのではなく。
`apiVersion`	`3.0`	トランスレーターREST APIバージョン。

レジリエンスとプレースホルダー保護

これらの入力は、Translatorがリクエストを制限した際のアクションの挙動や、{{name}}や{0}のようなプレースホルダートークンが翻訳中に破損しないように保護する仕組みを制御します。

レジリエンスとプレースホルダー保護入力
名称	デフォルト	概要
`maxRetries`	`5`	一時的なHTTP応答に対する最大リトライ試行数(`408, 425, 429, 500, 502, 503, 504`)。リクエストあたりのHTTP呼び出し数の総数は`1 + maxRetries`です。
`retryBackoffMs`	`30000`	バックオフスリープの1回分はミリ秒単位でキャップを設定しましょう。アクションはAzureの`Retry-After`応答ヘッダーを正確に尊重します。それ以外の場合は、この値に上限を設けたジッター指数バックオフを使用します。
`protectPlaceholders`	`true`	`true`(デフォルト)になると、`{{name}}`、`${var}`、`{0}`、`{0:N2}`、`%s`、`%1$s`、HTMLなどのプレースホルダーは、翻訳前にセンチネルトークンに置き換えられ、翻訳後に復元されます。翻訳すべき文字通りの仮文を含むソースのみを無効にしてください。
`customPlaceholderPatterns`	なし	デフォルトのプレースホルダーセットに追加された換行分離正則表現(区切り符なし)、例えばカスタムトークン構文用の`<<.+?>>`。
`noTranslatePatterns`	なし	パーサーレベルのキー(JSON点線パス、RESX `name`、PO `msgid`、XLIFF単位の単位`id`、INI/restextキー)と照合したニューライン分離グロブパターン。マッチングキーはトランスレーター要求から削除され、ソース値を保持したままパスされます。

出力

出力
名称	概要
`summary-title`	PRに適した短い要約、例:Machine-translated 320 files, a total of 5,418 translations。
`summary-details`	PR機関や求人概要に適したマークダウンサマリー。
`has-new-translations`	`'true'`、1つ以上の新しい翻訳が生成されたとき。