Wikisporta

Templat:Artikel terkait/doc: Perbedaan antara revisi

← Revisi sebelumnya

Wikisporta (bicara | kontrib)

11 grup pengguna
1.506 suntingan
VisualTeks wiki
Tanda: Suntingan perangkat seluler Suntingan peramban seluler
Tanda: Suntingan perangkat seluler Suntingan peramban seluler
 
(4 revisi perantara oleh pengguna yang sama tidak ditampilkan)
Baris 1: Baris 1:
<noinclude>
{{Documentation subpage}}
{{Documentation subpage}}
'''Template ini''' adalah templat pembungkus (wrapper) yang dirancang untuk mempermudah dan merapikan pemanggilan fungsi parser <code><nowiki>{{#related: Judul Artikel}}</nowiki></code>.  
'''Template {{tl|Artikel terkait}}''' adalah templat cerdas yang dirancang untuk mempermudah dan mengotomatisasi pemunculan artikel terkait di bagian bawah halaman menggunakan ekstensi '''RelatedArticles'''.


Dengan templat ini, penyunting tidak perlu lagi mengetikkan fungsi parser secara berulang untuk setiap artikel terkait. Templat ini mendukung penambahan hingga '''maksimal 3 artikel terkait''' dalam satu baris pemanggilan secara dinamis, rapi, dan bebas dari galat (error) jika parameter dikosongkan.
Templat ini dilengkapi dengan modul Lua backend (<code>Module:AutoRelated</code>) yang bekerja secara otomatis memindai pranala internal (wikilink) di dalam isi artikel, menyaring tautan yang valid, mengabaikan tautan merah dan halaman pengalihan, lalu memilih secara acak hingga maksimal 3 artikel terkait tanpa membebani performa server atau membutuhkan basis data pencarian eksternal yang berat.


== Cara Penggunaan ==
== Cara Penggunaan ==
Salin dan tempel kode berikut ke bagian bawah halaman artikel (biasanya diletakkan sebelum kategori atau di atas templat navigasi/rujukan):


=== Format Dasar ===
=== 1. Mode Otomatis (Direkomendasikan) ===
<pre>
Penyunting tidak perlu memasukkan parameter apa pun. Cukup pasang templat ini di bagian bawah halaman (sebelum kategori atau kotak navigasi):
{{Artikel terkait|Artikel 1|Artikel 2|Artikel 3}}
<syntaxhighlight lang="wikitext">
</pre>
{{Artikel terkait}}
</syntaxhighlight>
* '''Cara Kerja:''' Sistem akan otomatis mendeteksi wikilink biru yang ada di artikel tersebut, memastikan halaman tujuannya benar-benar ada dan bukan halaman pengalihan[cite: 6], mengacak pilihannya, dan menampilkan maksimal 3 artikel secara stabil.
 
=== 2. Mode Manual (Opsional) ===
Jika penyunting ingin menentukan artikel terkait secara spesifik secara manual, templat ini tetap mendukung parameter posisional (hingga 3 artikel):
<syntaxhighlight lang="wikitext">
{{Artikel terkait|Judul Artikel 1|Judul Artikel 2|Judul Artikel 3}}
</syntaxhighlight>


== Parameter ==
== Parameter ==
Templat ini menggunakan parameter posisional (tanpa nama):
{| class="wikitable"
{| class="wikitable"
! Parameter !! Status !! Deskripsi
! Parameter !! Status !! Deskripsi
|-
|-
| <code>1</code> || '''Wajib''' || Judul halaman/artikel terkait pertama yang ingin ditampilkan.
| <code>1</code> || Opsional || Judul artikel terkait pertama (jika ingin memaksa mode manual).
|-
|-
| <code>2</code> || Opsional || Judul halaman/artikel terkait kedua. Bisa dikosongkan.
| <code>2</code> || Opsional || Judul artikel terkait kedua.
|-
|-
| <code>3</code> || Opsional || Judul halaman/artikel terkait ketiga. Bisa dikosongkan.
| <code>3</code> || Opsional || Judul artikel terkait ketiga.
|}
|}
* ''Catatan: Jika parameter dikosongkan (hanya menulis <code><nowiki>{{Artikel terkait}}</nowiki></code>), sistem otomatis beralih ke mode pemindaian cerdas.''


== Contoh Penggunaan ==
== Fitur Cerdas Modul Otomatis ==
 
* '''Penyaringan Wikilink Aktif:''' Hanya mendeteksi halaman yang benar-benar ada (berwarna biru) dan mengabaikan tautan merah.
=== 1. Menampilkan 1 Artikel Terkait ===
* '''Anti-Pengalihan (Anti-Redirect):''' Secara otomatis melewati halaman bertipe pengalihan (redirect seperti pada kasus Real Madrid ke Real Madrid C.F.) agar target tautan selalu akurat.
Jika hanya ada satu artikel yang ingin dikaitkan:
* '''Batasan Kapasitas:''' Secara dinamis memilih maksimal 3 artikel. Jika artikel sumber hanya memiliki 1 atau 2 wikilink valid, maka sistem hanya akan menampilkan 1 atau 2 tanpa memaksakan error.
<syntaxhighlight lang="wikitext">
* '''Stabil & Terkunci:''' Hasil acakan bersifat stabil pada setiap halaman dan tidak berubah-ubah liar setiap kali pengunjung memuat ulang halaman.
{{Artikel terkait|Lionel Messi}}
</syntaxhighlight>
 
'''Hasil ekivalen sintaks parser:'''
<syntaxhighlight lang="wikitext">
{{#related: Lionel Messi}}
</syntaxhighlight>
 
---
 
=== 2. Menampilkan 2 Artikel Terkait ===
Jika ada dua artikel yang ingin dikaitkan:
<syntaxhighlight lang="wikitext">
{{Artikel terkait|Lionel Messi|Cristiano Ronaldo}}
</syntaxhighlight>
 
'''Hasil ekivalen sintaks parser:'''
<syntaxhighlight lang="wikitext">
{{#related: Lionel Messi}}
{{#related: Cristiano Ronaldo}}
</syntaxhighlight>
 
---
 
=== 3. Menampilkan 3 Artikel Terkait (Maksimal) ===
Jika ingin menampilkan kapasitas penuh (3 artikel):
<syntaxhighlight lang="wikitext">
{{Artikel terkait|Lionel Messi|Cristiano Ronaldo|Roberto Carlos}}
</syntaxhighlight>
 
'''Hasil ekivalen sintaks parser:'''
<syntaxhighlight lang="wikitext">
{{#related: Lionel Messi}}
{{#related: Cristiano Ronaldo}}
{{#related: Roberto Carlos}}
</syntaxhighlight>
 
== Penanganan Galat & Perilaku Khusus ==
* '''Pengisian Kosong/Skeptis:''' Jika parameter ke-2 atau ke-3 tidak diisi, templat menggunakan parser fungsi <code>#if:</code> untuk mengabaikannya secara otomatis tanpa menyisakan sisa baris kosong (whitespace/break) yang berantakan pada HTML keluaran.
* '''Kapasitas Parameter:''' Templat ini dibatasi maksimal 3 artikel sesuai batas tampilan rekomendasi visual terbaik agar tidak menumpuk di bagian bawah halaman.
* '''Nama Halaman Pekat (Case-Sensitive):''' Pastikan judul artikel yang dimasukkan sesuai dengan judul asli halaman di Wiki (memperhatikan huruf kapital dan spasi).
</noinclude>
Diperoleh dari "https://wikisporta.org/wiki/Templat:Artikel_terkait/doc"