co-op-translator

Co-op Translator

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

🌐 Многоязычная поддержка

Поддерживается Co-op Translator

Обзор

Co-op Translator позволяет быстро переводить ваш образовательный контент на GitHub на разные языки, чтобы легко охватить международную аудиторию. Когда вы обновляете свои Markdown-файлы, изображения или Jupyter-ноутбуки, переводы автоматически синхронизируются, чтобы ваш образовательный контент на GitHub всегда был актуальным для пользователей по всему миру.

Посмотрите, как Co-op Translator организует переведённый образовательный контент на GitHub:

Пример

Быстрый старт

# Create and activate a virtual environment (recommended)
python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS/Linux
source .venv/bin/activate
# Install the package
pip install co-op-translator
# Translate
translate -l "ko ja fr" -md

Docker:

# Pull the public image from GHCR
docker pull ghcr.io/azure/co-op-translator:latest
# Run with current folder mounted and .env provided (Bash/Zsh)
docker run --rm -it --env-file .env -v "${PWD}:/work" ghcr.io/azure/co-op-translator:latest -l "ko ja fr" -md

Минимальная настройка

Создайте файл .env по шаблону: .env.template
Настройте одного провайдера LLM (Azure OpenAI или OpenAI)
Для перевода изображений (-img) также укажите Azure AI Vision
Рекомендуется: если у вас есть переводы, созданные другими инструментами, сначала удалите их, чтобы избежать конфликтов (например: translations/).
Рекомендуется: добавьте раздел с переводами в ваш README, используя шаблон языков README
Подробнее: Настройка Azure AI

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

Перевести все поддерживаемые типы:

translate -l "ko ja"

Только Markdown:

translate -l "de" -md

Markdown + изображения:

translate -l "pt" -md -img

Только ноутбуки:

translate -l "zh" -nb

Больше флагов: Справочник команд

Возможности

Автоматический перевод Markdown, ноутбуков и изображений
Сохраняет синхронизацию переводов с исходными изменениями
Работает локально (CLI) и в CI (GitHub Actions)
Использует Azure OpenAI или OpenAI; опционально Azure AI Vision для изображений
Сохраняет форматирование и структуру Markdown

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

Поддержите нас и развивайте глобальное обучение

Присоединяйтесь к нам, чтобы изменить подход к распространению образовательного контента по всему миру! Поставьте ⭐ Co-op Translator на GitHub и поддержите нашу миссию по преодолению языковых барьеров в обучении и технологиях. Ваш интерес и вклад действительно важны! Мы всегда рады вашим предложениям и участию в разработке.

Изучайте образовательный контент Microsoft на вашем языке

Видео-презентации

Узнайте больше о Co-op Translator из наших презентаций (Нажмите на изображение ниже, чтобы посмотреть на YouTube.):

Open at Microsoft: Краткое 18-минутное введение и быстрый гид по использованию Co-op Translator.

Вклад

Этот проект открыт для предложений и участия. Хотите внести вклад в Azure Co-op Translator? Ознакомьтесь с CONTRIBUTING.md, чтобы узнать, как вы можете помочь сделать Co-op Translator более доступным.

Участники

Кодекс поведения

В этом проекте действует Кодекс поведения Microsoft Open Source. Подробнее см. FAQ по кодексу поведения или свяжитесь с opencode@microsoft.com по любым вопросам или комментариям.

Ответственный ИИ

Microsoft стремится помогать клиентам использовать наши ИИ-продукты ответственно, делиться опытом и строить доверительные отношения с помощью таких инструментов, как Transparency Notes и Impact Assessments. Многие из этих ресурсов доступны по адресу https://aka.ms/RAI. Подход Microsoft к ответственному ИИ основан на принципах справедливости, надёжности и безопасности, конфиденциальности и защите, инклюзивности, прозрачности и ответственности.

Крупномасштабные модели обработки естественного языка, изображений и речи — такие, как используются в этом примере — могут вести себя несправедливо, ненадёжно или оскорбительно, что может привести к негативным последствиям. Ознакомьтесь с Transparency note по Azure OpenAI service, чтобы узнать о рисках и ограничениях.

Рекомендуется включать систему безопасности в вашу архитектуру, чтобы обнаруживать и предотвращать вредоносное поведение. Azure AI Content Safety предоставляет независимый уровень защиты, способный обнаруживать вредоносный пользовательский и ИИ-контент в приложениях и сервисах. Azure AI Content Safety включает API для текста и изображений, которые позволяют выявлять опасные материалы. Также есть интерактивная Content Safety Studio, где можно просматривать, исследовать и тестировать примеры кода для обнаружения вредоносного контента в разных форматах. Следующая документация по быстрому старту поможет вам начать работу с сервисом. Еще один важный аспект — это производительность приложения в целом. В случае мультимодальных и многомодельных приложений, под производительностью мы понимаем, что система работает так, как ожидаете вы и ваши пользователи, включая предотвращение вредоносных результатов. Важно оценивать производительность всего приложения с помощью метрик качества генерации, рисков и безопасности.

Вы можете оценить свое AI-приложение в среде разработки с помощью prompt flow SDK. Используя тестовый датасет или целевую задачу, генерации вашего генеративного AI-приложения количественно оцениваются встроенными или пользовательскими оценщиками на ваш выбор. Чтобы начать работу с prompt flow sdk для оценки вашей системы, следуйте руководству по быстрому старту. После запуска оценки вы можете визуализировать результаты в Azure AI Studio.

Товарные знаки

В этом проекте могут использоваться товарные знаки или логотипы проектов, продуктов или сервисов. Разрешенное использование товарных знаков или логотипов Microsoft регулируется и должно соответствовать Руководству по использованию товарных знаков и брендов Microsoft. Использование товарных знаков или логотипов Microsoft в измененных версиях этого проекта не должно вводить в заблуждение или подразумевать спонсорство со стороны Microsoft. Любое использование товарных знаков или логотипов третьих сторон регулируется политиками этих сторон.

Получение помощи

Если у вас возникли трудности или вопросы по созданию AI-приложений, присоединяйтесь к:

Если у вас есть отзывы о продукте или возникли ошибки при разработке, посетите:

Отказ от ответственности: Этот документ был переведен с помощью сервиса автоматического перевода Co-op Translator. Несмотря на стремление к точности, автоматические переводы могут содержать ошибки или неточности. Оригинальный документ на исходном языке следует считать авторитетным источником. Для получения критически важной информации рекомендуется профессиональный перевод человеком. Мы не несём ответственности за любые недоразумения или неправильные толкования, возникшие в результате использования данного перевода.

This site is open source. Improve this page.