Bantuan:Daftar

From mediawiki.org
This page is a translated version of the page Help:Lists and the translation is 99% complete.
Outdated translations are marked like this.
PD Catatan: Ketika Anda menyunting halaman ini, Anda setuju untuk melepas kontribusi Anda di bawah CC0. Lihat Laman Bantuan Domain Publik untuk informasi lebih lanjut.
Beberapa revisi lama untuk halaman ini telah diimpor di bawah lisensi CC BY-SA. Hanya kontribusi baru yang DP.
PD

Halaman ini membahas mengenai pembuatan daftar dalam MediaWiki.

Dasar-dasar daftar

MediaWiki menawarkan tiga jenis daftar: daftar tidak berurut, daftar berurut, dan daftar deskripsi atau definisi.

Pada dasarnya

Daftar tak berurut
Setiap butir diletakkan di baris baru dengan diawali sebuah tanda bintang * contoh: * butir.
Daftar berurut
Setiap butir diletakkan di baris baru dengan diawali sebuah tanda pagar # contoh: # butir.
Daftar definisi
Setiap butir punya dua bagian: istilah dan deskripsi
Istilah diletakkan di baris baru dengan diawali sebuah tanda titik koma ; contoh: ; istilah.
Deskripsi mengikutinya di baris yang sama setelah tanda titik dua : contoh: ; istilah : deskripsi,
atau deskripsi berada di barisnya sendiri, diawali dengan tanda titik dua : contoh: : deskipsi (bisa ada beberapa deskripsi per istilah, setiap deskripsi diawali dengan tanda titik dua di garis baru).

Sedikit lagi

Di tabel berikut, Anda akan menemukan beberapa contoh untuk masing-masing metode:

Teks wiki Tampilan
* Daftar mudah dibuat:
** awali setiap baris
* dengan tanda bintang
** lebih banyak bintang berarti 
*** tingkatannya lebih tinggi
  • Daftar mudah dibuat:
    • awali setiap baris
  • dengan tanda bintang
    • lebih banyak bintang berarti
      • tingkatannya lebih tinggi
* Sebuah baris baru
* dalam suatu daftar
menandai akhir dari daftar.
Tentu saja
* Anda bisa
* memulainya lagi.
  • Sebuah baris baru
  • dalam suatu daftar

menandai akhir dari daftar. Tentu saja

  • Anda bisa
  • memulainya lagi.
# Daftar bernomor barus
## sangat teratur
## mudah diikuti
  1. Daftar bernomor barus
    1. sangat teratur
    2. mudah diikuti
* Anda juga bisa
** memecah baris
** seperti ini
  • Anda juga bisa
    • memecah baris
    • seperti ini
; Daftar deskripsi atau definisi
; istilah : definisi
; titik koma plus istilah
: titik dua plus definisi
Daftar definisi
istilah
definisi
titik koma plus istilah
titik dua plus definisi
; Daftar definisi campuran
; item 1 : definisi
:; sub-item 1 plus istilah
:: dua titik dua plus definisi
:; sub-item 2 : titik dua plus definisi
; item 2
: kembali ke daftar utama
Daftar definisi campuran
item 1
definisi
sub-item 1 plus istilah
dua titik dua plus definisi
sub-item 2
titik dua plus definisi
item 2
kembali ke daftar utama
* Atau membuat daftar campuran
*# dan menyarangkan mereka
*#* seperti ini
*#*; definisi
*#*: bekerja:
*#*; apel
*#*; pisang
*#*: buah-buahan
  • Atau membuat daftar campuran
    1. dan menyarangkan mereka
      • seperti ini
        definisi
        bekerja:
        apel
        pisang
        buah-buahan

Beberapa baris dalam daftar

Demi kesederhanaan, butir suatu daftar dalam markah wiki tidak bisa lebih panjang daripada satu paragraf. Garis kosong berikutnya akan mengakhiri daftar dan memulai ulang penghitung di daftar berurut. Memisahkan butir-butir daftar tidak berurut biasanya tidak menghasilkan efek yang mencolok.

Paragraf-paragraf bisa dipaksakan dalam daftar dengan menggunakan tag HTML. Jika Anda ingin menambahkan lebih dari satu baris teks, tambahkan dua simbol pengakhir baris, <br /><br />, dan Anda akan mendapatkan hasil yang diinginkan. Membungkus semua paragraf di dalam ‎<p>...‎</p> akan membuat teks tersebut diletakkan di paragraf baru, yang dimulai di baris baru ketika ditampilkan.

Melanjutkan suatu butir daftar setelah sebuah sub-bitur

Dalam HTML, butir daftar bisa berisi beberapa subdaftar, yang tidak harus bersebelahan; sehingga bisa ada bagian dari butir daftar yang tidak berada sebelum subdaftar pertama, melainkan juga di antara dua subdaftar, maupun setelah subdaftar terakhir. Akan tetapi, dalam sintaks wiki, subdaftar mengikuti aturan yang sama dengan bagian halaman: satu-satunya bagian untuk butir daftar di luar subdaftar adalah sebelum subdaftar pertama.

Dalam kasus daftar tak bernomor tingkat pertama dalam kode teks wiki, batasan ini bisa diatasi dengan memisahkan daftar menjadi beberapa daftar; teks yang diindentasi di antara dua daftar parsial bisa dilihat sebagai bagian dari butir daftar yang diletakkan setelah sebuah subdaftar; akan tetapi, ini bisa memberikan, tergantung CSS-nya, sebuah baris kosong sebelum dan sesudah masing-masing daftar, yang apabila begitu, untuk keseragaman, setiap butir daftar tingkat pertama bisa dijadikan daftar yang terpisah.

Daftar bernomor akan menunjukkan bahwa apa yang seharus tampak seperti satu daftar sebenarnya, bagi perangkat lunak, terdiri dari beberapa daftar; daftar tidak bernomor memberikan hasil yang serupa, tetapi masalah mulai-kembali-dari-1 tidak akan terjadi.

Teks wiki Tampilan
<ol>
  <li>butir daftar A1
    <ol>
      <li>butir daftar B1</li>
      <li>butir daftar B2</li>
    </ol>terusan butir daftar A1
  </li>
  <li>butir daftar A2</li>
</ol>
  1. butir daftar A1
    1. butir daftar B1
    2. butir daftar B2
    terusan butir daftar A1
  2. butir daftar A2
vs.
#butir daftar A1
##butir daftar B1
##butir daftar B2
#:terusan butir daftar A1
#butir daftar A2
  1. butir daftar A1
    1. butir daftar B1
    2. butir daftar B2
    terusan butir daftar A1
  2. butir daftar A2

Satu tingaktan lagi, dengan butir subdaftar diletakkan setelah sebuah sub-subdaftar, akan dihasilkan lebih banyak baris kosong; akan tetapi, lanjutan dari daftar tingkat-pertama tidak dipengaruhi:

Teks wiki Tampilan
#butir daftar A1
##butir daftar B1
###butir daftar C1
##:terusan butir daftar A1
##butir daftar B2
#butir daftar A2
  1. butir daftar A1
    1. butir daftar B1
      1. butir daftar C1
      terusan butir daftar A1
    2. butir daftar B2
  2. butir daftar A2

Lihat pula m:Template:List demo.

Daftar tak berurut bisa dimasukkan di dalam butir-butir daftar bernomor:

Teks wiki Tampilan
# list item A
#* nested bullet A1
#* nested bullet A2
# continuing list item B
#* nested bullet B1
#* nested bullet B2
  1. list item A
    • nested bullet A1
    • nested bullet A2
  2. continuing list item B
    • nested bullet B1
    • nested bullet B2

Mengubah jenis daftar

Per daftar

Jenis daftar (jenis penanda mana yang ditampilkan sebelum suatu butir daftar) bisa diubah dalam CSS dengan mengatur properti list-style-type:

Teks wiki Tampilan
<ol style="list-style-type:lower-roman">
  <li>Mengenai penulis</li>
  <li>Kata pengantar edisi pertama</li>
  <li>Kata pengantar edisi kedua</li>
</ol>
  1. Mengenai penulis
  2. Kata pengantar edisi pertama
  3. Kata pengantar edisi kedua
<ol style="list-style-type:lower-alpha">
  <li>Mengenai penulis</li>
  <li>Kata pengantar edisi pertama</li>
  <li>Kata pengantar edisi kedua</li>
</ol>
  1. Mengenai penulis
  2. Kata pengantar edisi pertama
  3. Kata pengantar edisi kedua

Untuk seluruh situs

Teks wiki standar #, ##, ### bisa disesuaikan dengan CSS di MediaWiki:Common.css untuk menghasilkan sistem daftar bernomor yang biasa (1, 2, 3; lalu a, b, c; lalu i, ii, iii):

ol { 
	list-style-type: decimal; 
}
ol li > ol { 
	list-style-type: lower-alpha; 
}
ol li > ol li > ol { 
	list-style-type: lower-roman; 
}

ol pertama di atas adalah format yang standar sehingga tidak dibutuhkan kecuali list-style-type lain ingin digunakan.

Teks wiki Tampilan
#list item A1
##list item B1
###list item C1
###list item C2
##list item B2
#list item A2
  1. list item A1
    1. list item B1
      1. list item C1
      2. list item C2
    2. list item B2
  2. list item A2

Indentasi tambahan untuk daftar

Dalam daftar bernomor dalam fon yang besar, beberapa peramban tidak menampilkan lebih dari dua digit, kecuali diterapkan indentasi tambahan (jika terdapat beberapa tanda titik dua: untuk masing-masing tanda titik dua). Ini bisa dilakukan dengan CSS:

ol { margin-left: 2cm}

atau alternatifnya, seperti berikut.

Teks wiki Tampilan Komentar
:#abc
:#def
:#ghi
 
  1. abc
  2. def
  3. ghi
Daftar berisi satu atau lebih baris yang dimulai dengan tanda titik dua menghasilkan daftar deskripsi tanpa istilah yang didefinisikan, dan dengan butiran sebagai deskripsi definisi, makanya diindentasikan. Akan tetapi, jika titik duanya ada di depan kode "*" atau "#" dari daftar tidak berurut atau berurut, daftarnya diperlakukan sebagai satu deskripsi definisi, jadi seluruh daftarnya diindentasi.
<ul>
  <ol>
    <li>abc</li>
    <li>def</li>
    <li>ghi</li>
  </ol>
</ul>
    1. abc
    2. def
    3. ghi
MediaWiki menerjemahkan daftar tidak berurut (ul) tanpa butir daftar (li) apapun menjadi sebuah div dengan style="margin-left: 2em", menyebabkan indentasi kontennya. Ini adalah metode yang paling leluwasa, karena memungkinkan memulai dengan nomor selain 1, lihat di bawah.
<ul>
#abc
#def
#ghi
</ul>
    1. abc
    2. def
    3. ghi
Seperti di atas, dengan konten dari "daftar tidak berurut tanpa butir daftar apapun", yang sendirinya merupakan daftar berurut, diekspresikan dengan kode #. HTML menghasilkan, dan menampilkan, hasil yang sama. Ini adalah metode yang disarankan ketika memulai daftar dari 1.

Untuk mendemonstrasikan bahwa ketiga metode tersebut menunjukkan semua digit dari bilangan 3-digit, lihat demo Daftar.

Menetapkan nilai permulaan

Menetapkan nilai permulaan bisa dilakukan dengan sintaks HTML.

<ol start="9">
<li>Amsterdam</li>
<li>Rotterdam</li>
<li>Den Haag</li>
</ol>
  1. Amsterdam
  2. Rotterdam
  3. Den Haag

Atau:

<ol>
<li value="9">Amsterdam</li>
<li value="8">Rotterdam</li>
<li value="7">Den Haag</li>
</ol>
  1. Amsterdam
  2. Rotterdam
  3. Den Haag

Perbandingan dengan tabel

Selain memberikan penomoran otomatis, daftar bernomor juga meratakan isi butir-butirnya, bisa dibandingkan dengan menggunakan sintaks tabel:

{|
|-
| align=right |  9.|| Amsterdam
|-
| align=right | 10.|| Rotterdam
|-
| align=right | 11.|| Den Haag
|}

menghasilkan:

9. Amsterdam
10. Rotterdam
11. Den Haag

Penomoroan tidak otomatis ini punya keuntungan yaitu apabila teks mengacu pada nomor, pemasukkan atau penghapusan suatu butir tidak mengganggu penyocokannya.

Daftar multikolom

Lihat pula Template:Col-begin, Template:Col-break, Template:Col-end.

Daftar berbulet multikolom

<div style="column-count:2">
* antah-berantah
* apel
* karpet
* kasar
* geografi
* gunung
* prangko
* roti
</div>

menghasilkan:

  • antah-berantah
  • apel
  • karpet
  • kasar
  • geografi
  • gunung
  • prangko
  • roti
<div style="column-count:3">
* antah-berantah
* apel
* karpet
* kasar
* geografi
* gunung
* prangko
* roti
</div>

menghasilkan:

  • antah-berantah
  • apel
  • karpet
  • kasar
  • geografi
  • gunung
  • prangko
  • roti

Daftar bernomor multikolom

<div style="column-count:3">
#antah-berantah
#apel
#karpet
#kasar
#geografi
#gunung
#prangko
#roti
</div>

menghasilkan:

  1. antah-berantah
  2. apel
  3. karpet
  4. kasar
  5. geografi
  6. gunung
  7. prangko
  8. roti

Dalam contoh berikut nilai permulaannya ditentukan dengan sintaks HTML (untuk kolom pertama sintaks wiki maupun sintaks HTML bisa digunakan).

Dengan digabungkan dengan indentasi tambahan yang dijelaskan di bagian sebelumnya:

{| valign="top"
|-
|<ul><ol start="125"><li>a</li><li>bb</li><li>ccc</li></ol></ul>
|<ul><ol start="128"><li>ddd</li><li>ee</li><li>f</li></ol></ul>
|}

menghasilkan

    1. a
    2. bb
    3. ccc
    1. ddd
    2. ee
    3. f

Menggunakan m:Template:multi-column numbered list penghitungan nilai permulaan bisa diotomatiskan, dan hanya nilai permulaan pertama dan banyak butir di masing-masing kolom selain yang terakhir yang perlu ditentukan. Menambahkan butir, atau menghapusnya dari kolom hanya memerlukan penyesuaian satu bilangan, banyak butir dalam kolom itu, bukannya mengubah semua bilangan permulaan untuk setiap kolom berikutnya.

{{Multi-column numbered list|125|a<li>bb<li>ccc|3|<li>ddd<li>ee<li>f}}

menghasilkan:

    1. a
    2. bb
    3. ccc
    1. ddd
    2. ee
    3. f
{{Multi-column numbered list|lst=lower-alpha|125|a<li>bb<li>ccc|3|<li>ddd<li>ee|2|<li>f}}

menghasilkan:

    1. a
    2. bb
    3. ccc
    1. ddd
    2. ee
    1. f
{{Multi-column numbered list|lst=lower-roman|125|a<li>bb<li>ccc|3|<li>ddd<li>ee|2|<li>f}}

menghasilkan:

    1. a
    2. bb
    3. ccc
    1. ddd
    2. ee
    1. f
{{Multi-column numbered list|lst=disc||a<li>bb<li>ccc||<li>ddd<li>ee||<li>f}}

menghasilkan:

    1. a
    2. bb
    3. ccc
    1. ddd
    2. ee
    1. f

Gaya dipersingkat atau gaya horizontal

Pembuatan daftar yang pendek bisa dilakukan dengan pemformatan yang sangat mendasar, misalnya:

''Judul daftar:'' contoh 1, contoh 2, contoh 3

Judul daftar: contoh 1, contoh 2, contoh 3

Gaya ini memerlukan lebih sedikit ruang di halaman, dan lebih disarankan apabila hanya terdapat sedikit entri dalam daftar, bisa dibaca dengan mudah, dan tidak memerlukan titik penyuntingan langsung. Butir-butir daftar seharusnya dimulai dengan huruf kecil kecuali mereka merupakan nama diri.

Tabel

Tabel satu kolom tampak mirip dengan sebuah daftar, tapi tabel memungkinkan pengurutan. Jika teks wikinya sendiri sudah diurutkan dengan kata kunci yang sama, keuntungan ini tidak berlaku. Tabel multikolom memungkinkan pengurutan di kolom mana pun.

Lihat pula Kapan sebaiknya menggunakan tabel.

Mengubah daftar tidak berurut menjadi berurut

Dengan CSS

ul { list-style: decimal }

daftar tidak berurut diubah menjadi berurut. Ini berlaku (sejauh yang tidak dibatasi selector CSS) kepada semua ul-lists di kode sumber HTML:

  • yang dihasilkan menggunakan *
  • yang memiliki ‎<ul> di teks wikinya
  • yang dihasilkan oleh sistem

Karena masing-masing halaman istimewa, seperti halaman lainnya, memiliki kelas sesuai nama halamannya, Anda bisa menetapkan secara terpisah untuk masing-masing jenis daftar apakah daftarnya diurutkan atau tidak, lihat Kontribusi pengguna dan Pranala balik.

Namun, kelihatannya tidak mungkin menjadikan semua daftar riwayat halaman berurut (kecuali Anda menjadikan semua daftar berurut), karena nama kelasnya didasarkan pada halaman yang riwayatnya dibaca.

Lihat pula