Help:Kutip

This page is a translated version of the page Help:Cite and the translation is 89% complete.
Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎français • ‎italiano • ‎polski • ‎português • ‎português do Brasil • ‎русский • ‎العربية • ‎سنڌي • ‎中文 • ‎日本語 • ‎한국어

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.[note 1] 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.[1] The Moon, however, is not so big.[2]

Catatan
  1. E. Miller, The Sun, (New York: Academic Press, 2005), 23–5.
  2. R. Smith, "Size of the Moon", Scientific American, 46 (April 1978): 44–6.

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.[1]

Referensi seperti ini khususnya berguna ketika mengutip sumber, jika beberapa pernyataan berasal dari sumber yang sama.[1] 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.[1]

Catatan
  1. 1.0 1.1 1.2 Remember that when you refer to the same footnote multiple times, the text from the first reference is used.
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"/>
  1. Catatan kaki ini digunakan sebagai contoh di bagian "Penggunaan".

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
According to scientists, the Sun is pretty big <ref>E. Miller, ''The Sun'', (New York: Academic Press, 2005), 23–5.</ref> In fact, it is very big <ref group="footnotes"> Take their word for it. Don't look directly at the sun!</ref>

==Catatan==
<references group="footnotes" />

==Referensi==
<references />
According to scientists, the Sun is pretty big [1] In fact, it is very big [footnotes 1]
Catatan
  1. Take their word for it. Don't look directly at the sun!
Referensi
  1. E. Miller, The Sun, (New York: Academic Press, 2005), 23–5.

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
According to scientists, the Sun is pretty big. <ref name="Miller">E. Miller, ''The Sun'', (New York: Academic Press, 2005)</ref> In fact, it is very big. <ref extends="Miller">p. 123</ref> Take their word for it. Don't look directly at the sun! <ref extends="Miller">p. 42</ref>

==References==
<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]
References

1. E. Miller, The Sun, (New York: Academic Press, 2005)
   1.1 ↑ p. 123
   1.2 ↑ p. 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
According to scientists, the Sun is pretty big.<ref name="miller" /> The Moon, however, is not so big.<ref name="smith" />

==Notes==
<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.[1] The Moon, however, is not so big.[2]

Notes
  1. E. Miller, The Sun, (New York: Academic Press, 2005), 23–5.
  2. R. Smith, "Size of the Moon", Scientific American, 46 (April 1978): 44–6.

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 [1] bar baz… Foo[2] bar baz…

  1. Ini tidak bekerja, lihat "Search" . Retrieved on [[{{subst:#time:Y-m-d|now}}]]. 
  2. Ini bekerja, lihat "Search" . Retrieved on 2020-06-23. 

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
This is an example of merging multiple texts into the same footnote.<ref name="main">Remember that all the texts will be included into the reference containing the name="…" attribute.</ref>

<ref follow="main">Simply include the additional text in a tag with the &lt;ref follow="…"> attribute, matching the first ref's name.</ref>

==Referensi==
<references/>

This is an example of merging multiple texts into the same footnote.[1]


Referensi

  1. Remember that all the texts will be included in the reference containing the name="…" attribute. Simply include the additional text in a tag with the <ref follow="…"> attribute, matching the first ref's name.

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.Cite error: Invalid <ref> tag; invalid names, e.g. too many

Catatan
Parsoids Cite extension is changing how errors are handled and error information is encoded for clients to use.

The first two errors Parsoid Cite handles are refs without name or content, and named refs without content. Those two errors are reported by Core Cite extension at the reference for refs with out name and content, and in the reference area for named refs without content. Parsoid Cite no longer inserts the actual i18n error text and instead annotates the erring refs html with "mw:Error" in the typeof attribute and the i18n error key in the data-mw attributes as shown in the following excerpt:

typeof="mw:Extension/ref mw:Error" data-mw='{"name":"ref","attrs":{"name":"example"},"errors":[{"key":"cite_error_ref_no_text"}]}'

It leaves the HTML without explicitly visible error information and creates a properly formed, but empty content reference and leaves how to indicate and correct the error to the client such as Visual Editor, which will need to be enhanced to recognize these new attributes and display the actual error message in the correct language with parameters such as the name expanded in the error message text.

The full suite of error conditions provided by Core Cite extension are being added to Parsoid Cite extension and will use the same mechanism for annotating the other error types. (This is the current state as of June 18th 2020, STB.)

Lihat pula