Глосарій

Терміни, які вживає це вікі, точно.

Alias (аліас) — будь-яке вхідне написання, що резолвиться в мову. Зберігається нормалізованим; глобально унікальний. Aliases and Normalisation

Base language (базова мова) — мова, чий канонічний код не несе кваліфікатора: en, de, ceb. Її власний код і є тим, що отримують провайдери; мапінг не потрібен. Це означає без кваліфікатора, а не дві літери.

BCP-47 — стандарт IETF для мовних тегів: language-Script-REGION, напр. zh-Hans-CN. Конвенція регістру, до якої канонізує сервіс.

Canonical code (канонічний код) — єдине написання мови, яке сервіс використовує й повертає. Зберігайте саме його.

Console (консоль) — animated-spoon, легасі-застосунок на Django, з якого засіяно каталог. Таблиці cabinet_language, cabinet_languageregioncode, translation_provider і translation_provider_supported_region_codes — вихідні дані.

Derived (виведено) — відповідь, отримана драбиною фолбеку, а не явним мапінгом. Коректна й придатна, але не курована. Будь-що з match, відмінним від exact.

Effective code (ефективний код) — те, що провайдер справді отримає для мови, явно чи виведено. ?effective=true.

Explicit mapping (явний мапінг) — налаштований рядок (провайдер, мова). Дає match: exact. Також — закріплено (pinned).

Fallback policy — по провайдеру: що відповісти для регіональної мови без явного рядка. base_language, passthrough або strict. Fallback Policies

Homoglyph (гомогліф) — символ, що виглядає ідентично іншому, як кирилична с (U+0441) і латинська c. Консоль містить один у коді себуанської; нормалізація його виправляє. Aliases and Normalisation

Lookup key (ключ пошуку) — нормалізована форма коду: нижній регістр, роздільник -. У такому вигляді аліаси зберігаються й звіряються.

match — як отримано відповідь: exact, variant, canonical, base_language, passthrough. Resolution Ladder

Provider (провайдер) — рушій перекладу, ідентифікований тим самим кодом, що й у provider_credentials: deepl_api, openai_api.

Provider alias — інша назва провайдера: коротка (deepl) або легасі service_name консолі (OpenAiGPT4o_2024_11_20_Provider).

Regional language (регіональна мова) — мова, чий канонічний код несе скрипт, регіон або обидва: pt-BR, zh-Hans, sr-Latn-RS. Саме щодо них провайдери не згодні.

Seed (сід) — data/seed/*.json, згенеровано з дампу консолі скриптом scripts/build_seed.py. Закомічений, рев'юабельний, детермінований. Rebuilding the Seed

service_name — ідентифікатор рядка провайдера в консолі. Зареєстрований тут як аліас провайдера, щоб виклики з консолі працювали.

Vendor (вендор) — компанія за одним чи кількома провайдерами. Google Cloud — вендор і google_translate, і gemini_api.