Pengguna:Mnam23/Panduan

Pendahuluan

Prakata

Tulisan ini berjudul "Panduan berkontribusi di Wikisumber Indonesia" dan ditulis oleh saya serta dilepas dengan lisensi CC-BY-SA-4.0. Merangkum Bantuan:Isi dan dibagi berdasar Ruang-nama, diharapkan pembaca memahami cara kerja Wikisumber dan mudah dalam berkontribusi.

Wikibooks Indonesia mungkin dipikir menjadi tempat yang tepat, tapi karena tulisan ini tidak akan memenuhi 'sudut pandang netral' sebagaimana kebanyakan dari kebijakan proyek-proyek Wikimedia seharusnya, maka ruang nama pengguna Wikisumber Indonesia dirasa tepat untuk mempublikasikan tulisan ini.

Mengenal Wikisumber

Baca Bantuan:Pengantar

Apa bedanya dengan Wikipedia?

Baca Bantuan:Untuk Wikipediawan

Apa bedanya dengan Wikibuku?

Baca Wikisumber:Apakah Wikisumber itu?#Wikisumber dan Wikibuku

Indeks

Indeks adalah salah satu ruang nama di Wikisumber yang berfungsi untuk mencatat segala informasi yang terkait dengan Berkas Pindaian.

Berkas

Berkas diunggah ke Wikimedia Commons dengan memenuhi segala persyaratan, terutama tidak melanggar hak cipta sebagaimana yang tertulis dalam DMCA di AS selaku negara tempat peladen dari proyek-proyek Wikimedia dan UUHC 2014 untuk setiap karya yang berbahasa Indonesia.

Indeks dibuat di Wikisumber berdasarkan nama berkas yang telah ada. Contoh, apabila Anda menggunggah berkas "Berkas.djvu" di Commons, maka Indeks di Wikisumber seharusnya Indeks:Berkas.djvu dan nanti halamannya akan Halaman:Berkas.djvu/x.

Indeks

• Jenis: Jenis karya.
• Butir Wikidata: Diawali dengan "Q", jika ingin mengaitkan dengan Wikidata.
• Judul: Judul karya, beserta pranala yang mengarah ke ruang nama Utama.
• Pengarang: Nama pengarang, beserta pranala yang mengarah ke ruang nama Pengarang.
• Penerjemah: Nama penerjemah, beserta pranala yang mengarah ke ruang nama Pengarang.
• Penyunting: Nama penyunting, beserta pranala yang mengarah ke ruang nama Pengarang.
• Ilustrator: Nama ilustrator, beserta pranala yang mengarah ke ruang nama Pengarang.
• Penerbit: Nama penerbit
• Alamat penerbit: Kota penerbit
• Tahun: Tahun terbit, sesuai Berkas
• Halaman: <pagelist>.
  • Gunakan ws-page-game.toolforge.org untuk mempersiapkan halaman.
  • 1-2=roman akan menampilkan halaman 1-2 dalam angka romawi, seperti i-ii
  • from= dan to= akan menampilkan halaman pada rentang tertentu
  • Selengkapnya baca Bantuan:Nomor halaman#Nomor Halaman pada Indeks ruangnama
• Volume: Berisikan daftar volume jika berbentuk serial
• Bagian kepala: Agar bagian kepala (header) halaman termuat secara otomatis setiap menyunting.
• Bagian kaki: Agar bagian kaki (footer) halaman termuat secara otomatis setiap menyunting.
• {{{pagenum}}} di Kepala/Kaki untuk halaman otomatis.

Halaman

Masih dalam tahap pengembangan.

• Apabila teks menggunakan ejaan lama, jangan diubah.
• Apabila teks terdapat salah ketik, jangan diubah, namun gunakan {{SIC}}.
• Apabila ada teks di bagian atas halaman, seperti nomor halaman atau judul halaman, mohon letakkan di kepala halaman agar tidak masuk saat transklusi, begitu pula di bawah halaman.
• Apabila ada kata yang memiliki penjarakan (spacing), gunakan {{sp}}.
• Apabila teks bersifat puisi, masukkan dalam <poem></poem>.
• Apabila ada kata terpotong dalam sebuah paragraf teks (misal, akhir baris 1 "ling-" dan awal baris 2 "kungan") maka hapus tanda hubung dan gabung kata tersebut (misal "lingkungan").
• Apabila ada kata terpotong lintas halaman (misal, akhir Halaman 1 "ling-" dan awal Halaman 2 "kungan"). Maka gunakan {{hws}} dan {{hwe}}. Sebagai contoh, {{hwe|ling|lingkungan}} di akhir Halaman 1 dan {{hws|ling|lingkungan}} di awal Halaman 2. Ini akan memudahkan Transklusi.
• Mark-up MediaWiki yang telah Anda kenal di Wikipedia, juga dapat diterapkan di sini, seperti '''Teks tebal''', ''Teks miring'' dan sebagainya. Tidak harus menggunakan kode HTML atau templat kecuali sangat diperlukan.
• Untuk ukuran huruf, bisa diatur dengan {{font-size}} dan templat sejenisnya. Baca Bantuan:Pedoman pemula tentang tipografi.
• Meski pindaian terdapat indentasi dan Wikisumber punya templat untuk menirunya persis, Wikisumber lebih memutuskan untuk tidak memberi indentasi atau penjorokan terhadap paragraf kecuali sangat diperlukan. Jadi, mohon untuk tidak menggunakan {{gap}}, {{tab}}, atau {{hii}} untuk penjarakan/indentasi selama tidak perlu. Penggayaan lebih lanjut dapat diberikan pada Transklusi jika menginginkan indentasi terhadap paragraf.
• Dalam perataan, secara bawaan akan rata kiri. Adapun jika ingin rata tengah, gunakan {{center}} dan {{right}} jika ingin rata kanan.
• Untuk daftar, Anda bisa menggunakan #, {{ol}} ({{ordered list}}), atau {{numbered list}} untuk daftar bernomor dan * untuk daftar tidak bernomor.
• Antar paragraf cukup dibatasi dua enter. Contoh:

Kedengarannja kalimat ini kalimat jang hebat. Kami tidak mau membangun sebelum masjarakat ini masjarakat jang sosialistis!

Kata bapak: ini sama dengan orang jang berkata, kami tidak mau mendirikan rumah, sebelum rumah itu gedung, atau sama dengan orang jang berkata: kami tidak mau mendjadi ajam, sebelum kami bertelur.

• Apabila sebuah paragraf tepat berakhir pada satu Halaman, tambahkan {{nop}} di akhir paragraf untuk memastikan tidak tersambung saat ditransklusikan.
• Apabila terdapat referensi, gunakan <ref>. Baca Bantuan:Catatan kaki dan catatan akhir.
• Untuk nomor halaman, baca Bantuan:Nomor halaman#Nomor_halaman_pada_ruangnama_Halaman.

Undang-Undang

• {{UU/Head}}
• {{PUU-konsideran}}
• {{persetujuanbersama}} / {{persetujuanDPR}}
• {{PUU-bab}}
• {{PUU-bagian}}
• {{PUU-paragraf}}
• {{PUU-pasal}}
• {{PUU-ayat}}
• {{PUU-nomor}}
• {{UU/PenjelasanHead}}
• {{UU/Penj}}
• {{hii}} jika diperlukan.

Gambar

• Cara pertama, manual menggunakan teks wiki. Contoh: [[Berkas:Gambar.jpg]].
• Cara kedua, menggunakan templat {{img float}}.
• Gunakan CropTool untuk memperoleh gambar dari halaman tertentu.

Tabel

• Cara pertama, manual menggunakan tag html <table>. Tidak disarankan.
• Cara kedua, menggunakan teks wiki yang biasanya diawali dengan {|

Status Halaman

• Tanpa teks apabila Halaman dalam Pindaian tidak memiliki teks atau tulisan apapun, atau halaman kosong. Apabila halaman itu tidak memiliki teks, tapi memiliki gambar yang memenuhi halaman itu, maka memang benar itu tanpa teks, lebih tepatnya halaman gambar sehingga bisa Anda letakkan status "Bermasalah" apabila tidak dimasukkan.
• Belum diuji baca adalah pilihan bawaan, yang pasti terpilih jika Anda membuat suntingan kosong sekalipun. Anda memilih ini apabila hanya membiarkan OCR mengerjakan fungsinya tanpa melakukan pemformatan sama sekali, atau Anda menyimpan sementara suntingan.
• Bermasalah apabila Halaman dalam Pindaian cacat atau Anda tidak menambahkan gambar dan tabel yang seharusnya ada dalam Pindaian. Anda tidak seharusnya mengubah status menjadi telah diuji baca atau bahkan validasi sedangkan gambar yang seharusnya ada malah tidak Anda masukkan.
• Telah diuji baca setelah Anda sangat yakin segalanya sesuai dengan Teks yang ada dalam Pindaian termasuk segala pemformatan, gambar, tabel dan segala yang terkait dengannya.
• Tervalidasi hanya bisa dilakukan oleh orang lain jika Anda yang menyunting dan menguji baca, atau bisa juga Anda jika orang lain yang menyunting dan uji baca.

Utama

Utama atau Halaman dasar adalah segala halaman wiki yang berada di ruang nama Utama. Wikipedia sendiri memiliki istilah "Artikel" untuk halaman seperti ini.

Header

Header adalah Templat yang harus ada dalam setiap Halaman di Ruang nama Utama. Segalanya yang terkait dengan templat ini, bisa dibaca di dokumentasi {{Header}}.

Transklusi

Diutamakan untuk menggunakan tag <pages />.

• index untuk menandakan Indeks mana yang akan ditransklusikan, tanpa ruang nama Indeks sendiri. Contoh index="Berkas.djvu"
• from dari halaman berapa di Pindaian. Contoh from="1"
• to sampai halaman berapa di Pindaian. Contoh to="10"
• include jika hanya ingin memasukkan halaman tertentu. Contoh include=5 atau include="4-6" yang berfungsi sama seperti from="4" to="6"
• exclude untuk mengecualikan halaman tertentu dari transklusi. Contoh exclude="7" atau exclude="7-9"

Contoh keseluruhan: <pages index="Berkas.djvu" from="1" to="10" exclude="8" /> akan menghasilkan transklusi Indeks:Berkas.djvu dari Halaman:Berkas.djvu/1 sampai Halaman:Berkas.djvu/10 dengan mengecualikan Halaman:Berkas.djvu/8.

Selengkapnya, baca Bantuan:Transklusi.

Halaman depan

Halaman depan, atau pendahuluan, adalah bagian pertama dari sebuah buku, dan biasanya bagian terkecil dalam hal jumlah halaman. Halaman biasanya diberi nomor dalam angka Romawi huruf kecil. Setiap halaman dihitung; tetapi tidak ada folio atau nomor halaman yang diungkapkan, atau dicetak, baik pada halaman tampilan, atau halaman kosong.

Halaman depan biasanya akan mencakup halaman judul, halaman hak cipta (dikenal sebagai kolofon), daftar isi, dan mungkin termasuk daftar ilustrasi, dan pengakuan, kata pengantar atau kata pengantar apa pun. Ini mungkin termasuk item seperti frontispiece dan halaman setengah judul. Untuk tujuan Wikisumber, sampul buku dapat dianggap sebagai bagian dari materi depan.

Subhalaman

Subhalaman dapat dikenali oleh garis miring ke depan dalam judul halaman. Ini bekerja seperti url halaman web atau sistem direktori file di komputer. Jika judul halaman adalah Foo / Bar maka halaman "Bar" adalah subhalaman halaman "Foo". Mungkin ada beberapa tingkat subhalaman dan lebih dari satu subhalaman di setiap tingkat. Misalnya:

• Foo
  • Foo/Bar
    • Foo/Bar/Bab 1
    • Foo/Bar/Bab 2
    • Foo/Bar/Bab 3
  • Foo/Baz
    • Foo/Baz/Bab 1
    • Foo/Baz/Bab 2
    • Foo/Baz/Bab 3
    • Foo/Baz/Bab 4
    • Foo/Baz/Bab 5

Foo adalah "halaman dasar" tingkat atas. Bar dan Baz adalah subhalaman Foo. Bar memiliki tiga subhalaman sendiri, bernomor 1 hingga 3. Baz memiliki lima subhalaman sendiri, bernomor 1 hingga 5.

Disambiguasi

Menemukan Karya yang berjudul mirip atau sama, tapi dari Pengarang yang berbeda? Disambiguasi berperan di sini.

Cara membuatnya cukup mudah.

1. Buat halaman di Ruang nama Utama
2. Tambahkan Templat {{disambiguasi}} pada halaman tersebut sebagai header
3. Masukkan semua halaman yang berjudul mirip atau sama dalam bentuk pranala teks wiki, beserta pranala yang mengarah ke Indeks Pindaian jika ada.
4. Menambahkan Templat {{serupa}} pada setiap atas halaman telah Anda masukkan sebelumnya.

Contoh:

• Anggap kita membuat halaman "Kitab Undang-Undang"
• Pada halaman Kitab Undang-Undang, tambahkan (contoh)

{{disambiguasi
|title=Kitab Undang-Undang
}}

• Masih di halaman Kitab Undang-Undang, di bawah templat {{disambiguasi}},

* [[Kitab Undang-Undang Hukum Pidana]] {{ssl|KUHPidana.pdf}}
* [[Kitab Undang-Undang Hukum Perdata]] {{ssl|KUHPerdata.pdf}}
* [[Kitab Undang-Undang Hukum Dagang]] {{ssl|KUHDagang.pdf}}

• Baru di halaman Kitab Undang-Undang Hukum Pidana, Kitab Undang-Undang Hukum Perdata juga Kitab Undang-Undang Hukum Dagang, tambahkan {{serupa|Kitab Undang-Undang}}

Versi

Menemukan Karya yang berjudul sama, bahkan dari Pengarang yang sama, tetapi dalam versi cetakan atau edisi yang berbeda? Itulah tujuan halaman Versi dan menjadi pembeda dari Wikipedia yang hanya memiliki Disambiguasi.

Cara membuatnya juga cukup mudah.

1. Buat halaman di Ruang nama Utama, sama seperti Disambiguasi
2. Tambahkan Templat {{versi}} pada halaman tersebut sebagai header
3. Masukkan semua versi dalam bentuk pranala teks wiki, beserta pranala yang mengarah ke Indeks Pindaian jika ada.
4. Menambahkan Templat {{versi lain}} pada setiap halaman yang versinya telah Anda masukkan sebelumnya.

Contoh:

• Anggap kita membuat "Si Umbut Muda"
• Pada halaman Si Umbut Muda, tambahkan (contoh)

{{versi
|title=Si Umbut Muda
|author=Tulis Sutan Sati
}}

• Masih di halaman Si Umbut Muda, di bawah templat {{versi}},

* [[Tjerita Si Umbut Muda]], versi ejaan lama.
* [[Si Umbut Muda]], versi ejaan baru.

• Baru di halaman Tjerita Si Umbut Muda juga Si Umbut Muda, tambahkan

{{versi lain|Si Umbut Muda}}

Lisensi

Baca Bantuan:Tag hak cipta.

Pengarang

Baca Bantuan:Halaman pengarang dan en:Help:Author pages.

Disambiguasi

Menemukan Pengarang bernama mirip atau sama, saking samanya yang membedakan hanya tahun hidupnya? Disambiguasi berfungsi di sini.

Cara membuatnya cukup mudah.

1. Buat halaman di Ruang nama Pengarang
2. Tambahkan Templat {{disambiguasi}} pada halaman tersebut sebagai header
3. Masukkan semua halaman yang berjudul mirip atau sama dalam bentuk pranala teks wiki, beserta pranala yang mengarah ke Indeks Pindaian jika ada.
4. Menambahkan Templat {{serupa}} pada setiap atas halaman telah Anda masukkan sebelumnya.

Contoh:

• Anggap kita membuat halaman "John"
• Pada halaman John, tambahkan (contoh)

{{disambiguasi
|title=John
}}

• Masih di halaman John, di bawah templat {{disambiguasi}},

* [[John (1819-1910)]]
* [[John (1817-1899]]

• Baru di halaman John (1819-1910), dan John (1817-1899), tambahkan {{serupa|John}}

Glosarium

B

• Belum diuji baca: salah satu status yang merupakan pilihan bawaan, pasti terpilih jika membuat suntingan kosong sekalipun; dipilih apabila hanya membiarkan OCR mengerjakan fungsinya tanpa melakukan pemformatan sama sekali, atau ketika menyimpan sementara suntingan.
• Berkas: Kumpulan data, program, dll., Disimpan dalam memori komputer atau pada perangkat penyimpanan di bawah satu nama identifikasi. Contoh: Berkas.djvu atau Berkas.jpg.
• Bermasalah: salah satu status; menandakan Halaman tersebut memiliki masalah seperti gambar yang ada pada Pindaian dan seharusnya juga ada dalam Naskah tapi tidak ada (gambar hilang) atau tabel yang ada pada Pindaian dan seharusnya juga ada dalam Naskah tapi tidak ada (tabel hilang) atau kecacatan lainnya pada Halaman seperti tidak dapat dibaca karena Berkas sendiri.

E

• Ekspor: Sebuah tindakan menyimpan Karya dari Wikisumber ke dalam bentuk berkas lunak seperti PDF dan MOBI.

G

• Gambar: Lukisan, gambaran, fotograf, atau potret dalam bentuk Berkas.

H

• Halaman: Salah satu Ruang-nama Wikisumber; satu sisi selembar kertas dalam koleksi lembaran terikat bersama-sama, terutama sebagai buku, majalah, atau surat kabar; lihat juga Utama dan Halaman dasar.

Halaman dasar: Halaman tingkat atas untuk setiap pekerjaan. Biasanya ini mungkin berisi daftar isi dengan link ke setiap subhalaman. Ini mungkin juga berisi materi depan dari karya asli, seperti halaman judul, frontispiece, dan sebagainya.

• HTML, "Hyper Text Markup Language", yang merupakan format yang semua halaman Wikisumber dikonversi ketika ditampilkan oleh peramban. Halaman itu sendiri ditulis dan disimpan sebagai Teks wiki, peladen web Wikisumber mengubah ini menjadi HTML.

I

• Indeks: Salah satu Ruang-nama Wikisumber; catatan (judul, pengarang, dll) pada Berkas.
• Indentasi: Awal (baris Teks) atau posisi (blok Teks) lebih jauh dari tepi atau perbatasan daripada bagian utama teks.

K

• Karya: hasil jadi dari uji-baca Indeks; selayaknya Artikel dalam Wikipedia

N

• Naskah: Lihat Teks.

P

• Pemformatan: mengatur atau dimasukkan ke dalam format dengan menggunakan Teks wiki, HTML, atau Templat.
• Pengarang
• Pindaian: bentuk digital yang telah dikonversi dari dokumen atau gambar untuk penyimpanan atau pemrosesan di komputer berupa Berkas.

R

• Ruang kerja: Ruang nama Indeks dan Halaman tempat Uji baca berlangsung. Area ruang belakang Wikisumber di mana pekerjaan berlangsung tetapi bukan lokasi akhir pekerjaan (itu akan dialihkan ke Ruang utama ketika telah dikoreksi).
• Ruang nama: Bagian atau area terpisah dari Wikisumber. Ini biasanya dapat dilihat sebagai awalan untuk nama halaman (misalnya, "Pengguna" dalam nama halaman "Pengguna:Mnafisalmukhdi1").
• Ruang utama: Lihat Utama.

S

• Sumber: Lihat Pindaian.
• Status: Lihat Status halaman.
• Status halaman: situasi Halaman pada waktu tertentu selama proses Uji baca.
• Subhalaman: Setiap halaman di bawah halaman dasar, berisi bab atau unit lain dari Karya.

T

• Tag: Elemen dalam kode yang terlihat seperti ini: <tag>. Terkadang tag adalah HTML, dan terkadang mereka adalah tag khusus yang ditangani oleh peladen Wikisumber.
• Teks: Tubuh utama buku atau tulisan lainnya, berbeda dari materi lain seperti catatan, lampiran, dan ilustrasi.
• Teks wiki: Kode yang digunakan untuk memasukkan konten ke Wikisumber. Ini adalah kombinasi dari mark-up khusus dan HTML.
• Templat: Bagian khusus dari Teks-wiki yang "mengembang" menjadi bagian konten yang telah ditentukan sebelumnya. Sering digunakan untuk memformat dan menghubungkan dalam Wikisumber untuk mengurangi kode berulang. Mereka menggunakan kurung kurawal atau kawat gigi ganda dan {{terlihat seperti ini}}
• Teruji baca: Status perantara dari sebuah karya di Wikisumber. Sebuah pekerjaan yang telah diperiksa dan diperbaiki oleh satu pengguna. Diwakili oleh warna kuning di indikator Status halaman dan di Ruang kerja.
• Tervalidasi: Status akhir dari sebuah karya di Wikisumber. Sebuah pekerjaan yang telah diperiksa dan dikoreksi oleh setidaknya dua pengguna yang terpisah. Diwakili oleh warna hijau di indikator Status halaman dan di Ruang kerja.
• Transklusi: Memasukkan teks atau template dari satu halaman ke halaman lainnya. Templat ditransklusi ke halaman lain. Halaman di Ruang-nama Halaman dialihkan ke ruang nama utama (ini adalah bagaimana teks Teruji baca ditransfer ke sana).

U

• Uji baca: Tindakan memeriksa dan mengubah teks dengan melakukan Pemformatan jika diperlukan.
• Utama: Singkatan dari Ruang Utama dan/atau Ruang-nama Utama, bagian dari Wikisumber yang berisi karya dan teks.

V

• Validasi: Tindakan memeriksa teks Teruji baca untuk mengkonfirmasi bahwa itu benar, termasuk memastikan kebenaran Teks dan Gambar beserta Pemformatan jika ada.