Help:Kutip

Pengutipan memberikan kemungkinan untuk menambah catatan kaki dalam sebuah halaman.

Lihat Extension:Cite untuk detail teknis.

Penggunaan

Konsep dasar dari tag <ref> adalah memasukkan teks yang dikelilingi oleh tag ref sebagai catatan kaki dalam bagian yang ditentukan, yang Anda tandai dengan tag placeholder <references />. Format ini tidak bisa digunakan secara tertukar dengan format yang lama—Anda harus memilih salah satu saja.

Tag placeholder tambahan <references /> bisa dimasukkan ke dalam teks, dan semua tag <ref> sebelum titik itu, dalam kelompok itu, akan dimasukkan di sana.

Jika Anda lupa memasukkan <references /> dalam artikel, catatan kakinya tidak akan menghilang, melainkan ditampilkan di ujung halaman.

Halaman ini menggunakan catatan kaki, seperti yang digunakan di akhir kalimat ini. Jika Anda membaca sumber halaman ini dengan cara menekan "Sunting halaman ini", Anda bisa melihat contoh bekerjanya catatan kaki.

Teks wiki	Tampilan
The Sun is pretty big.<ref>E. Miller, ''The Sun'', (New York: Academic Press, 2005), 23–5.</ref> The Moon, however, is not so big.<ref>R. Smith, "Size of the Moon", ''Scientific American'', 46 (April 1978): 44–6.</ref> ==Catatan== <references />	The Sun is pretty big. The Moon, however, is not so big. Catatan

Multiple uses of the same footnote

To give a footnote a unique identifier, use <ref name="name">. You can then refer to the same footnote again by using a ref tag with the same name. The text inside the second tag doesn't matter, because the text already exists in the first reference. You can either copy the whole footnote, or you can use a terminated empty ref tag that looks like this: <ref name="name" />.

In the following example, the same source is cited three times.

Teks wiki

Hasil

Ini adalah contoh beberapa referensi ke catatan kaki yang sama.<ref name="multiple">Ingatlah bahwa ketika Anda mengacu pada catatan kaki yang sama beberapa kali, teks dari referensi yang pertamalah yang digunakan.</ref> Referensi seperti ini khususnya berguna ketika mengutip sumber, jika beberapa pernyataan berasal dari sumber yang sama.<ref name="multiple" /> Semua tag yang digunakan lagi sebaiknya tidak berisi konten tambahan, itu akan menyebabkan galat. Hanya gunakan tag kosong dalam peran ini. Cara ringkas untuk membuat beberapa referensi adalah menggunakan tag ref kosong, yang memiliki garis miring di ujungnya. Meskipun ini bisa mengurangi pekerjaan yang berulang, tolong perhatikan bahwa apabila seorang penyunting di masa mendatang menghapus referensi yang pertama, ini akan menyebabkan hilangnya semua referensi yang menggunakan tag ref kosong.<ref name="multiple" /> ==Catatan== <references />

This is an example of multiple references to the same footnote. Referensi seperti ini khususnya berguna ketika mengutip sumber, jika beberapa pernyataan berasal dari sumber yang sama. Semua tag yang digunakan lagi sebaiknya tidak berisi konten tambahan, itu akan menyebabkan galat. Hanya gunakan tag kosong dalam peran ini. Cara ringkas untuk membuat beberapa referensi adalah menggunakan tag ref kosong, yang memiliki garis miring di ujungnya. Meskipun ini bisa mengurangi pekerjaan yang berulang, tolong perhatikan bahwa apabila seorang penyunting di masa mendatang menghapus referensi yang pertama, ini akan menyebabkan hilangnya semua referensi yang menggunakan tag ref kosong. Catatan

Perhatikan bahwa pengenal yang digunakan di atribut name memerlukan karakter alfabet; hanya menggunakan nomor akan menghasilkan pesan galat. Tanda kutipnya opsional kecuali namanya mengandung spasi, tanda baca atau tanda lainnya. Disarankan untuk menyederhanakan nama dan hanya menggunakan karakter ASCII.

Tag <references />

Tag <references /> memasukkan teks dari semua kutipan yang didefinisikan sebelumnya menggunakan tag <ref>. Contohnya, berdasarkan kutipan di atas, harusnya terdapat referensi untuk kelompok note.

Teks wiki	Hasil
<references group="note"/>

Daftar referensi bisa memiliki lebar yang responsif. Dalam kasus itu, atribut responsive digunakan untuk mengonfigurasi perilakunya. Di wiki-wiki dengan konfigurasi bawaan, ini terjadi di setiap halaman; di wiki lainnya, Anda perlu mengaktifkannya.

Dalam beberapa edisi bahasa Wikipedia, daftar referensi yang panjang bisa diletakkan menggunakan templat {{Reflist}}, yang berisi <references />. Templat tersebut menyediakan parameter opsional untuk menampilkan daftar referensinya dalam beberapa kolom. Contohnya, Wikipedia bahasa Inggris, Hindi dan Interlingua menggunakan selector CSS references-small untuk membuat teks referensi lebih kecil daripada teks normal.

Menggunakan templat dengan cara ini sangat tidak disarankan, untuk alasan kompatibilitas, performa, dan fungsionalitas.

Jika halaman mengandung lebih dari satu daftar <references />, setiap daftar berisi tag-tag <ref> yang didefinisikan setelah daftar referensi sebelumnya. Jika daftar-daftar referensi ini dibuat oleh templat, setiap daftar mendaftarkan tag ref yang didefinisikan sebelum daftar referensi pertama, dan muncul pesan galat yang mengatakan bahwa terdapat tag ref tapi bukan daftar referensi.

Referensi berkelompok

Ini bisa dimatikan dengan $wgAllowCiteGroups = false; jika diinginkan.

Contoh berikut menghasilkan daftar referensi terpisah untuk kutipan dan catatan kaki lainnya:

Teks wiki	Hasil
Menurut para ilmuwan, Matahari itu besar.<ref>E. Miller, ''The Sun'', (New York: Academic Press, 2005), 23–5.</ref> Bahkan, Matahari itu sangat besar <ref group="catatan kaki"> Percaya saja. Jangan menatap langsung ke Matahari!</ref> ==Catatan== <references group="footnotes" /> ==Referensi== <references />	According to scientists, the Sun is pretty big In fact, it is very big Catatan Referensi

Kelompok anonim bekerja sebagaimana sebelumnya, sedangkan referensi untuk kelompok bernama hanya akan muncul di elemen <references /> yang ditentukan.

Perhatikan bahwa pengenal yang digunakan di atribut group memerlukan karakter alfabet; hanya menggunakan nomor akan menghasilkan pesan galat. Tanda kutipnya opsional kecuali namanya mengandung spasi, tanda baca atau tanda lainnya. Disarankan untuk menyederhanakan nama dan hanya menggunakan karakter ASCII.

Mengutip bagian berbeda dari sumber yang sama

Ketika beberapa bagian dari karya yang sama digunakan sebagai referensi dalam sebuah artikel, Anda bisa mengelompokkan mereka dalam bagian referensi. Ini memberikan pembaca cara mengenali referensi mana yang berasal dari sumber yang sama. Ini juga membolehkan Anda mengutip bagian yang berbeda dari sumber yang sama tanpa mengetik ulang seluruh sumber setiap kali melakukannya.

Teks wiki	Hasil
Menurut para ilmuwan, Matahari itu besar.<ref name="Miller">E. Miller, ''The Sun'', (New York: Academic Press, 2005), 23–5.</ref> Bahkan, Matahari itu sangat besar. <ref extends="Miller">hlm. 123</ref> Percaya saja. Jangan menatap langsung ke Matahari!<ref extends="Miller">hlm. 42</ref> ==Referensi== <references />	According to scientists, the Sun is pretty big. [1] In fact, it is very big. [1.1] Take their word for it. Don't look directly at the sun! [1.2] Referensi 1. E. Miller, The Sun, (New York: Academic Press, 2005)    1.1 ↑ hlm. 123    1.2 ↑ hlm. 42

Perhatikan bahwa fitur ini belum bekerja di wiki di luar gugus beta, itulah mengapa contoh di atas dibuat-buat. Anda bisa mengikuti perkembangan proyek di m:WMDE Technical Wishes/Book referencing.

Memisahkan referensi dari teks

Referensi dalam-teks membuat mudah untuk menyalin teks ke halaman lain; di sisi yang lain, mereka membuat teks sulit dibaca. Referensi yang berisi banyak data, kutipan atau templat sitiran yang rumit bisa mengisi ruang yang lebih besar dalam sumber dibandingkan dengan teks yang akan ditampilkan. Untuk menghindari ini, versi terbaru dari ektensi memungkinkan pemindahan sebagian atau seluruh referensi ke dalam bagian <references />, tempat di mana mereka akan ditampilkan kepada pembaca.

Teks wiki	Hasil
Menurut para ilmuwan, Matahari itu sangat besar.<ref name="miller" /> Sedangkan Bulan tidak sebesar itu.<ref name="smith" /> ==Catatan== <references> <ref name="miller">E. Miller, ''The Sun'', (New York: Academic Press, 2005), 23–5.</ref> <ref name="smith">R. Smith, "Size of the Moon", ''Scientific American'', 46 (April 1978): 44–6.</ref> </references>	According to scientists, the Sun is pretty big. The Moon, however, is not so big. Notes

Dengan begitu, kode di atas akan menghasilkan keluaran yang sama dengan contoh yang pertama di atas, meskipun penomoran dan urutan referensinya secara umum tidak akan sama.

Substitusi dan fungsi parser yang ditanamkan

Karena tag <ref> Cite diuraikan sebelum fungsi parser MediaWiki (contoh: {{#ifexpr:…}}) atau variabel (contoh: {{PAGENAME}}) atau sebelum subst:, hal-hal tersebut tidak akan bekerja di dalam referensi sitasi. Jadi, Anda harus menggunakan kata ajaib {{#tag:…}}.

Teks wiki	Hasil
Foo <ref>Ini tidak bekerja, lihat {{cite journal|url=https://www.google.com |title=Search |author= |date= |accessdate={{subst:#time:Y-m-d|now}}}}</ref> bar baz… Foo{{#tag:ref|Ini bekerja, lihat {{cite journal|url=https://www.google.com |title=Search |author= |date= |accessdate=2020-06-23}}}} bar baz… <references />	Foo bar baz… Foo bar baz…

Menambahkan judul bagian secara otomatis sebelum daftar referensi

Hingga MediaWiki 1.28, Anda bisa menggunakan pesan sistem MediaWiki:Cite references prefix untuk mendefinisikan judul bagian untuk seluruh situs yang akan dimasukkan secara otomatis sebelum setiap daftar referensi. Dalam MediaWiki 1.29, pesan sistem ini dihapus. Cara hacky untuk memasukkan judul sekarang adalah dengan menambahkan kode berikut ke MediaWiki:Common.js:

$(document).ready(function(){
    $('.mw-references-wrap').before('<h2>References</h2>');
});

Jika Anda hanya memerlukan judul teks (tanpa pranala atau elemen aktif lainnya), maka Anda bisa menambahkan kode berikut ke MediaWiki:common.css (Chrome 4, IE9, FF 3.5, Safari 3.1, Opera 7):

.mw-references-wrap::before {
  content: "Blue references";
  color: #0645ad;
  text-decoration: none;
  background: none;
  font-style: italic;
  font-size: 100%;
  font-weight: bold;
  line-height: 1.6;
  direction: ltr;
  font-family: sans-serif;
}

Menggabungkan dua teks menjadi sebuah referensi

Masalah yang kerap ditemui di Wikisource adalah referensi yang mencakup beberapa halaman di sumber materinya. Ini bisa digabungkan menggunakan tag <ref name="nama"> untuk bagian pertama referensi, dan menandai bagian-bagian berikutnya dengan tag <ref follow="nama"> dengan nama yang sama.

Contoh:

Teks wiki	Hasil
Ini adalah contoh menggabungkan beberapa teks ke dalam catatan kaki yang sama.<ref name="main">Ingatlah bahwa seluruh teks akan dimasukkan ke dalam referensi yang berisi atribut name="…".</ref> <ref follow="main">Tinggal tambahkan teks tambahan di dalam ''tag'' dengan atrbiut &lt;ref follow="…">, menyamai nama ref yang pertama.</ref> ==Referensi== <references/>	This is an example of merging multiple texts into the same footnote. Referensi

Ketika menggunakan sintaks ini, perhatikan agar bagian "follow" dari catatan kaki dimasukkan di halaman yang sama dengan bagian pertama dari referensi. Perhatikan bahwa nama referensi tidak bisa dimulai dengan nomor, jadi selalu masukkan teks seperti <ref name="p32"> dan <ref follow="p32">.

Pengubahsuaian

Format dari keluaran <ref> dan <references> bisa disesuaikan hampir seluruhnya melalui pesan MediaWiki, yang bisa diubah, misalnya, melalui ruang nama MediaWiki bergantung pada konfigurasi wikinya.

Untuk daftar pesan yang mengendalikan keluaran <ref> dan <references> dan nilai-nilai, jika ada, yang diberikan kepada mereka ($1, $2, $3 ...) lihatlah daftar nilai default terkini yang bisa didapatkan langsung dari MediaWiki.

Incomplete list

• cite_reference_link_key_with_num
  1. key
  2. num
• cite_reference_link_prefix
• cite_reference_link_suffix
• cite_references_link_prefix
• cite_references_link_suffix
• cite_reference_link
  1. ref ID
  2. backlink ID
  3. count to display
• cite_references_link_one
  • Used to format the source list that <references /> outputs, it configures 3 things: the backlink ID, the ref ID, and text of note.
  1. backlink ID - used for creating the number order of the source list.
  2. ref ID - used to link back to the actual reference in the text, this is where you can configure the <bold>^</bold> symbol
  3. text of note - text used above describing the source info
• cite_references_link_many
  1. backlink ID
  2. list of links
  3. text of note
• cite_references_link_many_format
  1. ref ID
  2. numeric value to use as a backlink
  3. custom value (as defined in cite_references_link_many_format_backlink_labels to use as a backlink)
• cite_references_link_many_format_backlink_labels
• cite_references_link_many_sep
• cite_references_link_many_and
• cite_references_suffix

Mengatur referensi agar menggunakan ^ dan huruf

Untuk mengganti tanda panah (↑) standar dengan tanda sisipan (^), ubah pesan sistem berikut. Semua halaman berikut bisa ditemukan di Special:AllMessages.

MediaWiki:Cite references link one

Dari	Menjadi
<li id="$1"$4><span class="mw-cite-backlink">[[#$2|↑]]</span> $3</li>	<li id="$1"$4><span class="mw-cite-backlink">[[#$2|^]]</span> $3</li>

MediaWiki:Cite references link many

From	To
<li id="$1"$4><span class="mw-cite-backlink">↑ $2</span> $3</li>	<li id="$1"$4><span class="mw-cite-backlink">^ $2</span> $3</li>

MediaWiki:Cite references link many format

Replacing $2 with $3 changes the links from 1.0, 1.1, 1.2 to a, b, c etc…

From	To
<sup>[[#$1|$2]]</sup>	<sup>[[#$1|$3]]</sup>

Mencari halaman-halaman tersebut untuk pertama kalinya tidak akan menemukan hasil. Buat terlebih dahulu untuk menyunting kodenya. Perubahan tidak akn tampah sampai sebuah halaman dengan referensi dibuat ulang.

Mengatur penyorotan referensi dan nomor referensi

Sejak MediaWiki 1.26 pemilih untuk penyorotan digabungkan ke dalam Cite/modules/ext.cite.css. Sehingga kode CSS di bawah tidak lagi perlu ditambahkan secara manual.

Tambahkan kode berikut ke halaman MediaWiki:Common.css.

/* make the Cite extension list of references look smaller and highlight clicked reference in blue */
ol.references { font-size: 90%; }
ol.references li:target { background-color: #ddeeff; }
sup.reference:target { background-color: #ddeeff; }

Referensi rusak

Jika tag <ref> atau <references /> digunakan dengan salah, ekstensi Cite akan menambahkan pesan galat di halaman, dan menambahkannya kategori "Halaman dengan kesalahan referensi". Pesan galat akan ditampilkan dalam bahasa antarmuka pengguna, baik di konten artikel maupun di bagian Referensi. Contoh:

Teks wiki	Hasil
Ini adalah contoh pesan galat referensi.<ref broken>Teks yang dimaksudkan.</ref> ==Catatan== <references />	Ini adalah contoh pesan galat referensi. Catatan

Lihat spec untuk representasi galat Cite Parsoid.

Lihat pula

• w:Help:Cite link labels