Redigerer Mal:Lytte/dok

{{Dokumentasjonsunderside}}
<!-- LEGG TIL KATEGORIER OG INTERWIKIER PÅ BUNNEN AV DENNE SIDEN -->

== Formål ==

Denne malen lar leseren spille av en eller flere lydfiler. 

== Bruk ==

=== Grunnleggende parametre ===
Som et minimum må parametrene <var>filnavn</var> og <var>tittel</var> spesifiseres. <var>beskrivelse</var> er en valgfri parameter.
* <var>filnavn</var> – navnet på musikkfilen, uten prefikset «Fil:»
* <var>tittel</var> – tittel på musikkstykket
* <var>beskrivelse</var> – beskrivelse av innspillingen (valgfri parameter)

=== Avspiller som flyter ===
For å få en avspiller som flyter til høyre eller venstre for teksten (akkurat som bilder med <var>thumb</var> gjør), må parameteren <var>pos</var> spesifiseres. I tillegg kan <var>overskrift</var> og <var>type</var> spesifiseres.
* <var>pos</var> – settes til enten «left» eller «right» (uten anførselstegn)
* <var>overskrift</var> – overskrift øverst i boksen (valgfri parameter)
* <var>type</var> – settes til enten «lyd», «tale» eller «musikk» (valgfri parameter, bestemmer hvilket ikon som skal benyttes, default er ''musikk'')
:{| 
| lyd (default): || [[Fil:Gnome-mime-sound-openclipart.svg|65x50px]]
| tale: || [[Fil:Audio-input-microphone.svg|65x50px]]
| musikk: || [[Fil:Gnome-mime-audio-openclipart.svg|65x50px]]
|}

=== Flere musikkfiler === 
Ubegrenset antall musikkfiler kan plasseres i samme boks. Disse gis med parametren på formen:
* <var>filnavn2</var>   – navn på musikkfil 2
* <var>tittel2</var>      – tittel til musikkfil 2
* <var>beskrivelse2</var> – beskrivelse av musikkfil 2 (valgfri parameter)
der du bare bytter ut 2-tallet med 3, 4, 5, osv… for flere filer.

== Eksempler ==

=== Spiller som flyter til høyre ===

<pre>{{lytte
 | filnavn     = Thomas_Tallis_Lamentations_I_(The_Tudor_Consort).ogg
 | tittel        = Lamentatione Jeremiae Prophetae
 | beskrivelse  = Tatt opp i Madonna dei Monti, Rome av [[The Tudor Consort]] i november 2005 (5Mb). Varighet: {{Varighet|m=8|s=58}}
 | pos      = right
}}</pre>
gir
{{lytte
 | filnavn     = Thomas_Tallis_Lamentations_I_(The_Tudor_Consort).ogg
 | tittel        = Lamentatione Jeremiae Prophetae
 | beskrivelse  = Tatt opp i Madonna dei Monti, Rome av [[The Tudor Consort]] i november 2005 (5Mb). Varighet: {{Varighet|m=8|s=58}}
 | pos = right
}}
{{clear}}

=== Spiller som flyter til høyre, med flere filer ===

<pre>{{lytte
 | overskrift   = Klavierkonzert d-moll, BWV 1052. Fulda Symphonic Orchestra (2000)
 | filnavn      = Johann Sebastian Bach - Klavierkonzert d-moll - 1. Allegro.ogg
 | tittel       = 1st movement, allegro
 | filnavn2     = Johann Sebastian Bach - Klavierkonzert d-moll - 2. Adagio.ogg
 | tittel2      = 2nd movement, adagio
 | filnavn3     = Johann Sebastian Bach - Klavierkonzert d-moll - 3. Allegro.ogg
 | tittel3      = 3rd movement, allegro
 | pos          = right
}}</pre>
gir
{{lytte
 | overskrift   = Klaverkonsert i d-moll, BWV 1052. Fulda symfoniorkester (2000).
 | filnavn      = Johann Sebastian Bach - Klavierkonzert d-moll - 1. Allegro.ogg
 | tittel       = Første sats, allegro
 | filnavn2     = Johann Sebastian Bach - Klavierkonzert d-moll - 2. Adagio.ogg
 | tittel2      = Andre sats, adagio
 | filnavn3     = Johann Sebastian Bach - Klavierkonzert d-moll - 3. Allegro.ogg
 | tittel3      = Tredje sats, allegro
 | pos          = right
}}
{{clear}}

=== Enkel spiller som følger teksten ===
<pre>{{lytte
 | filnavn     = Thomas_Tallis_Lamentations_I_(The_Tudor_Consort).ogg
 | tittel        = Lamentatione Jeremiae Prophetae
 | beskrivelse  = Tatt opp i Madonna dei Monti, Rome av [[The Tudor Consort]] i november 2005 (5Mb)
 | pos = left
 | style = float:none; clear: none;
}}</pre>

gir:

{{lytte
 | filnavn     = Thomas_Tallis_Lamentations_I_(The_Tudor_Consort).ogg
 | tittel        = Lamentatione Jeremiae Prophetae
 | beskrivelse  = Tatt opp i Madonna dei Monti, Rome av [[The Tudor Consort]] i november 2005 (5Mb)
 | pos = left
 | style = float:none; clear: none;
}}

== TemplateData ==
<templatedata>
{
	"description": "Brukes til å inkludere lydfiler i artikler.",
	"format": "{{_\n| ____________ = _\n}}\n",
	"params": {
		"type": {
			"label": "Musikk eller taleikon",
			"description": "Viser musikkikon dersom satt til musikk, og viser mikrofonikon dersom satt til tale.",
			"type": "line",
			"example": "musikk",
			"default": "lyd"
		},
		"start": {
			"label": "Start time",
			"description": "Timestamp at which the first file should start playing (start2, start3, etc. can be used for subsequent files)",
			"type": "line",
			"example": "0:20"
		},
		"length": {
			"label": "Hide duration?",
			"description": "Enter \"hide\" here to hide the duration of the first file (length2, length3, etc. can be used for subsequent files).",
			"type": "line",
			"example": "hide"
		},
		"play": {
			"label": "Hide player?",
			"description": "Enter \"no\" here to hide the file player for the first file (play2, play3, etc. can be used for subsequent files). To be used for some media files that cannot be displayed inline, to prevent a broken inline link from showing.",
			"type": "line",
			"example": "no"
		},
		"pos": {
			"label": "Position",
			"description": "Enter \"left\" or \"center\" here to change the default position of the template from on the right.",
			"type": "line",
			"example": "left",
			"default": "right"
		},
		"plain": {
			"label": "Plain style?",
			"description": "Enter \"yes\" here to remove most of the ornamentation (border, background, icon and help text) and the float/positioning of the template to give a minimalist version, allowing the user to use the custom CSS (\"style\") parameter to style and position the template.",
			"type": "line",
			"example": "yes"
		},
		"embed": {
			"label": "Optimise for embedding?",
			"description": "Enter any text here to remove the left, right and bottom border, the background, the icon, the help text and the padding of the template for use in an infobox.",
			"type": "line",
			"example": "y"
		},
		"style": {
			"label": "Custom CSS",
			"description": "Custom CSS for the template",
			"type": "content",
			"example": "float:none; clear:none"
		},
		"overskrift": {
			"aliases": [
				"header"
			],
			"label": "Header",
			"description": "Tekst eller innhold som vises over alle filene, men inne i sideboksen. Tillater wikimarkup",
			"type": "content"
		},
		"bilde": {
			"aliases": [
				"image"
			],
			"label": "Bilde",
			"description": "Egendefinert bilde som erstatter høyttaler-ikonet. Alternativt bruk \"none\" for å fjerne ikonet helt.",
			"example": "[[File:Example.jpg|50px]], none",
			"type": "wiki-file-name"
		},
		"filnavn": {
			"aliases": [
				"filename"
			],
			"label": "Filnavn",
			"description": "Filnavnet til lydfilen. filnavn2, filename3 osv kan benyttes for flere filer.",
			"type": "wiki-file-name",
			"required": true
		},
		"tittel": {
			"aliases": [
				"title"
			],
			"label": "Tittel",
			"description": "Tittelen som skal vises for filen. tittel2, tittel3 osv kan benyttes for flere filer.",
			"type": "string",
			"required": true
		},
		"beskrivelse": {
			"aliases": [
				"description"
			],
			"label": "Beskrivelse",
			"description": "En beskrivelse av filen beskrivelse2, beskrivelse3, osv kan benyttes for flere filer.",
			"type": "string",
			"suggested": true
		},
		"hjelp": {
			"aliases": [
				"help"
			],
			"label": "Skjul hjelpetekst?",
			"description": "Legg til \"nei\" her for å skjule hjelpeteksten for problemer med å spille av filer.",
			"example": "no",
			"type": "line"
		}
	},
	"paramOrder": [
		"overskrift",
		"type",
		"bilde",
		"filnavn",
		"tittel",
		"beskrivelse",
		"start",
		"length",
		"play",
		"hjelp",
		"pos",
		"plain",
		"embed",
		"style"
	]
}
</templatedata>

== Se også ==
* {{tl|Audio}}, a variant of this template meant more for inline sounds like pronunciations.
* {{tl|Multi-listen start}}, {{tl|Multi-listen item}}, and {{tl|Multi-listen end}}, to link to multiple audio files.

<includeonly>
<!-- KATEGORIER OG INTERWIKIER UNDER DENNE LINJEN -->

{{DEFAULTSORT:{{PAGENAME}}}}
[[Kategori:Lenkemaler]]
[[Kategori:Musikkmaler]]

[[ar:قالب:استمع]]
[[be:Шаблон:Listen]]
[[be-x-old:Шаблён:Слухаць]]
[[bs:Šablon:Slušajte]]
[[ca:Plantilla:Escoltar]]
[[cs:Šablona:Poslech]]
[[da:Skabelon:Lyt]]
[[de:Vorlage:Bild mit Audio]]
[[et:Mall:Heli]]
[[en:Template:Listen]]
[[es:Plantilla:Multimedia]]
[[eo:Ŝablono:Aŭskultu]]
[[fa:الگو:شنیدن]]
[[fi:Malline:Kuuntele]]
[[fr:Modèle:Son]]
[[hsb:Předłoha:Posłuchaj]]
[[hu:Sablon:Hallgat]]
[[id:Templat:Dengar]]
[[it:Template:Multimedia]]
[[ja:Template:試聴]]
[[ka:თარგი:მოსმენა]]
[[kk:Үлгі:Listen]]
[[ko:틀:듣기]]
[[lv:Veidne:Listen]]
[[mk:Шаблон:Преслушување]]
[[ms:Templat:Listen/doc]]
[[mwl:Modelo:Oube]]
[[nl:Sjabloon:Luister]]
[[pl:Szablon:Listen]]
[[pt:Predefinição:Escute]]
[[ru:Шаблон:Listen]]
[[sk:Šablóna:Počúvaj]]
[[sl:Predloga:Poslušaj]]
[[sr:Шаблон:Slušajte]]
[[sv:Mall:Lyssna]]
[[ta:வார்ப்புரு:Listen]]
[[tr:Şablon:Dinle]]
[[uk:Шаблон:Звук]]
[[vi:Bản mẫu:Nghe nhìn]]
[[zh:Template:Listen]]
</includeonly>