Skip to content

Latest commit

 

History

History
249 lines (177 loc) · 23.1 KB

File metadata and controls

249 lines (177 loc) · 23.1 KB

Co-op Translator

Легко автоматизуйте та підтримуйте переклади вашого навчального контенту на GitHub кількома мовами в міру розвитку вашого проєкту.

Python 3.10–3.12 Python package License: MIT Downloads Downloads Container: GHCR Code style: black

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

🌐 Підтримка багатомовності

Підтримується Co-op Translator

Арабська | Бенгальська | Болгарська | Бирманська (М’янма) | Китайська (спрощена) | Китайська (традиційна, Гонконг) | Китайська (традиційна, Макао) | Китайська (традиційна, Тайвань) | Хорватська | Чеська | Датська | Голландська | Естонська | Фінська | Французька | Німецька | Грецька | Іврит | Гінді | Угорська | Індонезійська | Італійська | Японська | Каннада | Кхмер | Корейська | Литовська | Малайська | Малаялам | Маратхі | Непальська | Нігерійський пиджин | Норвезька | Перська (Фарсі) | Польська | Португальська (Бразилія) | Португальська (Португалія) | Панджабі (Гурмухі) | Румунська | Російська | Сербська (кирилиця) | Словацька | Словенська | Іспанська | Свахілі | Шведська | Тагальська (Філіппінська) | Тамільська | Телугу | Тайська | Турецька | Українська | Урду | В’єтнамська

Віддаєте перевагу клонувати локально?

Цей репозиторій містить переклади понад 50 мов, що значно збільшує розмір завантаження. Щоб клонувати без перекладів, використайте sparse checkout:

Bash / macOS / Linux:

git clone --filter=blob:none --sparse https://github.com/Azure/co-op-translator.git
cd co-op-translator
git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'

CMD (Windows):

git clone --filter=blob:none --sparse https://github.com/Azure/co-op-translator.git
cd co-op-translator
git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"

Це надасть усе необхідне для проходження курсу з набагато швидшим завантаженням.

GitHub watchers GitHub forks GitHub stars

Microsoft Foundry Discord

Open in GitHub Codespaces

Огляд

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

Приклад організації перекладеного контенту:

Example

Як керується стан перекладу

Co-op Translator керує перекладеним контентом як версіонованими артефактами програмного забезпечення,
а не як статичними файлами.

Інструмент відстежує стан перекладених Markdown, зображень і ноутбуків за допомогою метаданих, обмежених мовою.

Цей підхід дозволяє Co-op Translator:

  • Надійно виявляти застарілі переклади
  • Однаково обробляти Markdown, зображення та ноутбуки
  • Безпечно масштабуватися у великих, швидкорухомих багатомовних репозиторіях

Моделюючи переклади як керовані артефакти, робочі процеси перекладу природньо узгоджуються з сучасними практиками управління залежностями та артефактами у програмному забезпеченні.

Як керується стан перекладу

Швидкий старт

# Створіть та активуйте віртуальне середовище (рекомендовано)
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

Мінімальні налаштування

  1. Переконайтесь, що у вас підтримується версія Python (зараз 3.10-3.12). У poetry (pyproject.toml) це обробляється автоматично.
  2. Створіть файл .env за шаблоном: .env.template
  3. Налаштуйте одного провайдера LLM (Azure OpenAI або OpenAI)
  4. (Опційно) Для перекладу зображень (-img) налаштуйте Azure AI Vision
  5. (Опційно) Ви можете налаштувати кілька наборів облікових даних, дублюючи змінні з суфіксами _1, _2 і т.д. Всі змінні в наборі мають мати той самий суфікс.
  6. (Рекомендовано) Очистьте попередні переклади, щоб уникнути конфліктів (наприклад, translations/)
  7. (Рекомендовано) Додайте секцію перекладів у ваш README, використовуючи шаблон мов README
  8. Див. також: Налаштування 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 “Для початківців”.

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

Приєднуйтеся до революції у тому, як навчальний контент поширюється у світі! Поставте ⭐ Co-op Translator на GitHub і підтримайте нашу місію подолання мовних бар’єрів у навчанні та технологіях. Ваша зацікавленість і внесок мають велике значення! Запрошуємо до внесення коду та пропозицій нових функцій.

Досліджуйте навчальний контент Microsoft вашою мовою

Відео презентації

👉 Натисніть на зображення нижче, щоб подивитися на YouTube.

  • Open at Microsoft: Короткий 18-хвилинний вступ та швидка інструкція з використання Co-op Translator.

    Open at Microsoft

Внесок у проєкт

Цей проєкт вітає внесок та пропозиції. Бажаєте долучитися до розробки Azure Co-op Translator? Будь ласка, ознайомтеся з нашим CONTRIBUTING.md для інструкцій, як допомогти зробити Co-op Translator більш доступним.

Учасники проекту

co-op-translator contributors

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

Цей проєкт прийняв Кодекс поведінки Microsoft з відкритим вихідним кодом. Для отримання додаткової інформації див. FAQ з Кодексу поведінки або звертайтеся на opencode@microsoft.com з будь-якими додатковими питаннями чи коментарями.

Відповідальний Штучний Інтелект

Microsoft прагне допомогти нашим клієнтам відповідально використовувати наші AI продукти, ділитися своїм досвідом та будувати партнерські відносини на основі довіри за допомогою таких інструментів, як Transparency Notes та Impact Assessments. Багато з цих ресурсів можна знайти за адресою https://aka.ms/RAI. Підхід Microsoft до відповідального AI ґрунтується на наших принципах AI: справедливість, надійність і безпека, конфіденційність і захист, інклюзивність, прозорість та підзвітність.

Великі моделі природної мови, зображень і мовлення — такі, як ті, що використовуються в цьому прикладі — можуть потенційно поводитися несправедливо, ненадійно або образливо, що може призвести до шкоди. Будь ласка, ознайомтеся з Transparency note служби Azure OpenAI, щоб дізнатися про ризики та обмеження.

Рекомендований підхід до зменшення цих ризиків полягає у включенні системи безпеки у вашу архітектуру, яка може виявляти та запобігати шкідливій поведінці. Azure AI Content Safety забезпечує незалежний рівень захисту, здатний виявляти шкідливий контент, створений користувачами та AI, у додатках і службах. Azure AI Content Safety включає API для тексту та зображень, які дозволяють виявляти шкідливі матеріали. Ми також маємо інтерактивну Content Safety Studio, яка дозволяє переглядати, досліджувати та випробовувати приклади коду для виявлення шкідливого контенту в різних режимах. Наступна документація швидкого запуску проводить вас через процес надсилання запитів до служби.

Іншим аспектом є загальна продуктивність додатка. Для багатомодальних і багатомодельних додатків продуктивність означає, що система працює так, як ви і ваші користувачі очікують, включно з тим, що не генерує шкідливі результати. Важливо оцінити продуктивність вашого додатка загалом за допомогою метрик якості генерації та ризику і безпеки.

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

Торгові марки

Цей проєкт може містити торгові марки або логотипи проєктів, продуктів чи сервісів. Авторизоване використання торгових марок або логотипів Microsoft підпорядковується і має відповідати Правилам використання торгових марок і брендів Microsoft. Використання торгових марок або логотипів Microsoft у змінених версіях цього проєкту не повинно викликати плутанину або створювати враження спонсорства Microsoft. Використання торгових марок або логотипів третіх сторін підпорядковується політикам тих третіх сторін.

Отримання допомоги

Якщо ви зіткнулись із труднощами або у вас є питання щодо створення AI-додатків, приєднуйтеся до:

Microsoft Foundry Discord

Якщо у вас є відгуки про продукт або помилки під час розробки, відвідайте:

Microsoft Foundry Developer Forum


Відмова від відповідальності:
Цей документ було перекладено за допомогою сервісу автоматичного перекладу Co-op Translator. Хоча ми прагнемо до точності, зверніть увагу, що автоматичні переклади можуть містити помилки або неточності. Оригінальний документ рідною мовою слід вважати авторитетним джерелом. Для критично важливої інформації рекомендується звертатися до професійного людського перекладу. Ми не несемо відповідальності за будь-які непорозуміння чи неправильні тлумачення, що виникли внаслідок використання цього перекладу.