Co-op Translator

April 7, 2026 · View on GitHub

Mudah mengotomatiskan dan memelihara terjemahan untuk konten edukasi GitHub Anda dalam berbagai bahasa seiring perkembangan proyek Anda.

🌐 Dukungan Multi-Bahasa

Didukung oleh Co-op Translator

Lebih suka Clone secara Lokal?

Repository ini menyertakan lebih dari 50 terjemahan bahasa yang secara signifikan meningkatkan ukuran unduhan. Untuk 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 memberikan Anda semua yang Anda butuhkan untuk menyelesaikan kursus dengan unduhan yang jauh lebih cepat.

Co-op Translator membantu Anda melakukan lokalisasi konten edukasi GitHub Anda ke dalam berbagai bahasa dengan mudah.
Saat Anda memperbarui file Markdown, gambar, atau notebook Anda, terjemahan tetap otomatis tersinkronisasi, memastikan konten Anda tetap akurat dan terbaru untuk pelajar di seluruh dunia.

Contoh bagaimana konten terjemahan diorganisasi:

Contoh

Cara mengelola status terjemahan

Co-op Translator mengelola konten terjemahan sebagai arsip perangkat lunak berversi,
bukan sebagai file statis.

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

Desain ini memungkinkan Co-op Translator untuk:

Mendeteksi terjemahan yang sudah usang dengan dapat diandalkan
Menangani Markdown, gambar, dan notebook secara konsisten
Skalabilitas yang aman di repositori multi-bahasa yang besar dan bergerak cepat

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

→ Cara mengelola status terjemahan

Memulai cepat

# Buat dan aktifkan lingkungan virtual (disarankan)
python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS/Linux
source .venv/bin/activate
# Instal paket tersebut
pip install co-op-translator
# Terjemahkan
translate -l "ko ja fr" -md

Docker:

# Tarik gambar publik dari GHCR
docker pull ghcr.io/azure/co-op-translator:latest
# Jalankan dengan folder saat ini dipasang dan .env disediakan (Bash/Zsh)
docker run --rm -it --env-file .env -v "${PWD}:/work" ghcr.io/azure/co-op-translator:latest -l "ko ja fr" -md

Pengaturan minimum

Pastikan Anda memiliki versi Python yang didukung (saat ini 3.10-3.12). Dalam poetry (pyproject.toml) ini ditangani secara otomatis.
Buat file .env menggunakan template: .env.template
Konfigurasi satu penyedia LLM (Azure OpenAI atau OpenAI)
(Opsional) Untuk terjemahan gambar (-img), konfigurasikan Azure AI Vision
(Opsional) Anda dapat mengonfigurasi beberapa set kredensial dengan menggandakan variabel dengan akhiran seperti _1, _2, dll. Semua variabel dalam satu set harus berbagi akhiran yang sama.
(Disarankan) Bersihkan terjemahan lama untuk menghindari konflik (misal: translations/)
(Disarankan) Tambahkan bagian terjemahan ke README Anda menggunakan template bahasa README
Lihat: Mengatur Azure AI

Penggunaan

Terjemahkan semua tipe yang didukung:

translate -l "ko ja"

Hanya Markdown:

translate -l "de" -md

Markdown + gambar:

translate -l "pt" -md -img

Hanya notebook:

translate -l "zh" -nb

Lebih banyak opsi: Referensi perintah

Fitur

Terjemahan otomatis untuk Markdown, notebook, dan gambar
Menjaga terjemahan agar tetap sinkron dengan perubahan sumber
Berfungsi secara lokal (CLI) atau di CI (GitHub Actions)
Menggunakan Azure OpenAI atau OpenAI; opsional Azure AI Vision untuk gambar
Mempertahankan format dan struktur Markdown

Dokumentasi

Panduan khusus Microsoft

Note

Untuk pemelihara repositori “For Beginners” Microsoft saja.

Memperbarui daftar "kursus lain" (hanya untuk repositori MS Beginners)

Dukung kami dan dorong pembelajaran global

Bergabunglah dalam merevolusi cara konten edukasi dibagikan secara global! Berikan ⭐ pada Co-op Translator di GitHub dan dukung misi kami untuk menghilangkan hambatan bahasa dalam pembelajaran dan teknologi. Ketertarikan 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 ini untuk menonton di YouTube.

Open at Microsoft: Perkenalan singkat 18 menit dan panduan cepat cara menggunakan Co-op Translator.

Berkontribusi

Proyek ini menyambut kontribusi dan saran. Berminat berkontribusi ke Azure Co-op Translator? Silakan lihat CONTRIBUTING.md untuk panduan tentang bagaimana Anda dapat membantu membuat Co-op Translator lebih mudah diakses.

Kontributor

Kode Etik

Proyek ini telah mengadopsi Microsoft Open Source Code of Conduct. Untuk informasi lebih lanjut lihat Code of Conduct FAQ atau hubungi opencode@microsoft.com untuk pertanyaan atau komentar tambahan.

AI Bertanggung Jawab

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

Model bahasa alami, gambar, dan suara berskala besar - seperti yang digunakan dalam contoh ini - berpotensi berperilaku dengan cara yang tidak adil, tidak dapat diandalkan, atau menyinggung, yang dapat menyebabkan kerugian. Silakan lihat Azure OpenAI service Transparency note untuk mendapatkan informasi tentang risiko dan keterbatasan.

Pendekatan yang direkomendasikan untuk mengurangi risiko ini adalah dengan memasukkan sistem keamanan dalam arsitektur Anda yang dapat mendeteksi dan mencegah perilaku merugikan. Azure AI Content Safety menyediakan lapisan perlindungan independen, mampu mendeteksi konten berbahaya yang dibuat pengguna dan AI 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, menjelajah, dan mencoba contoh kode untuk mendeteksi konten berbahaya di berbagai modalitas. Dokumentasi quickstart berikut memandu Anda dalam membuat permintaan ke layanan ini.

Aspek lain yang perlu dipertimbangkan adalah kinerja keseluruhan aplikasi. Dengan aplikasi multimodal dan multimodel, kami menganggap kinerja berarti sistem berfungsi seperti yang Anda dan pengguna harapkan, termasuk tidak menghasilkan output berbahaya. Penting untuk menilai kinerja aplikasi Anda secara keseluruhan menggunakan generation quality and risk and safety metrics.

Anda dapat mengevaluasi aplikasi AI Anda di lingkungan pengembangan Anda menggunakan prompt flow SDK. Dengan dataset uji atau target, generasi AI generatif Anda diukur secara kuantitatif menggunakan evaluator bawaan atau evaluator kustom pilihan Anda. Untuk memulai dengan prompt flow sdk guna mengevaluasi sistem Anda, Anda dapat mengikuti panduan quickstart. Setelah menjalankan evaluasi, Anda dapat melihat 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 yang dimodifikasi dari proyek ini tidak boleh menimbulkan kebingungan atau menyiratkan dukungan Microsoft. Penggunaan merek dagang atau logo pihak ketiga tunduk pada kebijakan pihak ketiga tersebut.

Mendapatkan Bantuan

Jika Anda mengalami kebingungan atau memiliki pertanyaan tentang membuat aplikasi AI, bergabunglah dengan:

Jika Anda memiliki umpan balik produk atau mengalami kesalahan saat membangun, kunjungi:

Penafian:
Dokumen ini telah diterjemahkan menggunakan layanan terjemahan AI Co-op Translator. Meskipun kami berusaha untuk akurasi, harap diingat bahwa terjemahan otomatis mungkin mengandung kesalahan atau ketidakakuratan. Dokumen asli dalam bahasa aslinya harus dianggap sebagai sumber yang sah. Untuk informasi yang penting, disarankan menggunakan terjemahan manusia profesional. Kami tidak bertanggung jawab atas kesalahpahaman atau salah tafsir yang timbul dari penggunaan terjemahan ini.