Berikut adalah panduan-panduan dasar dalam penerjemahan situs reactjs.org ke Bahasa Indonesia. Dokumen ini ditujukan bagi mereka yang baru mulai berkontribusi dan yang pernah berkontribusi sebelumnya. Apabila ada kekurangan, silakan berkontribusi dengan menyunting dokumen ini.
Untuk menjalankan situs id.reactjs.org secara lokal, ikuti langkah-langkah berikut:
- Unduh dan instalasi Git, Node.js, dan Yarn.
- Buatlah fork dari repositori id.reactjs.org di akun Anda, kemudian clone repositori tersebut.
- Jalankan
yarn
di terminal untuk menginstalasi dependensi yang dibutuhkan. - Jalankan
yarn dev
untuk menjalankan server lokal. - Buka alamat
localhost:8000
dalam peramban web Anda.
Konten dari situs id.reactjs.org terdapat dalam folder content
, dan disimpan dalam format Markdown. Buka proyek id.reactjs.org dalam program penyunting teks Anda, dan mulailah menyunting. Konten dalam situs lokal akan diperbarui secara otomatis.
Proses penerjemahan akan dicatat dalam issue reactjs#1. Pastikan Anda telah meng-klaim halaman yang Anda ingin menerjemahkan, supaya tidak terjadi pekerjaan ganda.
Berikut adalah panduan penulisan yang berlaku bagi seluruh situs terjemahan reactjs.org.
Silakan merujuk ke halaman Glosarium pada wiki id.reactjs.org. Halaman wiki tersebut berisi daftar glosarium beserta terjemahannya.
Referensi panduan penulisan Bahasa Indonesia lainnya yang dapat digunakan adalah:
- Pedoman Umum Ejaan Bahasa Indonesia (PUEBI)
- Kamus Besar Bahasa Indonesia (KBBI)
- RSNI3 8527:2018 - Glosarium Istilah Teknologi Informasi
Setiap heading pada halaman reactjs.org memiliki ID seperti berikut:
## Try React {#try-react}
Jangan menerjemahkan ID-nya! ID yang diterjemahkan akan merusak navigasi dalam situs.
Lihat [bagian permulaan](/getting-started#try-react) untuk info lebih lanjut.
✅ LAKUKAN:
## Coba React {#try-react}
❌ JANGAN LAKUKAN:
## Coba React {#coba-react}
Ini akan merusak tautan di atas.
Anda dapat menerjemahkan teks di dalam string & komentar kode, namun berhati-hatilah supaya tidak menerjemahkan bagian dari kode secara tidak sengaja!
Contoh:
// Example
const element = <h1>Hello, world</h1>;
ReactDOM.render(element, document.getElementById('root'));
✅ LAKUKAN:
// Contoh
const element = <h1>Halo, dunia</h1>;
ReactDOM.render(element, document.getElementById('root'));
❌ JANGAN LAKUKAN:
// Contoh
const element = <h1>Halo, dunia</h1>;
// "root" merujuk kepada ID elemen.
// JANGAN DITERJEMAHKAN
ReactDOM.render(element, document.getElementById('induk'));
❌ SANGAT TIDAK BOLEH DILAKUKAN:
// Contoh
const elemen = <h1>Halo, dunia</h1>;
ReactDOM.render(elemen, dokumen.dapatkanElemenBerdasarkanId('induk'));
Apabila tautan eksternal merujuk kepada artikel referensi seperti di MDN atau Wikipedia, dan versi bahasa Indonesia dari artikel tersebut yang berkualitas cukup bagus tersedia, lebih baik merujuk kepada tautan versi bahasa Indonesia tersebut.
Contoh:
This helps prevent [XSS (cross-site-scripting)](https://en.wikipedia.org/wiki/Cross-site_scripting) attacks.
✅ OK:
Ini membantu menghindari serangan [XSS (*cross-site-scripting*)](https://id.wikipedia.org/wiki/XSS).