Templat:Diff/doc: Perbedaan antara revisi
Konten dihapus Konten ditambahkan
Hidayatsrf (bicara | kontrib) ←Membuat halaman berisi '{{Documentation subpage}} <!-- Masukan kategori pada bagian bawah yang sudah ditandai di halaman ini. Untuk interwiki gunakan Wikidata (lihat Wikipedia:Wikidata) -...' |
Menambahkan dokumentasi templat; beberapa contoh penggunaan templat belum diterjemahkan. Tag: Suntingan visualeditor-wikitext |
||
Baris 1:
{{Documentation subpage}}
Templat ini dimaksudkan untuk membantu membuat pranala ke [[Bantuan:Perbedaan|perbedaan revisi (''diff'')]]; yaitu, pranala ke halaman yang menunjukkan perbedaan antara dua versi halaman wiki. Setiap versi dari sebuah halaman memiliki ID revisi, yang dapat Anda temukan dari [[Bantuan:Riwayat_penyuntingan|riwayat halaman]] dengan melihat pranala ''timestamp'' untuk suntingan. Pranala ''timestamp'' memiliki bentuk seperti ini: <br/>
<code>http[s]://wiki-indonesia.club/w/index.php?title=SuatuHalaman&oldid=442212827</code><br/>
Angka setelah <code>oldid=</code> adalah ID revisi.
Dengan satu atau dua ID revisi, ada beberapa jenis pranala yang dapat dihasilkan.
== Penggunaan ==
:{{tlx|Diff|''title''|''diff''|''oldid''|''label''|''diffonly{{=}}yes''}}
* <code>''title''</code>{{snds}} Judul (nama) halaman (umumnya bersifat opsional)
* <code>''diff''</code>{{snds}}ID revisi atau kata kunci yang ingin dibandingkan dengan ID revisi patokan. Kata-kata kunci yang mungkin adalah:
*: <code>cur</code>{{snds}}membandingkan dengan versi saat ini dari halaman yang bersangkutan.
*: <code>prev</code>{{snds}}membandingkan dengan versi sebelum dari halaman yang bersangkutan.
*: <code>next</code>{{snds}}membandingkan dengan versi selanjutnya dari halaman yang bersangkutan.
*: Jika menggunakan ''id'', nilainya harus "lebih besar" daripada <code>oldid</code>.
* <code>''oldid''</code>{{snds}}revisi ID patokan yang digunakan untuk menghasilkan diff.
* <code>''label''</code>{{snds}}Teks yang ditampilkan sebagai pranala (opsional){{nsmdns}}Tidak mengisi ini akan menghasilkan pranala bernomor sebagai label.
* {{para|diffonly|yes}}{{snds}}Hanya menampilkan perbedaan antar versi halaman (opsional){{nsmdns}}nama parameter perlu digunakan.
Hanya parameter ''diff'' yang dibutuhkan; parameter-parameter lainnya bersifat opsional. Anda juga bisa menggunakan nama parameter untuk mengisi data templat <code>'''title'''</code>, <code>'''diff'''</code>, <code>'''oldid'''</code>, dan <code>'''label'''</code>.
== Beberapa contoh ==
Di bawah adalah tabel beberapa contoh penggunaan templat ini. Teks dengan ''<code>{{font color|brown|cetak miring berwarna coklat}}</code>'' di kolom sebelah kiri, adalah ''pseudocode'' untuk contoh tersebut. Elemen-elemen yang harus dimasukkan secara harfiah ditandai oleh tulisan '''''<code>{{font color|brown|{{Underline|cetak miring dengan garis bawah tebal berwarna coklat}}}}</code>''''. Ketika parameter dibiarkan kosong, dua karakter pipa yang berdekatan digarisbawahi (tetapi tidak dicetak tebal): ''<code>{{font color|brown|<u>||</u>}}</code>''.
{| class="wikitable"
|-
! style="width:33%;" | Kode !! Hasil
|-
| <code><nowiki>{{</nowiki>'''{{Underline|Diff}}'''<nowiki>|</nowiki>''Halaman utama''<nowiki>|</nowiki>'''<u>prev</u>'''<nowiki>|</nowiki>''11647961''<nowiki>|</nowiki>''Diff antara suatu revisi dengan versi sebelumnya''<nowiki>}}</nowiki></code>
::''<code>{{font color|brown|<nowiki>{{</nowiki>'''{{Underline|Diff}}'''<nowiki>|</nowiki>page<nowiki>|</nowiki>'''<u>prev</u>'''<nowiki>|</nowiki>oldid<nowiki>|</nowiki>label<nowiki>}}</nowiki>}}</code>''
| {{Diff|Halaman utama|prev|11647961|Diff antara suatu revisi dengan versi sebelumnya}}
'''Ini adalah bentuk yang paling sering digunakan'''
* Parameter '''diff=''' (parameter ke-2) diisi oleh kata '''prev'''.
* Parameter '''oldid=''' parameter (parameter ke-3) diisi dengan angka ID revisi yang tercatat.
|-
| <code><nowiki>{{</nowiki>'''{{Underline|Diff}}'''<nowiki>|</nowiki>''Foobar''<nowiki>|</nowiki>''18157674''<nowiki>|</nowiki>''14667793''<nowiki>|</nowiki>''Diff antara dua revisi suatu halaman''<nowiki>}}</nowiki></code>
::''<code>{{font color|brown|<nowiki>{{</nowiki>'''{{Underline|Diff}}'''<nowiki>|</nowiki>page title<nowiki>|</nowiki>diff<nowiki>|</nowiki>oldid<nowiki>|</nowiki>label<nowiki>}}</nowiki>}}</code>''
| {{Diff|Halaman utama|18157674|14667793|Diff antara dua revisi suatu halaman}}
* Parameter '''title=''' (parameter pertama) adalah nama halaman, contohnya [[:Foobar]].
* Parameter '''diff=''' (parameter ke-2) berisi ID revisi yang lebih besar.
* Parameter '''oldid=''' (parameter ke-3) berisi ID revisi yang lebih kecil.
|-
| <code><nowiki>{{</nowiki>'''{{Underline|Diff}}'''<nowiki>||</nowiki>''18157674''<nowiki>|</nowiki>''14667793''<nowiki>|</nowiki>''Diff antara dua revisi suatu halaman tanpa parameter title''<nowiki>}}</nowiki></code>
::''<code>{{font color|brown|<nowiki>{{</nowiki>'''{{Underline|Diff}}'''<nowiki>||</nowiki>diff<nowiki>|</nowiki>oldid<nowiki>|</nowiki>label<nowiki>}}</nowiki>}}</code>''
| {{Diff||18157674|14667793|Diff antara dua revisi suatu halaman tanpa parameter title}}
* Parameter '''title=''' (parameter pertama) dapat dikosongkan, dengan menuliskan dua karakter pipa.
* Parameter '''diff=''' (parameter ke-2) berisi ID revisi yang lebih besar.
* Parameter '''oldid=''' (parameter ke-3) berisi ID revisi yang lebih kecil.
|-
| <code><nowiki>{{</nowiki>'''{{Underline|Diff}}'''<nowiki>|</nowiki>''Istimewa:Bandingkan_halaman''<nowiki>|</nowiki>''18157674''<nowiki>|</nowiki>''14667793''<nowiki>|</nowiki>''Diff between two numbered versions of a <!-- Pagediff --> page in Wikipedia namespace''<nowiki>}}</nowiki></code>
::''<code>{{font color|brown|<nowiki>{{</nowiki>'''{{Underline|Diff}}'''<nowiki>|</nowiki>page<nowiki>|</nowiki>diff<nowiki>|</nowiki>oldid<nowiki>|</nowiki>label<nowiki>}}</nowiki>}}</code>''
| {{Diff|Istimewa:Bandingkan_halaman|18157674|14667793|Diff between two numbered versions of a <!-- Pagediff --> page in Wikipedia namespace}}
*Parameter '''title=''' (parameter pertama) adalah nama halaman, sebagai contoh [[Istimewa:Bandingkan_halaman]].
* Parameter '''diff=''' (parameter ke-2) berisi ID revisi yang ada di sisi kanan (proposal perubahan).
* Parameter '''oldid=''' (parameter ke-3) berisi ID revisi yang ada di sisi kiri (keadaan saat ini).
|-
| <code><nowiki>{{</nowiki>'''{{Underline|Diff}}'''<nowiki>|</nowiki>''Halaman utama''<nowiki>|</nowiki>'''<u>next</u>'''<nowiki>|</nowiki>''11647961''<nowiki>|</nowiki>''Diff between a numbered version and the subsequent version''<nowiki>}}</nowiki></code>
:: ''<code>{{font color|brown|<nowiki>{{</nowiki>'''{{Underline|Diff}}'''<nowiki>|</nowiki>page<nowiki>|</nowiki>'''<u>next</u>'''<nowiki>|</nowiki>oldid<nowiki>|</nowiki>label<nowiki>}}</nowiki>}}</code>''
| {{Diff|Halaman utama|next|11647961|Diff between a numbered version and the subsequent version}}
* Parameter '''diff=''' (parameter ke-2) diisi oleh kata '''next'''.
* Parameter '''oldid=''' parameter (parameter ke-3) diisi dengan angka ID revisi yang tercatat.
|-
| <code><nowiki>{{</nowiki>'''{{Underline|Diff}}'''<nowiki>|</nowiki>''Halaman utama''<nowiki>|</nowiki>'''<u>cur</u>'''<nowiki>|</nowiki>''11647961''<nowiki>|</nowiki>''Diff between a numbered version and the current version of a page''<nowiki>}}</nowiki></code>
:: ''<code>{{font color|brown|<nowiki>{{</nowiki>'''{{Underline|Diff}}'''<nowiki>|</nowiki>page<nowiki>|</nowiki>'''<u>cur</u>'''<nowiki>|</nowiki>oldid<nowiki>|</nowiki>label<nowiki>}}</nowiki>}}</code>''
| {{Diff|Halaman utama|cur|11647961|Diff between a numbered version and the current version of a page}}
* Parameter '''diff=''' (parameter ke-2) diisi oleh kata '''cur'''.
* Parameter '''oldid=''' parameter (parameter ke-3) diisi dengan angka ID revisi yang tercatat.
|-
| <code><nowiki>{{</nowiki>'''{{Underline|Diff}}'''<nowiki>|</nowiki>''Halaman utama''<nowiki>|</nowiki>'''<u>cur<nowiki>||</nowiki></u>'''''Diff showing the most recent change to a page''<nowiki>}}</nowiki></code>
:: ''<code>{{font color|brown|<nowiki>{{</nowiki>'''{{Underline|Diff}}'''<nowiki>|</nowiki>page<nowiki>|</nowiki><u>'''cur'''<nowiki>||</nowiki></u>label<nowiki>}}</nowiki>}}</code>''
| {{Diff|Halaman utama|cur||Diff showing the most recent change to a page}}
* Parameter '''diff=''' (parameter ke-2) diisi oleh kata '''cur'''.
* Parameter '''oldid=''' parameter (parameter ke-3) dikosongkan.
|-
| <code><nowiki>{{</nowiki>'''{{Underline|Diff}}'''<nowiki>|</nowiki>''Halaman utama'''''<u><nowiki>||</nowiki></u>'''''11647961''<nowiki>|</nowiki>''A link to a numbered version of a page''<nowiki>}}</nowiki></code>
:: ''<code>{{font color|brown|<nowiki>{{</nowiki>'''{{Underline|Diff}}'''<nowiki>|</nowiki>page{{Underline|<nowiki>||</nowiki>}}oldid<nowiki>|</nowiki>label<nowiki>}}</nowiki>}}</code>''
| {{Diff|Halaman utama||11647961|A link to a numbered version of a page}}
* Parameter '''diff=''' (parameter ke-2) dikosongkan.
* Parameter '''oldid=''' parameter (parameter ke-3) diisi dengan angka ID revisi yang tercatat.
* Hasil yang didapatkan sebenarnya bukan suatu diff, jadi ini bisa dianggap sebagai penggunaan templat yang salah. Lihat templat {{tl|oldid}} untuk informasi lebih lanjut.
|-
| <code><nowiki>{{</nowiki>'''{{Underline|Diff}}'''<nowiki>|</nowiki>''Halaman utama''<nowiki>|</nowiki>''11647961''<nowiki>|</nowiki>''202506579''<nowiki>|</nowiki>''Comparison display without page display of two numbered versions of a page'' <nowiki>|</nowiki>'''<u>diffonly=yes</u>'''<nowiki>}}</nowiki></code>
: ''<code>{{font color|brown|<nowiki>{{</nowiki>'''{{Underline|Diff}}'''<nowiki>|</nowiki>page<nowiki>|</nowiki>diff<nowiki>|</nowiki>oldid<nowiki>|</nowiki>label<nowiki>|</nowiki>'''<u>diffonly{{=}}yes</u>'''<nowiki>}}</nowiki>}}</code>''
| {{Diff|Halaman utama|11647961|202506579|Comparison display without page display of two numbered versions of a page |diffonly=yes}}
* Parameter '''title=''' (parameter pertama) adalah nama halaman, contohnya [[:Foobar|Halaman utama]].
* Parameter '''diff=''' (parameter ke-2) berisi ID revisi yang lebih besar.
* Parameter '''oldid=''' (parameter ke-3) berisi ID revisi yang lebih kecil.
* Parameter '''diffonly=''', perlu ditulis dengan nama parameter ini, dapat diset menjadi<code>yes</code>
|}
== TemplateData ==
{{TemplateData header}}
<templatedata>
{
"params": {
"title": {
"required": false,
"label": "title",
"type": "string/wiki-page-name",
"description": "Judul halaman.",
"aliases": [
"page",
"1"
]
},
"diff": {
"required": true,
"label": "Diff",
"type": "string/line",
"description": "ID revisi atau kata kunci yang ingin dibandingkan dengan ID revisi patokan. Kata-kata kunci yang mungkin adalah:\n* cur – membandingkan dengan versi saat ini dari halaman yang bersangkutan.\n* prev – membandingkan dengan versi sebelum dari halaman yang bersangkutan.\n* next – membandingkan dengan versi selanjutnya dari halaman yang bersangkutan.\n* id – membandingkan dengan revisi ID ini, nilainya harus 'lebih besar' daripada nilai oldid.",
"aliases": [
"2"
]
},
"oldid": {
"required": false,
"label": "Oldid",
"type": "number",
"description": "revisi ID patokan yang digunakan untuk menghasilkan diff. Suatu angka seperti \"442212827\" (tanpa simbol petik).",
"aliases": [
"3"
]
},
"diffonly": {
"required": false,
"label": "Diffonly",
"type": "string/line",
"description": "Hanya menampilkan perbedaan antar versi halaman. Jika menggunakan parameter ini, isi dengan \"yes\" (tanpa tanda kutip)."
},
"label": {
"required": false,
"label": "Label",
"type": "string/line",
"description": "Teks yang ditampilkan sebagai pranala.",
"aliases": [
"4"
]
}
},
"description": "Templat ini dimaksudkan untuk membantu membuat pranala ke perbedaan revisi (diff); yaitu, pranala ke halaman yang menunjukkan perbedaan antara dua versi halaman wiki.",
"paramOrder": [
"title",
"diff",
"oldid",
"label",
"diffonly"
]
}
</templatedata>
== Lihat pula ==
* {{Tl|Oldid}} – templat yang lebih sederhana untuk membuat pranala ke suatu versi halaman
* {{Tl|Diff2}} – same as {{Tlf|Diff}}, but assumes a diff between the given revision and the one immediately before
* {{Tl|Querylink}} – templat dasar (''base template'') untuk membuat [[query string]]s
* [[Istimewa:Diff]] memiliki tujuan yang mirip
* {{t|TextDiff}}
|