Terjemahan Sumberdaya Svelte

Saat ini, belum diketahui bagaimana bentuk implementasi penerjemahan sumber daya resmi Svelte akan diimplementasikan, oleh sebab itu nantinya perubahan dalam struktur dan pendekatan repositori ini sangatlah mungkin akan terjadi di kemudian hari.

Rencana Hasil Penerjemahan

Situs resmi berbahasa Indonesia berikut ini akan diluncurkan apabila projek penerjemahan ini selesai:

• id.svelte.dev
• id.sapper.svelte.dev
• id.svelte-native.technology

Rencananya situs versi Indonesia akan dikumpulkan dan di-deploy secara otomatis setelah semua commit ke dalam repositori ini dinyatakan lengkap.

Apa yang Diterjemahkan

• Tutorial Svelte V3 (GitHub)
• Dokumentasi Svelte V3 (GitHub)
• Dokumentasi Sapper (GitHub)
• Contoh (GitHub)
• Blog (GitHub)
• Konten situs svelte.technology (GitHub)
• Konten situs sapper.svelte.technology (GitHub)
• Konten situs svelte-native.technology (GitHub)

Cara Berkontribusi pada Penerjemahan

• Terjemahkanlah bagian dari sumber daya apa saja di atas yang belum diterjemahkan.
• Tingkatkanlah kualitas terjemahan yang sudah ada: perbaikilah kesalahan pengejaan, tanda baca atau semantik, revisilah kalimat yang disusun dengan buruk, hilangkanlah inkonsistensi terjemahan dengan rekomendasi, dll. Cara melakukannya hanya melalui sistem pull request dalam repositori github ini.

Rekomendasi Penerjemahan

• Desain terjemahan harus sesuai dengan desain aslinya.
• Lebih baik untuk membangun kalimat dalam bentuk anonim (tanpa kami dan tanpa Anda), walaupun tidak wajib, agar Dokumentasi jangan menjadi terlalu formal.
• Gunakanlah tanda pisah —— manakala dibutuhkan, dan gunakanlah tanda hubung -— saat dibutuhkan. Contoh: sebagaimana Svelte adalah sebuah framework.
• Di semua contoh kode, komentar dan semua teks yang terkait dengan antarmuka pengguna (user interface/ UI) wajib diterjemahkan, yakni apa yang dilihat pengguna saat menjalankan contoh tersebut.
• Daftar urutan prioritas penerjemahan dari yang utama yang harus disepakati:
  • Glosarium Svelte;
  • gunakanlah persamaan atau analogi dengan terjemahan dokumentasi framework ternama lainnya (Vue, React, Angular);
  • gunakanlah dokumentasi berbahasa Indonesia, laporan atau artikel yang menggunakan kosakata yang baik dan benar;
  • yang terakhir gunakanlah terjemahan hasil temuan pribadi.
• Hindarilah kebarat-baratan selama masih ada padanan kata dalam Bahasa Indonesia.
• Tautan yang menuju ke sumber daya eksternal (MDN, Wikipedia) haruslah diarahkan kepada versi yang sudah diterjemahkan ke dalam Bahasa Indonesia jika ada.
• Terjemahkanlah nama asing dengan nama asli dalam tanda kurung: (Rich Harris).
• Judul artikel referensi yang ditulis dalam bahasa asing haruslah disampaikan dalam bahasa aslinya lalu diikuti dengan terjemahan Bahasa Indonesia dalam tanda kurung.
• Upayakanlah menggunakan bahasa umum yang tidak membedakan gender.
• Judul artikel dan heading ditulis dengan huruf kapital.
• Bahasa asing yang tidak diterjemahkan karena dianggap bahasa umum komputer, ditulis dalam cetak miring misalnya: file, browser.

Untuk menghindari kebingungan, cobalah mengartikan suatu kalimat dan mengulanginya seolah menjelaskan kepada kolega senior. Apabila kalimatnya terdengar janggal, maka kalimat tersebut harus ditulis kembali dengan cara yang berbeda.

Sedikit ruang kebebasan berekspresi dalam penerjemahan tetap diperkenankan, namun jika dan hanya jika terjemahan itu membantu memperjelas makna. Terjemahan sebaiknya jangan terlalu resmi tapi juga jangan terlalu longgar. Carilah terjemahan yang baik dan benar di antara kedua ekstrim tersebut.

Luncurkan Situs Versi Lokal

Skrip npm telah ditambahkan ke dalam repositori, yang memperkenankan Anda dari Github untuk mengambil versi terkini situs yang terkait dalam projek ini, aplikasikanlah semua modifikasi dari repositori terjemahan ini dan jalankanlah salinan situs pada komputer Anda untuk melihat secara langsung hasil terjemahannya.

git clone [email protected]:Svelte-ID/svelte3-translation-id.git terjemahan-svelte
cd terjemahan-svelte

# 1. Instalasi semua paket wajib
npm install

# 2. Unduh versi terkini dari situs yang diinginkan dan aplikasikan terjemahan pada situs itu
npm run update-svelte 
#...atau...
npm run update-sapper 
#...atau...
npm run update-svelte-native 

# 3. Luncurkan situs pada mesin lokal
npm run dev-svelte
#...atau...
npm run dev-sapper
#...atau...
npm run dev-svelte-native

Kini kamu bisa buka situsnya yang running di http://localhost:3000 dan lihatlah semua perubahan yang tampak padanya saat ini.

Ketika mengubah file terjemahan, refresh jendela peramban (browser) dan kamu akan lihat perubahannya.