Plantilla:Escoltar/ús

Escoltar/ús 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 }}