Zobacz Konfiguracja dla schematu YAML i kolejności ładowania.
Wymagane dane wejściowe
| Nazwa | Opis |
|---|---|
sourceLocale | Lokalizacja źródłowa (np. en) używana do wyszukiwania plików zasobów, takich jak **/*.en.resx. Również przekazane do Translator jako from=<locale>. |
subscriptionKey | Azure AI Translator subscription key. Przejdź przez secrets. |
endpoint | Adres URL końcowy translatora, np. https://api.cognitive.microsofttranslator.com/. |
Powszechne opcjonalne wejścia
| Nazwa | Domyślność | Opis |
|---|---|---|
region | Brak | Region zasobów translatora (pominięcie dla zasobów globalnych). |
toLocales | wszystkie wspierane | Miejsca do tłumaczenia. Akceptuje tablicę JSON (["fr","de"]) lub wartości rozdzielone przecinkami. |
include | Brak | Wzory kul oddzielone przez nowe linie; tłumaczone są tylko dopasowane pliki. |
exclude | Brak | Wzory kul oddzielone przez nowe linie; pliki dopasowania są pomijane (stosowane po dodaniu plików). |
configPath | .github/resource-translator.yml | Ścieżka do pliku konfiguracyjnego YAML (względem rootu workspace). |
dryRun | false | Gdy true, wykonuj tłumaczenia i generuj streszczenia, ale nie zapisuj plików. |
failOnError | true | Gdy true, nieoczekiwane błędy powodują niepowodzenie akcji; Gdy false, błędy są ostrzeżeniem. |
Translator żąda wejść
Te parametry są bezpośrednio mapowane na parametry zapytania Azure AI Translator v3. Każdy jest opcjonalny; domyślne ustawienia translatora obowiązują przy nieustawieniu.
| Nazwa | Domyślność | Opis |
|---|---|---|
categoryId | general | Azure Custom Translator kategoria — pokrętło branżowe/domenowe/tonowe. Przekierowane jako ?category=.... |
textType | plain | plain czy html. Używaj html tylko wtedy, gdy wartości zasobów to prawdziwe fragmenty HTML. |
profanityAction | NoAction | NoAction, Marked lub Deleted. Kontroluje, jak wulgarne terminy są wydawane w tłumaczeniach. |
profanityMarker | Asterisk | Asterisk czy Tag. Znaczące tylko wtedy, gdy profanityAction jest Marked. |
allowFallback | true (domyślny translator) | Gdy false, Translator zwraca błąd zamiast wracać do ogólnego systemu, jeśli twój categoryId nie ma wdrożenia dla docelowego miejsca. |
apiVersion | 3.0 | Translator REST API w wersji |
Odporność i ochrona tymczasowa
Te wejścia kontrolują, jak akcja się zachowuje, gdy Translator ogranicza twoje żądanie, oraz jak chroni tokeny zastępcze, takie jak {{name}} czy {0}, przed zakłóceniami podczas tłumaczenia.
| Nazwa | Domyślność | Opis |
|---|---|---|
maxRetries | 5 | Maksymalna liczba prób powtórek na przejściowych odpowiedziach HTTP (408, 425, 429, 500, 502, 503, 504). Łączna liczba wywołań HTTP na jedno żądanie wynosi 1 + maxRetries. |
retryBackoffMs | 30000 | Limit (w milisekundach) podczas każdego pojedynczego snu z przerwą. Akcja honoruje nagłówek odpowiedzi Retry-After Azure dokładnie wtedy, gdy jest obecny; w przeciwnym razie używa się drgającego wykładniczego cofnięcia ograniczonego do tej wartości. |
protectPlaceholders | true | Gdy true (domyślnie), zastępcze takie jak {{name}}, ${var}, {0}, {0:N2}, %s, %1$s oraz jednostki HTML są zastępowane tokenami sentinel przed tłumaczeniem i przywracane po tłumaczeniu. Wyłącz tylko wtedy, gdy źródło celowo zawiera dosłowny tekst w kształcie zastępców, który powinien być przetłumaczony. |
customPlaceholderPatterns | Brak | Regexy oddzielone od nowej linii (bez separatorów) dodawane do domyślnego zestawu zastępców, np. <<.+?>> dla niestandardowej składni tokenów. |
noTranslatePatterns | Brak | Wzory globów oddzielone od nowych linii dopasowywane do kluczy na poziomie parsera (JSON przerywana ścieżka, RESX name, PO msgid, jednostka XLIFF id, INI/klucz restextowy). Pasujące klucze są usuwane z żądania tłumacza i przekazywane z zachowaniem wartości źródłowej. |
Wyniki
| Nazwa | Opis |
|---|---|
summary-title | Krótkie, przyjazne dla PR tytułowe podsumowanie, np. Machine-translated 320 files, a total of 5,418 translations. |
summary-details | Podsumowanie Markdown odpowiednie dla organizacji PR lub podsumowania stanowiska. |
has-new-translations | 'true' gdy generowano jedno lub więcej nowych tłumaczeń. |