co-op-translator

Co-op Translator: Otomatiskan Terjemahan Dokumentasi Pendidikan dengan Mudah

Mudah otomatiskan terjemahan dokumentasi Anda ke berbagai bahasa untuk menjangkau audiens global.

Dukungan Bahasa Didukung oleh Co-op Translator

[!NOTE] Ini adalah terjemahan konten repositori ini saat ini. Untuk daftar lengkap bahasa yang didukung oleh Co-op Translator, silakan lihat bagian Language Support.

Ikhtisar: Permudah Terjemahan Konten Pendidikan Anda

Hambatan bahasa sangat menghalangi akses ke sumber daya pendidikan dan pengetahuan teknis yang berharga bagi pelajar dan pengembang di seluruh dunia. Hal ini membatasi partisipasi dan memperlambat laju inovasi dan pembelajaran global.

Co-op Translator lahir dari kebutuhan untuk mengatasi proses terjemahan manual yang tidak efisien untuk seri edukasi berskala besar milik Microsoft (seperti panduan “For Beginners”). Kini, alat ini berkembang menjadi solusi yang mudah digunakan dan kuat yang dirancang untuk menghapus hambatan tersebut bagi semua orang. Dengan menyediakan terjemahan otomatis berkualitas tinggi melalui CLI dan GitHub Actions, Co-op Translator memberdayakan pendidik, pelajar, peneliti, dan pengembang di seluruh dunia untuk berbagi dan mengakses pengetahuan tanpa batasan bahasa.

Lihat bagaimana Co-op Translator mengorganisir konten edukasi yang sudah diterjemahkan:

File Markdown dan teks gambar diterjemahkan secara otomatis dan disusun rapi ke dalam folder berdasarkan bahasa.

Buka akses global ke konten edukasi Anda dengan Co-op Translator hari ini!

Mendukung Akses Global untuk Sumber Belajar Microsoft

Co-op Translator membantu menjembatani kesenjangan bahasa untuk inisiatif edukasi utama Microsoft, mengotomatisasi proses terjemahan untuk repositori yang melayani komunitas pengembang global. Contoh yang saat ini menggunakan Co-op Translator meliputi:

Fitur Utama

• Terjemahan Otomatis: Terjemahkan teks ke berbagai bahasa dengan mudah.
• Integrasi GitHub Actions: Otomatiskan terjemahan sebagai bagian dari pipeline CI/CD Anda.
• Pemeliharaan Markdown: Jaga sintaks Markdown tetap benar selama proses terjemahan.
• Terjemahan Teks Gambar: Ekstrak dan terjemahkan teks dalam gambar.
• Teknologi LLM Canggih: Gunakan model bahasa terkini untuk terjemahan berkualitas tinggi.
• Integrasi Mudah: Terhubung mulus dengan pengaturan proyek Anda yang sudah ada.
• Permudah Lokalisasi: Sederhanakan proses melokalkan proyek Anda untuk pasar internasional.

Cara Kerja

Co-op Translator mengambil file Markdown dan gambar dari folder proyek Anda dan memprosesnya sebagai berikut:

1. Ekstraksi Teks: Mengambil teks dari file Markdown dan, jika dikonfigurasi (misalnya dengan Azure AI Vision), teks yang ada di dalam gambar.
2. Terjemahan AI: Mengirim teks yang diekstrak ke LLM yang dikonfigurasi (Azure OpenAI, OpenAI, dll.) untuk diterjemahkan.
3. Menyimpan Hasil: Menyimpan file Markdown dan gambar yang sudah diterjemahkan ke dalam folder berdasarkan bahasa, sambil mempertahankan format asli.

Memulai

Mulai dengan cepat menggunakan CLI atau atur otomatisasi penuh dengan GitHub Actions. Pilih cara yang paling sesuai dengan alur kerja Anda:

1. Command Line (CLI) - Untuk terjemahan sekali jalan atau kontrol manual
2. GitHub Actions - Untuk terjemahan otomatis setiap kali ada push

[!NOTE] Meskipun tutorial ini fokus pada sumber daya Azure, Anda dapat menggunakan model bahasa apa pun yang didukung.

Dukungan Bahasa

Co-op Translator mendukung berbagai bahasa untuk membantu Anda menjangkau audiens global. Berikut yang perlu Anda ketahui:

Referensi Cepat

Bahasa	Kode	Bahasa	Kode	Bahasa	Kode
Arab	ar	Bengali	bn	Bulgaria	bg
Burma (Myanmar)	my	Cina (Sederhana)	zh	Cina (Tradisional, HK)	hk
Cina (Tradisional, Macau)	mo	Cina (Tradisional, TW)	tw	Kroasia	hr
Ceko	cs	Denmark	da	Belanda	nl
Finlandia	fi	Perancis	fr	Jerman	de
Yunani	el	Ibrani	he	Hindi	hi
Hungaria	hu	Indonesia	id	Italia	it
Jepang	ja	Korea	ko	Melayu	ms
Marathi	mr	Nepali	ne	Norwegia	no
Persia (Farsi)	fa	Polandia	pl	Portugis (Brasil)	br
Portugis (Portugal)	pt	Punjabi (Gurmukhi)	pa	Rumania	ro
Rusia	ru	Serbia (Sirilik)	sr	Slowakia	sk
Slovenia	sl	Spanyol	es	Swahili	sw
Swedia	sv	Tagalog (Filipina)	tl	Thai	th
Turki	tr	Ukraina	uk	Urdu	ur
Vietnam	vi	—	—	—	—

Menggunakan Kode Bahasa

Saat menggunakan Co-op Translator, Anda harus menentukan bahasa menggunakan kode-kode tersebut. Contoh:

# Translate to French, Spanish, and German
translate -l "fr es de"

# Translate to Chinese (Simplified) and Japanese
translate -l "zh ja"

[!NOTE] Untuk informasi teknis mendetail tentang dukungan bahasa, termasuk:

• Spesifikasi font untuk tiap bahasa
• Masalah yang diketahui
• Cara menambahkan bahasa baru

Lihat Dokumentasi Bahasa yang Didukung.

Model dan Layanan yang Didukung

Tipe	Nama
Model Bahasa
AI Vision

[!NOTE] Jika layanan AI vision tidak tersedia, co-op translator akan beralih ke mode Markdown saja.

Pengaturan Awal

Sebelum memulai, Anda perlu menyiapkan sumber daya berikut:

1. Resource Model Bahasa (Wajib):
   • Azure OpenAI (Direkomendasikan) - Menyediakan terjemahan berkualitas tinggi dengan keandalan kelas enterprise
   • OpenAI - Pilihan alternatif jika Anda tidak memiliki akses Azure
   • Untuk info detail tentang model yang didukung, lihat Supported Models and Services
2. Resource AI Vision (Opsional):
   • Azure AI Vision - Memungkinkan terjemahan teks dalam gambar
   • Jika tidak dikonfigurasi, penerjemah otomatis akan menggunakan mode Markdown saja
   • Direkomendasikan untuk proyek dengan gambar yang mengandung teks yang perlu diterjemahkan
3. Langkah Konfigurasi:
   • Ikuti panduan penyiapan Azure AI untuk instruksi lengkap
   • Buat file .env dengan API key dan endpoint Anda (lihat bagian Quick Start)
   • Pastikan Anda memiliki izin dan kuota yang diperlukan untuk layanan yang dipilih

Persiapan Proyek Sebelum Terjemahan

Sebelum memulai proses terjemahan, ikuti langkah-langkah berikut untuk menyiapkan proyek Anda:

1. Siapkan README Anda:
   • Tambahkan tabel terjemahan ke README.md Anda untuk menghubungkan versi terjemahan

   • Contoh format:

     
     ### 🌐 Multi-Language Support
          
     [French](/co-op-translator/translations/fr/) | [Spanish](/co-op-translator/translations/es/) | [German](/co-op-translator/translations/de/) | [Russian](/co-op-translator/translations/ru/) | [Arabic](/co-op-translator/translations/ar/) | [Persian (Farsi)](/co-op-translator/translations/fa/) | [Urdu](/co-op-translator/translations/ur/) | [Chinese (Simplified)](/co-op-translator/translations/zh/) | [Chinese (Traditional, Macau)](/co-op-translator/translations/mo/) | [Chinese (Traditional, Hong Kong)](/co-op-translator/translations/hk/) | [Chinese (Traditional, Taiwan)](/co-op-translator/translations/tw/) | [Japanese](/co-op-translator/translations/ja/) | [Korean](/co-op-translator/translations/ko/) | [Hindi](/co-op-translator/translations/hi/) | [Bengali](/co-op-translator/translations/bn/) | [Marathi](/co-op-translator/translations/mr/) | [Nepali](/co-op-translator/translations/ne/) | [Punjabi (Gurmukhi)](/co-op-translator/translations/pa/) | [Portuguese (Portugal)](/co-op-translator/translations/pt/) | [Portuguese (Brazil)](/co-op-translator/translations/br/) | [Italian](/co-op-translator/translations/it/) | [Polish](/co-op-translator/translations/pl/) | [Turkish](/co-op-translator/translations/tr/) | [Greek](/co-op-translator/translations/el/) | [Thai](/co-op-translator/translations/th/) | [Swedish](/co-op-translator/translations/sv/) | [Danish](/co-op-translator/translations/da/) | [Norwegian](/co-op-translator/translations/no/) | [Finnish](/co-op-translator/translations/fi/) | [Dutch](/co-op-translator/translations/nl/) | [Hebrew](/co-op-translator/translations/he/) | [Vietnamese](/co-op-translator/translations/vi/) | [Indonesian](/co-op-translator/translations/id/) | [Malay](/co-op-translator/translations/ms/) | [Tagalog (Filipino)](/co-op-translator/translations/tl/) | [Swahili](/co-op-translator/translations/sw/) | [Hungarian](/co-op-translator/translations/hu/) | [Czech](/co-op-translator/translations/cs/) | [Slovak](/co-op-translator/translations/sk/) | [Romanian](/co-op-translator/translations/ro/) | [Bulgarian](/co-op-translator/translations/bg/) | [Serbian (Cyrillic)](/co-op-translator/translations/sr/) | [Croatian](/co-op-translator/translations/hr/) | [Slovenian](/co-op-translator/translations/sl/) | [Ukrainian](/co-op-translator/translations/uk/) | [Burmese (Myanmar)](/co-op-translator/translations/my/) 
         
     

2. Bersihkan Terjemahan yang Ada (jika perlu):
   • Hapus folder terjemahan yang sudah ada (misalnya translations/)
   • Hapus file terjemahan lama agar proses dimulai dari awal
   • Ini memastikan tidak ada konflik dengan proses terjemahan baru

Mulai Cepat: Command Line

Untuk memulai dengan cepat menggunakan command line:

1. Buat virtual environment:

    python -m venv .venv
   

2. Aktifkan virtual environment:

   • Di Windows:

    .venv\scripts\activate
   

   • Di Linux/macOS:

    source .venv/bin/activate
   

3. Pasang paket:

    pip install co-op-translator
   

4. Konfigurasi Kredensial:

   • Buat file .env file in your project’s root directory.
   • Copy the contents from the .env.template file into your new .env file.
   • Fill in the required API keys and endpoint information in your .env file.

5. Run Translation:

   • Navigate to your project’s root directory in your terminal.
   • Execute the translate command, specifying target languages with the -l flag:

    translate -l "ko ja fr"
   

   (Ganti "ko ja fr" with your desired space-separated language codes)

Detailed Usage Guides

Choose the approach that best fits your workflow:

1. Using the Command Line (CLI)

• Best for: One-time translations, manual control, or integration into custom scripts.
• Requires: Local installation of Python and the co-op-translator package.
• Guide: Command Line Guide

2. Using GitHub Actions (Automation)

• Best for: Automatically translating content whenever changes are pushed to your repository. Keeps translations consistently up-to-date.
• Requires: Setting up a workflow file (.github/workflows) di repositori Anda. Tidak perlu instalasi lokal.
• Panduan:
  • Panduan GitHub Actions (Repositori Publik & Secrets Standar) - Gunakan ini untuk repositori publik atau pribadi yang mengandalkan secrets standar repositori.
  • Panduan GitHub Actions (Repositori Organisasi Microsoft & Pengaturan Level Organisasi) - Gunakan panduan ini jika Anda bekerja dalam organisasi GitHub Microsoft atau perlu menggunakan secrets atau runner tingkat organisasi.

Pemecahan Masalah dan Tips

• Panduan Pemecahan Masalah

Sumber Tambahan

• Referensi Perintah: Panduan lengkap untuk semua perintah dan opsi yang tersedia.
• Bahasa yang Didukung: Cek daftar bahasa yang didukung dan instruksi menambahkan bahasa baru.
• Mode Markdown Saja: Cara menerjemahkan hanya teks tanpa terjemahan gambar.

Presentasi Video

Pelajari lebih lanjut tentang Co-op Translator lewat presentasi kami (Klik gambar di bawah untuk menonton di YouTube.):

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

Dukung Kami dan Dorong Pembelajaran Global

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

Kontribusi

Proyek ini menerima kontribusi dan saran. Tertarik 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 yang Bertanggung Jawab

Microsoft berkomitmen membantu pelanggan kami menggunakan produk AI secara bertanggung jawab, membagikan pembelajaran kami, dan membangun kemitraan yang 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 yang bertanggung jawab didasarkan pada prinsip AI kami yaitu keadilan, keandalan dan keselamatan, privasi dan keamanan, inklusivitas, transparansi, dan akuntabilitas.

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

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 berbahaya yang dihasilkan pengguna dan AI dalam aplikasi dan layanan. Azure AI Content Safety mencakup API teks dan gambar yang memungkinkan Anda mendeteksi materi berbahaya. Kami juga memiliki Content Safety Studio interaktif yang memungkinkan Anda melihat, menjelajah, dan mencoba kode contoh untuk mendeteksi konten berbahaya di berbagai modalitas. Dokumentasi quickstart berikut memandu Anda dalam membuat permintaan ke layanan ini.

Aspek lain yang perlu diperhatikan adalah kinerja aplikasi secara keseluruhan. Dengan aplikasi multi-modal dan multi-model, kami mengartikan kinerja sebagai sistem yang bekerja sesuai harapan Anda dan pengguna, termasuk tidak menghasilkan keluaran yang berbahaya. Penting untuk menilai kinerja aplikasi Anda secara keseluruhan menggunakan metrik kualitas generasi serta risiko dan keselamatan.

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

Merek Dagang

Proyek ini mungkin mengandung 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 modifikasi proyek ini tidak boleh menimbulkan kebingungan atau menyiratkan sponsor Microsoft. Penggunaan merek dagang atau logo pihak ketiga tunduk pada kebijakan pihak ketiga tersebut.

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 sahih. Untuk informasi yang penting, disarankan menggunakan terjemahan profesional oleh manusia. Kami tidak bertanggung jawab atas kesalahpahaman atau penafsiran yang salah yang timbul dari penggunaan terjemahan ini.

This site is open source. Improve this page.