Files

18 KiB

Co-op Translator

Mudah mengotomatiskan dan memelihara terjemahan untuk konten edukasi GitHub Anda ke berbagai bahasa seiring proyek Anda berkembang.

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

Mulai di sini: Choose your workflow | Configuration | CLI | Python API | MCP Server

🌐 Dukungan Multi-Bahasa

Didukung oleh 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

Lebih Suka Meng-Cloning Secara Lokal?

Repositori ini mencakup lebih dari 50 terjemahan bahasa yang secara signifikan menambah ukuran unduhan. Untuk meng-clone tanpa terjemahan, gunakan 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"

Ini memberi Anda semua yang diperlukan untuk menyelesaikan kursus dengan unduhan yang jauh lebih cepat.

GitHub watchers GitHub forks GitHub stars

Microsoft Foundry Discord

Open in GitHub Codespaces

Ikhtisar

Co-op Translator membantu Anda melokalkan konten edukasi GitHub Anda ke berbagai bahasa dengan mudah. Saat Anda memperbarui file Markdown, gambar, atau notebook, terjemahan akan tetap tersinkronisasi secara otomatis, memastikan konten Anda tetap akurat dan mutakhir bagi pelajar di seluruh dunia.

Gunakan dari CLI untuk menerjemahkan repositori, dari Python API untuk otomatisasi, atau melalui server MCP untuk alur kerja agen dan editor.

Contoh bagaimana konten terjemahan diatur:

Example

Mengapa Co-op Translator?

Menerjemahkan satu file itu mudah. Menjaga seluruh repositori dokumentasi yang sudah diterjemahkan, terhubung, dan mutakhir adalah bagian yang sulit.

Problem How Co-op Translator helps
Long docs are not one prompt File Markdown besar dibagi menjadi potongan-potongan, sehingga README panjang tidak bergantung pada satu respons model yang rapuh. Jika sebuah potongan gagal, Co-op Translator dapat mencoba lagi dan hanya memproses ulang bagian yang gagal.
Incomplete translations should not be marked current Terjemahan yang terpotong tidak boleh ditandai sebagai mutakhir. Co-op Translator memeriksa integritas terjemahan sebelum menyimpan dan dapat mendeteksi terjemahan yang secara struktural tidak lengkap.
Links should match the translated repo structure Terjemahan manual sering meninggalkan tautan relatif yang mengarah kembali ke pohon sumber. Co-op Translator menulis ulang tautan Markdown, notebook, gambar, dan README agar sesuai dengan struktur translations/<lang>/....
Translation should work across an entire repo Co-op Translator menangani file README, docs, notebook, dan teks gambar sebagai bagian dari satu alur kerja repositori, alih-alih menerjemahkan file satu per satu.
Maintaining translations matters more than creating them once Hash sumber dan metadata terjemahan memungkinkan Co-op Translator menemukan file yang usang, melewati file yang tidak berubah, dan menjaga konten terjemahan tetap sinkron saat repositori sumber berkembang.

Bagaimana status terjemahan dikelola

Co-op Translator mengelola konten terjemahan sebagai artefak perangkat lunak yang diberi versi,
bukan sebagai file statis.

Alat ini melacak status Markdown, gambar, dan notebook yang diterjemahkan menggunakan metadata yang dibatasi per bahasa.

Desain ini memungkinkan Co-op Translator untuk:

  • Mendeteksi terjemahan yang usang dengan andal
  • Memperlakukan Markdown, gambar, dan notebook secara konsisten
  • Berskala dengan aman di seluruh repositori multi-bahasa yang besar dan bergerak cepat

Dengan memodelkan terjemahan sebagai artefak yang dikelola, alur kerja terjemahan selaras secara alami dengan praktik manajemen ketergantungan dan artefak perangkat lunak modern.

→ Bagaimana status terjemahan dikelola

Ulasan mendalam terkait

Memulai

Co-op Translator dapat digunakan dari CLI, Python API, atau server MCP. Mulailah dengan panduan alur kerja jika Anda memilih di antara terjemahan lokal, otomatisasi, CI, dan integrasi agen/editor.

Contoh CLI minimal setelah konfigurasi:

python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS/Linux
source .venv/bin/activate

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

Untuk jalankan pertama pada repositori besar, gunakan --dry-run sebelum menulis file terjemahan. Lihat CLI Reference untuk flag tipe konten, log, peninjauan, dan migrasi tautan.

Jalankan cepat container dengan Bash/Zsh:

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

Jalankan cepat container dengan PowerShell:

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

Fitur

  • Terjemahan otomatis untuk Markdown, notebook, dan gambar
  • Menjaga terjemahan sinkron dengan perubahan sumber
  • Bekerja secara lokal (CLI) atau di CI (GitHub Actions)
  • Mengekspos alat terjemahan untuk Markdown, notebook, gambar, peninjauan, dan proyek melalui MCP
  • Menggunakan Azure OpenAI atau OpenAI untuk penyedia terjemahan
  • Memungkinkan MCP menjadi host agen untuk menerjemahkan potongan Markdown dan notebook tanpa kredensial LLM Co-op Translator
  • Menggunakan Azure AI Vision untuk ekstraksi teks gambar dan terjemahan
  • Meninjau struktur dan kesegaran terjemahan dengan pemeriksaan deterministik
  • Mempertahankan format dan struktur Markdown

Dokumentasi

Panduan khusus Microsoft

Note

Untuk pemelihara repositori Microsoft “For Beginners” saja.

Dukung kami dan dukung pembelajaran global

Bergabunglah bersama kami dalam merevolusi cara konten edukasi dibagikan secara global! Berikan Co-op Translator sebuah ⭐ di GitHub dan dukung misi kami untuk menghapus hambatan bahasa dalam pembelajaran dan teknologi. Minat dan kontribusi Anda memberikan dampak besar! Kontribusi kode dan saran fitur selalu disambut.

Jelajahi konten edukasi Microsoft dalam bahasa Anda

Presentasi video

👉 Klik gambar di bawah untuk menonton di YouTube.

  • Open di Microsoft: Sebuah pengantar singkat 18 menit dan panduan cepat tentang cara menggunakan Co-op Translator.

    Open di Microsoft

Berkontribusi

Proyek ini menerima kontribusi dan saran. Tertarik berkontribusi pada Azure Co-op Translator? Silakan lihat CONTRIBUTING.md untuk pedoman tentang bagaimana Anda dapat membantu membuat Co-op Translator lebih mudah diakses.

Kontributor

kontributor co-op-translator

Kode Perilaku

Proyek ini telah mengadopsi Kode Perilaku Open Source Microsoft. Untuk informasi lebih lanjut lihat FAQ Kode Perilaku atau hubungi opencode@microsoft.com jika ada pertanyaan atau komentar tambahan.

AI yang Bertanggung Jawab

Microsoft berkomitmen untuk membantu pelanggan kami menggunakan produk AI secara bertanggung jawab, berbagi pembelajaran kami, dan membangun kemitraan yang didasarkan pada kepercayaan melalui alat seperti Transparency Notes dan Impact Assessments. Banyak sumber daya ini dapat ditemukan di https://aka.ms/RAI. Pendekatan Microsoft terhadap AI yang bertanggung jawab didasarkan pada prinsip AI kami yaitu keadilan, keandalan dan keselamatan, privasi dan keamanan, inklusivitas, transparansi, dan akuntabilitas.

Model skala besar untuk bahasa alami, gambar, dan ucapan - seperti yang digunakan dalam contoh ini - berpotensi berperilaku dengan cara yang tidak adil, tidak dapat diandalkan, atau menyinggung, yang pada gilirannya dapat menyebabkan dampak buruk. Harap lihat Azure OpenAI service Transparency note untuk mengetahui risiko dan keterbatasan.

Pendekatan yang disarankan untuk mengurangi risiko ini adalah dengan menyertakan sistem keamanan dalam arsitektur Anda yang dapat mendeteksi dan mencegah perilaku berbahaya. Azure AI Content Safety menyediakan lapisan perlindungan independen, mampu mendeteksi konten yang dihasilkan pengguna dan AI yang berbahaya dalam aplikasi dan layanan. Azure AI Content Safety mencakup API teks dan gambar yang memungkinkan Anda mendeteksi materi yang berbahaya. Kami juga memiliki Content Safety Studio interaktif yang memungkinkan Anda melihat, mengeksplorasi, dan mencoba contoh kode untuk mendeteksi konten berbahaya di berbagai modalitas. Dokumentasi quickstart berikut memandu Anda melalui pembuatan permintaan ke layanan tersebut.

Aspek lain yang perlu diperhatikan adalah kinerja keseluruhan aplikasi. Dengan aplikasi multi-modal dan multi-model, kami menganggap kinerja berarti bahwa sistem bekerja sebagaimana Anda dan pengguna Anda harapkan, termasuk tidak menghasilkan output yang berbahaya. Penting untuk menilai kinerja aplikasi keseluruhan Anda menggunakan metrik kualitas generasi serta risiko dan keselamatan.

Anda dapat mengevaluasi aplikasi AI Anda di lingkungan pengembangan menggunakan prompt flow SDK. Dengan dataset uji atau target tertentu, keluaran dari aplikasi generatif AI Anda diukur secara kuantitatif dengan evaluator bawaan atau evaluator kustom pilihan Anda. Untuk memulai dengan prompt flow sdk untuk mengevaluasi sistem Anda, Anda dapat mengikuti panduan quickstart. Setelah Anda menjalankan evaluasi, Anda dapat memvisualisasikan hasilnya di Azure AI Studio.

Merek Dagang

Proyek ini mungkin berisi merek dagang atau logo untuk proyek, produk, atau layanan. Penggunaan merek dagang atau logo Microsoft yang sah tunduk pada dan harus mengikuti Microsoft's Trademark & Brand Guidelines. Penggunaan merek dagang atau logo Microsoft dalam versi proyek yang dimodifikasi tidak boleh menimbulkan kebingungan atau menyiratkan sponsor oleh Microsoft. Setiap penggunaan merek dagang atau logo pihak ketiga tunduk pada kebijakan pihak ketiga tersebut.

Mendapatkan Bantuan

Jika Anda mengalami kebuntuan atau memiliki pertanyaan tentang membangun aplikasi AI, bergabunglah:

Microsoft Foundry Discord

Jika Anda memiliki masukan produk atau menemukan kesalahan saat membangun, kunjungi:

Forum Pengembang Microsoft Foundry