Plantilla:Escoltar/ús

De Viquidites

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.

Ús[modifica el codi]

Sintaxi en blanc[modifica el codi]

{{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[modifica el codi]

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ó
}}
Acords amb acordió

Acords tocats amb un acordió

Problemes per escoltar l'arxiu? Vegeu l'ajuda

Fitxers múltiples[modifica el codi]

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
}}
Acords amb acordió

Acords tocats amb un acordió

Moonlight Sonata

Sonata en C sostingut menor de Beethoven

Au Clair de la Lune
La cançó tradicional francesa

Problemes per escoltar els arxius? Vegeu l'ajuda

Paràmetres d'estil[modifica el codi]

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).

(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
Enregistraments d'aquesta frase:
"One small step for a man..."

Primeres paraules a la lluna.

Problemes per escoltar l'arxiu? Vegeu l'ajuda
{{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
Acords d'acordió


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