* chore: add Bahasa Indonesia -- CONTRIBUTING * fix: linting error Co-authored-by: James Harris <wopian@wopian.me>
5.4 KiB
Menyumbang
🎌 Bahasa Indonesia, Čeština, Deutsch, English, Español, Français, Italiano, Kurdi, Lietuvių, Nederlands, Norsk, Polski, Português, Türkçe, Ελληνικά, العربية, 日本語, 正體中文, 简体中文, 한국어
Kode asli dalam repositori ini didigitalkan secara manual dari kertas cetak, sehingga inkonsistensi dan ketidaksesuaian lainnya mungkin terjadi karena kesalahan. Kode perlu diubah agar sesuai dengan edisi yang diterbitkan:
Ekstensi yang berguna
GitHub memiliki dukungan sintaks untuk pengaturan bahasa AGC. Sayangnya kode editor anda tidak dapat melakukannya, namun ada ekstensi bahasa AGC yang menyediakan penyorotan sintaks untuk kode editor berikut:
- Atom†
- CodeBlocks
- Eclipse
- Kate
- ProgrammersNotepad
- Sublime Text 3†
- TextPad
- Vim
- Visual Studio Code†
- jEdit
† Mendukung pemformatan otomatis
Pemformatan
Note: GitHub dan plugin yang tercantum di atas akan secara otomatis mengonfirmasi bahwa Anda menggunakan plugin yang benar.
- Gunakan panjang tab
- Gunakan panjang tab 8
- Hapus karakter spasi ataupun tab di awal atau di akhir string
Apa yang saya periksa?
Setiap perbedaan antara pemindaian dan kode sumber dalam repositori ini.
Komentar
Komentar dalam kode yang ditranskripsikan HARUS cocok dengan pindaian persis.
Masalah umum yang harus Anda perhatikan saat pemeriksaan termasuk, tetapi tidak terbatas pada:
Kesalahan Tipografi
Di beberapa tempat, pengembang asli membuat kesalahan ketik saat menulis komentar. Beberapa di antaranya salah dikoreksi selama digitalisasi awal, namun digitalisasi juga menimbulkan kesalahan tipografi yang tidak ada dalam pemindaian.
Misalnya, jika komentar digital berisi SPACECRAFT
, tetapi spaecraft
dicetak dalam pemindaian, maka digitalisasi HARUS dikoreksi ke spaecraft
(hilang C
).
Demikian juga, jika sebuah kata memiliki kesalahan ketik dalam digitalisasi tetapi dieja dengan benar dalam pemindaian, maka kesalahan ketik HARUS diperbaiki.
Spasi
Spasi antara dua karakter dalam komentar HARUS cocok dengan pindaian. Dalam kebanyakan kasus (lihat diskusi di #316), ini adalah:
- Satu spasi untuk kata-kata baru.
- Spasi ganda untuk kalimat baru.
- Tiga ruang untuk lekukan.
Tidak semua halaman dalam pemindaian mengikuti generalisasi ini, jika pemindaian hanya memiliki satu spasi, bukan spasi ganda, gunakan satu spasi.
Jeda baris
- Pemisahan baris dengan
R0000
di kolom 1 harus sama persis dengan pemindaian. - Pemisahan baris dengan*out*
R0000
di kolom 1 hanya boleh berisi 1 atau 2 baris kosong dalam satu baris.- Jika ada lebih dari 2 jeda baris kosong, hapus jeda baris tambahan.
- Baris dengan
R0000
di kolom 1 tidak diperhitungkan dalam hal ini.
- Baris dengan
- Dalam gambar sumber, ini dibuat oleh digit yang belum dicetak di kolom 8. A 2 di sana memaksa spasi ganda (satu baris kosong dan 3 memaksa spasi tiga (garis kosong ganda). Nilai 4-8 didefinisikan tetapi tidak pernah digunakan. Baca selengkapnya di #159
- Jika ada lebih dari 2 jeda baris kosong, hapus jeda baris tambahan.
Misalnya berikut ini:
R0819 SUBROUTINE TO SKIP...
R0820
0821 LAMPTEST CS IMODES33
Harus menjadi:
R0819 SUBROUTINE TO SKIP...
R0820
0820 LAMPTEST CS IMODES33
Catatan
Sebelum Anda membuat PR, pastikan perubahan Anda konsisten dengan pemindaian!