Обзор

gt-next@6.11.0 добавляет поддержку параметра $maxChars в функции перевода, расширяя возможности formatCutoff(), представленной в generaltranslation@8.1.0.

Использование

Параметр $maxChars можно использовать с любыми вызовами перевода строк:

gt('Welcome to our application', { $maxChars: 20 });
// ИИ пытается выполнить перевод в пределах 20 символов: "Bienvenido a app"

Обработка ограничения числа символов

Параметр $maxChars запускает два отдельных механизма:

1. Оптимизация ИИ-перевода: ИИ получает ограничение на число символов и пытается создать перевод, который укладывается в указанную длину.

2. Усечение библиотекой: Если какой-либо перевод (от ИИ или из кэша) превышает ограничение на число символов, библиотека применяет усечение с учетом локали, чтобы обеспечить соблюдение ограничения.

gt('Long description text', { $maxChars: 15 });
// ИИ пытается создать краткий перевод: "Texto breve"
// Если результат превышает лимит: "Texto de desc…" (усечено)

Интеграция

Совместимо с существующими способами перевода:

gt('User notification', {
  $context: 'mobile-alert',
  $maxChars: 30,
});
// ИИ пытается уложить перевод в 30 символов: "Notificación usuario"
// Библиотека усекает при необходимости: "Notificación del usuario…"

Параметр влияет на хеширование переводов, обеспечивая создание отдельных записей перевода для разных ограничений на количество символов.