О проекте

Утилита для автоперевода контента Astro-сайтов. Автоматически генерирует переведённый контент из файлов в директории content/, поддерживая одиночные и пакетные переводы.

Возможности

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

Укажи на директорию контента, настрой целевые языки — получи переводы. Без ручного копирования и создания заглушек.

Гибкость

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

Интеграция с Astro

Работает со встроенной поддержкой языков в Astro. Выводит контент в нужной структуре.

Сохранение формата

Сохраняет Markdown/MDX форматирование, структуру метаданных и использование компонентов. Переводы выглядят как оригиналы.

Как работает

# Установи инструмент
npm install astro-content-ai-translator

# Настрой целевые языки
# (в файле конфигурации)

# Запусти перевод
npx translate-content --target ru,ja,de

Инструмент:

1. Сканирует директорию контента
2. Определяет непереведённый контент
3. Отправляет контент на автоперевод
4. Сохраняет переведённые файлы в правильной структуре
5. Сохраняет метаданные и форматирование

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

// translator.config.js
export default {
  contentDir: './src/content/pages',
  defaultLanguage: 'en',
  targetLanguages: ['ru', 'ja', 'de', 'fr'],
  // Конфигурация провайдера
  provider: 'openai',
  // Настройки качества
  preserveFormatting: true,
  reviewMode: false
}

Практики

Для рабочего контента

1. Используй инструмент для первичного перевода
2. Дай носителям языка проверить
3. Внеси правки в переведённые файлы
4. Инструмент не перезаписывает существующие переводы

Для быстрой работы

1. Переводи рано и часто
2. Используй режим черновика для тестов
3. Пакетный перевод когда контент стабилизируется

Зачем сделали

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

Цель — не заменить переводчиков, а ускорить процесс и снизить порог входа.

Ограничения

• Автоперевод неидеален — рекомендуется проверка человеком для рабочего контента
• Очень технический контент требует дополнительного внимания
• Культурная адаптация всё ещё требует человеческого суждения

Открытый код

Доступен на GitHub. Задачи, предложения и вклад приветствуются.