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

உங்களுக்கு இயல்புநிலை அல்லாத இருப்பிடம் தேவைப்பட்டால் configPath உள்ளீட்டுடன் பாதையை மேலெழுதவும்.

திட்ட விவரம்

# .github/resource-translator.yml
sourceLocale: en

# Provider config can be nested. Keep secrets in workflow inputs; use repo
# config for non-secret defaults like region, model, formality, or category.
provider:
  azure:
    categoryId: my-custom-translator-category
    apiVersion: "3.0"
    allowFallback: true

toLocales:
  - fr
  - de
  - es
include:
  - "src/**/*.en.json"
  - "apps/**/*.en.resx"
exclude:
  - "**/__tests__/**"
glossary:
  Acme: Contoso
  Octocat: Octocat   # keep brand names verbatim

# Translator request shape — most users can ignore these.
textType: plain                  # plain | html
profanityAction: NoAction        # NoAction | Marked | Deleted
profanityMarker: Asterisk        # Asterisk | Tag (only when profanityAction == Marked)

# Resilience — Translator returns 429 under load. Defaults are usually
# fine; tune only if your runs are large enough to hit them.
maxRetries: 5
retryBackoffMs: 30000             # cap on any single backoff sleep (ms)

# Placeholder protection. ON by default — wraps tokens like {{name}},
# {0}, %s, ${var} into sentinels before translation and restores them
# on the way back. Set false only when source intentionally contains
# placeholder-shaped literals.
protectPlaceholders: true
customPlaceholderPatterns:
  - "<<.+?>>"                     # any extra token syntax you use

# Per-key opt-out. Keys matching any glob are dropped from the request
# and pass through with the source value preserved.
noTranslatePatterns:
  - "errors.code.*"
  - "brands.*"

புல குறிப்பு

provider

வகை: "azure" | "aws" | "google" | provider block

Either a provider string or a nested provider block (provider.azure, provider.aws, or provider.google). Prefer nested blocks for provider-specific settings; keep secrets in workflow inputs rather than committed config.

sourceLocale

வகை: string

அமைக்கப்படாவிட்டால் sourceLocale உள்ளீட்டிற்கு திரும்பும். குறுகிய சரங்கள் தானாக கண்டறியப்படாததால் from=<locale> மொழிபெயர்ப்பாளருக்கு அனுப்பப்படுகிறது.

toLocales

வகை: string[]

ஒரு வரிசை அல்லது காற்புள்ளி பிரிக்கப்பட்ட சரம்.

include / exclude

வகை: string[]

முழுமையான மற்றும் பணியிட-உறவினர் பாதைகளுக்கு எதிராக குளோப் வடிவங்கள் மதிப்பீடு செய்யப்பட்டன.

glossary

வகை: map<string,string>

மொழிபெயர்ப்புக்குப் பிந்தைய சொல் மீறுகிறது. வார்த்தை-எல்லை விழிப்புணர்வு (கையாளுகிறது C++, .NET).

categoryId

வகை: string

அஸூர் Custom Translator வகை — உங்கள் தொழில்/டொமைன் குமிழ் (சட்ட, மருத்துவம், சந்தைப்படுத்தல் தொனி போன்றவை). ?category=... என அனுப்பப்பட்டது.

textType

வகை: "plain" | "html"

plain இயல்புநிலைகள். உங்கள் வள மதிப்புகளில் உண்மையான HTML துண்டுகள் இருந்தால் மட்டுமே html பயன்படுத்தவும்.

profanityAction

வகை: "NoAction" | "Marked" | "Deleted"

மொழிபெயர்க்கப்பட்ட வெளியீட்டில் அவதூறு சொற்களை எவ்வாறு நடத்துவது.

profanityMarker

வகை: "Asterisk" | "Tag"

profanityAction "Marked" இருக்கும்போது மட்டுமே அர்த்தமுள்ளதாக இருக்கும்.

allowFallback

வகை: boolean

உங்கள் categoryId பொது மாதிரிக்கு திரும்பிச் செல்வதற்குப் பதிலாக இலக்கு இருப்பிடத்திற்கு வரிசைப்படுத்தல் இல்லாதபோது மொழிபெயர்ப்பில் தோல்வியடைய false என அமைக்கவும்.

apiVersion

வகை: string

மொழிபெயர்ப்பாளர் REST API பதிப்பு. 3.0 இயல்புநிலைகள்.

awsFormality

வகை: "FORMAL" | "INFORMAL"

AWS Translate formality setting for supported target languages.

awsBrevity

வகை: boolean

Set to true to enable AWS Translate brevity mode for supported language pairs.

awsTerminologyNames / awsParallelDataNames

வகை: string[]

AWS Translate custom terminology and parallel data resource names. Either an array or comma-separated string.

googleModel

வகை: string

Google Cloud Translation model, e.g. nmt or base.

googleApiEndpoint

வகை: string

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

வகை: boolean

Optional Google Cloud Translation automatic retry toggle. Leave unset to use the Google client default.

maxRetries

வகை: integer

நிலையற்ற HTTP பதில்களில் அதிகபட்ச மறுமுயற்சி முயற்சிகள் (408, 425, 429, 500, 502, 503, 504). 5 இயல்புநிலைகள். ஒரு கோரிக்கைக்கு மொத்த HTTP அழைப்புகள் 1 + maxRetries.

retryBackoffMs

வகை: integer

எந்தவொரு ஒற்றை பேக்ஆஃப் தூக்கத்திலும் தொப்பி (எம்.எஸ்). 30000 இயல்புநிலைகள். Azure இன் Retry-After தலைப்பு இருக்கும்போது சரியாக கௌரவிக்கப்படுகிறது; இல்லையெனில் நடுக்கமான அதிவேக பின்னடைவு பயன்படுத்தப்படுகிறது, இந்த மதிப்பில் மூடப்பட்டுள்ளது.

protectPlaceholders

வகை: boolean

true இயல்புநிலைகள். இயக்கத்தில் இருக்கும்போது, {{name}}, ${var}, {0}, {0:N2}, %s, %1$s மற்றும் HTML நிறுவனங்கள் போன்ற டோக்கன்கள் மொழிபெயர்ப்புக்கு முன் சென்டினல் டோக்கன்களுடன் மாற்றப்பட்டு பின்னர் மீட்டெடுக்கப்படுகின்றன. மூலத்தில் வேண்டுமென்றே பிளேஸ்ஹோல்டர் வடிவ எழுத்துக்கள் இருந்தால் மட்டுமே முடக்கவும்.

customPlaceholderPatterns

வகை: string[]

இயல்புநிலை பிளேஸ்ஹோல்டர் தொகுப்பில் கூடுதல் regex வடிவங்கள் (delimiters இல்லாமல்) சேர்க்கப்பட்டன, எ.கா. தனிப்பயன் டோக்கன் தொடரியல் <<.+?>>. செல்லுபடியாகாத பதிவுகள் புறக்கணிக்கப்படுகின்றன.

noTranslatePatterns

வகை: string[]

குளோப் வடிவங்கள் பாகுபடுத்தல்-நிலை விசைகளுடன் பொருந்துகின்றன (JSON புள்ளியிடப்பட்ட பாதை, RESX name, PO msgid, XLIFF அலகு id, INI/restext விசை). பொருந்தும் விசைகள் கோரிக்கையிலிருந்து கைவிடப்பட்டு, அவற்றின் மூல மதிப்புடன் கடந்து செல்லப்படுகின்றன.

changeDetection

வகை: "smart" | "disabled"

Defaults to smart. Uses the committed state manifest to translate only changed or missing parser keys. Set to disabled or false to preserve the legacy always-translate behavior.

statePath

வகை: string

Path to the deterministic smart change-detection state manifest. Defaults to .github/resource-translator-state.json.

ஏற்றுதல் ஆர்டர்

செயல் பணிப்பாய்வுகளில் இருந்து வெளிப்படையான உள்ளீடுகளைப் படிக்கிறது.
இது configPath இலிருந்து YAML கட்டமைப்பை ஏற்றுகிறது.
பகிரப்பட்ட ஒவ்வொரு புலத்திற்கும், உள்ளீடு வெற்றி பெறுகிறது; இல்லையெனில் YAML மதிப்பு பயன்படுத்தப்படுகிறது.
இணைக்கப்பட்ட மதிப்புகள் சரிபார்க்கப்படுகின்றன. செல்லுபடியாகாத ஈனம்கள் (எ.கா. profanityAction: Mask) தெளிவான செய்தியுடன் செயலை வேகமாக தோல்வியடையச் செய்கின்றன.

தொனி மற்றும் தொழில், எளிய சொற்களில்

Azure AI Translator v3 API ஆனது ஒற்றை தொனி குமிழ் இல்லை. இரண்டு அமைப்புகள் ஒன்றிணைந்து உங்களுக்கு ஒரே கட்டுப்பாட்டை வழங்குகின்றன:

தொழில் / களம்: சட்ட, தொழில்நுட்பம், மருத்துவம், சந்தைப்படுத்தல் அல்லது வேறு எதையும் உங்கள் சொந்த கார்பஸில் பயிற்சி பெற்ற அஸூர் Custom Translator வகையைச் சுட்டிக்காட்ட categoryId ஐப் பயன்படுத்தவும். தொனி, பிராண்ட் குரல் மற்றும் சொற்களஞ்சியத்திற்கான வலுவான நெம்புகோல் இது.
மேற்பரப்பு உரை: பிராண்ட் பெயர்கள் மற்றும் தயாரிப்பு விதிமுறைகளை வாய்மொழியாக பூட்ட அகராதி ஐப் பயன்படுத்தவும், இளைய பார்வையாளர்களுக்கான உள்ளூர்மயமாக்கலை குறிவைக்கும் போது அவதூறு சொற்களைத் துடைக்க profanityAction பயன்படுத்தவும்.

உங்கள் மொழியைத் தேர்வுசெய்க

களஞ்சியக் கட்டமைப்பு

திட்ட விவரம்

புல குறிப்பு

ஏற்றுதல் ஆர்டர்

தொனி மற்றும் தொழில், எளிய சொற்களில்