உள்ளீடுகள் மற்றும் வெளியீடுகள் · வள மொழிபெயர்ப்பாளர்

YAML திட்டம் மற்றும் ஏற்றுதல் வரிசைக்கு கட்டமைப்பு பார்க்கவும்.

தேவையான உள்ளீடுகள்

தேவையான உள்ளீடுகள்
பெயர்	விளக்கம்
`sourceLocale`	மூல இருப்பிடம் (எ.கா. `en`) போன்ற `*/.en.resx` போன்ற வளக் கோப்புகளைக் கண்டறியப் பயன்படுகிறது. மொழிபெயர்ப்பாளருக்கு `from=<locale>` என அனுப்பப்பட்டது.
`subscriptionKey`	Azure AI Translator சந்தா விசை. `secrets` வழியாக செல்லுங்கள்.
`endpoint`	மொழிபெயர்ப்பாளர் இறுதிப்புள்ளி URL, எ.கா. `https://api.cognitive.microsofttranslator.com/`.

பொதுவான விருப்ப உள்ளீடுகள்

பொதுவான விருப்ப உள்ளீடுகள்
பெயர்	இயல்புநிலை	விளக்கம்
`region`	ஏதுமில்லை	மொழிபெயர்ப்பாளர் வள பகுதி (உலகளாவிய வளங்களைத் தவிர்க்கவும்).
`toLocales`	அனைத்தும் ஆதரிக்கப்படுகின்றன	மொழிபெயர்க்க வேண்டிய இடங்கள். JSON வரிசை (`["fr","de"]`) அல்லது கமா-பிரிக்கப்பட்ட மதிப்புகளை ஏற்றுக்கொள்கிறது.
`include`	ஏதுமில்லை	நியூலைன்-பிரிக்கப்பட்ட குளோப் வடிவங்கள்; பொருந்தக்கூடிய கோப்புகள் மட்டுமே மொழிபெயர்க்கப்படுகின்றன.
`exclude`	ஏதுமில்லை	நியூலைன்-பிரிக்கப்பட்ட குளோப் வடிவங்கள்; பொருந்தக்கூடிய கோப்புகள் தவிர்க்கப்படுகின்றன (சேர்க்கப்பட்ட பிறகு பயன்படுத்தப்படும்).
`configPath`	`.github/resource-translator.yml`	YAML உள்ளமைவு கோப்பிற்கான பாதை (பணியிட ரூட்டுடன் தொடர்புடையது).
`dryRun`	`false`	`true` போது, மொழிபெயர்ப்புகளை இயக்கவும் மற்றும் சுருக்கங்களை வெளியிடவும் ஆனால் கோப்புகளை எழுத வேண்டாம்.
`failOnError`	`true`	`true` போது, எதிர்பாராத பிழைகள் செயலில் தோல்வியடைகின்றன; `false` போது, பிழைகள் எச்சரிக்கைகள்.

மொழிபெயர்ப்பாளர் கோரிக்கை உள்ளீடுகள்

இவை நேரடியாக Azure AI Translator v3 வினவல் அளவுருக்களில் வரைபடமாக்குகின்றன. ஒவ்வொன்றும் விருப்பமானவை; அமைவு நீக்கப்படும்போது மொழிபெயர்ப்பாளர் இயல்புநிலைகள் பொருந்தும்.

மொழிபெயர்ப்பாளர் கோரிக்கை உள்ளீடுகள்
பெயர்	இயல்புநிலை	விளக்கம்
`categoryId`	general	Azure Custom Translator வகை — தொழில்/டொமைன்/தொனி குமிழ். `?category=...` என அனுப்பப்பட்டது.
`textType`	`plain`	`plain` அல்லது `html`. உங்கள் வள மதிப்புகள் உண்மையான HTML துண்டுகளாக இருக்கும்போது மட்டுமே `html` பயன்படுத்தவும்.
`profanityAction`	`NoAction`	`NoAction`, `Marked` அல்லது `Deleted`. மொழிபெயர்ப்புகளில் அவதூறு சொற்கள் எவ்வாறு உமிழப்படுகின்றன என்பதைக் கட்டுப்படுத்துகிறது.
`profanityMarker`	`Asterisk`	`Asterisk` அல்லது `Tag`. `profanityAction` `Marked` போது மட்டுமே அர்த்தமுள்ளதாக இருக்கும்.
`allowFallback`	உண்மை (மொழிபெயர்ப்பாளர் இயல்புநிலை)	`false` போது, உங்கள் `categoryId` இலக்கு இருப்பிடத்திற்கு வரிசைப்படுத்தல் இல்லையென்றால், மொழிபெயர்ப்பாளர் பொது கணினிக்கு திரும்பிச் செல்வதற்குப் பதிலாக பிழையைத் தருகிறார்.
`apiVersion`	`3.0`	மொழிபெயர்ப்பாளர் REST API பதிப்பு.

நெகிழ்திறன் மற்றும் இடவசதி பாதுகாப்பு

இந்த உள்ளீடுகள் மொழிபெயர்ப்பாளர் உங்கள் கோரிக்கையைத் தடுக்கும் போது செயல் எவ்வாறு செயல்படுகிறது என்பதையும், மொழிபெயர்ப்பின் போது {{name}} அல்லது {0} போன்ற பிளேஸ்ஹோல்டர் டோக்கன்களை எவ்வாறு பாதுகாக்கிறது என்பதையும் கட்டுப்படுத்துகிறது.

பின்னடைவு மற்றும் பிளேஸ்ஹோல்டர் பாதுகாப்பு உள்ளீடுகள்
பெயர்	இயல்புநிலை	விளக்கம்
`maxRetries`	`5`	நிலையற்ற HTTP பதில்களில் அதிகபட்ச மறுமுயற்சி முயற்சிகள் (`408, 425, 429, 500, 502, 503, 504`). ஒரு கோரிக்கைக்கு HTTP அழைப்புகளின் மொத்த எண்ணிக்கை `1 + maxRetries`.
`retryBackoffMs`	`30000`	எந்தவொரு ஒற்றை பேக்ஆஃப் தூக்கத்திலும் தொப்பி (மில்லி வினாடிகளில்). இந்த நடவடிக்கை Azure இன் `Retry-After` மறுமொழி தலைப்பை சரியாக இருக்கும்போது கௌரவிக்கிறது; இல்லையெனில் இது இந்த மதிப்பில் மூடப்பட்ட நடுக்கமான அதிவேக பின்னடைவைப் பயன்படுத்துகிறது.
`protectPlaceholders`	`true`	`true` (இயல்புநிலை) இருக்கும்போது, `{{name}}`, `${var}`, `{0}`, `{0:N2}`, `%s`, `%1$s` மற்றும் HTML நிறுவனங்கள் போன்ற பிளேஸ்ஹோல்டர்கள் மொழிபெயர்ப்புக்கு முன் சென்டினல் டோக்கன்களுடன் மாற்றப்பட்டு பின்னர் மீட்டெடுக்கப்படுகின்றன. உங்கள் மூலத்தில் வேண்டுமென்றே மொழிபெயர்க்கப்பட வேண்டிய இடவசதி வடிவ உரை இருந்தால் மட்டுமே முடக்கவும்.
`customPlaceholderPatterns`	ஏதுமில்லை	இயல்புநிலை பிளேஸ்ஹோல்டர் தொகுப்பில் நியூலைன்-பிரிக்கப்பட்ட regexes (delimiters இல்லாமல்) சேர்க்கப்பட்டது, எ.கா. தனிப்பயன் டோக்கன் தொடரியல் `<<.+?>>`.
`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'` ஒன்று அல்லது அதற்கு மேற்பட்ட புதிய மொழிபெயர்ப்புகள் உருவாக்கப்பட்ட போது.