co-op-translator
Co-op Translator: Oktatási dokumentációk fordításának automatizálása könnyedén
A dokumentáció több nyelvre történő egyszerű automatizált fordításával érjen el globális közönséget.
Nyelvi támogatás a Co-op Translator segítségével
[!NOTE] Ezek a jelenlegi fordítások a repository tartalmához. A Co-op Translator által támogatott összes nyelv teljes listájáért kérjük, tekintse meg a Language Support részt.
Áttekintés: Egyszerűsítse oktatási tartalmai fordítását
A nyelvi akadályok jelentősen korlátozzák a tanulók és fejlesztők hozzáférését értékes oktatási anyagokhoz és technikai tudáshoz világszerte. Ez csökkenti a részvételt, és lassítja a globális innováció és tanulás ütemét.
A Co-op Translator abból a szükségletből született, hogy megoldja a Microsoft saját nagyszabású oktatási sorozatainak (például a “For Beginners” útmutatók) kézi fordításának hatékonysági problémáit. Egy könnyen használható, erőteljes eszközzé fejlődött, amely mindenki számára lebontja ezeket a nyelvi korlátokat. Magas színvonalú, automatikus fordításokat kínál CLI-n és GitHub Actions-en keresztül, így világszerte segíti az oktatókat, diákokat, kutatókat és fejlesztőket a tudás megosztásában és hozzáférésében nyelvi akadályok nélkül.
Nézze meg, hogyan rendezi a Co-op Translator a lefordított oktatási tartalmakat:
A Markdown fájlok és a képek szövege automatikusan fordításra kerül, és nyelvspecifikus mappákba rendezve jelenik meg.
Nyissa meg oktatási tartalma világméretű elérését még ma a Co-op Translator segítségével!
A Microsoft tanulási anyagainak globális elérhetőségének támogatása
A Co-op Translator segít áthidalni a nyelvi szakadékot a Microsoft kulcsfontosságú oktatási kezdeményezései számára, automatizálva a fordítási folyamatokat olyan repókban, amelyek egy globális fejlesztői közösséget szolgálnak ki. Jelenleg a következő projektek használják a Co-op Translator-t:
Főbb jellemzők
- Automatikus fordítások: Szöveg több nyelvre történő könnyed fordítása.
- GitHub Actions integráció: A fordítások automatizálása CI/CD folyamat részeként.
- Markdown megőrzése: A helyes Markdown szintaxis megtartása a fordítás során.
- Kép szöveg fordítása: Képekben található szöveg kinyerése és fordítása.
- Fejlett LLM technológia: Csúcstechnológiás nyelvi modellek használata a magas színvonalú fordításokért.
- Egyszerű integráció: Zökkenőmentes beillesztés a meglévő projektbe.
- Lokalizáció egyszerűsítése: A projekt nemzetközi piacokra való lokalizációjának felgyorsítása.
Hogyan működik
A Co-op Translator a projekt mappájából veszi a Markdown fájlokat és képeket, majd a következőképpen dolgozza fel őket:
- Szövegkinyerés: Kinyeri a szöveget a Markdown fájlokból, és ha be van állítva (pl. Azure AI Vision segítségével), a képekbe ágyazott szöveget is.
- AI fordítás: Az így kinyert szöveget elküldi a konfigurált LLM-nek (Azure OpenAI, OpenAI, stb.) fordításra.
- Eredmény mentése: A lefordított Markdown fájlokat és képeket (a fordított szöveggel) nyelvspecifikus mappákba menti, megőrizve az eredeti formázást.
Első lépések
Gyorsan elindulhat a CLI használatával, vagy beállíthat teljes automatizálást GitHub Actions segítségével. Válassza ki az Ön munkafolyamatához legjobban illő megoldást:
- Parancssor (CLI) – Egyszeri fordításokhoz vagy manuális vezérléshez
- GitHub Actions – Automatikus fordítás minden push eseménynél
[!NOTE] Bár ez az útmutató az Azure erőforrásokra fókuszál, bármilyen támogatott nyelvi modellt használhat.
Nyelvi támogatás
A Co-op Translator számos nyelvet támogat, hogy segítsen elérni a globális közönséget. Íme, amit tudnia kell:
Gyors referencia
| Nyelv | Kód | Nyelv | Kód | Nyelv | Kód |
|---|---|---|---|---|---|
| Arab | ar | Bengáli | bn | Bolgár | bg |
| Burmai (Myanmar) | my | Kínai (Egyszerűsített) | zh | Kínai (Hagyományos, HK) | hk |
| Kínai (Hagyományos, Makaó) | mo | Kínai (Hagyományos, TW) | tw | Horvát | hr |
| Cseh | cs | Dán | da | Holland | nl |
| Finn | fi | Francia | fr | Német | de |
| Görög | el | Héber | he | Hindi | hi |
| Magyar | hu | Indonéz | id | Olasz | it |
| Japán | ja | Koreai | ko | Maláj | ms |
| Maráthi | mr | Nepáli | ne | Norvég | no |
| Perzsa (Fárszi) | fa | Lengyel | pl | Portugál (Brazília) | br |
| Portugál (Portugália) | pt | Pandzsbí (Gurmukhi) | pa | Román | ro |
| Orosz | ru | Szerb (Cirill) | sr | Szlovák | sk |
| Szlovén | sl | Spanyol | es | Szuahéli | sw |
| Svéd | sv | Tagalog (Filippínó) | tl | Thai | th |
| Török | tr | Ukrán | uk | Urdu | ur |
| Vietnami | vi | — | — | — | — |
Nyelvkódok használata
A Co-op Translator használatakor a nyelveket kódokkal kell megadni. Például:
# Translate to French, Spanish, and German
translate -l "fr es de"
# Translate to Chinese (Simplified) and Japanese
translate -l "zh ja"
[!NOTE] A nyelvi támogatás részletes technikai információiért, beleértve:
- Betűtípus-specifikációk nyelvenként
- Ismert problémák
- Új nyelvek hozzáadásának módja
Tekintse meg a Supported Languages Documentation dokumentációt.
Támogatott modellek és szolgáltatások
| Típus | Név |
|---|---|
| Nyelvi modell |   |
| AI Vision |  |
[!NOTE] Ha AI vision szolgáltatás nem érhető el, a co-op translator Markdown-only mode üzemmódra vált.
Kezdeti beállítás
Mielőtt elkezdené, állítsa be a következő erőforrásokat:
- Nyelvi modell erőforrás (kötelező):
- Azure OpenAI (ajánlott) – Magas színvonalú, vállalati megbízhatóságú fordításokat biztosít
- OpenAI – Alternatív megoldás, ha nincs Azure hozzáférése
- Részletes információkért lásd a Supported Models and Services részt
- AI Vision erőforrás (opcionális):
- Azure AI Vision – Képekben található szöveg fordítását teszi lehetővé
- Ha nincs beállítva, a fordító automatikusan a Markdown-only mode üzemmódot használja
- Ajánlott olyan projektekhez, amelyek képeket tartalmaznak fordítandó szöveggel
- Konfigurációs lépések:
- Kövesse az Azure AI setup guide részletes útmutatóját
- Hozzon létre egy
.envfájlt az API kulcsokkal és végpontokkal (lásd a Quick Start részt) - Ellenőrizze, hogy rendelkezik a szükséges jogosultságokkal és kvótákkal a választott szolgáltatásokhoz
Projekt előkészítése a fordítás előtt
A fordítás megkezdése előtt készítse elő a projektet az alábbi lépésekkel:
- README előkészítése:
- Adjon hozzá egy fordítási táblázatot a README.md fájlhoz, amely linkel a lefordított verziókra
-
Példa formátum:
### 🌐 Multi-Language Support [French](/co-op-translator/translations/fr/) | [Spanish](/co-op-translator/translations/es/) | [German](/co-op-translator/translations/de/) | [Russian](/co-op-translator/translations/ru/) | [Arabic](/co-op-translator/translations/ar/) | [Persian (Farsi)](/co-op-translator/translations/fa/) | [Urdu](/co-op-translator/translations/ur/) | [Chinese (Simplified)](/co-op-translator/translations/zh/) | [Chinese (Traditional, Macau)](/co-op-translator/translations/mo/) | [Chinese (Traditional, Hong Kong)](/co-op-translator/translations/hk/) | [Chinese (Traditional, Taiwan)](/co-op-translator/translations/tw/) | [Japanese](/co-op-translator/translations/ja/) | [Korean](/co-op-translator/translations/ko/) | [Hindi](/co-op-translator/translations/hi/) | [Bengali](/co-op-translator/translations/bn/) | [Marathi](/co-op-translator/translations/mr/) | [Nepali](/co-op-translator/translations/ne/) | [Punjabi (Gurmukhi)](/co-op-translator/translations/pa/) | [Portuguese (Portugal)](/co-op-translator/translations/pt/) | [Portuguese (Brazil)](/co-op-translator/translations/br/) | [Italian](/co-op-translator/translations/it/) | [Polish](/co-op-translator/translations/pl/) | [Turkish](/co-op-translator/translations/tr/) | [Greek](/co-op-translator/translations/el/) | [Thai](/co-op-translator/translations/th/) | [Swedish](/co-op-translator/translations/sv/) | [Danish](/co-op-translator/translations/da/) | [Norwegian](/co-op-translator/translations/no/) | [Finnish](/co-op-translator/translations/fi/) | [Dutch](/co-op-translator/translations/nl/) | [Hebrew](/co-op-translator/translations/he/) | [Vietnamese](/co-op-translator/translations/vi/) | [Indonesian](/co-op-translator/translations/id/) | [Malay](/co-op-translator/translations/ms/) | [Tagalog (Filipino)](/co-op-translator/translations/tl/) | [Swahili](/co-op-translator/translations/sw/) | [Hungarian](/co-op-translator/translations/hu/) | [Czech](/co-op-translator/translations/cs/) | [Slovak](/co-op-translator/translations/sk/) | [Romanian](/co-op-translator/translations/ro/) | [Bulgarian](/co-op-translator/translations/bg/) | [Serbian (Cyrillic)](/co-op-translator/translations/sr/) | [Croatian](/co-op-translator/translations/hr/) | [Slovenian](/co-op-translator/translations/sl/) | [Ukrainian](/co-op-translator/translations/uk/) | [Burmese (Myanmar)](/co-op-translator/translations/my/)
- Korábbi fordítások eltávolítása (ha szükséges):
- Törölje a meglévő fordítási mappákat (pl.
translations/) - Távolítson el régi fordítási fájlokat, hogy tiszta lappal induljon
- Ez megakadályozza az esetleges ütközéseket az új fordítási folyamattal
- Törölje a meglévő fordítási mappákat (pl.
Gyors kezdés: Parancssor
Gyors indításhoz a parancssor használatával:
-
Hozzon létre egy virtuális környezetet:
python -m venv .venv -
Aktiválja a virtuális környezetet:
- Windows rendszeren:
.venv\scripts\activate- Linux/macOS rendszeren:
source .venv/bin/activate -
Telepítse a csomagot:
pip install co-op-translator -
Hitelesítő adatok beállítása:
- Hozzon létre egy
.envfile in your project’s root directory. - Copy the contents from the .env.template file into your new
.envfile. - Fill in the required API keys and endpoint information in your
.envfile.
- Hozzon létre egy
-
Run Translation:
- Navigate to your project’s root directory in your terminal.
- Execute the translate command, specifying target languages with the
-lkapcsolót:
translate -l "ko ja fr"(Cserélje ki a
"ko ja fr"with your desired space-separated language codes)
Detailed Usage Guides
Choose the approach that best fits your workflow:
1. Using the Command Line (CLI)
- Best for: One-time translations, manual control, or integration into custom scripts.
- Requires: Local installation of Python and the
co-op-translatorpackage. - Guide: Command Line Guide
2. Using GitHub Actions (Automation)
- Best for: Automatically translating content whenever changes are pushed to your repository. Keeps translations consistently up-to-date.
- Requires: Setting up a workflow file (
.github/workflows) a repository-jában. Helyi telepítés nem szükséges. - Útmutatók:
- GitHub Actions útmutató (Nyilvános repók és standard titkok) – Használja ezt a legtöbb nyilvános vagy személyes repóhoz, amelyek standard repository titkokat használnak.
- GitHub Actions útmutató (Microsoft szervezeti repók és szervezeti szintű beállítások) – Ezt az útmutatót használja, ha a Microsoft GitHub szervezeten belül dolgozik, vagy szervezeti szintű titkokat vagy futtatókat szeretne használni.
Hibakeresés és tippek
További források
- Parancsreferencia: Részletes útmutató az összes elérhető parancshoz és opcióhoz.
- Támogatott nyelvek: A támogatott nyelvek listája és új nyelvek hozzáadásának útmutatója.
- Markdown-only mód: Hogyan fordítsunk csak szöveget, képfeldolgozás nélkül.
Videó bemutatók
Ismerje meg jobban a Co-op Translator-t bemutatóinkon keresztül (Kattintson a lenti képre a YouTube megtekintéséhez.):
- Open at Microsoft: Egy rövid, 18 perces bevezető és gyors útmutató a Co-op Translator használatához.
Támogass minket és elősegítsd a globális tanulást
Csatlakozz hozzánk az oktatási tartalmak globális megosztásának forradalmasításában! Adj egy ⭐-t a Co-op Translator projektnek a GitHubon, és támogasd küldetésünket, hogy lebontsuk a nyelvi akadályokat a tanulás és a technológia terén. Az érdeklődésed és hozzájárulásod jelentős hatással van! Kódhozzájárulásokat és funkciójavaslatokat mindig szívesen fogadunk.
Hozzájárulás
Ez a projekt szívesen fogad hozzájárulásokat és javaslatokat. Érdekel a hozzájárulás az Azure Co-op Translatorhoz? Kérjük, nézd meg a CONTRIBUTING.md fájlt, ahol útmutatást találsz arról, hogyan segíthetsz abban, hogy a Co-op Translator még hozzáférhetőbb legyen.
Közreműködők
Magatartási kódex
Ez a projekt elfogadta a Microsoft Open Source Code of Conduct irányelveit. További információkért lásd a Code of Conduct FAQ oldalt, vagy keresd a opencode@microsoft.com címet, ha további kérdéseid vagy észrevételeid vannak.
Felelős mesterséges intelligencia
A Microsoft elkötelezett amellett, hogy ügyfeleink felelősségteljesen használják AI termékeinket, megosszuk tapasztalatainkat, és bizalmon alapuló partnerségeket építsünk olyan eszközök segítségével, mint a Transparency Notes és Impact Assessments. Ezeknek az erőforrásoknak nagy része megtalálható a https://aka.ms/RAI címen. A Microsoft felelős AI megközelítése az AI alapelveinken nyugszik: méltányosság, megbízhatóság és biztonság, adatvédelem és biztonság, befogadás, átláthatóság és elszámoltathatóság.
A nagy léptékű természetes nyelvi, képi és beszédfeldolgozó modellek – mint amilyenek ebben a példában is szerepelnek – potenciálisan méltánytalanul, megbízhatatlanul vagy sértően viselkedhetnek, ami károkat okozhat. Kérjük, tájékozódj az Azure OpenAI szolgáltatás Transparency note dokumentációból a kockázatokról és korlátokról.
A kockázatok mérséklésére ajánlott megoldás egy olyan biztonsági rendszer beépítése az architektúrába, amely képes felismerni és megakadályozni a káros viselkedést. Az Azure AI Content Safety független védelmi réteget kínál, amely képes felismerni a felhasználók és az AI által generált káros tartalmakat alkalmazásokban és szolgáltatásokban. Az Azure AI Content Safety szöveges és képi API-kat tartalmaz, amelyekkel észlelhető a káros anyag. Emellett rendelkezünk egy interaktív Content Safety Studioval, amely lehetővé teszi, hogy megtekintsd, felfedezd és kipróbáld a mintakódokat a különböző modalitásokban előforduló káros tartalmak felismerésére. A következő gyors kezdési dokumentáció végigvezet a szolgáltatás kérésének elkészítésén.
Fontos szempont az alkalmazás általános teljesítménye is. Többmodalitású és többmodellű alkalmazások esetén a teljesítmény azt jelenti, hogy a rendszer úgy működik, ahogy te és a felhasználóid elvárják, beleértve azt is, hogy nem generál káros kimeneteket. Fontos értékelni az alkalmazás teljesítményét a generálási minőség és kockázat- és biztonsági mutatók segítségével.
Az AI alkalmazásodat fejlesztői környezetben a prompt flow SDK használatával értékelheted. Egy tesztadatkészlet vagy cél alapján a generatív AI alkalmazásod kimenetei mennyiségileg mérhetők beépített vagy saját értékelőkkel. Ha szeretnéd elkezdeni a prompt flow SDK-val a rendszer értékelését, kövesd a gyors kezdési útmutatót. Az értékelési futás lefuttatása után az eredményeket az Azure AI Studioban vizualizálhatod.
Védjegyek
Ez a projekt tartalmazhat védjegyeket vagy logókat projektek, termékek vagy szolgáltatások számára. A Microsoft védjegyek vagy logók engedélyezett használata a Microsoft Trademark & Brand Guidelines irányelveinek megfelelően történhet. A Microsoft védjegyek vagy logók módosított verziókban történő használata nem okozhat félreértést, és nem sugallhat Microsoft szponzorálást. Harmadik fél védjegyeinek vagy logóinak használata a harmadik fél szabályzatai szerint történik.
Felelősségkizárás:
Ezt a dokumentumot az AI fordító szolgáltatás, a Co-op Translator segítségével fordítottuk le. Bár a pontosságra törekszünk, kérjük, vegye figyelembe, hogy az automatikus fordítások hibákat vagy pontatlanságokat tartalmazhatnak. Az eredeti dokumentum az anyanyelvén tekintendő hivatalos forrásnak. Fontos információk esetén professzionális emberi fordítást javaslunk. Nem vállalunk felelősséget az ezen fordítás használatából eredő félreértésekért vagy félreértelmezésekért.