Contoh tugas 1

Tugas

Berikan kontribusi 20 terjemahan bahasa Indonesia baru ke berkas https://github.com/phpmyadmin/localized_docs/blob/master/po/id.po .

Tugas ini dinilai dengan meninjau commit dengan nama pengguna GitHub Anda ke berkas tersebut, dan menghitung banyaknya terjemahan baru yang ditambahkan.

Catatan: commit tersebut saat ini tidak memenuhi kriteria Besut Kode untuk tugas registrasi, karena proyek localized_docs belum memiliki 50 bintang (hanya 10 bintang terhitung 29 September).

Latar belakang

Read The Docs (RTD) adalah layanan yang umum digunakan untuk hosting dokumentasi.

Layanan RTD gratis untuk perangkat lunak terbuka, dan juga memiliki layanan komersial.

Layanan RTD mendukung beberapa bahasa.

Contoh terjemahan yang disediakan dalam dokumentasi mereka adalah phpMyAdmin.

Mengklik pada “v: latest” di bagian bawah phpMyAdmin menunjukkan dokumentasi phpMyAdmin telah diterjemahkan ke bahasa-bahasa berikut:

  • en : Inggris
  • zh_CN: Cina (disederhanakan)
  • cs: Ceko
  • fr: Perancis
  • de: Jerman
  • el: Yunani
  • hu: Hongaria
  • ja: Jepang
  • pt_BR: Portugis (Brasil)
  • es: Spanyol
  • tr: Turki

Dokumentasi phpMyAdmin dalam bahasa Inggris ada di repositori GitHub phpmyadmin/phpmyadmin dalam subdirektori /doc, dan terjemahannya disimpan di repositori GitHub phpmyadmin/localized_docs.

Terjemahan tersebut disimpan dalam berkas .po gettext dalam subdirektori /po.

Tersedia terjemahan dalam bahasa Indonesia dalam berkas /po/id.po, namun sebagian besarnya belum diterjemahkan, jadi phpMyAdmin tidak menyertakan bahasa Indonesia pada situs Read The Docs mereka.

Berkas id.po ini dapat disunting menggunakan editor teks biasa, atau dengan aplikasi khusus. Ada beberapa aplikasi lintas-platform yang disebutkan dalam artikel Wikipedia bahasa Inggris mengenai gettext. Sintaks yang digunakan di seluruh format berkas .po sangatlah ketat dan langka. Tugas ini mengharuskan Anda memperoleh pemahaman dasar dari format berkas .po.

Ada juga library khusus untuk memanipulasi berkas .po, tersedia untuk sebagian besar bahasa pemrograman populer, yang bisa digunakan untuk melakukan penerjemahan secara pemrograman.

Terdapat juga layanan-layanan GitHub untuk penerjemahan berkas .po, yang menyediakan aplikasi web untuk menambah dan memperbarui terjemahan.

Proyek localized_docs phpMyAdmin terhubung dengan layanan Weblate, di mana halaman terjemahan bahasa Indonesia menunjukkan bahwa dokumentasinya telah 0.6% diterjemahkan.

Jika Anda log in ke Weblate menggunakan akun GitHub Anda, ketika Anda menyumbangkan terjemahan di Weblate maka perubahan Anda akan di-lazy-commit-kan ke repositori GitHub, misalnya ketika orang lain melakukan penerjemahan, dan muncul di profil GitHub Anda.

Proyek phpMyAdmin lebih menyukai terjemahan yang disediakan menggunakan Weblate, karena mengurangi beban kerja untuk para committers karena Weblate otomatis melakukan commit untuk setiap perubahan. Kecuali ada alasan yang sangat baik untuk memberikan kontribusi langsung ke repositori, jangan ajukan Pull Request untuk menyelesaikan tugas ini. Contoh alasan untuk menggunakan Pull Request adalah menerjemahkan kelompok pesan yang sangat besar secara pemrograman menggunakan salah satu library gettext. Meskipun dengan alasan yang baik, tidak dianjurkan untuk melakukan ini ketika ada banyak kontributor pada berkas yang sama, seperti tugas kelompok semacam Besut Kode, karena konflik penggabungan mungkin terjadi.

Tag StackOverflow terkait: