Plantilla:Escoltar

Documentació de la plantilla [ mostra ] [ modifica el codi ] [ mostra l'historial ] [ refresca ]

Escoltar permet incloure fitxers d'àudio als articles. S'hauria de fer servir amb àudios que tenen a veure amb el text, com vídeos musicals i enregistraments de sons.

Sintaxi en blanc

{{Escoltar 
| nom_del_fitxer  = 
| títol           = 
| descripció      = 
| tipus           = 
| pos             = <!-- esquerra o dreta -->
| nom_del_fitxer2 = 
| títol2          = 
| descripció2     = 
| nom_del_fitxer3 = 
| títol3          = 
| descripció3     = 
| encapçalament  = 
}}

Simple

En la seva forma més senzilla, la plantilla fa servir els següents paràmetres:

{{Escoltar 
| nom_del_fitxer = 
| títol          = 
| descripció     = 
}}

• nom_del_fitxer (Necessari) – el nom del fitxer d'àudio o video, sense el prefix Fitxer: (abans Imatge:)
• títol (Necessari) – el títol que es mostrarà pel fitxer.
• descripció – una descripció del fitxer.

(També es poden fer servir els noms dels paràmetres en anglès: filename, title i description)

Exemple

{{Escoltar | nom_del_fitxer = Accordion chords-01.ogg | títol = Acords amb acordió | descripció = Acords tocats amb un acordió }}

Fitxers múltiples

Es pot afegir més d'un fitxer a l'article amb una sola plantilla afegint un número a cada paràmetre. Es poden incloure fins a 10 fitxers.

{{Escoltar
| nom_del_fitxer  = 
| títol           = 
| descripció      = 
| nom_del_fitxer2 = 
| títol2          = 
| descripció2     = 
| nom_del_fitxer3 = 
| títol3          = 
| descripció3     = 
}}

• nom_del_fitxer (Necessari) – el nom del fitxer d'àudio o video, sense el prefix Fitxer: (abans Imatge:)
• títol (Necessari) – el títol que es mostrarà per l'arxiu.
• descripció – una descripció de l'arxiu.

Exemple

{{Escoltar | nom_del_fitxer = Accordion chords-01.ogg | títol = Acords amb acordió | descripció = Acords tocats amb un acordió | tipus = música | nom_del_fitxer2 = Moonlight.ogg | títol2 = ''Moonlight Sonata'' | descripció2 = Sonata en C sostingut menor de [[Beethoven]] | nom_del_fitxer3 = Au_clair_de_la_lune_mode_do.mid | títol3 = Au Clair de la Lune | nom_del_fitxer3 = La cançó tradicional francesa | reprodueix3 = no }}

Paràmetres d'estil

La plantilla també fa servir alguns paràmetres per controlar la seva aparença:

• tipus – es pot fer servir per alterar la imatge que es mostra a l'esquerra, en funció del tipus de contingut que s'inclou. Els valors acceptables són so, veu i música (que s'inclou per defecte)
• encapçalament – es pot fer servir per afegir un títol a la caixa.
• ajuda – si s'estableix |ajuda=no, suprimeix el text d'ajuda que apareix normalment a la part inferior de la caixa. Només suprimiu aquest text en el cas que hi hagi altres fitxers a l'article on es pugui llegir aquest missatge d'ajuda; hauria d'aparèixer "com a mínim" al primer fitxer de l'article.
• pos – per defecte la caixa es situa flotant a la dreta de la pantalla. Establint aquest paràmetre a esquerra la caixa es situarà a l'esquerra.
• imatge – defineix una imatge diferent. Ex |imatge|[[Fitxer:Example.jps|20px]]. Es pot establir |imatge=no per fer desaparèixer completament la imatge.
• estil – es pot fer servir per especificar unes característiques concretes d'estil a la caixa. Establint-ho com a float:none ancorarà la caixa. Establint float:none; clear:none permetrà a la caixa ancorada co-existir al costat d'una altra caixa flotant.
• reprodueix – alguns fitxers no es poden mostrar en línia; si aquest és el cas aleshores cal establir |reprodueix=no per prevenir que es mostrin enllaços que no funcionen. Si hi ha més de d'un fitxer, darrera la paraula reprodueix s'ha d'afegir el número corresponent.
• pla – si s'estableix |pla=sí, no apareixeran la major part de les ornamentacions (vora de la taula, imatge, i enllaços d'ajuda) i d'aquesta manera apareixerà una versió minimalista. També treu el posicionament esquerra/dreta, per permetre que la caixa es posicioni manualment fent servir el paràmetre |estil (ex. |estil|float:right). Amb ajuda=sí es mostra l'enllaç d'ajuda.

(També es poden fer servir els noms dels paràmetres en anglès: type, header, help, image, style, play# i plain )

Exemple fent servir els paràmetres tipus=veu, pos=esquerra i encapçalament=text

{{Escoltar | nom_del_fitxer = Phrase de Neil Armstrong.oga | títol = "One small step for a man..." | descripció = Primeres paraules a la lluna. | tipus = veu | pos = esquerra | encapçalament = Enregistraments d'aquesta frase: }}

Exemple fent servir els paràmetres pla=sí i estil=float:left

{{Escoltar | nom_del_fitxer = Accordion chords-01.ogg | títol = Acords d'acordió | pla = sí | estil = float:left }}

Dades de la plantilla

Aquesta és la documentació dels paràmetres de la plantilla utilitzada pel nou editor visual.

Escoltar

Permet incloure múltiples fitxers d'àudio relacionats amb els continguts dels articles. Tots els paràmetres també es poden afegir en anglès.

Paràmetres de la plantilla[Edita les dades de la plantilla]

Aquesta plantilla prefereix el format de paràmetres en la mateixa línia.

Paràmetre		Descripció	Tipus	Estat
Nom del fitxer	nom_del_fitxer	Nom del fitxer d'àudio o video (sense el prefix "Fitxer:").	Fitxer	obligatori
Títol del fitxer	títol	Enunciat que es mostrarà pel fitxer.	Cadena	obligatori
Descripció	descripció	Breu descripció que es mostrarà pel fitxer.	Cadena	suggerit
Reprodueix	reprodueix	Si no es vol que el fitxer es reprodueixi, afegir "no". Si hi ha més d'un fitxer, afegir el número just darrere el "no". Exemple no	Cadena	suggerit
Nom del segon fitxer	nom_del_fitxer2	Nom del segon fitxer d'àudio o video (sense prefix).	Fitxer	suggerit
Títol del segon fitxer	títol2	Enunciat que es mostrarà pel segon fitxer.	Cadena	suggerit
Descripció del segon fitxer	descripció2	Breu descripció que es mostrarà pel segon fitxer.	Cadena	suggerit
Reprodueix el fitxer 2	reprodueix2	Si no es vol que el fitxer es reprodueixi, afegir "no". Si hi ha més d'un fitxer, afegir el número just darrere el "no". Exemple no2	Cadena	suggerit
Nom del tercer fitxer	nom_del_fitxer3	Nom del tercer fitxer d'àudio o video (sense prefix).	Fitxer	suggerit
Títol del tercer fitxer	títol3	Enunciat que es mostrarà pel tercer fitxer.	Cadena	suggerit
Descripció del tercer fitxer	descripció3	Breu descripció que es mostrarà pel tercer fitxer.	Cadena	suggerit
Reprodueix el fitxer 3	reprodueix3	Si no es vol que el fitxer es reprodueixi, afegir "no". Si hi ha més d'un fitxer, afegir el número just darrere el "no". Exemple no3	Cadena	suggerit
Tipus d'arxiu	tipus	Canvia la icona de l'esquerra segons el contingut que s'inclou. Accepta els valors "so", "veu" i "música" (aquest per defecte). Per defecte música	Cadena	suggerit
Encapçalament	encapçalament	Inclou un títol a la caixa on s'encabeixen els fitxers.	Cadena	suggerit
Visibilitat de l'ajuda	ajuda	Si s'afegeix "no", suprimeix l'enllaç a l'ajuda. No és recomanable si no és que hi ha una altra plantilla igual que el contingui.	Cadena	suggerit
Posició de la caixa	pos	Ubicació de la caixa; accepta els valors "esquerra" i "dreta" (per defecte). Per defecte dreta	Desconegut	suggerit
Icona	imatge	Permet canviar la icona o eliminar-la afegint "no". El canvi requereix l'addició de la imatge en termes de codi, com a l'exemple. Exemple [[Fitxer:Example.jps|20px]]	Fitxer	suggerit
Estil de la caixa	estil	Especifica unes característiques concretes d'estil a la caixa. Establint "float:none" ancorarà la caixa, i "float:none; clear:none" permetrà a la caixa ancorada co-existir al costat d'una altra caixa flotant.	Cadena	suggerit
Caixa plana	pla	Afegint "sí" elimina les ornamentacions (vora de la taula, imatge, i enllaços d'ajuda) i deixa una caixa minimalista. El format passa a dependre del paràmetre d'estil.	Cadena	suggerit
Nom del quart fitxer	nom_del_fitxer4	Nom del quart fitxer d'àudio o video (sense prefix).	Fitxer	opcional
Títol del quart fitxer	títol4	Enunciat que es mostrarà pel quart fitxer.	Cadena	opcional
Descripció del quart fitxer	descripció4	Breu descripció que es mostrarà pel quart fitxer.	Cadena	opcional
Reprodueix el fitxer 4	reprodueix4	Si no es vol que el fitxer es reprodueixi, afegir "no". Si hi ha més d'un fitxer, afegir el número just darrere el "no". Exemple no4	Cadena	opcional
Nom del cinquè fitxer	nom_del_fitxer5	Nom del cinquè fitxer d'àudio o video (sense prefix).	Fitxer	opcional
Títol del cinquè fitxer	títol5	Enunciat que es mostrarà pel cinquè fitxer.	Cadena	opcional
Descripció del cinquè fitxer	descripció5	Breu descripció que es mostrarà pel cinquè fitxer.	Cadena	opcional
Reprodueix el fitxer 5	reprodueix5	Si no es vol que el fitxer es reprodueixi, afegir "no". Si hi ha més d'un fitxer, afegir el número just darrere el "no". Exemple no5	Cadena	opcional
Nom del sisè fitxer	nom_del_fitxer6	Nom del sisè fitxer d'àudio o video (sense prefix).	Fitxer	opcional
Títol del sisè fitxer	títol6	Enunciat que es mostrarà pel sisè fitxer.	Cadena	opcional
Descripció del sisè fitxer	descripció6	Breu descripció que es mostrarà pel sisè fitxer.	Cadena	opcional
Reprodueix el fitxer 6	reprodueix6	Si no es vol que el fitxer es reprodueixi, afegir "no". Si hi ha més d'un fitxer, afegir el número just darrere el "no". Exemple no6	Cadena	opcional
Nom del setè fitxer	nom_del_fitxer7	Nom del setè fitxer d'àudio o video (sense prefix).	Fitxer	opcional
Títol del setè fitxer	títol7	Enunciat que es mostrarà pel setè fitxer.	Cadena	opcional
Descripció del setè fitxer	descripció7	Breu descripció que es mostrarà pel setè fitxer.	Cadena	opcional
Reprodueix el fitxer 7	reprodueix7	Si no es vol que el fitxer es reprodueixi, afegir "no". Si hi ha més d'un fitxer, afegir el número just darrere el "no". Exemple no7	Cadena	opcional
Nom del vuitè fitxer	nom_del_fitxer8	Nom del vuitè fitxer d'àudio o video (sense prefix).	Fitxer	opcional
Títol del vuitè fitxer	títol8	Enunciat que es mostrarà pel vuitè fitxer.	Cadena	opcional
Descripció del vuitè fitxer	descripció8	Breu descripció que es mostrarà pel vuitè fitxer.	Cadena	opcional
Reprodueix el fitxer 8	reprodueix8	Si no es vol que el fitxer es reprodueixi, afegir "no". Si hi ha més d'un fitxer, afegir el número just darrere el "no". Exemple no8	Cadena	opcional
Nom del novè fitxer	nom_del_fitxer9	Nom del novè fitxer d'àudio o video (sense prefix).	Fitxer	opcional
Títol del novè fitxer	títol9	Enunciat que es mostrarà pel novè fitxer.	Cadena	opcional
Descripció del novè fitxer	descripció9	Breu descripció que es mostrarà pel novè fitxer.	Cadena	opcional
Reprodueix el fitxer 9	reprodueix9	Si no es vol que el fitxer es reprodueixi, afegir "no". Si hi ha més d'un fitxer, afegir el número just darrere el "no". Exemple no9	Cadena	opcional
Nom del desè fitxer	nom_del_fitxer10	Nom del desè fitxer d'àudio o video (sense prefix).	Fitxer	opcional
Títol del desè fitxer	títol10	Enunciat que es mostrarà pel desè fitxer.	Cadena	opcional
Descripció del desè fitxer	descripció10	Breu descripció que es mostrarà pel desè fitxer.	Cadena	opcional
Reprodueix el fitxer 10	reprodueix10	Si no es vol que el fitxer es reprodueixi, afegir "no". Si hi ha més d'un fitxer, afegir el número just darrere el "no". Exemple no10	Cadena	opcional
filename	filename	cap descripció	Desconegut	opcional
title	title	cap descripció	Desconegut	opcional
description	description	cap descripció	Desconegut	opcional
play	play	cap descripció	Desconegut	opcional
filename2	filename2	cap descripció	Desconegut	opcional
title2	title2	cap descripció	Desconegut	opcional
description2	description2	cap descripció	Desconegut	opcional
play2	play2	cap descripció	Desconegut	opcional
filename3	filename3	cap descripció	Desconegut	opcional
title3	title3	cap descripció	Desconegut	opcional
description3	description3	cap descripció	Desconegut	opcional
play3	play3	cap descripció	Desconegut	opcional
type	type	cap descripció	Desconegut	opcional
header	header	cap descripció	Desconegut	opcional
help	help	cap descripció	Desconegut	opcional
plain	plain	cap descripció	Desconegut	opcional
image	image	cap descripció	Desconegut	opcional
style	style	cap descripció	Desconegut	opcional
filename4	filename4	cap descripció	Desconegut	opcional
title4	title4	cap descripció	Desconegut	opcional
description4	description4	cap descripció	Desconegut	opcional
play4	play4	cap descripció	Desconegut	opcional
filename5	filename5	cap descripció	Desconegut	opcional
title5	title5	cap descripció	Desconegut	opcional
description5	description5	cap descripció	Desconegut	opcional
play5	play5	cap descripció	Desconegut	opcional
filename6	filename6	cap descripció	Desconegut	opcional
title6	title6	cap descripció	Desconegut	opcional
description6	description6	cap descripció	Desconegut	opcional
play6	play6	cap descripció	Desconegut	opcional
filename7	filename7	cap descripció	Desconegut	opcional
title7	title7	cap descripció	Desconegut	opcional
description7	description7	cap descripció	Desconegut	opcional
play7	play7	cap descripció	Desconegut	opcional
filename8	filename8	cap descripció	Desconegut	opcional
title8	title8	cap descripció	Desconegut	opcional
description8	description8	cap descripció	Desconegut	opcional
play8	play8	cap descripció	Desconegut	opcional
filename9	filename9	cap descripció	Desconegut	opcional
title9	title9	cap descripció	Desconegut	opcional
description9	description9	cap descripció	Desconegut	opcional
play9	play9	cap descripció	Desconegut	opcional
filename10	filename10	cap descripció	Desconegut	opcional
title10	title10	cap descripció	Desconegut	opcional
description10	description10	cap descripció	Desconegut	opcional
play10	play10	cap descripció	Desconegut	opcional

La documentació de més amunt està transclosa de Plantilla:Escoltar/ús. (modifica | historial)
Els editors poden fer proves amb aquesta plantilla al seu espai de proves (crea | modifica)
Afegiu categories en la subpàgina /ús. Vegeu les subpàgines d'aquesta plantilla, utilització de paràmetres.