Bantuan:Konvensi bentuk

←

Konvensi Bentuk

→

Konvensi pemformatan standar yang digunakan untuk Uji-Baca di Wikisource.

Konvensi berikut dianggap sebagai praktik terbaik untuk halaman di Halaman: namespace (file DjVu, PDF, dan file lain yang menggunakan ekstensi Halaman Uji-Baca).

Running headers sunting

Kop dan kaki halaman yang dipindai sering kali menyertakan nomor halaman dan judul, yang bukan transklusi. Tempatkan informasi ini di kotak edit kop dan kaki, diakses dengan mengklik yang muncul di atas jendela edit, di bagian Peralatan Uji Baca.

Template {{RunningHeader}} berguna untuk memformat header ini, dan digunakan sebagai berikut:

{{RunningHeader|left=|center=|right=}}
Teks di kiri, tengah, atau kanan akan muncul pada baris yang sama.
Judul gaya lima entri, seperti yang muncul di ensiklopedia dan kamus tertentu dapat dimasukkan dengan {{rh/5}}

Jeda Baris sunting

Hapus tanda hubung akhir dan jeda baris.

Lembusura adalah patih negara Gua⏎
Kiskenda di bawah kekuasaan⏎
pemerintahan Prabu Maesasura.⏎
...

Lembusura adalah patih negara Gua Kiskenda di bawah kekuasaan pemerintahan Prabu Maesasura....

Untuk memulai paragraf baru, halaman MediaWiki menggunakan dua jeda baru (yaitu, tekan dua kali enter dan biarkan satu baris kosong):

...ini adalah akhir dari satu paragraf.

Ini adalah awal dari paragraf berikutnya ...

Puisi dan teks lain yang disajikan berdasarkan baris demi baris harus dipertahankan jeda barisnya. Lihat H:PUISI untuk cara memformatnya.

Kata-kata di akhir halaman dengan tanda penghubung sunting

Ketika sebuah kata dibubuhi tanda hubung ke dua halaman pemindaian yang berurutan, perangkat lunak akan secara otomatis menghapus tanda hubung dan menggabungkan kata-kata tersebut saat ditransklusikan ke dalam ruang nama utama.
Halaman pertama: Lembusura adalah patih negara Gua Kiskenda di ba-

Halaman kedua: wah kekuasaan pemerintahan Prabu Maesasura.

Hasil akhir (setelah ditransklusikan di dalam ruang nama utama: "Lembusura adalah patih negara Gua Kiskenda di bawah kekuasaan pemerintahan Prabu Maesasura."
- Catatan: Beberapa karya lama menggunakan template {{hws}} dan {{hwe}}: ini tidak lagi diperlukan untuk halaman yang baru dibuat.
Jika mengharapkan untuk tidak menggabungkan kalimat (seperti dalam kalimat mondar-mandir), dapat menggunakan {{peh}} (alias {{page end hyphen}}) dan perangkat lunak tidak akan menggantinya:
Halaman pertama: Saat pandemi tidak ada warga masyarakat yang mondar{{peh}}

Halaman Kedua: mandir seperti biasanya.

Hasil akhir: "Saat pandemi tidak ada warga masyarakat yang mondar-mandir seperti biasanya."
Jika sebuah tautan melewati jeda halaman, gunakan {{lps}} dan {{lpe}}. Lihat dokumentasi template tersebut untuk berbagai kasus yang didukungnya.

Akhir paragraf yang berada di akhir halaman sunting

Jika paragraf berakhir di bagian bawah pemindaian halaman dan paragraf baru di bab yang sama akan dimulai di halaman berikutnya, tambahkan {{nop}} di bagian bawah halaman (pada barisnya sendiri) untuk memaksa jeda dalam teks. Jika tidak, ketika halaman ditransklusi, pemisahan antara dua halaman akan diperlakukan sebagai spasi tunggal dan bukan baris baru.

Templat sunting

Lihat pula: Bantuan:Templat

gunakan template Standard sebagai ganti jenis markup lainnya, memberikan Wikisource perlindungan dari perubahan eksternal yang tidak diinginkan. misal: Menggunakan {{right}} sebagai ganti <p align="right">.
- Jika Anda perlu menunjukkan bahwa kata/frasa harus dalam ukuran Small Caps, gunakan template {{small-caps}}.
- Jika anda perlu menunjukkan kata/frasa harus dalam ukuran lebih kecil (atau lebih besar), gunakan templat {{smaller}} If you need to indicate a word/phrase should be in a smaller (or larger) font, use the {{smaller}} template. Demikian pula, {{xx-smaller}}, {{x-smaller}}, {{larger}}, {{x-larger}}, {{xx-larger}} , dan templat {{font-size}} dapat digunakan untuk mengubah ukuran teks.

Catatan kaki sunting

Footnotes Seperti halnya di wikipedia, setiap buku pasti akan memuat catatan kaki. Untuk menuliskannya memerlukan templat <ref></ref> dan <references/> ( atau {{smallrefs}} ). Untuk templat {{reflist}} hanya tanda bagi penulis dan ruang nama utaman.

Penanda usang sunting

Beberapa markup sudah usang dalam HTML modern dan pada akhirnya akan dihapus dari browser dan MediaWiki. Ini bukan keputusan MediaWiki atau Wikisource: konstruksi HTML tidak digunakan lagi oleh badan standar web resmi, W3C.

Secara umum, ada dua jenis yang dianggap usang dan kemudian di hapus:

Tag usang (tag terlihat seperti <ini>) yang mewakili konten "non-semantik" dan lebih tepat dilakukan menggunakan tag dan gaya yang bermakna secara semantik melalui CSS

Dalam beberapa kasus, misalnya, dalam ekspor EPUB, HTML yang tidak digunakan lagi dapat menyebabkan masalah klien dan eksporter akan mencoba menghapus kode yang bermasalah dan menggantinya dengan upaya pengganti terbaik. Ini tidak selalu berhasil.

Beberapa penolakan yang umum, dan resolusinya

Tag HTML usang. Penggunaan pemicu tag ini.
- <poem>: untuk konten yang berbentuk puisi
- <center>: untuk rata tengah, di Wikisource bahasa Indonesia dianjurkan memakai {{center}}
- <big>: untuk memperbesar huruf, di Wikisource bahasa Indonesia dianjurkan memakai {{larger}}
- <small>: untuk memperkecil huruf, di Wikisource bahasa Indonesia dianjurkan memakai {{smaller}}
- <font>: memakai templat seperti {{blackletter}}, {{red}}, dll, yang paling sesuai
- <tt>: memakai {{monospace}}

penggunaan align atribut ini juga tidak digunakan dan harus diganti dengan atribut CSS:
- untuk memposisikan tabel ^[1]
  - align=center: gunakan style="margin: auto;"
  - align=left/right: gunakan style="margin-right/margin-left: auto;" (batas di sisi kosong tabel)
  - align=left/right: gunakan style="float: left/right;" (ini memungkinkan konten untuk mengambang diantara tabel)
- untuk meratakan teks (misal untuk tabel cell^[2]:
  - align=left/center/right: gunakan style="text-align: left/center/right;"
Penggunaan atribut valign sebaiknya digantikan dengan CSS^[3]:
- valign=top → vertical-align: top;
- valign=middle → vertical-align: middle;
- valign=bottom → vertical-align: bottom;
'atribut spesifik lainnya yang digunakan untuk tabel, kini sudah tidak digunakan lagi ^[4]:
- width: gunakan CSS width
- frame: gunakan CSS border
- cellpadding: gunakan CSS padding pada cells, dan atur border-collapse: collapse
- cellspacing: gunakan CSS border-spacing and do not border-collapse (keduanya dipraktekkan untuk tabel, bukan untuk cell)
- bgcolor: gunakan CSS background-color

Penandaan sunting

Beberapa tapi tidak semuanya, penghapusan secara otomatis ditandai dengan edit filter. Jika hasil edit Anda diberi tag demikian, Anda mungkin ingin menyesuaikan konten untuk menghindari konstruksi yang tidak digunakan lagi. Anda tidak harus melakukannya, tetapi ini akan menghindari pembuatan backlog jika/ketika penghentian tersebut menyebabkan masalah teknis di masa mendatang. Perubahan terbaru dengan tag ini dapat dilihat di sini. Sterkadang, hasil edit Anda mungkin diberi tag bukan karena kontribusi Anda, tetapi karena kode usang yang sudah ada sebelumnya.

Notes sunting

[1] ttps://developer.mozilla.org/en-US/docs/Web/HTML/Element/table#attr-align

[2] ttps://developer.mozilla.org/en-US/docs/Web/HTML/Element/td#attr-align

[3] tables, in table cells

[4] ttps://developer.mozilla.org/en-US/docs/Web/HTML/Element/table#attributes

[1]

[2]

[3]

[4]