Skip to content

Describe glossary purpose and format on AI translation page - #324

Merged
martyanovandrey merged 1 commit into
masterfrom
docs/translate-ai-glossary
Aug 11, 2026
Merged

Describe glossary purpose and format on AI translation page#324
martyanovandrey merged 1 commit into
masterfrom
docs/translate-ai-glossary

Conversation

@martyanovandrey

Copy link
Copy Markdown
Contributor

По следу ревью страницы AI-перевода: в секции «Глоссарий» формат был задан отсылкой «тот же, что у провайдера yandex», а структура файла и смысл глоссария нигде не описаны.

Что теперь есть в секции Глоссарий:

  • зачем он нужен: модель переводит каждый сегмент независимо, поэтому без глоссария один и тот же термин разъезжается между файлами и запусками; отдельно случай «не переводить вообще» через translatedText, повторяющий sourceText;
  • структура файла: ключ glossaryPairs и таблица с описанием sourceText и translatedText, оговорка про отдельный файл на каждый --target;
  • подключение: путь в --glossary считается от --input, а в .yfm - от самого конфига;
  • как пары применяются: подставляются в промпт каждого запроса, то есть это инструкция модели, а не замена по тексту; словоформы модель разбирает сама; глоссарий уходит в каждый батч и расходует токены; его изменение инвалидирует кэш переводов.

Отсылка к провайдеру yandex убрана: там глоссарий устроен иначе и на своей странице не описан.

Поведение сверено с кодом CLI (providers/ai/prompts.ts, providers/ai/index.ts), сборка доки чистая.

The section only referenced the yandex provider for the file format,
while that page does not document the glossary at all. Spell out why
a glossary is needed, the glossaryPairs structure, path resolution for
the flag and for the config, and how the pairs reach the model.
@martyanovandrey
martyanovandrey merged commit 114e7c1 into master Aug 11, 2026
1 check passed
@github-actions

Copy link
Copy Markdown

✅ Documentation build

Revision built successfully
Revision preview link

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant