Wikipedia:Transklusi

WP:TRANS

Transklusi secara umum ialah merangkumkan atau memasukkan kandungan sesuatu dokumen ke dalam dokumen lain melalui rujukan. Dalam konteks ahli Wikipedia pula, ia ialah penggunaan kefungsian templat MediaWiki untuk merangkumkan kandungan yang sama di dalam pelbagai dokumen tanpa perlu menyunting dokumen-dokumen tersebut secara berasingan.

Bagaimana transklusi bertindak

Sintaks templat

Jika sumber di ruang nama rencana utama, sebagai contoh ("Cat"), anda mesti meletakkan tanda kolon (:) dihadapan nama, maka ditulis begini: {{:Cat}}

Jika sumber di ruang nama templat, sebagai contoh ("Templat:LamanKedaiKopi"), anda hanya perlu meletakkan nama itu secara bersendirian, maka ditulis begini: {{LamanKedaiKopi}}

Jika sumber dalam ruang nama yang lain iaitu sebagai contoh ("User:Example"), anda perlu meletakkan nama penuhnya, termasuk ruang nama, maka ia akan jadi: {{User:Example}}

Untuk transklusi apa jua laman sumber (antara mana-mana projek MediaWiki, contohnya en:Wikipedia) dalam kalangan halaman sasaran yang lain, masukkan kod berikut:

{{SOMEPAGE}}

Apabila laman sasaran A yang mengandungi kod ini dipersembahkan, enjin akan menyertakan di situ bukan kod itu, tetapi keseluruhan isi halaman sumber B, SOMEPAGE.

Sebagai contoh, anda mahukan pesanan selamat datang diletakkan di setiap laman perbincangan pengguna baru. Transklusi akan membuat satu pautan "langsung" antara laman templat dengan laman sasaran, yakni laman yang pesanan tersebut ingin dipaparkan. Apabila templat tadi disunting, kesemua laman sasaran tadi akan turut tersunting.

Lagi satu contoh, anda mahu mencipta sebuat laman (templat) yang kandungannya alamat mel anda dan menyertakan templat tersebut bukan sahaja di laman anda, tetapi di semua laman rakan-rakan anda juga. Jika anda pindahkan televisyen dan sofa anda ke kediaman lain, anda pun mengubah templat alamat anda, lalu secara automatik, maklumat baru itu akan muncul di laman rakan-rakan anda.

Contoh

Laman ini sendiri menggunakan transklusi templat. Bahagian yang bertajuk "Bagaimana transklusi bekerja" di atas sebenarnya ditransklusikan daripada dokumen Wikipedia:Transklusi/Bagaimana_Transklusi_Bekerja. Bahagian itu dirangkumkan secara rujukan dengan menggunakan penanda MediaWiki {{Wikipedia:Transklusi/Bagaimana_Transklusi_Bekerja}} untuk merangkumkannya.

Etimologi

Ted Nelson dianggap sebagai orang yang pertama menggunakan istilah "transclusion" (istilah bahasa Inggerisnya). Transklusi pula ialah perbendaharaan kata bagi istilah tersebut.

Laman-laman berkaitan transklusi MediaWiki

Templat

m:Help:Template
Wikipedia:Ruang nama templat
- Wikipedia:Pesanan templat
Wikipedia:Had-had templat
en:Wikipedia:Avoid using meta-templat (ditolak di sana)

Lihat juga

Request for template transclusion from Commons (templat-templat interwiki, dsb.)