18 KiB
Co-op Translator
Mudah mengotomatiskan dan memelihara terjemahan untuk konten edukasi GitHub Anda ke berbagai bahasa seiring proyek Anda berkembang.
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.
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:
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.
- Pilih alur kerja Anda
- Konfigurasikan kredensial
- Terjemahkan dari CLI
- Otomatisasi dengan Python API
- Hubungkan dengan Server MCP
- Jalankan di GitHub Actions
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
- Situs dokumentasi
- Pilih alur kerja Anda
- Konfigurasi
- Pengaturan Azure AI
- Referensi CLI
- Python API
- Server MCP
- GitHub Actions
- Template README bahasa
- Bahasa yang didukung
- Kontribusi
- Pemecahan masalah
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
- LangChain4j untuk Pemula
- AZD untuk Pemula
- Edge AI untuk Pemula
- Model Context Protocol (MCP) untuk Pemula
- Agen AI untuk Pemula
- Generative AI untuk Pemula menggunakan .NET
- Generative AI untuk Pemula
- Generative AI untuk Pemula menggunakan Java
- ML untuk Pemula
- Data Science untuk Pemula
- AI untuk Pemula
- Keamanan Siber untuk Pemula
- Pengembangan Web untuk Pemula
- IoT untuk Pemula
- PhiCookBook
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.
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
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:
Jika Anda memiliki masukan produk atau menemukan kesalahan saat membangun, kunjungi:
