Templat:Dengar/doc

{{Dengar/doc}} untuk memasukkan berkas audio seperti potongan musik atau rekaman suara ke dalam artikel. Berkas audio ditampilkan di dalam kotak yang terpisah dari teks.

Penggunaan

Sederhana

Dalam penggunaan yang paling sederhana, templat ini memerlukan parameter sebagai berikut:

{{Listen
 |filename     = 
 |title        = 
 |description  = 
}}

• filename (harus diisi): nama berkas, tanpa didahului awalan kata Berkas: (dulu Gambar:)
• title (harus diisi): judul berkas audio
• description: keterangan tentang berkas audio

Contoh

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

Lebih dari satu berkas

Berkas-berkas audio tambahan dalam dimasukkan dalam artikel dengan menambahkan set-set parameter kedua, ketiga, dan seterusnya pada satu templat. Maksimum 10 berkas audio dapat ditangani oleh templat ini.

{{Listen
 |filename     = 
 |title        = 
 |description  = 
 |filename2    = 
 |title2       = 
 |description2 = 
 |filename3    = 
 |title3       = 
 |description3 = 
}}

• filename (harus diisi): nama berkas, tanpa didahului awalan kata Berkas: (dulu Gambar:)
• title (harus diisi): judul berkas audio
• description: keterangan tentang berkas audio

Contoh

{{Listen |filename = Accordion chords-01.ogg |title = Akord akordion |description = Akord dimainkan dengan sebuah akordion |type = musik |filename2 = Moonlight.ogg |title2 = ''Moonlight Sonata'' |description2 = "Sonata dalam C-sharp minor" karya [[Beethoven]] |filename3 = Au_clair_de_la_lune_mode_do.mid |title3 = Au Clair de la Lune |description3 = Lagu anak-anak tradisional Perancis |play3 = no }}

Parameter tampilan

Templat ini juga dapat menggunakan sejumlah parameter tampilan untuk mengubah tampilan kotak dan gambar:

• type: diisi dengan sound (suara), speech (pidato), atau music (musik) bergantung kepada tipe isi berkas audio. Bila tidak diisi, maka dianggap sebagai musik.
• header: diisi dengan frasa yang ingin dijadikan tajuk pada kotak
• help: bila disetel |help=no, maka templat tidak akan menampilkan teks bantuan di dasar kotak. Setel dengan |help=no bila berkas audio lain pada artikel sudah menampilkan teks bantuan. Mohon paling sedikit beri satu teks bantuan pada halaman artikel.
• pos: posisi kotak pada halaman, right untuk sisi kanan artikel (nilai awal) atau left untuk di sisi kiri
• image: diisi bila ingin menampilkan berkas gambar yang lain, misalnya: |image=[[Berkas:Example.jps|20px]]. Bila disetel dengan |image=none, maka gambar sama sekali tidak ditampilkan.
• style: diisi dengan gaya tampilan yang diinginkan untuk kotak. Bila disetel dengan float:none, maka posisi kotak akan terkunci di satu tempat. Sementara bila disetel float:none; clear:none, kotak akan terkunci di dalam kotak lain.
• play#: sejumlah media tidak dapat ditampilkan langsung; bila demikian, setel dengan |play=no agar tidak ditampilkan
• plain: bila disetel |plain=yes, maka kotak akan ditampilkan tanpa ornamen (bingkai tabel, gambar, dan pranala ke teks bantuan). Hasilnya adalah kotak sederhana yang tidak menempel di sisi kiri/sisi kanan secara otomatis sehingga posisi dapat disetel secara manual dengan |style= misalnya: |style=float:right).

Contoh penggunaan parameter |type=sound dan |header=text

{{Listen |filename = Frase de Neil Armstrong.ogg |description = Kata-kata pertama yang diucapkan manusia di [[Bulan]]. |type = speech |pos = left |header = Rekaman: }}

Contoh penggunaan parameter |plain=yes dan |style=float:left

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

Lihat pula

• {{Sound sample box align right}}