ch0ic3/free-programming-books
1
0
Fork 0
mirror of https://github.com/EbookFoundation/free-programming-books.git synced 2024-12-18 09:26:10 +00:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity

Enhance Indonesian translation (review assistance requested) (#10393)

Browse Source 
* enhance indonesian language translation for CONTRIBUTING-id.md

* enhance indonesian language translation for HOWTO-id.md

* re-paraphrase

* fix typo and resolve comments

* Update docs/CONTRIBUTING-id.md

Co-authored-by: Daffa Muhammad Faizan <112247545+daffafaizan@users.noreply.github.com>

* Update docs/CONTRIBUTING-id.md

Co-authored-by: Harryanto Winsen <harry.winsen@yahoo.com>

* Update docs/CONTRIBUTING-id.md

Co-authored-by: Harryanto Winsen <harry.winsen@yahoo.com>

* Update docs/CONTRIBUTING-id.md

Co-authored-by: Harryanto Winsen <harry.winsen@yahoo.com>

* Update docs/CONTRIBUTING-id.md

Co-authored-by: Fityan <fityannugroho@gmail.com>

* Update docs/CONTRIBUTING-id.md

Co-authored-by: Fityan <fityannugroho@gmail.com>

* Update docs/CONTRIBUTING-id.md

Co-authored-by: Harryanto Winsen <harry.winsen@yahoo.com>

* Update docs/CONTRIBUTING-id.md

Co-authored-by: Harryanto Winsen <harry.winsen@yahoo.com>

---------

Co-authored-by: Eric Hellman <eric@hellman.net>
Co-authored-by: Daffa Muhammad Faizan <112247545+daffafaizan@users.noreply.github.com>
Co-authored-by: Harryanto Winsen <harry.winsen@yahoo.com>
Co-authored-by: Fityan <fityannugroho@gmail.com>
This commit is contained in:
Raja Azian 2024-01-03 23:39:24 +07:00 committed by GitHub
parent c1561e15da
commit cbf31128b2
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 59 additions and 58 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

115
docs/CONTRIBUTING-id.md
View File

@ -16,60 +16,60 @@ Dengan berkontribusi, Anda setuju untuk menghormati [Kode Etik](CODE_OF_CONDUCT-
<!----><a id="in-a-nutshell"></a> <!----><a id="in-a-nutshell"></a>
## Versi pendek ## Versi pendek
1. "Tautan untuk mengunduh buku dengan mudah" tidak selalu merujuk pada buku yang *gratis*. Harap hanya memberikan konten yang gratis. Pastikan itu benar-benar gratis. Kami tidak menerima tautan ke halaman yang *meminta* alamat email yang valid untuk mengunduh buku, tetapi kami menyambut daftar situs yang meminta alamat email. 1. "Tautan untuk mengunduh buku" tidak selalu merujuk pada buku yang benar-benar *gratis*. Mohon untuk hanya mendaftarkan tautan ke buku/konten yang benar-benar gratis. Kami tidak menerima tautan ke situs web yang *membutuhkan* alamat email dari pengguna sebelum mengunduh atau mengakses kontennya. Kami hanya dapat menerima tautan yang membutuhkan alamat email pengguna (atau yang serupa) jika bagian keterangan sesuai dengan panduan yang kami berikan.
2. Anda tidak harus terbiasa dengan Git: jika Anda menemukan sesuatu yang menarik *dan belum ada di repositori ini*, silakan buka [Isu](https://github.com/EbookFoundation/free-programming-books/issues) dengan proposal tautan Anda. 2. Anda tidak harus terbiasa dengan Git: jika Anda menemukan sesuatu yang menarik *dan belum ada di repositori ini*, silakan buka [Isu](https://github.com/EbookFoundation/free-programming-books/issues) dengan proposal tautan Anda.
- Jika Anda sudah familiar dengan Git, fork repositori dan kirimkan Pull Request (PR) Anda. - Jika Anda sudah familiar dengan Git, fork repositori dan kirimkan Pull Request (PR) Anda.
3. Kami memiliki 6 jenis daftar. Pastikan untuk memilih yang tepat: 3. Kami memiliki 6 kategori tautan. Pastikan untuk memilih kategori yang tepat sebelum mendaftarkan tautan yang anda usulkan:
- *Buku*: PDF, HTML, ePub, halaman berdasarkan gitbook.io, repositori Git, dll. - *Buku*: PDF, HTML, ePub, halaman gitbook.io berbasis web, repositori Git, dll.
- *Kursus*: Kursus menggambarkan materi pembelajaran yang bukan berupa buku. [Ini adalah contoh kursus](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/). - *Kursus*: Kursus menggambarkan materi pembelajaran yang bukan berupa buku. [Ini adalah contoh kursus](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/).
- *Tutorial interaktif*: Situs web interaktif yang memungkinkan pengguna memasukkan kode sumber perintah dan mengevaluasi hasilnya (dengan "mengevaluasi" kami tidak bermaksud "menilai"). misalnya: [Coba Haskell](http://tryhaskell.org), [Coba Git](https://learngitbranching.js.org). - *Tutorial interaktif*: Situs web interaktif yang memungkinkan pengguna memasukkan kode sumber (source code) atau perintah dan hasilnya bisa dievaluasi ("evaluasi" yang dimaksud bukan evaluasi dengan tujuan memberikan "nilai" yang berupa angka). misalnya: [Coba Haskell](http://tryhaskell.org), [Coba Git](https://learngitbranching.js.org).
- *Playgrounds*: Situs web interaktif, permainan, atau perangkat lunak desktop untuk belajar pemrograman. Anda dapat menulis, mengkompilasi (atau menjalankan), dan membagikan potongan kode. Playgrounds seringkali memperbolehkan Anda untuk membuat salinan (fork) dan membebaskan Anda untuk bermain dengan kodenya. - *Playgrounds*: Situs web interaktif, permainan (game), atau aplikasi desktop untuk belajar pemrograman. Anda dapat menulis, mengkompilasi (atau menjalankan), dan membagikan source code yang ditulis. Playgrounds seringkali memperbolehkan Anda untuk membuat salinan (fork) dan membebaskan Anda untuk bermain dengan kodenya.
- *Podcast dan Screencasts*: Podcast dan Screencasts. - *Podcast dan Screencasts*: Podcast dan Screencasts.
- *Kumpulan Masalah & Pemrograman Kompetitif*: Situs web atau perangkat lunak yang memungkinkan Anda mengukur kemampuan pemrograman Anda dengan menyelesaikan masalah-masalah sederhana atau kompleks, dengan atau tanpa tinjauan kode, dengan atau tanpa membandingkan hasilnya dengan pengguna lain. - *Kumpulan Masalah & Pemrograman Kompetitif*: Situs web atau perangkat lunak yang memungkinkan Anda untuk mengukur kemampuan pemrograman Anda dengan menyelesaikan masalah-masalah sederhana atau kompleks, dengan atau tanpa proses tinjauan kode, dengan atau tanpa membandingkan hasilnya dengan pengguna lain.
4. Pastikan Anda mengikuti [Guidelines di bawah](#guidelines) dan menghormati [Formatting Markdown](#formatting) dari setiap file. 4. Pastikan Anda mengikuti [Pedoman](#guidelines) di bawah ini dan mengikuti [Panduan Penulisan Markdown](#formatting).
5. GitHub Actions akan menjalankan pengujian untuk **memastikan bahwa daftar yang Anda buat diurutkan secara alfabetis** dan **mengikuti aturan format**. **Pastikan** untuk memeriksa bahwa perubahan yang Anda buat lulus uji coba tersebut. 5. GitHub Actions akan melakukan pengujian untuk **memastikan bahwa daftar yang Anda buat diurutkan secara alfabetis** dan **mengikuti aturan format**. **Pastikan** untuk memeriksa bahwa perubahan yang Anda buat lulus pengujian tersebut.
<!----><a id="guidelines"></a> <!----><a id="guidelines"></a>
### Pedoman ### Pedoman
- Pastikan bahwa buku yang Anda tambahkan benar-benar gratis. Periksa dua kali jika perlu. Ini akan membantu para admin jika Anda memberikan komentar di PR mengenai alasan Anda menganggap buku tersebut gratis. - Pastikan bahwa buku yang Anda tambahkan benar-benar gratis. Periksa dua kali jika perlu. Para Admin akan sangat terbantu jika Anda menambahkan catatan pada Pull Request (PR) tentang alasan Anda menganggap buku/konten yang diusulkan gratis.
- Kami tidak menerima file yang bersumber dari Google Drive, Dropbox, Mega, Scribd, Issuu, dan platform unggah file serupa lainnya. - Kami tidak menerima file yang bersumber dari Google Drive, Dropbox, Mega, Scribd, Issuu, dan platform unggah file serupa lainnya.
- Masukkan tautan Anda dalam urutan alfabetis, seperti yang dijelaskan [di bawah](#alphabetical-order). - Masukkan tautan Anda dalam urutan alfabetis, seperti yang dijelaskan [di bawah](#alphabetical-order).
- Gunakan tautan dengan sumber yang paling otoritatif (artinya situs web penulis lebih baik daripada situs web penyunting, yang lebih baik daripada situs web pihak ketiga). - Gunakan tautan dengan sumber yang paling otoritatif (artinya situs web penulis lebih baik daripada situs web penyunting, yang lebih baik daripada situs web pihak ketiga).
- Jangan gunakan layanan hosting file (termasuk namun tidak terbatas pada tautan Dropbox dan Google Drive). - Jangan gunakan layanan hosting file (termasuk namun tidak terbatas pada tautan Dropbox dan Google Drive).
- Selalu gunakan protokol tautan `https` daripada tautan `http` -- selama keduanya berada di domain yang sama dan menyajikan konten yang sama. - Selalu gunakan protokol tautan `https` daripada tautan `http` -- selama keduanya berada di domain yang sama dan menyajikan konten yang sama.
- Pada domain root, hapus garis miring di akhir: `http://example.com` alih-alih `http://example.com/` - Pada domain utama, hapus garis miring di akhir: `http://example.com` alih-alih `http://example.com/`
- Selalu pilih tautan terpendek: `http://example.com/dir/` lebih baik daripada `http://example.com/dir/index.html`. - Selalu pilih tautan terpendek: `http://example.com/dir/` lebih baik daripada `http://example.com/dir/index.html`.
- Jangan gunakan tautan penyusut (shortener) URL. - Jangan gunakan tautan penyingkat (shortener) URL.
- Pilih tautan ke "versi terbaru" alih-alih menautkan ke "versi tertentu": `http://example.com/dir/book/current/` lebih baik daripada `http://example.com/dir/book/v1.0.0/index.html`. - Gunakan tautan ke "versi terbaru" daripada menautkan ke "versi tertentu": `http://example.com/dir/book/current/` lebih baik daripada `http://example.com/dir/book/v1.0.0/index.html`.
- Jika sebuah tautan memiliki sertifikat yang sudah kedaluwarsa/sertifikat buatan sendiri/masalah SSL lainnya: - Jika sebuah tautan memiliki sertifikat SSL yang sudah kedaluwarsa, sertifikat SSL buatan sendiri, atau masalah SSL lainnya:
1. *Gantilah* dengan versi `http` jika memungkinkan (karena prosesi pengecualian / bypass bisa jadi rumit di perangkat seluler). 1. *Gantilah* dengan versi `http` jika memungkinkan (karena proses bypass sertifikat SSL pada perangkat genggam terbilang sulit).
2. *Biarkan apa adanya* jika versi `http` tidak tersedia, tetapi tautan dapat diakses melalui `https` dengan mengabaikan peringatan di browser atau menambahkan pengecualian. 2. *Biarkan apa adanya* jika versi `http` tidak tersedia, tetapi tautan dapat diakses melalui `https` dengan mengabaikan peringatan di browser atau menambahkan pengecualian.
3. *Hapus* jika tidak ada pilihan lain. 3. *Hapus* jika tidak ada pilihan lain.
- Jika sebuah tautan ada dalam beberapa format, tambahkan tautan terpisah dengan catatan tentang setiap format. - Jika sebuah tautan/konten mempunyai beberapa format, tambahkan tautan terpisah dengan catatan tentang setiap format.
- Jika sebuah sumber ada di berbagai tempat di Internet: - Jika sebuah tautan/konten ada di berbagai tempat di Internet:
- Gunakan tautan dengan sumber yang paling otoritatif (artinya situs web penulis lebih baik daripada situs web penyunting, yang lebih baik daripada situs web pihak ketiga). - Gunakan tautan dengan sumber yang paling otoritatif (artinya situs web penulis lebih baik daripada situs web penyunting, yang lebih baik daripada situs web pihak ketiga).
- Jika mereka merujuk ke edisi yang berbeda, dan Anda menganggap edisi tersebut cukup berbeda sehingga layak untuk tetap mempertahankannya, tambahkan tautan terpisah dengan catatan tentang setiap edisi (lihat [Issue #2353](https://github.com/EbookFoundation/free-programming-books/issues/2353) untuk berpartisipasi dalam diskusi tentang pemformatan). - Jika tautan/konten-nya merujuk ke edisi yang berbeda, dan Anda merasa edisi tersebut cukup berbeda sehingga layak untuk tetap didaftarkan, tambahkan tautan terpisah dengan menambahkan keterangan untuk masing-masing edisi (lihat [Issue #2353](https://github.com/EbookFoundation/free-programming-books/issues/2353) untuk berpartisipasi dalam diskusi tentang pemformatan).
- Utamakan komit atomik (satu komit per-penambahan/penghapusan/modifikasi) daripada komit yang lebih besar. Tidak perlu menggabungkan komit-komit Anda sebelum mengirimkan PR. (Kami tidak akan pernah menegakkan aturan ini karena ini hanya masalah kenyamanan bagi para pengelola). - Utamakan komit atomik (satu komit per-penambahan/penghapusan/modifikasi) daripada komit yang lebih besar. Tidak perlu menggabungkan komit-komit Anda sebelum mengirimkan PR. (Kami tidak memaksakan aturan ini untuk diikuti, karena ini hanya masalah kenyamanan bagi para pengelola).
- Jika buku sudah lama diterbitkan, sertakan tanggal publikasinya bersama dengan judulnya. - Jika buku/konten yang ingin didaftarkan atau terbitan lama, sertakan tanggal publikasi setelah judul dari konten/buku yang diusulkan.
- Sertakan nama atau nama-nama penulis yang sesuai. Anda dapat memendekkan daftar penulis dengan "`et al.`". - Sertakan nama atau nama-nama penulis (jika penulis lebih dari satu). Anda dapat menyingkat daftar penulis dengan "`et al.`".
- Jika buku belum selesai, dan masih dalam tahap pengerjaan, tambahkan keterangan "`dalam proses`" seperti yang dijelaskan [di bawah ini](#in_process). - Jika buku belum selesai, dan masih dalam tahap pengerjaan, tambahkan keterangan "`dalam proses`" seperti yang dijelaskan [di bawah ini](#in_process).
- Jika suatu sumber dipulihkan menggunakan [*Internet Archive's Wayback Machine*](https://web.archive.org) (atau serupa), tambahkan keterangan "`terarsip`" seperti yang dijelaskan [di bawah](#archived). Versi terbaik untuk digunakan adalah versi terbaru dan lengkap. - Jika suatu sumber merupakan sumber yang dipulihkan menggunakan [*Internet Archive's Wayback Machine*](https://web.archive.org) (atau serupa), mohon tambahkan keterangan "`terarsip`" seperti yang dijelaskan [di bawah](#archived). Akan tetapi mohon gunakan versi terbaru dan lengkap.
- Jika alamat email atau pengaturan akun diperlukan sebelum pengunduhan, tambahkan catatan sesuai dengan bahasa yang tepat dalam tanda kurung, misalnya: `(alamat email *diminta*, tidak wajib)`. - Jika suatu sumber membutuhkan alamat email pengunduh/pengunjung atau membutuhkan proses pembuatan akun maka tambahkan catatan sesuai dengan bahasa yang tepat dalam tanda kurung, misalnya: `(alamat email *wajib*, tidak wajib)`.
<!----><a id="formatting"></a> <!----><a id="formatting"></a>
### Pemformatan ### Pemformatan
- Semua daftar adalah file `.md`. Coba pelajari sintaks [Markdown](https://guides.github.com/features/mastering-markdown/). Itu mudah! - Semua daftar tautan ditulis pada berkas `.md`. Coba pelajari sintaks [Markdown](https://guides.github.com/features/mastering-markdown/). Itu mudah!
- Semua daftar dimulai dengan Indeks. Idenya adalah untuk membuat daftar dan menautkan semua bagian dan subbagian di sana. Simpan dalam urutan abjad. - Semua daftar tautan dimulai dengan Indeks. Idenya adalah untuk membuat daftar dan menautkan semua bagian dan subbagian di sana. Simpan dalam urutan alfabetis.
- Bagian menggunakan heading level 3 (`###`), dan subbagian menggunakan heading level 4 (`####`). - Bagian daftar tautan menggunakan heading level 3 (`###`), dan subbagiannya menggunakan heading level 4 (`####`).
Idenya adalah untuk memiliki: Idenya adalah untuk memiliki:
@ -119,7 +119,7 @@ Contoh:
BAIK : * [Buku yang Sangat Bagus](https://example.org/book.pdf) - Jane Roe (PDF) BAIK : * [Buku yang Sangat Bagus](https://example.org/book.pdf) - Jane Roe (PDF)
``` ```
- Format lebih dari satu (Kami lebih suka satu tautan untuk setiap sumber. Ketika tidak ada tautan tunggal yang dapat diakses lebih mudah ke format yang berbeda, beberapa tautan lebih diutamakan. Namun, setiap tautan yang kami tambahkan akan menambah beban pemeliharaan sehingga kami mencoba menghindarinya.) - Konten dengan lebih dari satu format (Kami lebih mengutamakan satu tautan untuk semua sumber. Ketika tidak ada tautan tunggal yang bisa digunakan, maka boleh menggunakan satu tautan untuk masing-masing format. Namun, setiap tautan yang ditambahkan akan menambah beban pemeliharaan sehingga kami mencoba menghindarinya.)
- Format lebih dari satu: - Format lebih dari satu:
```text ```text
@ -135,30 +135,31 @@ Contoh:
BAIK : * [Buku yang Sangat Bagus (1970)](https://example.org/book.html) - Jane Roe BAIK : * [Buku yang Sangat Bagus (1970)](https://example.org/book.html) - Jane Roe
``` ```
- <a id="in_process"></a>Buku dalam proses: - <a id="in_process"></a>Buku dalam proses penulisan:
```text ```text
BAIK : * [Akan Segera Menjadi Buku yang Luar Biasa](http://example.com/book2.html) - John Doe (HTML) *(:construction: in process)* BAIK : * [Akan Segera Menjadi Buku yang Luar Biasa](http://example.com/book2.html) - John Doe (HTML) *(:construction: in process)*
``` ```
- <a id="archived"></a>Archived link: - <a id="archived"></a>Tautan yang diarsipkan:
```text ```text
BAIK : * [A Way-backed Interesting Book](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archived)* BAIK : * [A Way-backed Interesting Book](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archived)*
``` ```
### Alphabetical order <!----><a id="alphabetical-order"></a>
### Urutan Alfabetis
- Ketika terdapat beberapa judul yang dimulai dengan huruf yang sama, urutkan berdasarkan yang kedua, dan seterusnya. Sebagai contoh: `aa` muncul sebelum `ab`. - Jika terdapat beberapa judul konten yang diawali dengan huruf yang sama, maka urutkan berdasarkan huruf kedua dari judul konten tersebut, dan seterusnya. Sebagai contoh: `aa` terlebih dahulu sebelum `ab`.
- `one two` muncul sebelum `onetwo` - `one two` terlebih dahulu sebelum `onetwo`
Jika Anda melihat tautan yang salah tempat, periksa pesan kesalahan linter untuk mengetahui baris mana yang harus ditukar. Jika Anda melihat tautan dengant urutan yang salah, mohon periksa pesan kesalahan yang diberikan oleh linter untuk mengetahui baris mana yang harus ditukar/diubah.
<!----><a id="notes"></a> <!----><a id="notes"></a>
### Catatan ### Catatan
Meskipun dasar-dasarnya relatif sederhana, ada keragaman besar dalam sumber daya yang kami daftarkan. Berikut adalah beberapa catatan tentang bagaimana kita menghadapi keragaman ini. Meskipun dasar-dasarnya relatif sederhana, terdapat keragaman yang besar pada konten-konten yang kami daftarkan. Berikut beberapa catatan tentang bagaimana kami menangani keragaman ini.
#### Metadata #### Metadata
@ -169,14 +170,14 @@ Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform
<!----><a id="titles"></a> <!----><a id="titles"></a>
##### Judul ##### Judul
- Tidak menggunakan judul yang diciptakan. Kami mencoba menggunakan judul dari sumber daya itu sendiri; kontributor diharapkan untuk tidak membuat judul atau menggunakan judul secara editorial jika hal ini dapat dihindari. Sebuah pengecualian adalah untuk karya-karya lama; jika mereka utamanya dari minat sejarah, tahun dalam tanda kurung yang ditambahkan ke judul membantu pengguna mengetahui jika mereka menarik minat. - Tidak menggunakan judul yang diciptakan. Kami mencoba menggunakan judul dari konten-konten yang terdaftar sebagaimana adanya; Sebisa mungkin bagi kontributor untuk tidak membuat, mengubah, mensunting, atau menulis ulang judul dari konten-konten yang didaftarkan. Kecuali jika konten-konten yang didaftarkan merupakan karya-karya lama; Jika konten-konten yang didaftarkan bertujuan untuk kepentingan sejarah (historis), menambahkan tahun perilisan atau terbit konten akan membantu pengguna untuk mengetahui apakah konten tersebut sesuai dengan yang dibutuhkan.
- Tidak menggunakan judul dengan HURUF KAPITAL. Biasanya, judul yang ditulis dengan huruf kapital awal adalah yang sesuai, tetapi jika ragu, gunakan kapitalisasi yang sesuai dari sumbernya. - Judul konten tidak boleh ditulis dengan menggunakan HURUF KAPITAL semua. Biasanya, penggunaan huruf kapital pada judul konten hanya untuk awalan kata saja, tetapi jika ragu, gunakan kapitalisasi yang sesuai dari sumbernya.
- Tidak menggunakan emoji. - Tidak menggunakan emoji.
##### URLs ##### URLs
- Kami tidak mengizinkan penggunaan URL yang disingkat. - Kami tidak mengizinkan menggunakan tautan (URL) yang disingkat.
- Kode pelacakan harus dihapus dari URL. - Kode pelacakan harus dihapus dari URL.
- URL internasional harus diubah menjadi format yang benar (escaped). Biasanya, bilah peramban akan menampilkan ini dalam bentuk Unicode, namun, untuk menghindari kesalahan, harap menggunakan salin dan tempel (copy and paste). - URL internasional harus diubah menjadi format yang benar (escaped). Biasanya, bilah peramban akan menampilkan ini dalam bentuk Unicode, namun, untuk menghindari kesalahan, harap menggunakan salin dan tempel (copy and paste).
- URL yang aman (`https`) selalu diutamakan daripada URL yang tidak aman (`http`) di tempat-tempat di mana HTTPS telah diimplementasikan. - URL yang aman (`https`) selalu diutamakan daripada URL yang tidak aman (`http`) di tempat-tempat di mana HTTPS telah diimplementasikan.
@ -187,14 +188,14 @@ Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform
##### Pencipta ##### Pencipta
- Kami ingin menghargai pencipta sumber daya gratis jika perlu, termasuk penerjemah! - Kami ingin menghargai pencipta sumber daya gratis jika perlu, termasuk penerjemah!
- Untuk karya terjemahan, penulis asli harus dikreditkan. Kami rekomendasikan menggunakan [kode relator MARC](https://loc.gov/marc/relators/relaterm.html) untuk mengkredit pencipta selain penulis, seperti dalam contoh ini: - Untuk karya terjemahan, penulis asli harus disebutkan. Kami rekomendasikan menggunakan [kode relator MARC](https://loc.gov/marc/relators/relaterm.html) untuk mengkredit pencipta selain penulis, seperti dalam contoh ini:
```markdown ```markdown
* [A Translated Book](http://example.com/book-id.html) - John Doe, `trl.:` Mike The Translator * [A Translated Book](http://example.com/book-id.html) - John Doe, `trl.:` Mike The Translator
``` ```
di sini, anotasi `trl.:` memakai kode relator MARC untuk "penerjemah". di sini, anotasi `trl.:` memakai kode relator MARC untuk "penerjemah".
- Gunakan koma `,` untuk memisahkan setiap item dalam daftar penulis. - Gunakan koma `,` untuk memisahkan setiap nama dalam daftar penulis.
- Anda dapat mempersingkat daftar penulis dengan "`et al.`". - Anda dapat mempersingkat daftar penulis dengan "`et al.`".
- Kami tidak mengizinkan tautan untuk Kreator. - Kami tidak mengizinkan tautan untuk Kreator.
- Untuk karya kompilasi atau campuran, "pencipta" mungkin memerlukan deskripsi. Misalnya, buku "GoalKicker" atau "RIP Tutorial" dikreditkan sebagai "`Dikompilasi dari dokumentasi StackOverflow`" (dalam Bahasa Inggris: `Compiled from StackOverflow documentation`). - Untuk karya kompilasi atau campuran, "pencipta" mungkin memerlukan deskripsi. Misalnya, buku "GoalKicker" atau "RIP Tutorial" dikreditkan sebagai "`Dikompilasi dari dokumentasi StackOverflow`" (dalam Bahasa Inggris: `Compiled from StackOverflow documentation`).
@ -203,30 +204,30 @@ Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform
<!----><a id="time-limited-courses-and-trials"></a> <!----><a id="time-limited-courses-and-trials"></a>
##### Kursus dan Uji Coba dengan Batas Waktu ##### Kursus dan Uji Coba dengan Batas Waktu
- Kami tidak mencantumkan hal-hal yang perlu kami hapus dalam enam bulan. - Kami tidak mencantumkan konten-konten yang perlu kami hapus dalam enam bulan kedepan.
- Jika sebuah kursus memiliki periode pendaftaran atau durasi terbatas, kami tidak akan mencantumkannya. - Jika sebuah kursus mempunyai periode pendaftaran atau durasinya terbatas, kami tidak akan mencantumkannya.
- Kami tidak dapat mencantumkan sumber daya yang gratis hanya untuk jangka waktu tertentu. - Kami tidak dapat mencantumkan konten gratis hanya untuk jangka waktu tertentu.
<!----><a id="platforms-and-access-notes"></a> <!----><a id="platforms-and-access-notes"></a>
##### Platform dan Catatan Akses ##### Platform dan Catatan Akses
- Kursus. Khususnya untuk daftar kursus kami, platform merupakan bagian penting dari deskripsi sumber daya. Hal ini karena platform kursus memiliki keterjangkauan dan model akses yang berbeda. Meskipun kami biasanya tidak akan mencantumkan buku yang memerlukan pendaftaran, banyak platform kursus memiliki keterjangkauan yang tidak berfungsi tanpa akun tertentu. Contoh platform kursus termasuk Coursera, EdX, Udacity, dan Udemy. Ketika sebuah kursus bergantung pada suatu platform, nama platform tersebut harus dicantumkan dalam tanda kurung. - Kursus. Khususnya untuk konten kursus yang didaftarkan, platform tempat kursus tersebut berada harus ditambahkan pada keterangan konten. Hal ini karena platform kursus memiliki keterjangkauan dan model akses yang berbeda. Meskipun kami biasanya tidak akan mencantumkan konten yang memerlukan proses pendaftaran, banyak platform kursus yang tidak bisa diakses tanpa proses pembuatan/pendaftaran akun terlebih dahulu. Seperti Coursera, EdX, Udacity, dan Udemy. Ketika sebuah kursus bergantung pada suatu platform, nama platform tersebut harus dicantumkan pada keterangan konten dalam tanda kurung.
- YouTube. Kami memiliki banyak kursus yang terdiri dari daftar putar YouTube. Kami tidak mencantumkan YouTube sebagai sebuah platform, kami mencoba mencantumkan kreator YouTube, yang seringkali merupakan sub-platform. - YouTube. Kami memiliki banyak kursus yang terdiri dari daftar putar YouTube. Kami tidak mencantumkan YouTube sebagai sebuah platform, kami mencoba mencantumkan kreator YouTube, yang seringkali merupakan sub-platform.
- Video YouTube. Kami biasanya tidak mengaitkan tautan ke video YouTube individu kecuali jika video tersebut berdurasi lebih dari satu jam dan disusun seperti kursus atau tutorial. Jika ini adalah kasusnya, pastikan untuk mencatatnya dalam deskripsi PR. - Video YouTube. Kami biasanya tidak mengaitkan tautan ke video YouTube individu kecuali jika video tersebut berdurasi lebih dari satu jam dan disusun seperti kursus atau tutorial. Jika ini adalah kasusnya, pastikan untuk mencatatnya dalam deskripsi PR.
- Leanpub. Leanpub menyediakan buku dengan berbagai model akses. Terkadang sebuah buku bisa dibaca tanpa registrasi; terkadang sebuah buku memerlukan akun Leanpub untuk akses gratis. Mengingat kualitas buku dan campuran serta kelenturan model akses Leanpub, kami mengizinkan penulisan yang terakhir dengan catatan akses `*(Akun Leanpub atau alamat email valid diminta)*` - Leanpub. Leanpub menyediakan buku dengan berbagai model akses. Terkadang sebuah buku bisa dibaca tanpa registrasi; terkadang sebuah buku memerlukan akun Leanpub untuk bisa mengaksesnya secara gratis. Mengingat kualitas buku dan campuran serta kelenturan model akses Leanpub, kami mengizinkan penulisan yang terakhir dengan catatan akses `*(Akun Leanpub atau alamat email valid diminta)*`
<!----><a id="genres"></a> <!----><a id="genres"></a>
#### Genre #### Genre
Aturan pertama dalam menentukan daftar mana sebuah sumber daya masuk adalah melihat bagaimana sumber daya itu menggambarkan dirinya sendiri. Jika sumber daya tersebut menyebut dirinya sebagai buku, bisa jadi sumber daya tersebut adalah buku. Aturan pertama dalam menentukan genre mana sebuah konten adalah dengan melihat bagaimana isi dari konten tersebut. Jika konten tersebut mengatakan dirinya sebagai buku, bisa jadi konten tersebut adalah buku.
<!----><a id="genres-we-dont-list"></a> <!----><a id="genres-we-dont-list"></a>
##### Genre yang tidak kami cantumkan ##### Genre yang tidak kami cantumkan
Karena Internet sangat luas, kami tidak memasukkan dalam daftar kami: Karena Internet sangat luas, kami tidak mendaftarkan konten dengan genre:
- blog - blog
- postingan blog - postingan blog
@ -234,17 +235,17 @@ Karena Internet sangat luas, kami tidak memasukkan dalam daftar kami:
- situs web (kecuali yang meng-host BANYAK item yang kami daftarkan). - situs web (kecuali yang meng-host BANYAK item yang kami daftarkan).
- video yang bukan kursus atau screencasts. - video yang bukan kursus atau screencasts.
- bab buku - bab buku
- sampel teaser dari buku - sampel dari buku
- saluran IRC atau Telegram - saluran IRC atau Telegram
- Slacks atau daftar email (Slacks or mailing lists) - Slacks atau berlangganan email (Slacks or mailing lists)
Daftar pemrograman kompetitif kami tidak seketat pengecualian ini. Lingkup repositori ini ditentukan oleh komunitas; jika Anda ingin menyarankan perubahan atau penambahan pada lingkup, harap gunakan isu (issue) untuk memberikan saran. Panduan untuk daftar konten-konten pemrograman kompetitif kami tidak seketat ini. Ruang lingkup repositori ini ditentukan oleh komunitas; jika Anda ingin menyarankan perubahan atau penambahan pada ruang lingkup yang sekarang, harap gunakan isu (issue) untuk memberikan saran.
<!----><a id="books-vs-other-stuff"></a> <!----><a id="books-vs-other-stuff"></a>
##### Buku vs. Barang Lainnya ##### Buku vs. Barang Lainnya
Kami tidak rewel tentang kebukuan. Berikut adalah beberapa atribut yang menandakan bahwa sumber daya adalah sebuah buku: Kami tidak rewel tentang kebukuan. Berikut adalah beberapa atribut yang menandakan bahwa konten yang didaftarkan adalah sebuah buku:
- memiliki ISBN (Nomor Buku Standar Internasional) - memiliki ISBN (Nomor Buku Standar Internasional)
- memiliki Daftar Isi - memiliki Daftar Isi
@ -254,7 +255,7 @@ Kami tidak rewel tentang kebukuan. Berikut adalah beberapa atribut yang menandak
- mencoba untuk mencakup topik secara komprehensif - mencoba untuk mencakup topik secara komprehensif
- bersifat mandiri - bersifat mandiri
Ada banyak buku yang kami cantumkan yang tidak memiliki atribut-atribut ini; itu bisa tergantung pada konteks. Terdapat banyak buku yang kami daftarkan tidak memiliki atribut-atribut ini; Hal ini kembali ke konteks dari konten yang didaftarkan.
<!----><a id="books-vs-courses"></a> <!----><a id="books-vs-courses"></a>
@ -262,25 +263,25 @@ Ada banyak buku yang kami cantumkan yang tidak memiliki atribut-atribut ini; itu
Terkadang ini sulit untuk dibedakan! Terkadang ini sulit untuk dibedakan!
Kursus sering kali memiliki buku teks terkait, yang akan kami daftarkan dalam daftar buku kami. Kursus memiliki kuliah, latihan, tes, catatan atau alat bantu didaktik lainnya. Sebuah kuliah atau video dengan sendirinya bukanlah sebuah kursus. Sebuah powerpoint bukanlah kursus. Kursus sering kali memiliki buku teks terkait, yang akan kami daftarkan dalam daftar buku kami. Kursus memiliki materi pembelajaran, latihan, tes, catatan atau alat bantu pembelajaran lainnya. Materi pembelajaran tunggal atau video tunggal bukan sebuah kursus. Slide persentasi (biasanya berupa PowerPoint) bukan sebuah kursus.
<!----><a id="interactive-tutorials-vs-other-stuff"></a> <!----><a id="interactive-tutorials-vs-other-stuff"></a>
##### Tutorial Interaktif vs. Hal-hal lain ##### Tutorial Interaktif vs. Hal-hal lain
Jika Anda dapat mencetaknya dan mempertahankan esensinya, itu bukan Tutorial Interaktif. Jika Anda dapat mencetaknya dan isi tidak berubah, maka itu bukan Tutorial Interaktif.
<!----><a id="automation"></a> <!----><a id="automation"></a>
### Otomatisasi ### Otomatisasi
- Penegakan aturan format dilakukan secara otomatis melalui [GitHub Actions](https://github.com/features/actions) menggunakan [fpb-lint](https://github.com/vhf/free-programming-books-lint) (lihat [`.github/workflows/fpb-lint.yml`](../.github/workflows/fpb-lint.yml)). - Proses validasi aturan-aturan tulisan/pemformatan dilakukan secara otomatis oleh [GitHub Actions](https://github.com/features/actions) dengan menggunakan [fpb-lint](https://github.com/vhf/free-programming-books-lint) (lihat [`.github/workflows/fpb-lint.yml`](../.github/workflows/fpb-lint.yml)).
- Validasi URL menggunakan [awesome_bot](https://github.com/dkhamsing/awesome_bot). - Proses validasi URL menggunakan [awesome_bot](https://github.com/dkhamsing/awesome_bot).
- Untuk memicu validasi URL, *lakukan commit* yang mencakup pesan commit yang berisi `check_urls=berkas_yang_akan_dicek`: - Untuk menjalankan proses validasi URL, *lakukan commit* yang mencatumkan pesan `check_urls=berkas_yang_akan_dicek`:
```properties ```properties
check_urls=free-programming-books.md free-programming-books-id.md check_urls=free-programming-books.md free-programming-books-id.md
``` ```
- Anda dapat menentukan lebih dari satu berkas untuk diperiksa, dengan menggunakan spasi tunggal untuk memisahkan setiap entri. - Anda dapat memvalidasi URL banyak berkas dengan menggunakan spasi sebagai pemisah masing-masing berkas.
- Jika Anda menentukan lebih dari satu berkas, hasil build didasarkan pada hasil berkas terakhir yang diperiksa. Anda harus memperhatikan bahwa Anda mungkin mendapatkan hasil build yang berhasil, jadi pastikan Anda memeriksa log pembangunan pada akhir Pull Request dengan mengklik "Show all checks" -> "Details". - Jika Anda memvalidasi URL untuk banyak berkas, hasil validasi yang ditampilkan merupakan hasil validasi dari berkas terakhir. Sehingga, jika proses validasi berhasil, mohon untuk memeriksa log dari proses validasi pada Pull Request Anda dengan mengklik "Show all checks" -> "Details".

2
docs/HOWTO-id.md
View File

@ -8,7 +8,7 @@
**Selamat datang di `Free-Programming-Books`!** **Selamat datang di `Free-Programming-Books`!**
Kami sangat menyambut kontributor baru, bahkan untuk mereka yang membuat Pull Request (PR) pertamanya di GitHub. Jika Anda termasuk salah satu di antara mereka, berikut adalah sumber daya yang mungkin berguna: Kami menyambut hangat kontributor baru, bahkan untuk mereka yang membuat Pull Request (PR) pertamanya di GitHub. Jika Anda termasuk salah satu di antara mereka, berikut adalah tautan-tautan yang mungkin berguna bagi anda:
* [Tentang Pull Requests](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) *(Dalam Bahasa Inggris)* * [Tentang Pull Requests](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) *(Dalam Bahasa Inggris)*
* [Membuat sebuah pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) *(Dalam Bahasa Inggris)* * [Membuat sebuah pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) *(Dalam Bahasa Inggris)*