# Algebras AI + Github Actions

## Действия GitHub — средство проверки локали

## Действие «Статус перевода алгебр»

Действие GitHub для проверки статуса переводов вашего приложения с помощью интерфейса командной строки Algebras.

#### Автоматическая проверка работоспособности перевода

Это действие предназначено для проектов NextJS с фреймворком i18n для локализации. Оно выполняет проверку работоспособности, чтобы убедиться, что все переводы синхронизированы на разных языках. Если какие-либо переводы отсутствуют или устарели, действие не будет выполнено, что выявит проблемы в конвейере CI/CD.

**Доступно уже сейчас \| Лицензия MIT**

## Руководство по быстрой настройке

Начните работу с действием «Статус перевода алгебр» за считанные минуты

#### Пример базового рабочего процесса

```javascript
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
```

#### Опции конфигурации

- **шаблон файла:** Укажите шаблон глобуса для файлов локализации **‍**
- **отсутствует только:** Сообщайте только об отсутствующих ключах (игнорируйте устаревшие)

#### Требования

- Проект NextJS с фреймворком i18n
- Конфигурация интерфейса командной строки Algebras
- Файлы перевода в поддерживаемом формате

## Ключевые характеристики

Что делает этот GitHub Action мощным инструментом для вашего рабочего процесса перевода?

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

Автоматическое обнаружение отсутствующих или устаревших переводов в конвейере CI/CD

#### Гибкие шаблоны файлов

Поддержка настраиваемых шаблонов глобусов в соответствии со структурой вашего проекта

#### Подробные отчеты об ошибках

Четкие сообщения об ошибках, показывающие, какие именно переводы требуют внимания

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

Легко интегрируется с GitHub Actions для предотвращения некорректных переводов

#### Настраиваемые опции

Настройте поведение с помощью таких параметров, как «только отсутствующие» или «настраиваемые шаблоны файлов»

#### Открытый исходный код

Лицензированный MIT и полностью открытый исходный код для прозрачности и персонализации

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

Узнайте, о чем сообщает действие при проверке ваших переводов

#### Случай успеха

```javascript
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'], 'fr': ['src/locales/fr.json'], 'es': ['src/locales/es.json'], 'de': ['src/locales/de.json']}

Processing languages: fr, es, de
All translation keys are up-to-date! ✅
::notice::Translation status check passed! All translations are up-to-date.
```

#### Случай отказа

```javascript
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.
```

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

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

#### Настраиваемый шаблон файла

```javascript
- name: Algebras Translation Status
  uses: algebras-ai/locale-checker-action@main
  with:
    file_pattern: "src/locale/**/*.json"
```

#### Только недостающие ключи

```javascript
- name: Algebras Translation Status
  uses: algebras-ai/locale-checker-action@main
  with:
    only-missing: true
```

#### Комбинированная конфигурация

```javascript
- name: Algebras Translation Status
  uses: algebras-ai/locale-checker-action@main
  with:
    file_pattern: "src/translations/**/*.json"
    only-missing: true
```

## Зачем использовать это действие?

Преимущества интеграции переводов в конвейер CI/CD

#### Предотвращение неработающих переводов

Улавливайте недостающие или устаревшие переводы еще до их выпуска в производство, обеспечивая единообразный пользовательский интерфейс на всех языках.

#### Автоматизированный контроль качества

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

#### Производительность разработчиков

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

#### Совместная работа в команде

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

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

Ресурсы, которые помогут вам получить максимальную отдачу от GitHub Action

#### [Репозиторий GitHub](https://github.com/algebras-ai/locale-checker-action)

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

#### [Примечания к релизу](https://github.com/algebras-ai/locale-checker-action/releases)

Будьте в курсе последних функций и исправлений ошибок

#### Обратитесь за помощью

Нужна помощь в реализации акции GitHub?

[Сообщить о проблемах](https://github.com/algebras-ai/locale-checker-action/issues)