Vés al contingut

Plantilla:Escoltar

De la Viquipèdia, l'enciclopèdia lliure
Icona de documentació de mòdul 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

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

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

[modifica]

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

[modifica]

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
}}

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àmetreDescripcióTipusEstat
Nom del fitxernom_del_fitxer

Nom del fitxer d'àudio o video (sense el prefix "Fitxer:").

Fitxerobligatori
Títol del fitxertítol

Enunciat que es mostrarà pel fitxer.

Cadenaobligatori
Descripciódescripció

Breu descripció que es mostrarà pel fitxer.

Cadenasuggerit
Reprodueixreprodueix

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
Cadenasuggerit
Nom del segon fitxernom_del_fitxer2

Nom del segon fitxer d'àudio o video (sense prefix).

Fitxersuggerit
Títol del segon fitxertítol2

Enunciat que es mostrarà pel segon fitxer.

Cadenasuggerit
Descripció del segon fitxerdescripció2

Breu descripció que es mostrarà pel segon fitxer.

Cadenasuggerit
Reprodueix el fitxer 2reprodueix2

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
Cadenasuggerit
Nom del tercer fitxernom_del_fitxer3

Nom del tercer fitxer d'àudio o video (sense prefix).

Fitxersuggerit
Títol del tercer fitxertítol3

Enunciat que es mostrarà pel tercer fitxer.

Cadenasuggerit
Descripció del tercer fitxerdescripció3

Breu descripció que es mostrarà pel tercer fitxer.

Cadenasuggerit
Reprodueix el fitxer 3reprodueix3

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
Cadenasuggerit
Tipus d'arxiutipus

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
Cadenasuggerit
Encapçalamentencapçalament

Inclou un títol a la caixa on s'encabeixen els fitxers.

Cadenasuggerit
Visibilitat de l'ajudaajuda

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.

Cadenasuggerit
Posició de la caixapos

Ubicació de la caixa; accepta els valors "esquerra" i "dreta" (per defecte).

Per defecte
dreta
Desconegutsuggerit
Iconaimatge

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]]
Fitxersuggerit
Estil de la caixaestil

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.

Cadenasuggerit
Caixa planapla

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.

Cadenasuggerit
Nom del quart fitxernom_del_fitxer4

Nom del quart fitxer d'àudio o video (sense prefix).

Fitxeropcional
Títol del quart fitxertítol4

Enunciat que es mostrarà pel quart fitxer.

Cadenaopcional
Descripció del quart fitxerdescripció4

Breu descripció que es mostrarà pel quart fitxer.

Cadenaopcional
Reprodueix el fitxer 4reprodueix4

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
Cadenaopcional
Nom del cinquè fitxernom_del_fitxer5

Nom del cinquè fitxer d'àudio o video (sense prefix).

Fitxeropcional
Títol del cinquè fitxertítol5

Enunciat que es mostrarà pel cinquè fitxer.

Cadenaopcional
Descripció del cinquè fitxerdescripció5

Breu descripció que es mostrarà pel cinquè fitxer.

Cadenaopcional
Reprodueix el fitxer 5reprodueix5

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
Cadenaopcional
Nom del sisè fitxernom_del_fitxer6

Nom del sisè fitxer d'àudio o video (sense prefix).

Fitxeropcional
Títol del sisè fitxertítol6

Enunciat que es mostrarà pel sisè fitxer.

Cadenaopcional
Descripció del sisè fitxerdescripció6

Breu descripció que es mostrarà pel sisè fitxer.

Cadenaopcional
Reprodueix el fitxer 6reprodueix6

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
Cadenaopcional
Nom del setè fitxernom_del_fitxer7

Nom del setè fitxer d'àudio o video (sense prefix).

Fitxeropcional
Títol del setè fitxertítol7

Enunciat que es mostrarà pel setè fitxer.

Cadenaopcional
Descripció del setè fitxerdescripció7

Breu descripció que es mostrarà pel setè fitxer.

Cadenaopcional
Reprodueix el fitxer 7reprodueix7

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
Cadenaopcional
Nom del vuitè fitxernom_del_fitxer8

Nom del vuitè fitxer d'àudio o video (sense prefix).

Fitxeropcional
Títol del vuitè fitxertítol8

Enunciat que es mostrarà pel vuitè fitxer.

Cadenaopcional
Descripció del vuitè fitxerdescripció8

Breu descripció que es mostrarà pel vuitè fitxer.

Cadenaopcional
Reprodueix el fitxer 8reprodueix8

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
Cadenaopcional
Nom del novè fitxernom_del_fitxer9

Nom del novè fitxer d'àudio o video (sense prefix).

Fitxeropcional
Títol del novè fitxertítol9

Enunciat que es mostrarà pel novè fitxer.

Cadenaopcional
Descripció del novè fitxerdescripció9

Breu descripció que es mostrarà pel novè fitxer.

Cadenaopcional
Reprodueix el fitxer 9reprodueix9

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
Cadenaopcional
Nom del desè fitxernom_del_fitxer10

Nom del desè fitxer d'àudio o video (sense prefix).

Fitxeropcional
Títol del desè fitxertítol10

Enunciat que es mostrarà pel desè fitxer.

Cadenaopcional
Descripció del desè fitxerdescripció10

Breu descripció que es mostrarà pel desè fitxer.

Cadenaopcional
Reprodueix el fitxer 10reprodueix10

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
Cadenaopcional
filenamefilename

cap descripció

Desconegutopcional
titletitle

cap descripció

Desconegutopcional
descriptiondescription

cap descripció

Desconegutopcional
playplay

cap descripció

Desconegutopcional
filename2filename2

cap descripció

Desconegutopcional
title2title2

cap descripció

Desconegutopcional
description2description2

cap descripció

Desconegutopcional
play2play2

cap descripció

Desconegutopcional
filename3filename3

cap descripció

Desconegutopcional
title3title3

cap descripció

Desconegutopcional
description3description3

cap descripció

Desconegutopcional
play3play3

cap descripció

Desconegutopcional
typetype

cap descripció

Desconegutopcional
headerheader

cap descripció

Desconegutopcional
helphelp

cap descripció

Desconegutopcional
plainplain

cap descripció

Desconegutopcional
imageimage

cap descripció

Desconegutopcional
stylestyle

cap descripció

Desconegutopcional
filename4filename4

cap descripció

Desconegutopcional
title4title4

cap descripció

Desconegutopcional
description4description4

cap descripció

Desconegutopcional
play4play4

cap descripció

Desconegutopcional
filename5filename5

cap descripció

Desconegutopcional
title5title5

cap descripció

Desconegutopcional
description5description5

cap descripció

Desconegutopcional
play5play5

cap descripció

Desconegutopcional
filename6filename6

cap descripció

Desconegutopcional
title6title6

cap descripció

Desconegutopcional
description6description6

cap descripció

Desconegutopcional
play6play6

cap descripció

Desconegutopcional
filename7filename7

cap descripció

Desconegutopcional
title7title7

cap descripció

Desconegutopcional
description7description7

cap descripció

Desconegutopcional
play7play7

cap descripció

Desconegutopcional
filename8filename8

cap descripció

Desconegutopcional
title8title8

cap descripció

Desconegutopcional
description8description8

cap descripció

Desconegutopcional
play8play8

cap descripció

Desconegutopcional
filename9filename9

cap descripció

Desconegutopcional
title9title9

cap descripció

Desconegutopcional
description9description9

cap descripció

Desconegutopcional
play9play9

cap descripció

Desconegutopcional
filename10filename10

cap descripció

Desconegutopcional
title10title10

cap descripció

Desconegutopcional
description10description10

cap descripció

Desconegutopcional
play10play10

cap descripció

Desconegutopcional