Help:Kutip

From mediawiki.org
This page is a translated version of the page Help:Cite and the translation is 93% 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

Pengutipan memberikan kemungkinan untuk menambah catatan kaki dalam sebuah halaman.

Lihat Cite extension 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
Matahari cukup besar.<ref>E. Miller, ''Matahari'', (New York: Academic Press, 2005), 23–5.</ref> Bulan, bagaimanapun, tidak terlalu besar.<ref>R. Smith, "Ukuran Bulan", ''Scientific American'', 46 (April 1978): 44–6.</ref>

==Catatan==
<references />

Matahari cukup besar.[1] Bulan, bagaimanapun, tidak terlalu besar.[2]

Catatan
  1. E. Miller, Matahari, (New York: Academic Press, 2005)
  2. R. Smith, "Ukuran Bulan", Scientific American, 46 (April 1978): 44–6.

Menggunakan catatan kaki yang sama beberapa kali

Untuk memberikan catatan kaki penanda yang unik, gunakan ‎<ref name="name">. Anda kemudian bisa menggunakan catatan kaki yang sama lagi dengan menggunakan tag ref dengan nama yang sama. Teks di dalam tag yang kedua tidak penting, karena teksnya sudah ada di referensi pertama. Anda bisa menyalin seluruh catatan kaki, atau Anda bisa menggunakan tag ref kosong seperti ini: ‎<ref name="nama" />.

Dalam contoh berikut, sumber yang sama dikutip tiga kali.

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

Ini adalah contoh beberapa referensi ke catatan kaki yang sama.[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 Ingatlah bahwa ketika Anda mengacu pada catatan kaki yang sama beberapa kali, teks dari referensi yang pertamalah yang digunakan.
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.


<span id="The_‎<references />_tag">

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.

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, ''Matahari'', (New York: Academic Press, 2005), 23–5.</ref> Bahkan, Matahari itu sangat besar.<ref group="footnotes"> Percaya saja. Jangan menatap langsung ke Matahari!</ref>

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

==Referensi==
<references />
Menurut para ilmuwan, Matahari itu besar.[1] Bahkan, Matahari itu sangat besar.[footnotes 1]
Catatan
  1. Percaya saja. Jangan menatap langsung ke Matahari!
Referensi
  1. E. Miller, Matahari, (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.

The rendering of a given group can be customized across the wiki by creating MediaWiki:Cite_link_label_group-<name> and listing the used signs in the order they appear, separated by spaces or newlines.

For example, if MediaWiki:Cite_link_label_group-lower-alpha is created with the content
a b c d e f g h i j k l m n o p q r s t u v w x y z
then the first <ref group="lower-alpha">...</ref> renders [a], the second one renders [b], and so on, the 26th renders [z].

It is an error to use more footnotes in a custom-rendered group than the number of signs defined, so the 27th footnote in this group causes an error.

The following group names are often defined as custom groups by the following messages respectively:

group name message
upper-alpha MediaWiki:Cite link label group-upper-alpha
lower-alpha MediaWiki:Cite link label group-lower-alpha
upper-roman MediaWiki:Cite link label group-upper-roman
lower-roman MediaWiki:Cite link label group-lower-roman
lower-greek MediaWiki:Cite link label group-lower-greek
The Cite link label group pages are not created by default. If a wiki does not configure them, markup such as <ref group="lower-alpha">...</ref> will render as lower-alpha 1.

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, ''Matahari'', (New York: Academic Press, 2005).</ref> Bahkan, Matahari itu sangat besar.<ref extends="Miller">p. 123</ref> Percaya saja. Jangan menatap langsung ke Matahari!<ref extends="Miller">p. 42</ref>

==Referensi==
<references />
Menurut para ilmuwan, Matahari itu besar.[1] Bahkan, Matahari itu sangat besar.[1.1] Percaya saja. Jangan menatap langsung ke Matahari![1.2]
Referensi

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
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, ''Matahari'', (New York: Academic Press, 2005), 23–25.</ref>
<ref name="smith">R. Smith, "Ukuran Bulan", ''Scientific American'', 46 (April 1978): 44–46.</ref>
</references>

Menurut para ilmuwan, Matahari itu besar.[1] Sedangkan Bulan tidak sebesar itu.[2]

Catatan
  1. E. Miller, Matahari, (New York: Academic Press, 2005), 23–25.
  2. R. Smith, "Ukuran Bulan", Scientific American, 46 (April 1978): 44–46.

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 |author= |date= |accessdate={{subst:#time:Y-m-d|now}}|title=Cari}}</ref> bar baz…
Foo{{#tag:ref|Ini bekerja, lihat {{cite journal|url=https://www.google.com |author= |date= |accessdate={{subst:#time:Y-m-d|now}}|title=Cari}}}} bar baz…
<references />

Foo[1] bar baz… Foo[2] bar baz…

  1. Ini tidak bekerja, lihat "Cari" . Retrieved on [[{{subst:#time:Y-m-d|now}}]]. 
  2. Ini tidak bekerja, lihat "Cari" . Retrieved on 2021-03-11. 

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>Referensi</h2>');
});

Note that this adds the header unconditionally, i.e. if you already have the header it gets added again thus creating duplicated headers.

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 follow="…", menyamai nama ref yang pertama.</ref>

==Referensi==
<references/>

Ini adalah contoh menggabungkan beberapa teks ke dalam catatan kaki yang sama.[1]


Referensi

  1. Ingatlah bahwa seluruh teks akan dimasukkan ke dalam referensi yang berisi atribut name="…". Tinggal tambahkan teks tambahan di dalam tag dengan atrbiut follow="…", menyamai nama ref yang pertama.

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.

Daftar tidak lengkap
  • 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. ID ref
    2. ID pranala balik
    3. hitungan yang ditampilkan
  • cite_references_link_one
    • Gunakan untuk memformat daftar sumber yang dihasilkan ‎<references />, mengatur 3 hal: ID pranala balik, ID ref, dan teks catatan.
    1. ID pranala balik — Digunakan untuk membuat urutan nomor daftar sumber.
    2. ID ref — Digunakan untuk menautkan kembali ke referensi yang sebenarnya di teks, ini adalah di mana Anda bisa mengatur simbol ^.
    3. teks catatan — teks yang digunakan untuk menjelaskan info sumber
  • cite_references_link_many
    1. ID pranala balik
    2. daftar pranala
    3. teks catatan
  • cite_references_link_many_format
    1. ID ref
    2. nilai numerik untuk digunakan sebagai pranala balik
    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 reference backlink symbol
Dari Menjadi
^
MediaWiki:Cite references link many format

Mengganti $2 dengan $3 mengubah pranala dari 1.0, 1.1, 1.2 menjadi a, b, c, dll...

Dari Ke
<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.

/* membuat daftar referensi ekstensi Cite lebih kecil dan menyoroti referensi yang sudah ditekan dengan warna biru */
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 parameter in <ref> tag

Catatan

Lihat spec untuk representasi galat Cite Parsoid.

Lihat pula