Skip to content

Latest commit

 

History

History
243 lines (170 loc) · 28.3 KB

File metadata and controls

243 lines (170 loc) · 28.3 KB

Co-op Translator

Easily automate and maintain translations for your educational GitHub content across multiple languages as your project evolves.

Python 3.10–3.12 កញ្ចប់ Python អាជ្ញាប័ណ្ណ: MIT ការទាញយក ការទាញយក កុងតឺន័រ: GHCR រចនាប័ទ្ម​កូដ: black

អ្នករួមចំណែក GitHub បញ្ហា GitHub Pull-Requests GitHub ស្វាគមន៍ PRs

ចាប់ផ្ដើមនៅទីនេះ: Choose your workflow | Configuration | CLI | Python API | ម៉ាស៊ីនបម្រើ MCP

🌐 Multi-Language Support

Supported by 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

Prefer to Clone Locally?

ឃ្លាំងនេះមានការបកប្រែលើស 50 ភាសា ដែលធ្វើឲ្យទំហំទាញយកធំឡើងយ៉ាងទូលំទូលាយ។ ដើម្បី clone ដោយមិនទាញយកឯកសារបកប្រែ សូមប្រើ 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 Forks GitHub ផ្កាយ GitHub

Microsoft Foundry Discord

បើកក្នុង GitHub Codespaces

ទិដ្ឋភាពទូទៅ

Co-op Translator ជួយអ្នកក្នុងការរួមបម្លែងមាតិកាអប់រំលើ GitHub ទៅជាភាសាជាច្រើនបានយ៉ាងងាយស្រួល។ ជាមួយពេលដែលអ្នកធ្វើបច្ចុប្បន្នភាពឯកសារ Markdown, រូបភាព ឬ notebook ការបកប្រែទាំងឡាយនឹងត្រូវសមកាលភាពដោយស្វ័យប្រវត្តិ ដែលធានាថាមាតិការបស់អ្នកនៅតែត្រឹមត្រូវ និងបច្ចុប្បន្នសម្រាប់អ្នកសិក្សាទូទាំងពិភពលោក។

ប្រើវាចេញពី CLI សម្រាប់ការបកប្រែឃ្លាំង, ពី Python API សម្រាប់ស្វ័យករណ៍, ឬតាមរយៈម៉ាស៊ីនបម្រើ MCP សម្រាប់លំហូរអ្នកប្រើប្រាស់-agent និងកែសម្រួល។

Example of how translated content is organized:

ឧទាហរណ៍

ហេតុអ្វី Co-op Translator?

Translating one file is easy. Keeping an entire documentation repository translated, linked, and up to date is the hard part.

បញ្ហា របៀប Co-op Translator ជួយ
Long docs are not one prompt ឯកសារ Markdown វែងៗ ត្រូវបានបំបែកចេញជាផ្នែកតូចៗ ដូច្នេះ README វែងមួយមិនពឹងផ្អែកលើចម្លើយពីម៉ូឌែលតែមួយដែលងាយខូចទុកទេ។ ប្រសិនបើផ្នែកណាមួយបរាជ័យ Co-op Translator អាចព្យាយាមម្តងទៀត ហើយបំបែកឡើងវិញសម្រាប់ផ្នែកដែលបរាជ័យតែកន្លែងនោះ។
Incomplete translations should not be marked current ការបកប្រែដែលត្រូវកាត់ខ្លី មិនគួរត្រូវបានគិតថា​ត្រឹមត្រូវ​បច្ចុប្បន្ន។ Co-op Translator ពិនិត្យភាពទាំងមូលនៃការបកប្រែមុនពេលរក្សាទុក ហើយអាចរកឃើញការបកប្រែដែលខ្វះដោយរចនាសម្ព័ន្ធបាន។
Links should match the translated repo structure ការបកប្រែដោយដៃជាញិញជាមានន័យថា link ដែលជាអ نسب(Relative) គួរត្រូវតែបង្ហាញត្រឡប់ទៅដើមឈើដើម។ Co-op Translator សរសេរឡើងវិញ Markdown, notebook, រូបភាព និង README links ដើម្បីផ្គូរផ្គងទៅនឹងរចនាសម្ព័ន្ធ translations/<lang>/...
Translation should work across an entire repo Co-op Translator គ្រប់គ្រង README files, docs, notebooks និងអត្ថបទក្នុងរូបភាពដោយជាទម្រង់លំហូរបស់ឃ្លាំងមួយទៀងទាត់ មិនមែនបកប្រែកឯកសារមួយៗ។
Maintaining translations matters more than creating them once Hashs ของ source និង metadata នៃការបកប្រែនាំឲ្យ Co-op Translator រកឃើញឯកសារចាស់ៗ, កាត់កើតឯកសារដែលមិនប្រែប្រួល, និងរក្សាការសមកាលភាពនៃការបកប្រែពេលដែលឃ្លាំងដើមមានការផ្លាស់ប្ដូរ។

របៀបគ្រប់គ្រងស្ថានភាពការបកប្រែ

Co-op Translator គ្រប់គ្រងមាតិកាបកប្រែជាប្រភេទ "អាត៊ីហ្វ៉ាក់សូហ្វ្ថវែរ" ដែលមានកំណែ (versioned software artifacts),
មិនមែនជាឯកសារស្ថិតស្ថេរទេ។

ឧបករណ៍នេះតាមដានស្ថានភាពនៃ Markdown, រូបភាព និង notebooks ដែលបានបកប្រែ ដោយប្រើ metadata ដែលពាក់ព័ន្ធតាមភាសា។

ការរចនានេះអនុញ្ញាតឲ Co-op Translator អាច:

  • រកឃើញការបកប្រែចាស់ៗដោយទុកចិត្ត
  • ដំណើរការ Markdown, រូបភាព និង notebooks ឲ្យក្លាយជា​ទៀងទាត់
  • លានសមត្ថភាពឲ្យសមរម្យនៅក្នុងឃ្លាំងធំដែលផ្លាសចលនាដោយលឿន និងមានភាសាច្រើន

ដោយមើលការបកប្រែជា អាត៊ីហ្វ៉ាក់ដែលគ្រប់គ្រង, លំហូរការបកប្រែឆ្គាំឆ្គងជាមួយនឹងអនុប្បទាប современной វិធានការគ្រប់គ្រងអាសយដ្ឋាន និងអាត៊ីហ្វ៉ាក់នៃសូហ្វ ថូវែរ។

How translation state is managed

Related deep dives

ចាប់ផ្ដើម

Co-op Translator អាចប្រើបានពី CLI, Python API, ឬម៉ាស៊ីនបម្រើ MCP។ ចាប់ផ្ដើមជាមួយមគ្គុទេសក៍ workflow ប្រសិនបើអ្នកកំពុងជ្រើសរើសរវាងការបកប្រែក្នុងកុំព្យូទ័រមូលដ្ឋាន, ស្វ័យករ, CI, និងការរួមបញ្ចូលរវាង agent/editor។

Minimal CLI example after configuration:

python -m venv .venv
# វីនដូ
.venv\Scripts\activate
# ម៉ាក់អូអេស/លីនុច
source .venv/bin/activate

pip install co-op-translator
translate -l "ko" -md
co-op-review -l "ko"

For first runs on large repositories, use --dry-run before writing translated files. See the CLI Reference for content type flags, logs, review, and link migration.

Container quick run with Bash/Zsh:

docker run --rm -it --env-file .env -v "${PWD}:/work" ghcr.io/azure/co-op-translator:latest -l "ko" -md

Container quick run with PowerShell:

docker run --rm -it --env-file .env -v ${PWD}:/work ghcr.io/azure/co-op-translator:latest -l "ko" -md

មុខលក្ខណៈ

  • បកប្រែស្វ័យប្រវត្តិសម្រាប់ Markdown, notebooks, និងរូបភាព
  • រក្សាការសមកាលភាពការបកប្រែជាមួយការផ្លាស់ប្តូរក្នុងប្រភព
  • ប្រើបាននៅក្នុងកុំព្យូទ័រមូលដ្ឋាន (CLI) ឬក្នុង CI (GitHub Actions)
  • បង្ហាញឧបករណ៍បកប្រែ Markdown, notebook, រូបភាព, ការត្រួតពិនិត្យ និងគម្រោង តាមរយៈ MCP
  • ប្រើ Azure OpenAI ឬ OpenAI សម្រាប់អ្នកផ្គត់ផ្គង់ (provider)-supported translation
  • អនុញ្ញាតឲ MCP ជាអ្នកផ្តល់ទីតាំងឲ្យ agents បកប្រែកchunks Markdown និង notebook ដោយមិនចាំបាច់មានគណនី LLM របស់ Co-op Translator
  • ប្រើ Azure AI Vision សម្រាប់ដកអត្ថបទពីរូបភាព និងបកប្រែ
  • ត្រួតពិនិត្យរចនាសម្ព័ន្ធនិងភាពទាន់សម័យនៃការបកប្រែជាមួយតេស្តដែលកំណត់ច្បាស់
  • រក្សាទ្រង់ទ្រាយ និងរចនាសម្ព័ន្ធ Markdown

ឯកសារ

Microsoft-specific guide

Note

សម្រាប់អ្នកថែទាំរបស់ឃ្លាំង Microsoft “For Beginners” តែប៉ុណ្ណោះ។

គាំទ្រយើង និងសម្របតាមការសិក្សាថ្មីทั่วលោក

ចូលរួមជាមួយយើងក្នុងការបំលែងរបៀបដែលមាតិកាហត្ថាបណ្តុះបណ្តាលត្រូវចែកចាយជាច្រើនជាសកល! ផ្ដល់⭐ ទៅ Co-op Translator លើ GitHub និងគាំទ្រយុទ្ធសាស្ត្ររបស់យើងក្នុងការបំបែកឧបសគ្គភាសាក្នុងការសិក្សា និងបច្ចេកវិទ្យា។ ការចាប់អារម្មណ៍ និងការរួមចំណែករបស់អ្នកមានអត្ថិភាពយ៉ាងខ្លាំង! ការរួមចំណែកកូដ និងការផ្តល់យោបល់លើមុខងារ សូមស្វាគមន៍អស់។

ស្វែងយល់មាតិកាអប់រំ Microsoft ជាភាសារបស់អ្នក

ការបង្ហាញវីដេអូ

👉 ចុចរូបភាពខាងក្រោមដើម្បីមើលលើ YouTube។

  • Open នៅ Microsoft: ការណែនាំខ្លីប្រមាណ 18 នាទី និងមគ្គុទេសក៍លឿនអំពីវិធីប្រើ Co-op Translator។

    Open នៅ Microsoft

រួមចំណែក

គម្រោងនេះស្វាគមន៍ការរួមចំណែក និងយោបល់។ ចាប់អារម្មណ៍ក្នុងការរួមចំណែកទៅ Azure Co-op Translator ទេ? សូមមើល CONTRIBUTING.md សម្រាប់កាន់តែលម្អិតអំពីរបៀបដែលអ្នកអាចជួយធ្វើឱ្យ Co-op Translator មានភាពងាយចូលប្រើកាន់តែច្រើន។

អ្នករួមចំណែក

អ្នករួមចំណែក co-op-translator

កូដអាកប្បកិរិយា

គម្រោងនេះបានទទួលយក កូដអាកប្បកិរិយាសម្រាប់ប្រភពបើករបស់ Microsoft។ សម្រាប់ព័ត៌មានបន្ថែម សូមមើល សំណួរញឹកញាប់អំពីកូដអាកប្បកិរិយា ឬ ទំនាក់ទំនង opencode@microsoft.com ប្រសិនបើមានសំណួរ ឬ មតិយោបល់បន្ថែម។

AI ធ្វើការ​ខាងទទួលខុសត្រូវ

Microsoft មានក្តីសន្យាផ្តល់ជំនួយដល់អតិថិជនដើម្បីប្រើផលិតផល AI របស់យើងយ៉ាងមានការទទួលខុសត្រូវ, ចែករំលែកบทសិក្សា, និងសាងសង់ភាពជាដៃគូផ្អែកលើទំនុកចិត្ត តាមឧបករណ៍ដូចជា Transparency Notes និង Impact Assessments។ ធនធានជាច្រើនអាចស្វែងរកបាននៅ https://aka.ms/RAI

យុទ្ធសាស្ត្ររបស់ Microsoft ចំពោះ AI ដែលមានការទទួលខុសត្រូវស្ថិតលើគោលការណ៍ AI របស់យើង ដូចជា ភាពយុតិធម៌, ការជឿទុកចិត្ត និងសុវត្ថិភាព, សម្ងាត់និងសន្តិសុខ, ភាពរួមបញ្ចូល, ភាពថ្លា, និងការទទួលខុសត្រូវ។

ម៉ូឌែលធំនៃភាសា, រូបភាព និងសំឡេង — ដូចជាThose used in this sample — អាចមានឥរិយាបថដែលអាចមិនយុតិធម៌, មិនអាចទុកចិត្តបាន, ឬអាចជួបប្រទៈចំពោះអត្ថន័យផ្ទាល់ខ្លួន ដោយបណ្ដាលឲ្យមានគ្រោះថ្នាក់។ សូមយោងទៅកាន់ សេចក្តីសម្គាល់ភាពថ្លាពីសេវា Azure OpenAI ដើម្បីទទួលបានព័ត៌មានអំពីហានិភ័យ និងគួចចំនុចកំណត់។

វិធីសាស្ត្រដែលផ្ដល់អនុសាសន៍ក្នុងការត្រួតពិនិត្យហានិភ័យទាំងនេះ គឺការរួមបញ្ចូលប្រព័ន្ធសុវត្ថិភាពនៅក្នុងស្ថាបត្យកម្មរបស់អ្នក ដែលអាចស្គាល់ និងទប់ស្កាត់ឥរិយាបថមិនល្អបាន។ Azure AI Content Safety ផ្តល់ជានិរន្តរភាពការការពារ ដោយអាចស្គាល់មាតិកាដែលបង្កហានិភ័យដែលបានបង្កើតដោយអ្នកប្រើ និងដោយ AI នៅក្នុងកម្មវិធី និងសេវាកម្ម។ Azure AI Content Safety រួមមាន API សម្រាប់អត្ថបទ និងរូបភាព ដែលអនុញ្ញាតឲ្យអ្នកស្គាល់មាតិកាដែលមានហានិភ័យ។ យើងក៏មាន Content Safety Studio អន្តរកម្ម ដែលអាចឲ្យអ្នកមើល, ស្វែងចែក និងសាកល្បងកូដឧទាហរណ៍សម្រាប់ស្គាល់មាតិកាដែលបង្កហានិភ័យនៅក្នុងរបៀបផ្សេងៗគ្នា។ កុងតឺនដែលមើលឃើញក្នុង quickstart documentation ខាងក្រោម នាំបង្ហាញអ្នកតាមដានវិធីធ្វើសំណើទៅសេវា។

មុខម្ហូបមួយទៀតដែលគួរឲ្យយកចិត្តទុកដាក់ គឺកម្រិតសមត្ថភាពរួមបញ្ចូលនៃកម្មវិធី។ ជាមួយកម្មវិធីដែលមានមុខងារច្រើន-ចំហៀង និងម៉ូឌែលជាច្រើន យើងចាត់ទុកថា សមត្ថភាពបង្ហាញថារូបបែបនេះសមនឹងការរំពឹងទុករបស់អ្នកនិងអ្នកប្រើ រួមទាំងការមិនបង្កើតផលិតផលមានគ្រោះថ្នាក់។ វាសំខាន់ក្នុងការវាយតម្លៃសមត្ថភាពរបស់កម្មវិធីរួមសរុបដោយប្រើ គុណភាពការបង្កើត និង ម៉ែត្រហានិភ័យនិងសុវត្ថិភាព

អ្នកអាចវាយតម្លៃកម្មវិធី AI របស់អ្នកនៅក្នុងបរិយាកាសអភិវឌ្ឍន៍ដោយប្រើ prompt flow SDK។ ប្រសិនបើមានទិន្នន័យសាកល្បង ឬ គោលដៅណាណាមួយ ការបង្កើតរបស់កម្មវិធី generative AI របស់អ្នក នឹងត្រូវបានវាស់វែងជាបរិមាណដោយឧបករណ៍វាស់វែងដែលមានរួចឬឧបករណ៍វាស់វែងឯកជនដែលអ្នកជ្រើស។ ដើម្បីចាប់ផ្តើមប្រើ prompt flow sdk សម្រាប់វាយតម្លៃប្រព័ន្ធរបស់អ្នក អ្នកអាចអាន quickstart guide។ បន្ទាប់ពីអ្នកអនុវត្តការប្រតិបត្តិការវាយតម្លៃ អ្នកអាច បង្ហាញទិន្នផលនៅក្នុង Azure AI Studio

សញ្ញាពាណិជ្ជកម្ម

គម្រោងនេះអាចមានសញ្ញាពាណិជ្ជកម្ម ឬឡូហ្គោសម្រាប់គម្រោង, ផលិតផល, ឬសេវាកម្ម المختلفة។ ការប្រើប្រាស់សញ្ញាពាណិជ្ជកម្ម ឬឡូហ្គោរបស់ Microsoft ត្រូវសម្របខ្លួន និងត្រូវតាម សេចក្ដីណែនាំសញ្ញាពាណិជ្ជកម្ម និងម៉ាករបស់ Microsoft។ ការប្រើប្រាស់សញ្ញា ឬឡូហ្គោរបស់ Microsoft ក្នុងកំណែដែលបានកែប្រែក្នុងគម្រោងនេះ មិនគួរបង្កឲ្យមានច្របូកច្របល់ ឬពន្យល់ថា Microsoft ជាអ្នកឧបត្ថម្ភ។ ការប្រើប្រាស់សញ្ញាពាណិជ្ជកម្ម ឬឡូហ្គោរបស់ភាគីទីបី ត្រូវសម្របទៅតាមគោលការណ៍នៃភាគីទីបីនោះៗ។

ការទទួលជំនួយ

ប្រសិនបើអ្នកជាប់ព្រួយ ឬមានសំណួរអំពីការសាងសង់កម្មវិធី AI សូមចូលរួម៖

Discord របស់ Microsoft Foundry

បើអ្នកមានមតិយោបល់ពីផលិតផល ឬកំហុសពេលកំពុងសាងសង់ សូមទៅកាន់៖

វេទិកាអភិវឌ្ឍន៍ Microsoft Foundry