Templat:Dengar

Dokumentasi templatlihatsuntingriwayatsegarkan

Templat ini digunakan pada banyak halaman dan perubahannya kemungkinan memicu perubahan massal pada semua halaman yang menggunakannya. Uji cobalah di subhalaman /bak pasir atau /kasus uji Templat:Dengar, atau subhalaman pengguna Anda. Pertimbangkan untuk mendiskusikan perubahan di halaman pembicaraan sebelum mengimplementasikannya.

Templat ini menggunakan Lua: Modul:Listen

{{Dengar}} digunakan untuk menyematkan berkas audio dan video ke dalam artikel. Templat ini terutama digunakan untuk berkas audio yang ditampilkan terpisah dari teks utama artikel, seperti klip musik atau rekaman pidato/suara.

Penggunaan

Sederhana

{{Dengar
| filename    = 
| title       = 
| description = 
| pos         = 
}}

• filename (Wajib): nama berkas media, tanpa awalan Berkas: (atau File:).
• title (Wajib): judul berkas audio yang akan ditampilkan. Jangan menggunakan pranala wiki (wikilink) pada parameter judul karena tidak akan berfungsi.
• description: keterangan atau deskripsi mengenai audio yang diperdengarkan.
• pos: perataan letak kotak pada halaman; pilihannya adalah right (kanan, bawaan), left (kiri), atau center (tengah).

Lebih dari satu berkas

Beberapa berkas audio/video dapat disematkan sekaligus dalam satu kotak templat dengan menambahkan angka pada setiap parameter (hingga berkas ke-10 atau lebih).

{{Dengar
| filename     = 
| title        = 
| alt          = 
| description  = 
| filename2    = 
| title2       = 
| alt2         = 
| description2 = 
| filename3    = 
| title3       = 
| alt3         = 
| description3 = 
}}

• filename (Wajib): nama berkas media, tanpa awalan Berkas:. Gunakan filename2, filename3, dan seterusnya untuk berkas berikutnya.
• title (Wajib): judul berkas audio yang akan ditampilkan. Gunakan title2, title3, dan seterusnya untuk berkas berikutnya.
• alt: teks alternatif (alt text) untuk gambar/video pratinjau berkas bagi pembaca dengan keterbatasan penglihatan (pembaca layar). Teks ini menjelaskan gambar pratinjau awal video secara ringkas.
• description: keterangan atau deskripsi berkas suara yang sedang diputar. Gunakan description2, description3, dan seterusnya untuk berkas berikutnya.

Parameter tampilan

Templat ini mendukung sejumlah parameter pemformatan dan gaya untuk mengendalikan tata letak dan tampilannya:

• type: menentukan ikon yang muncul di sebelah kiri kotak sesuai dengan tipe konten audio. Nilai yang dapat digunakan:
  • sound (suara/audio umum, bawaan)
  • speech (pidato/rekaman suara berbicara)
  • music (musik/lagu)
• header: menambahkan tajuk teks di bagian atas kotak templat.
• help: jika diisi |help=no, menonaktifkan teks bantuan pemutar media ("Bermasalah memainkan berkas ini?...") di bagian bawah kotak. Sebaiknya hanya digunakan jika sudah ada templat audio lain pada halaman yang sama yang menyertakan pranala bantuan tersebut; setidaknya berkas pertama dalam artikel harus menyertakan teks bantuan.
• pos: secara bawaan kotak mengambang di sisi kanan halaman (right). Nilai dapat diubah ke left (mengambang di sisi kiri) atau center (di tengah).
• image: menentukan gambar atau ikon kustom, misalnya |image=[[Berkas:Example.jpg|50px]]. Jika diisi |image=none, ikon ditiadakan sepenuhnya.
• style: menambahkan deklarasi CSS kustom pada kotak. Menyetel ke float:none akan menambatkan kotak pada posisi tertentu. Menyetel ke float:none; clear:none memungkinkan kotak disandingkan dengan kotak mengambang lainnya.
• play''(n): jika berkas media tertentu tidak dapat diputar langsung di peramban, isi |play=no untuk mencegah munculnya pemutar media yang rusak (misalnya |play2=no untuk berkas ke-2).
• plain: jika diisi |plain=yes, templat akan melepaskan bingkai tabel, ikon, dan teks bantuan sehingga tampil minimalis tanpa pemosisian otomatis. Tata letak selanjutnya dapat disesuaikan menggunakan parameter |style= (misalnya |style=float:right).
• embed: gunakan |embed=yes saat menyematkan templat ini ke dalam kotak info (infobox) untuk meniadakan batas tepi (border), latar belakang, dan bantalan (padding).
• start''(n): stempel waktu awal berkas mulai diputar (misalnya 0:20).
• length''(n): jika diisi |length=hide, menyembunyikan durasi waktu pemutaran berkas.

Contoh penggunaan

Dasar

Akord akordion

Akord yang dimainkan dengan akordion.

Bermasalah memainkan berkas ini? Lihat bantuan media.

{{Dengar
| filename    = Accordion chords-01.ogg
| title       = Akord akordion
| description = Akord yang dimainkan dengan akordion.
}}

Disertai video

Pidato pelantikan Barack Obama (21:21)

Pidato pelantikan pertama Barack Obama, 20 Januari 2009.

{{Dengar
| image       = [[Berkas:Crystal Project video camera.png|50px]]
| help        = no
| filename    = Barack Obama inaugural address.ogv
| alt         = Seorang pria berkulit hitam mengenakan mantel hitam berpidato di mimbar diapit teleprompter. Di belakangnya terdapat sejumlah hadirin berpakaian hangat.
| title       = Pidato pelantikan Barack Obama
| description = [[Pelantikan pertama Barack Obama|Pidato pelantikan pertama]] Barack Obama, 20 Januari 2009.
}}

Disertai tajuk

Rekaman perkataan:

"One small step for a man..."

Kata-kata pertama yang diucapkan manusia di Bulan.

Bermasalah memainkan berkas ini? Lihat bantuan media.

{{Dengar
| header      = Rekaman perkataan:
| type        = speech
| filename    = Phrase de Neil Armstrong.oga
| title       = "One small step for a man..."
| description = Kata-kata pertama yang diucapkan manusia di [[Bulan]].
}}

Penyematan dalam kotak info

{{Infobox person
| name        = Pemain Akordion
| occupation  = Musikus
| module      =
{{Dengar
| filename    = Accordion chords-01.ogg
| title       = Akord akordion
| embed       = yes
}}
}}

Format polos (plain)

{{Dengar
| filename    = Accordion chords-01.ogg
| title       = Akord akordion
| plain       = yes
| style       = float:left
}}

Banyak berkas

Akord akordion

Akord yang dimainkan dengan instrumen akordion.

Moonlight Sonata

Sonata Piano No. 14 karya Ludwig van Beethoven.

Waltz No. 15

Dari Enam Belas Waltz, Op. 39 karya Johannes Brahms.

Bermasalah memainkan berkas-berkas ini? Lihat bantuan media.

{{Dengar
| type         = music
| filename     = Accordion chords-01.ogg
| title        = Akord akordion
| description  = Akord yang dimainkan dengan instrumen akordion.
| filename2    = Moonlight.ogg
| title2       = ''Moonlight Sonata''
| description2 = Sonata Piano No. 14 karya [[Ludwig van Beethoven]].
| filename3    = Brahms-waltz15.ogg
| title3       = Waltz No. 15
| description3 = Dari ''Enam Belas Waltz, Op. 39'' karya [[Johannes Brahms]].
}}

Kategori pelacak

Modul pemroses templat ini otomatis menambahkan kategori pelacak berikut jika terpenuhi:

• Kategori:Articles with hAudio microformats – halaman yang memuat templat dengan format mikro hAudio.
• Kategori:Articles with empty listen template – templat yang dipanggil tanpa menyertakan berkas yang valid.
• Kategori:Listen template using plain parameter – penggunaan templat dengan parameter plain=yes.

TemplateData

Menyematkan berkas audio atau video ke dalam artikel lengkap dengan pemutar media.

Parameter templat

Templat ini memiliki pemformatan ubahsuai.

Teks judul atau tajuk yang ditampilkan di bagian atas kotak templat.

Menentukan ikon di sisi kiri: "sound" untuk suara umum, "music" untuk musik, atau "speech" untuk rekaman pidato/bicara.

Nilai yang disarankan

sound music speech

Bawaan

sound

Contoh

music

Berkas gambar kustom pengganti ikon pengeras suara bawaan. Masukkan "none" untuk meniadakan ikon sepenuhnya.

Contoh

[[Berkas:Example.jpg|50px]], none

Nama berkas media tanpa awalan Berkas: atau File:. Gunakan filename2, filename3, dst. untuk berkas berikutnya.

Judul berkas audio yang ditampilkan di kotak. Gunakan title2, title3, dst. untuk berkas berikutnya.

Keterangan atau deskripsi tambahan mengenai berkas audio yang dimainkan. Gunakan description2, description3, dst. untuk berkas berikutnya.

Stempel waktu berkas mulai diputar (gunakan start2, start3, dst. untuk berkas berikutnya).

Contoh

0:20

Isi "hide" untuk menyembunyikan keterangan durasi pemutaran berkas (gunakan length2, length3, dst. untuk berkas berikutnya).

Contoh

hide

Isi "no" untuk menyembunyikan pemutar media sebaris jika berkas bermasalah (gunakan play2, play3, dst. untuk berkas berikutnya).

Contoh

no

Isi "no" untuk menonaktifkan teks bantuan "Bermasalah memainkan berkas ini?". Hanya disarankan jika sudah ada templat lain dalam artikel yang menyertakan bantuan.

Contoh

no

Posisi letak kotak templat pada halaman (left, center, atau right).

Nilai yang disarankan

left center right

Bawaan

right

Contoh

left

Isi "yes" untuk menampilkan versi minimalis tanpa bingkai kotak, ikon, dan teks bantuan.

Contoh

yes

Isi "yes" untuk menghilangkan batas tepi dan bantalan agar rapi saat disematkan di dalam kotak info (infobox).

Contoh

yes

Aturan CSS tambahan untuk mengatur pemformatan atau tata letak kotak.

Contoh

float:none; clear:none

Lihat pula

• {{Audio}} – templat penyematan berkas suara secara sebaris (inline) di tengah kalimat artikel.
• {{Listen voice}} – templat variasi untuk contoh suara atau klip suara figur.