co-op-translator

Co-op Translator

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

🌐 Поддержка нескольких языков

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

Обзор

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

Пример организации переведённого контента:

Example

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

# Создайте и активируйте виртуальное окружение (рекомендуется)
python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS/Linux
source .venv/bin/activate
# Установите пакет
pip install co-op-translator
# Перевести
translate -l "ko ja fr" -md

Docker:

# Загрузить публичный образ из GHCR
docker pull ghcr.io/azure/co-op-translator:latest
# Запустить с текущей папкой, смонтированной и с предоставленным .env (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

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

Руководство для Microsoft

[!NOTE] Только для поддерживающих репозитории Microsoft “Для начинающих”.

Обновление списка «других курсов» (только для репозиториев MS Beginners)

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

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

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

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

👉 Нажмите на изображение ниже, чтобы посмотреть на 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, чтобы быть в курсе рисков и ограничений. Рекомендуемый подход к снижению этих рисков — включить в архитектуру систему безопасности, которая может обнаруживать и предотвращать вредоносное поведение. 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.