Заповнення / аудит / переклад словників

npx intlayer fill

Ця команда аналізує ваші файли декларацій контенту на предмет потенційних проблем, таких як відсутні переклади, структурні невідповідності або невідповідності типів. Якщо будуть виявлені якісь проблеми, intlayer fill запропонує або застосує оновлення, щоб тримати ваші словники консистентними та повними.

Ключові моменти:

• Розділяє великі JSON-файли на частини, щоб залишатися в межах вікна контексту моделі AI.
• Повторює переклад, якщо формат виводу невірний.
• Включає контекст, специфічний для додатка та файлу, для підвищення точності перекладу.
• Зберігає існуючі переклади, не перезаписуючи їх.
• Обробляє файли, частини та локалі паралельно, використовуючи систему черг для збільшення швидкості.

Аліаси:

• npx intlayer dictionaries fill
• npx intlayer dictionary fill
• npx intlayer dic fill

Приклади виводу:

npx intlayer fillPreparing Intlayer (v7.5.14)Done 76ms@intlayer/ai found - Run process locallyProvider: (default) - Model: (default) - API Key: ✓Affected dictionary keys for processing: app, comp-test, hello-world, lang-switcher - [comp-test]      No locales to fill, Skipping comp-test.content.json - [app]            Processing app.content.tsx - [app]            Filling missing metadata for app.content.tsx - [hello-world]    Processing test.content.ts - [hello-world]   [French (fr)]      Preparing test.content.ts - [hello-world]   [Spanish (es)]     Preparing test.content.ts - [lang-switcher]  Processing langSwitcher.content.ts - [lang-switcher]  Filling missing metadata for langSwitcher.content.ts - [hello-world]    Translation completed successfully for test.content.ts - [lang-switcher] [Spanish (es)]     Preparing langSwitcher.content.ts - [app]           [French (fr)]      Preparing app.content.tsx - [app]           [Spanish (es)]     Preparing app.content.tsx - [hello-world]    Content declaration written to test.content.ts - [app]            Translation completed successfully for app.content.tsx - [app]            Content declaration written to app.content.tsx - [lang-switcher]  Translation completed successfully for langSwitcher.content.ts - [lang-switcher]  Content declaration written to langSwitcher.content.ts

Аргументи:

Опції списку файлів:

• -f, --file [files...]: Список конкретних файлів декларації контенту для перевірки. Якщо не вказано, будуть перевірені всі виявлені *.content.{ts,js,mjs,cjs,tsx,jsx,json} згідно з налаштуваннями вашого конфігураційного файлу.

  Приклад: npx intlayer dictionary fill -f src/home/app.content.ts

• -k, --keys [keys...]: Фільтрувати словники за ключами. Якщо не вказано, будуть перевірені всі словники.

  Приклад: npx intlayer dictionary fill -k key1 key2

• --key [keys...]: Фільтрувати словники за ключами (псевдонім для --keys).

  Приклад: npx intlayer dictionary fill --key key1 key2

• --excluded-keys [excludedKeys...]: Виключати словники за ключами. Якщо не вказано, будуть перевірені всі словники.

  Приклад: npx intlayer dictionary fill --excluded-keys key1 key2

• --excluded-key [excludedKeys...]: Фільтрувати словники за ключами (синонім для --excluded-keys).

  Приклад: npx intlayer dictionary fill --excluded-key key1 key2

• --path-filter [pathFilters...]: Фільтрувати словники на основі шаблону glob для шляхів файлів.

  Приклад: npx intlayer dictionary fill --path-filter "src/home/**"

Параметри виводу записів:

• --source-locale [sourceLocale]: Початкова локаль для перекладу. Якщо не вказано, буде використана локаль за замовчуванням з вашої конфігурації.

• --output-locales [outputLocales...]: Цільові локалі для перекладу. Якщо не вказано, будуть використані всі локалі з вашої конфігурації, за винятком початкової локалі.

• --mode [mode]: Режим перекладу: complete, review. За замовчуванням, complete. complete заповнює весь відсутній контент, review заповнює відсутній контент та переглядає наявні ключі.

Параметри Git:

• --git-diff: Запускати лише для словників, які містять зміни від бази (за замовчуванням origin/main) до поточної гілки (за замовчуванням: HEAD).
• --git-diff-base: Вказати базовий референс для git diff (за замовчуванням origin/main).
• --git-diff-current: Вказати поточний референс для git diff (за замовчуванням: HEAD).
• --uncommitted: Включати незакомічені зміни.
• --unpushed: Включати незапушені зміни.

• --untracked: Включати не відстежувані файли.

  Приклад: npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD

  Приклад: npx intlayer doc translate --uncommitted --unpushed --untracked

Параметри AI:

• --model [model]: Модель AI для перекладу (наприклад, gpt-3.5-turbo).
• --provider [provider]: Провайдер AI, який буде використаний для перекладу.
• --temperature [temperature]: Параметр temperature для моделі AI.
• --api-key [apiKey]: Надайте власний API-ключ для сервісу AI.
• --custom-prompt [prompt]: Надайте власний prompt для інструкцій перекладу.
• --application-context [applicationContext]: Надайте додатковий контекст для перекладу AI.

• --data-serialization [dataSerialization]: Формат серіалізації даних для використання у функціях ШІ Intlayer. Опції: json (стандартний, надійний), toon (менше токенів, менш стабільний).

  Приклад: npx intlayer fill --model gpt-3.5-turbo --provider openai --temperature 0.5 --api-key sk-1234567890 --application-context "My application is a cat store"

Параметри змінних середовища:

• --env: Вказати середовище (наприклад, development, production).

• --env-file [envFile]: Надати власний файл середовища для завантаження змінних.

  Приклад: npx intlayer fill --env-file .env.production.local

  Приклад: npx intlayer fill --env production

Параметри конфігурації:

• --base-dir: Вказати базовий каталог для проєкту.

  Приклад: npx intlayer fill --base-dir ./src

• --no-cache: Вимкнути кеш.

  Приклад: npx intlayer build --no-cache

Опції підготовки:

• --build: Збирати словники перед відправкою, щоб забезпечити актуальність контенту. True примусово виконає збірку, false пропустить збірку, undefined дозволить використовувати кеш збірки.

• --skip-metadata: Пропустити заповнення відсутніх метаданих (description, title, tags) для словників.

Опції логування:

• --verbose: Увімкнути детальне (verbose) логування для налагодження. (за замовчуванням true при використанні CLI)

Приклад:

npx intlayer fill --file src/home/*.content.ts --source-locale en --output-locales fr es --model gpt-3.5-turbo

Ця команда перекладе вміст з англійської на французьку та іспанську для всіх файлів декларацій вмісту в директорії src/home/, використовуючи модель GPT-3.5 Turbo.