Skip to content

Latest commit

 

History

History
250 lines (178 loc) · 16.7 KB

File metadata and controls

250 lines (178 loc) · 16.7 KB

Co-op Translator

Lengvai automatizuokite ir palaikykite vertimus savo edukaciniam GitHub turiniui keliomis kalbomis, kai jūsų projektas vystosi.

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

🌐 Daugiakalbė palaikymas

Palaikoma su 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

Norite klonuoti vietoje?

Šiame saugykloje yra daugiau nei 50 kalbų vertimų, kurie žymiai padidina atsisiuntimo dydį. Norėdami klonuoti be vertimų, naudokite ribotą 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"

Tai suteikia jums viską, ko reikia kursui užbaigti, daug greičiau atsisiunčiant.

GitHub watchers GitHub forks GitHub stars

Microsoft Foundry Discord

Open in GitHub Codespaces

Apžvalga

Co-op Translator padeda lengvai lokalizuoti jūsų edukacinį GitHub turinį keliomis kalbomis.
Kai atnaujinate savo Markdown failus, paveikslėlius ar užrašų knygeles, vertimai automatiškai sinchronizuojami, užtikrinantys, kad jūsų turinys išliktų tikslus ir atnaujintas mokiniams visame pasaulyje.

Pavyzdys, kaip organizuojamas išverstas turinys:

Example

Kaip valdomas vertimo būsenos valdymas

Co-op Translator valdo išverstą turinį kaip versijuotus programinės įrangos artefaktus,
o ne kaip statinius failus.

Įrankis seka išverstų Markdown, paveikslėlių ir užrašų būseną
naudodamas kalbai pritaikytą metaduomenų sistemą.

Šis dizainas leidžia Co-op Translator:

  • Patikimai aptikti pasenusius vertimus
  • Nuosekliai elgtis su Markdown, paveikslėliais ir užrašų knygelėmis
  • Saugaus mastelio palaikymą didelėse, sparčiai besivystančiose daugakalbėse saugyklose

Modeliuodama vertimus kaip valdomus artefaktus,
vertimų darbo eiga natūraliai dera su šiuolaikinėmis
programinės įrangos priklausomybių ir artefaktų valdymo praktikomis.

Kaip valdomas vertimo būsenos valdymas

Greitas pradžios vadovas

# Sukurkite ir suaktyvinkite virtualią aplinką (rekomenduojama)
python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS/Linux
source .venv/bin/activate
# Įdiekite paketą
pip install co-op-translator
# Išverskite
translate -l "ko ja fr" -md

Docker:

# Pasiimkite viešą atvaizdą iš GHCR
docker pull ghcr.io/azure/co-op-translator:latest
# Vykdykite su pritvirtinta esama aplanko vieta ir pateiktu .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

Minimalus nustatymas

  1. Įsitikinkite, kad turite palaikomą Python versiją (šiuo metu 3.10-3.12). Poetry (pyproject.toml) tai valdo automatiškai.
  2. Sukurkite .env failą naudodami šabloną: .env.template
  3. Konfigūruokite vieną LLM teikėją (Azure OpenAI arba OpenAI)
  4. (Pasirinktinai) Vaizdų vertimui (-img) konfigūruokite Azure AI Vision
  5. (Pasirinktinai) Galite sukonfigūruoti kelis kredencialų rinkinius, dubliuodami kintamuosius su priesagomis, tokiomis kaip _1, _2 ir pan. Visi kintamieji rinkinyje turi turėti tą pačią priesagą.
  6. (Rekomenduojama) Išvalykite ankstesnius vertimus, kad išvengtumėte konfliktų (pavyzdžiui, translations/)
  7. (Rekomenduojama) Pridėkite vertimų skyrių į savo README naudodami README kalbų šabloną
  8. Žiūrėkite: Azure AI nustatymas

Naudojimas

Versti visų palaikomų tipų turinį:

translate -l "ko ja"

Tik Markdown:

translate -l "de" -md

Markdown + paveikslėliai:

translate -l "pt" -md -img

Tik užrašų knygelės:

translate -l "zh" -nb

Daugiau parinkčių: Komandų nuoroda

Funkcijos

  • Automatizuotas vertimas Markdown, užrašų knygelių ir paveikslėlių turiniui
  • Išlaiko vertimus sinchronizuotus su šaltinio pakeitimais
  • Veikia vietoje (CLI) arba CI (GitHub Actions)
  • Naudoja Azure OpenAI arba OpenAI; pasirinktinai Azure AI Vision paveikslėliams
  • Išlaiko Markdown formatavimą ir struktūrą

Dokumentacija

Microsoft specifinis vadovas

Note

Tik Microsoft „Pradedantiesiems“ saugyklų prižiūrėtojams.

Palaikykite mus ir skatinkite pasaulinį mokymąsi

Prisijunkite prie mūsų revoliucijoje, kaip edukacinis turinys dalijamasi visame pasaulyje! Duokite Co-op Translator ⭐ GitHub ir palaikykite mūsų misiją pašalinti kalbinius barjerus mokymesi ir technologijose. Jūsų susidomėjimas ir indėlis daro didelį poveikį! Kodo indėliai ir funkcijų pasiūlymai visada laukiami.

Ištirkite Microsoft edukacinį turinį savo kalba

Vaizdo pristatymai

👉 Spustelėkite žemiau esantį paveikslėlį, norėdami žiūrėti YouTube.

  • Open at Microsoft: Trumpa 18 minučių įžanga ir greitas gidų, kaip naudoti Co-op Translator.

    Open at Microsoft

Prisidėjimas

Šis projektas laukia jūsų indėlių ir pasiūlymų. Norite prisidėti prie Azure Co-op Translator? Prašome peržiūrėti mūsų CONTRIBUTING.md, kad sužinotumėte, kaip galite padėti padaryti Co-op Translator prieinamesnį.

Dalyviai

co-op-translator contributors

Elgesio kodeksas

Šis projektas priėmė Microsoft atvirojo kodo elgesio kodeksą. Daugiau informacijos rasite Elgesio kodekso DUK arba kreipkitės el. paštu [email protected] su bet kokiais papildomais klausimais ar pastabomis.

Atsakingas Dirbtinis Intelektas

Microsoft įsipareigoja padėti mūsų klientams atsakingai naudoti mūsų DI produktus, dalintis savo patirtimi ir kurti pasitikėjimu grįstas partnerystes, naudodama tokias priemones kaip Skaidrumo pastabos ir Poveikio vertinimai. Daugelį šių išteklių rasite adresu https://aka.ms/RAI. Microsoft atsakingo DI požiūris grindžiamas mūsų DI principais: teisingumu, patikimumu ir saugumu, privatumu ir apsauga, įtrauktimi, skaidrumu ir atsakingumu.

Didelio masto natūralios kalbos, vaizdų ir kalbos modeliai - pavyzdžiui, naudojami šiame pavyzdyje - gali pasireikšti neteisingu, nepatikimu ar įžeidžiančiu elgesiu, sukeldami žalą. Prašome susipažinti su Azure OpenAI paslaugos Skaidrumo pastaba, kad sužinotumėte apie rizikas ir apribojimus.

Rekomenduojamas būdas mažinti šias rizikas – įtraukti į savo architektūrą saugos sistemą, galinčią aptikti ir užkirsti kelią žalingam elgesiui. Azure AI Content Safety suteikia nepriklausomą apsaugos sluoksnį, gebantį aptikti žalingą vartotojų ir DI generuojamą turinį programėlėse ir paslaugose. Azure AI Content Safety apima teksto ir vaizdų API, leidžiančias aptikti žalingą medžiagą. Taip pat turime interaktyvų Content Safety Studio, leidžiantį peržiūrėti, tyrinėti ir išbandyti pavyzdinį kodą, skirtą žalingo turinio aptikimui skirtingose modalinėse srityse. Ši greitojo starto dokumentacija padės jums pateikti užklausas paslaugai.

Kitas svarbus aspektas yra bendras programėlės našumas. Multi-modaliose ir daugmodelių programėlėse, našumas reiškia, kad sistema veikia taip, kaip tikitės jūs ir jūsų naudotojai, įskaitant nekurti žalingų rezultatų. Svarbu įvertinti bendrą jūsų programėlės našumą naudodami generavimo kokybės bei rizikos ir saugumo metrikas.

Galite įvertinti savo DI programėlę savo kūrimo aplinkoje naudodami prompt flow SDK. Turėdami testinį duomenų rinkinį arba tikslą, jūsų generatyvių DI programėlės generacijų kokybė kiekybiškai vertinama su įmontuotais vertintojais arba pasirinktiniais vertintojais. Norėdami pradėti naudoti prompt flow sdk savo sistemos vertinimui, galite sekti greitojo starto vadovą. Vykdę vertinimo procesą, galite vizualizuoti rezultatus Azure AI Studio.

Prekės ženklai

Šis projektas gali turėti projektų, produktų ar paslaugų prekių ženklus arba logotipus. Leidžiamas Microsoft prekių ženklų arba logotipų naudojimas yra reglamentuojamas ir privalo atitikti Microsoft prekių ženklų ir prekės ženklų naudojimo taisykles. Naudojant Microsoft prekių ženklus ar logotipus modifikuotose šio projekto versijose neturi kilti painiavos ar reikšti Microsoft rėmimą. Bet koks trečiųjų šalių prekių ženklų ar logotipų naudojimas yra reglamentuojamas atitinkamų trečiųjų šalių politikos.

Pagalba

Jei įstrigote arba turite klausimų apie DI programėlių kūrimą, prisijunkite prie:

Microsoft Foundry Discord

Jei turite produktų atsiliepimų arba statymo klaidų, apsilankykite:

Microsoft Foundry Developer Forum


Atsakomybės apribojimas:
Šis dokumentas buvo išverstas naudojant dirbtinio intelekto vertimo paslaugą Co-op Translator. Nors stengiamės užtikrinti tikslumą, prašome atkreipti dėmesį, kad automatizuoti vertimai gali turėti klaidų ar netikslumų. Originalus dokumentas jo gimtąja kalba turėtų būti laikomas autoritetingu šaltiniu. Kritinei informacijai rekomenduojamas profesionalus žmogiškas vertimas. Mes neatsakome už jokius nesusipratimus ar klaidų interpretacijas, kylančias naudojant šį vertimą.