Dokumentasi resmi Angular yang diterjemahkan dengan AI
(angular-kr-docs.web.app)Halo! Baru-baru ini saya bergabung dengan proyek Angular dan mengalami kesulitan karena kurangnya materi berbahasa Korea.
Karena itu, saya memanfaatkan proyek terjemahan AI open source untuk menerjemahkan dokumentasi resmi Angular ke dalam bahasa Korea dan bahkan mendistribusikannya hanya dalam 5 jam.
Saat ini, sebagian besar masih berada pada tahap terjemahan awal oleh AI!
Status progres terjemahan
- Sekitar 300 file md telah selesai diterjemahkan
- Sedang menerjemahkan tambahan file yang tidak diterjemahkan otomatis, seperti file HTML
- Dapat memahami konsep inti dalam bahasa Korea bersama contoh kode
- Struktur tetap sama dengan naskah asli bahasa Inggris sehingga mudah menemukan isi yang dibutuhkan
Sebenarnya saya sempat bimbang apakah akan memakai kategori Show GN untuk memperkenalkan dokumentasi Angular yang diterjemahkan, atau kategori News untuk memperkenalkan alat terjemahannya.
Mungkin tidak banyak orang yang menggunakan Angular, tetapi saya memilih Show GN karena berpikir ini bisa membantu siapa pun yang sedang mencari materi berbahasa Korea!
Alat yang digunakan
Saya menemukan proyek kecil bernama "ai-markdown-translator", dan hasilnya ternyata jauh lebih bagus dari yang saya perkirakan.
Saya cukup menyukainya, jadi saya sedang mem-fork repositorinya dan mencoba memodifikasi kodenya agar bisa berkontribusi ke proyek tersebut.
Kelebihan
- Proyek open source yang dioptimalkan untuk menerjemahkan dokumen Markdown
- Dapat menerjemahkan file dengan ekstensi tertentu di dalam folder secara rekursif
- Menerjemahkan sekaligus dengan perintah
npx ai-markdown-translator -i . -e md -l "Korean" --log - Sebagian besar mempertahankan struktur sintaks dan format Markdown saat menerjemahkan
- Cocok untuk dokumentasi teknis yang membuat halaman berdasarkan konten MD
Keterbatasan
- Terjemahan harfiah istilah teknis masih kurang memuaskan, misalnya Signal diterjemahkan menjadi 'sinyal'
- Ditemukan masalah di mana jalur referensi beberapa file berubah secara keliru
- Masih ada bagian yang perlu diperbaiki karena levelnya baru terjemahan awal
Proses terjemahan dan deployment
- Clone repositori dokumentasi resmi Angular
- Menjalankan perintah, lalu sekitar 2 jam kemudian terjemahan untuk sekitar 300 file selesai
- Memperbaiki jalur referensi file yang salah
- Melakukan deployment dengan mengacu pada konfigurasi Firebase dari proyek Angular yang sudah ada
Masih banyak bagian yang perlu dirapikan, jadi akan saya tinjau dan perbaiki secara bertahap, tetapi dibandingkan dengan waktu yang diinvestasikan, hasilnya terasa cukup bagus.
Bagi yang ingin menerjemahkan dokumentasi teknis yang ditulis dalam format MD, saya merekomendasikan untuk mencobanya!!
Terima kasih sudah membaca tulisan panjang ini! Semoga harimu menyenangkan!! ❤️🔥
4 komentar
Wow! Angular!
...! Apakah Anda menggunakan Angular?
Akhir-akhir ini sepertinya hampir tidak ada pengguna di Korea, jadi saya senang sekali Anda meninggalkan komentar! wkwkwk
Saya tidak bisa menggunakan React dan hanya sedikit bisa menggunakan Angular, tetapi saya senang melihat tulisan tentang Angular di komunitas Korea.
Saya tadinya hanya memakai React lalu pindah ke Angular, jadi kebalikannya ya wkwk.
Kalau suatu saat ada kesempatan, saya akan menulis lagi tentang Angular,,, hehe