Bantuan:Daftar

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page Help:Lists and the translation is 100% complete.
Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎català • ‎español • ‎français • ‎polski • ‎português • ‎slovenčina • ‎suomi • ‎svenska • ‎русский • ‎العربية • ‎中文 • ‎日本語 • ‎한국어
PD Catatan: Ketika Anda menyunting halaman ini, Anda setuju untuk melepas kontribusi Anda di bawah CC0. Lihat Halaman Bantuan Domain Publik untuk informasi selengkapnya.
PD

Halaman ini membahas mengenai pembuatan daftar dalam MediaWiki.

Dasar-dasar daftar

MediaWiki menawarkan tiga jenis daftar: daftar berurut, daftar tidak berurut, dan daftar definisi. Dalam bagian-bagian berikut, daftar berurut akan digunakan sebagai contoh. Daftar tidak berurut akan memberikan hasil yang serupa.

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 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

Paragraf 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. Dua simbol pengakhir baris, <br /><br />, akan menghasilkan pengaruh yang diinginkan. Begitu pula membungkus semua paragraf kecuali yang pertama dengan <p>...</p>.

Untuk daftar dengan butir-butir yang lebih panjang dari satu paragraf, menambahkan sebuah baris kosong di antara butir disarankan untuk menghindari kebingungan.

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.

<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:

#butir daftar A1
##butir daftar B1
###butir daftar C1
##:terusan butir daftar A1
##butir daftar B2
#butir daftar A2

menghasilkan

  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.

It is possible to embed unnumbered bullets inside enclosing numbered items:

# list item A
#* nested bullet A1
#* nested bullet A2
# continuing list item B
#* nested bullet B1
#* nested bullet B2

gives

  1. list item A
    • nested bullet A1
    • nested bullet A2
  2. continuing list item B
    • nested bullet B1
    • nested bullet B2

Mengubah jenis 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

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 kolom: untuk masing-masing kolom). 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 definisi 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;-moz-column-count:2;-webkit-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;-moz-column-count:3;-webkit-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;-moz-column-count:3;-webkit-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>bb<li>ccc</ol></ul>
|<ul><ol start="128"><li>ddd<li>ee<li>f</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 manapun.

Lihat pula Kapan 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