YAML స్కీమా మరియు లోడింగ్ ఆర్డర్ కొరకు కాన్ఫిగరేషన్ చూడండి.
అవసరమైన ఇన్పుట్లు
sourceLocaleసోర్స్ లొకేల్ (ఉదా. en) **/*.en.resx వంటి రిసోర్స్ ఫైళ్లను కనుగొనడానికి ఉపయోగించబడుతుంది. from=<locale> వలే ప్రొవైడర్ కు కూడా ఫార్వర్డ్ చేయబడింది.
ప్రొవైడర్ ఎంపిక & ఆధారాలు
provider తో ప్రతి పరుగుకు ఒక ప్రొవైడర్ ను ఎంచుకోండి. ఎంచుకున్న ప్రొవైడర్ యొక్క ఆధారాలను మాత్రమే అందించండి — పూర్తి సెటప్ కోసం ఇన్పుట్లు & అవుట్పుట్లు గైడ్ చూడండి.
providerఅనువాద ప్రదాత: azure (డిఫాల్ట్), aws లేదా google. ప్రతి చర్య కాల్ కు ఒక ప్రొవైడర్ మాత్రమే ఉపయోగించబడుతుంది.
subscriptionKeyAzure AI Translator సబ్ స్క్రిప్షన్ కీ. azure కోసం అవసరం. secrets గుండా వెళ్ళండి.
endpointAzure Translator endpoint URL, ఉదా. https://api.cognitive.microsofttranslator.com/. azure కోసం అవసరం.
awsAccessKeyIdAWS యాక్సెస్ కీ ఐడి. ఐచ్ఛికం - AWS డిఫాల్ట్ క్రెడెన్షియల్ చైన్ / OIDC ఉపయోగించడానికి (awsSecretAccessKey తో) తొలగించండి. secrets గుండా వెళ్ళండి.
awsSecretAccessKeyAWS సీక్రెట్ యాక్సెస్ కీ. awsAccessKeyId కలిపి సప్లై చేయాలి. secrets గుండా వెళ్ళండి.
awsSessionTokenతాత్కాలిక ఆధారాల కొరకు ఐచ్ఛిక AWS సెషన్ టోకెన్. secrets గుండా వెళ్ళండి.
awsRegionట్రాన్స్ లేట్ సర్వీస్ కొరకు AWS ప్రాంతం (ఉదా. us-east-1). వాతావరణంలో AWS_REGION సెట్ చేయనట్లయితే aws కొరకు అవసరం అవుతుంది.
awsFormalityAWS Translate formality setting: FORMAL or INFORMAL.
awsBrevityWhen true, enables AWS Translate brevity mode for supported language pairs.
awsTerminologyNamesAWS Translate custom terminology resource names. Accepts a JSON array or comma-separated values.
awsParallelDataNamesAWS Translate parallel data resource names. Accepts a JSON array or comma-separated values.
googleApiKeyగూగుల్ క్లౌడ్ API కీ. google కొరకు దీనిని OR googleCredentials అందించండి. secrets గుండా వెళ్ళండి.
googleCredentialsగూగుల్ క్లౌడ్ సర్వీస్-ఖాతా కీని JSON స్ట్రింగ్ వలె google కొరకు దీనిని OR googleApiKey అందించండి. secrets గుండా వెళ్ళండి.
googleProjectIdఐచ్ఛిక గూగుల్ క్లౌడ్ ప్రాజెక్ట్ ఐడి. సాధారణంగా సర్వీస్-ఖాతా ఆధారాల నుండి ఊహించబడుతుంది.
googleModelGoogle Cloud Translation model, e.g. nmt or base.
googleApiEndpointOptional Google Cloud Translation API endpoint override.
googleAutoRetryOptional Google Cloud Translation automatic retry toggle. Leave unset to use the Google client default.
సాధారణ ఐచ్ఛిక ఇన్ పుట్ లు
regionట్రాన్స్ లేటర్ రిసోర్స్ రీజియన్ (గ్లోబల్ రిసోర్సెస్ కొరకు మినహాయింపు).
toLocalesఅనువదించాల్సిన స్థానాలు. JSON ఎరాయ్ (["fr","de"]) లేదా కామా-సపరేట్ విలువలను ఆమోదిస్తుంది.
includeన్యూలైన్-వేరు చేయబడిన గ్లోబ్ నమూనాలు; సరిపోలే ఫైళ్లు మాత్రమే అనువదించబడతాయి.
excludeన్యూలైన్-వేరు చేయబడిన గ్లోబ్ నమూనాలు; సరిపోలే ఫైళ్లు దాటవేయబడతాయి (చేర్చిన తర్వాత వర్తింపజేయబడతాయి).
configPathYAML కాన్ఫిగర్ ఫైలుకు పాత్ (వర్క్ స్పేస్ రూట్ కు సంబంధించినది).
changeDetectionSmart change detection mode. smart translates only keys whose source value, target presence, state entry, or translation-affecting settings require it. Use disabled or false to send every eligible key on every run.
statePathPath to the compact deterministic smart change-detection state manifest. Defaults to .github/resource-translator-state.json; commit it so future runs can audit and reuse unchanged translations.
snapshotOnlyWhen true, create/update the smart change-detection manifest from existing source and target files without calling a translation provider or writing target resource files. Useful when bootstrapping statePath while a provider is unavailable.
dryRuntrue చేసినప్పుడు, అనువాదాలను రన్ చేయండి మరియు సారాంశాలను ఎమిట్ చేయండి కానీ ఫైళ్లను వ్రాయవద్దు.
failOnErrortrue అయినప్పుడు, ఊహించని లోపాలు చర్యను విఫలం చేస్తాయి; false ఉన్నప్పుడు, లోపాలు హెచ్చరికలు.
Azure Translator అభ్యర్థన ఇన్ పుట్ లు
ఇవి నేరుగా అజ్యూరే AI ట్రాన్స్ లేటర్ v3 క్వైరీ పరామీటర్లపై మ్యాప్ చేయబడతాయి మరియు అజ్యూరే ప్రొవైడర్ కు అప్లై చేయబడతాయి. textType మరియు అశ్లీలత చర్య కూడా AWS / Google కు మ్యాప్ చేయబడ్డాయి, ఇక్కడ సమానమైన ఉంది (ప్రొవైడర్స్ గైడ్ చూడండి); మిగిలినవి అజ్యూరే మాత్రమే. ప్రతి ఒక్కటి ఐచ్ఛికం; అన్ సెట్ చేసినప్పుడు అనువాదకుడు డిఫాల్ట్ లు వర్తిస్తాయి.
categoryIdఅజ్యూరే Custom Translator కేటగిరీ — ఇండస్ట్రీ/డొమైన్/టోన్ నాబ్. ?category=... గా ఫార్వార్డ్ చేయబడింది.
textTypeplain లేదా html. మీ రిసోర్స్ విలువలు నిజమైన హెచ్ టిఎమ్ ఎల్ ఫ్రాగ్ మెంట్ లు అయినప్పుడు మాత్రమే html ఉపయోగించండి.
profanityActionNoAction, Marked లేదా Deleted. అనువాదాలలో అశ్లీల పదాలు ఎలా వెలువడతాయో నియంత్రిస్తుంది.
profanityMarkerAsterisk లేదా Tag. profanityAction Marked ఉన్నప్పుడు మాత్రమే అర్థవంతంగా ఉంటుంది.
allowFallbackfalse చేసినప్పుడు, మీ categoryId లక్ష్య ప్రదేశానికి విస్తరణ లేకపోతే ట్రాన్స్ లేటర్ సాధారణ సిస్టమ్ కు తిరిగి రావడానికి బదులుగా ఒక దోషాన్ని రిటర్న్ చేస్తాడు.
apiVersionఅనువాదకుడు REST API వెర్షన్.
స్థితిస్థాపకత మరియు ప్లేస్ హోల్డర్ రక్షణ
ఈ ఇన్ పుట్ లు అనువాదకుడు మీ అభ్యర్థనను థ్రోటిల్ చేసినప్పుడు చర్య ఎలా ప్రవర్తిస్తుందో మరియు అనువాద సమయంలో {{name}} లేదా {0} వంటి ప్లేస్ హోల్డర్ టోకెన్ లను ఎలా కాపాడుతుందో నియంత్రిస్తుంది.
maxRetriesతాత్కాలిక HTTP ప్రతిస్పందనలపై గరిష్ట పునఃప్రయత్న ప్రయత్నాలు (408, 425, 429, 500, 502, 503, 504). ప్రతి అభ్యర్థనకు మొత్తం HTTP కాల్స్ సంఖ్య 1 + maxRetries.
retryBackoffMsఏదైనా సింగిల్ బ్యాక్ ఆఫ్ స్లీప్ పై క్యాప్ (మిల్లీసెకన్లలో). ఈ చర్య అజ్యూరే యొక్క Retry-After ప్రతిస్పందన శీర్షికను ఖచ్చితంగా కలిగి ఉన్నప్పుడు గౌరవిస్తుంది; లేకపోతే ఇది ఈ విలువ వద్ద మూసివేయబడిన జిట్టెర్డ్ ఎక్స్ పోనెన్షియల్ బ్యాక్ ఆఫ్ ను ఉపయోగిస్తుంది.
protectPlaceholderstrue (డిఫాల్ట్) అయినప్పుడు, {{name}}, ${var}, {0}, {0:N2}, %s, %1$s మరియు HTML ఎంటిటీలు వంటి ప్లేస్ హోల్డర్లు అనువాదానికి ముందు సెంటినెల్ టోకెన్లతో భర్తీ చేయబడతాయి మరియు తరువాత పునరుద్ధరించబడతాయి. మీ మూలం ఉద్దేశ్యపూర్వకంగా అనువదించాల్సిన అక్షరాలా ప్లేస్ హోల్డర్ ఆకారపు టెక్స్ట్ ను కలిగి ఉన్నప్పుడు మాత్రమే నిలిపివేయండి.
customPlaceholderPatternsడిఫాల్ట్ ప్లేస్ హోల్డర్ సెట్ కు న్యూలైన్-సెపరేట్ చేయబడిన రెజెక్స్ లు (డీలిమిటర్లు లేకుండా) జోడించబడ్డాయి, ఉదా. కస్టమ్ టోకెన్ సింటాక్స్ కోసం <<.+?>>.
noTranslatePatternsన్యూలైన్-వేరు చేయబడిన గ్లోబ్ నమూనాలు పార్సర్-స్థాయి కీలకు (JSON చుక్కల మార్గం, RESX name, PO msgid, XLIFF యూనిట్ id, INI / రెస్ టెక్స్ట్ కీ) తో సరిపోలాయి. మ్యాచింగ్ కీలు ట్రాన్స్ లేటర్ రిక్వెస్ట్ నుంచి డ్రాప్ చేయబడతాయి మరియు వాటి సోర్స్ వాల్యూ భద్రపరచబడతాయి.
అవుట్ పుట్ లు
summary-titleసంక్షిప్త PR-శీర్షిక-స్నేహపూర్వక సారాంశం, ఉదా. Machine-translated 320 files, a total of 5,418 translations.
summary-detailsపిఆర్ బాడీ లేదా ఉద్యోగ సారాంశానికి తగిన మార్క్ డౌన్ సారాంశం.
has-new-translationsఒకటి లేదా అంతకంటే ఎక్కువ కొత్త అనువాదాలు జనరేట్ చేయబడినప్పుడు 'true'.