Skip to content

README.md

Latest commit

 

History

History
250 lines (178 loc) · 21.4 KB

README.md

File metadata and controls

250 lines (178 loc) · 21.4 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

Arabic | Bengali | Bulgarian | Burmese (Myanmar) | Chinese (Simplified) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Macau) | Chinese (Traditional, Taiwan) | Croatian | Czech | Danish | Dutch | Estonian | Finnish | French | German | Greek | Hebrew | Hindi | Hungarian | Indonesian | Italian | Japanese | Kannada | Khmer | Korean | Lithuanian | Malay | Malayalam | Marathi | Nepali | Nigerian Pidgin | Norwegian | Persian (Farsi) | Polish | Portuguese (Brazil) | Portuguese (Portugal) | Punjabi (Gurmukhi) | Romanian | Russian | Serbian (Cyrillic) | Slovak | Slovenian | Spanish | Swahili | Swedish | Tagalog (Filipino) | Tamil | Telugu | Thai | Turkish | Ukrainian | Urdu | Vietnamese

Претпочитате да клонирате локално?

Овај репозиторијум садржи више од 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 фајлове, слике или белешке (notebooks), преводи се аутоматски синхронизују, осигуравајући да садржај остане тачан и ажуран за ученике широм света.

Пример како је преведени садржај организован:

Example

Како се управља стањем превода

Co-op Translator обрађује преведени садржај као верзионисане софтверске артефакте,
не као статичне фајлове.

Алат прати стање преведеног Markdown-а, слика и бележница
користећи метаподатке у оквиру језика.

Овај дизајн омогућава Co-op Translator-у да:

  • Поуздано детектује застареле преводе
  • Истоветно третира Markdown, слике и белешке
  • Безбедно скалира на великим, брзо мењајућим, мулти-језичким репозиторијумима

Моделирањем превода као управљаних артефаката,
радни токови превођења се природно усклађују са савременим
практикама управљања софтверским зависностима и артефактима.

→ Како се управља стањем превода

Брзи почетак

# Креирајте и активирајте виртуелно окружење (препоручено)
python -m venv .venv
# Виндоус
.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 languages template
  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 “For Beginners” репозиторијума.

Подржите нас и промовишите глобално учење

Придружите нам се у револуционисању начина на који се едукативни садржај дели глобално! Дајте 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 Open Source Code of Conduct. За више информација погледајте Честа питања о Кодексу понашања или контактирајте [email protected] са додатним питањима или коментарима.

Одговорни AI

Microsoft је посвећен помагању нашим корисницима да одговорно користе наше AI производе, делећи наша сазнања и градећи партнерства заснована на поверењу кроз алате као што су Transparency Notes и Impact Assessments. Многи од ових ресурса могу се пронаћи на https://aka.ms/RAI. Приступ Microsoft-а одговорном AI-у заснован је на нашим AI принципима праведности, поузданости и безбедности, приватности и безбедности, инклузивности, транспарентности и одговорности.

Модели великог обима за природни језик, слику и говор - као они који се користе у овом примеру - потенцијално могу да се понашају на начине који нису праведни, поуздани или могу бити увредљиви, што може изазвати штету. Молимо вас да консултујете Azure OpenAI service Transparency note како бисте били информисани о ризицима и ограничењима.

Препоручени приступ ублажавању ових ризика је укључивање система безбедности у вашу архитектуру који може да детектује и спречи штетно понашање. Azure AI Content Safety пружа независни слој заштите, способан да детектује штетни кориснички и AI генерисани садржај у апликацијама и сервисима. Azure AI Content Safety укључује текстуалне и сликовне API-је који вам омогућавају да детектујете материјал који је штетан. Такође имамо интерактивни Content Safety Studio који вам омогућава да гледате, истражујете и испробате пример кода за детекцију штетног садржаја кроз разне модалитете. Следећа quickstart документација вас води кроз прављење захтева сервису.

Још један аспект који треба узети у обзир је укупна перформанса апликације. Код мултимодалних и мултимоделских апликација, перформанса подразумева да систем делује онако како ви и ваши корисници очекујете, укључујући да не генерише штетне резултате. Важно је проценити перформансе ваше укупне апликације користећи метрике квалитета генерације и ризика и безбедности.

Можете проценити вашу AI апликацију у вашем развојном окружењу користећи prompt flow SDK. Узете генерације ваше генеративне AI апликације се квантитативно мере помоћу уграђених или прилагођених евалуатора по вашем избору, уз тест скуп података или циљ. Да бисте започели коришћење prompt flow SDK за процену вашег система, можете пратити quickstart водич. Када извршите процену, можете визуализовати резултате у Azure AI Studio.

Заштитни знаци

Овај пројекат може садржати заштитне знаке или логотипе пројеката, производа или услуга. Овлашћена употреба Microsoft заштитних знакова или логотипа подлеже и мора пратити Microsoft-ова правила за коришћење заштитних знакова и брендова. Употреба Microsoft заштитних знакова или логотипа у модификованим верзијама овог пројекта не сме изазивати забуну нити имплицирати спонзорство Microsoft-а. Употреба заштитних знакова или логотипа трећих страна подложна је правилима тих трећих страна.

Добијање помоћи

Ако сте заглављени или имате питања о изградњи AI апликација, придружите се:

Microsoft Foundry Discord

Уколико имате повратне информације о производу или грешке током развоја посете:

Microsoft Foundry Developer Forum

Одрицање од одговорности:
Овај документ је преведен коришћењем АИ преводилачке услуге Co-op Translator. Иако тежимо тачности, имајте на уму да аутоматизовани преводи могу садржати грешке или нетачности. Изворни документ на његовом оригиналном језику треба сматрати ауторитетним извором. За критичне информације препоручује се професионални људски превод. Нисмо одговорни за било каква неспоразума или погрешна тумачења која произлазе из коришћења овог превода.
⚡