Глоссарий

Термины, которые употребляет эта вики, точно.

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.