Algebras AI CLI translation tool

Приступаем к работе

Выполните следующие шаги, чтобы начать использовать инструмент Algebras CLI для управления локализацией в ваших приложениях.

‍

1. Установка

pip install git+https://github.com/algebras-ai/algebras-cli.git

‍

2. Настройка ключа API

Вы можете создавать ключи API на нашей платформе

Создать ключ API

‍

‍

3. Настройка проекта

algebras init

‍

Предварительный просмотр

Посмотрите на инструмент Algebras CLI в действии

‍

Инструмент CLI предоставляет интерактивный интерфейс для управления переводами вашего приложения

‍

Основные команды

Основные команды для управления переводами

‍

Добавить язык

Добавьте новый язык в свой проект

algebras add <language>

Перевести

Переведите содержимое приложения

algebras translate

Обновить

Обновить существующие переводы

algebras update

Статус

Проверьте статус перевода

algebras status

‍

Конфигурация

Настройте свой проект с помощью файла.algebras.config

‍

Конфигурация проекта

{
  "languages": ["en", "es", "fr"],
  "path_rules": ["locales/**/*.json"],
  "api": {
    "provider": "algebras-ai",
    "model": "gpt-4"
  }
}

‍

Функции обеспечения качества

Встроенные инструменты для обеспечения высокого качества переводов

‍

Обнаружение недостающих ключей

Автоматически определяет ключи перевода, существующие на основном языке, но отсутствующие на других языках, обеспечивая полный охват во всех регионах.

‍

Внимание к устаревшим переводам

Определяет, когда переводы не синхронизированы, идентифицируя ключи, которые были обновлены на основном языке, но не обновлены на других, что предотвращает устаревание содержимого.

‍

Автоматические проверки качества

Выполняет комплексную проверку всех переводов, включая совместимость строк формата, согласованность заполнителей и проверку синтаксиса.

‍

Встроенная поддержка Next.js

Оптимизирован для работы с проектами Next.js и имеет встроенную поддержку шаблонов интернационализации Next.js и файловых структур.

‍

Расширенное использование

Мощные функции для сложных задач локализации

‍

Настраиваемые шаблоны подсказок

Создавайте персонализированные запросы на перевод с помощью файла.algebras.prompt

# Translation prompt template
Translate the following strings for a {{project_type}} app.
Maintain a {{tone}} tone that is consistent with our brand.
Keep variables like {{example_variable}} unchanged.

‍

Поддержка форматов файлов

Поддерживаемые форматы файлов для локализации:

JSON (.json)
YAML (.yml, .yaml)
Свойства (.properties)
XML для Android (.xml)
Строки iOS (.strings)
CSV (.csv)
PO (.po)

‍

Интеграция с CI/CD

Добавьте это в свой конвейер CI:

# GitHub Actions example
- name: Setup Algebras CLI
  run: pip install git+https://github.com/algebras-ai/algebras-cli.git
- name: Update translations 
  run: algebras update --non-interactive
  env:
    ALGEBRAS_API_KEY: ${secrets.ALGEBRAS_API_KEY}

‍

Интеграция действий GitHub

‍Торговая площадка

‍

Автоматизируйте проверку работоспособности переводов в своем конвейере CI/CD с помощью официального действия GitHub Action Algebras Translation Status.

The Действие «Статус перевода алгебр» проверяет ваш проект Next.js с поддержкой i18n на наличие отсутствующих или устаревших переводов. При обнаружении каких-либо проблем рабочий процесс прерывается, обеспечивая автоматическое обеспечение качества перевода.

‍

Быстрый старт: Добавьте этот файл рабочего процесса в .github/рабочие процессы/check-translations.yml:

name: Check Translations

on:
  pull_request:
    branches: [ main ]
    paths:
      - '**/locale/**'
      - '**/translations/**'
      - '**/i18n/**'

jobs:
  translation-check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Algebras Translation Status
        uses: algebras-ai/locale-checker-action@main
        # Optional: specify a file pattern
        # with:
        #   file_pattern: "src/locale/**/*.json"
        #   only-missing: true

‍

Входы:

шаблон файла (опционально): глобус для файлов локализации (например src/locale/**/*.json).
отсутствует только (опционально): установите значение правда сообщать только об отсутствующих ключах (игнорировать устаревшие).

‍

Примеры выходных данных:

Успех

Loaded configuration: /path/to/.algebras.config
Available languages: en, fr, es, de
Source language: en
Running CI checks...
Scanning for translation files...
Found files by language: {'en': ['src/locales/en.json'], ...}
Processing languages: fr, es, de
All translation keys are up-to-date! ✅
::notice::Translation status check passed! All translations are up-to-date.

‍

Неудача

Loaded configuration: /path/to/.algebras.config
Available languages: en, fr, es, ru
Source language: en
Running CI checks...

CI Check: Found issues with translations:

Language 'ru': Missing keys:
  - Features.feature6_description
  - Features.feature6_title
  - TodoForm.some_new_key_to_test

Language 'ru': Outdated keys:
  - Features.feature1_title (Source updated: 2024-10-08, Target: 2024-10-03)
  - Hero.title (Source updated: 2024-10-07, Target: 2024-10-03)

::error::Translation status check failed! Some translations are missing or outdated.
Error: Process completed with exit code 1.

‍

Для получения дополнительной информации и дополнительных опций см. Страница торговой площадки GitHub.

‍

Документация и поддержка

Ресурсы, которые помогут вам максимально эффективно использовать инструмент Algebras CLI

‍

Репозиторий GitHub

Просматривайте исходный код, вносите вклад и сообщайте о проблемах на GitHub

‍

Документация

Подробные руководства, учебные пособия и справочная документация

‍

Поддержка

Нужна помощь? Обратитесь к нам по одному из следующих каналов:

Поддержка по электронной почте

‍Справочный центр