Plantilla:Versió

De Viquipèdia
Dreceres ràpides: navegació, cerca
Icona de documentació de mòdul Documentació de la plantilla[mostra] [modifica] [historial] [refresca]

Descripció[modifica el codi]

Aquesta plantilla serveix per a presentar taules d'historial de versions de programari en un format estandarditzat.

Molts articles a la Viquipèdia utilitzen taules amb codis de colors per a il·lustrar l'historial de versions o de publicació de programari. La plantilla ha estat importada de la Wikipedia en alemany on s'utilitza com l'estàndard de taules d'historial amb codificació per colors.

Aquesta plantilla s'utilitza en taules de la Viquipèdia creades fent ús de la «sintaxi wiki». Possibilita afegir llegendes ja sigui formant part de la taula principal o com a taules flotants independents. Atès que els colors no són visibles per als lectors cecs o amb discapacitat visual, aquesta plantilla utilitza la informació de substitució, quan sigui necessari, per a millorar l'accessibilitat, per exemple usant l'atribut "title".

En crear un històric de versions, tinguem en compte que «menys és més» (less is more): la Viquipèdia no és un directori ni te la funció de «changelog» (llista de canvis). Només hauríem de publicar les versions de programari principals, les més significatives.

Aspecte general[modifica el codi]

Versió Any Canvis significatius
Una versió antiga, sense suport: 1.0 2010 Versió antiga
Una versió antiga, encara amb suport: 1.8 2011 Versió antiga, amb suport
La darrera versió estable: 2.0 2012 Darrera versió
Proper llançament: 3.0 2017 Proper llançament
Llegenda:
Versió antiga
Versió antiga, amb suport
Darrera versió
Darrera versió preliminar
Proper llançament

Quan evitar el seu ús[modifica el codi]

Productes discontinuats (obsolets)
En productes discontinuats totes les version serien «Versió antiga» (sense suport). Atès que no existiria cap distinció entre les diferents versions, l'ús d'aquesta plantilla no tindria cap fonament. N'hi hauria prou amb definir el producte a la infotaula com a discontinuat.
Quan només hi ha una versió estable
Quan no hi ha versions anteriors amb suport, versions de prova o versions futures anunciades, tota la taula consistiria en versions vermelles amb una única versió en verd al final. En aquests casos, no es recomana l'ús d'aquesta plantilla.

Paràmetres[modifica el codi]

Quadre de llegenda[modifica el codi]

Paràmetre Descripció Notes
1 Tipus de llegenda Qualsevol dels següents valors genera un quadre de llegenda. Els valors permesos són:
l: Llegenda horitzontal
lv: Llegenda vertical
t: Llegenda horitzontal, taula
tv: Llegenda vertical, taula
show Contingut de la llegenda Aquest paràmetre és opcional. Per defecte, el quadre de la llegenda conté els següents 6 elements:
  1. Llegenda: (apareix en negreta quan el tipus de llegenda és «l», «lv», o «t»)
  2. Versió antiga
  3. Versió antiga, amb suport
  4. Versió actual (apareix en negreta)
  5. Darrera versió preliminar
  6. Proper llançament

Aquest paràmetre permet ocultar o mostrar cada element de la llegenda. Cada dígit controla l'estat del seu element associat a la llista anterior.
Les xifres vàlides són: «1» (mostra l'element de llegenda associada) i «0» (oculta l'element de llegenda associada).
Sintaxi: "show=XXX" on "XXX" és:

  • un nombre de sis dígits quan el tipus de llegenda és «l» o «lv»
  • un nombre de cinc dígits quan el tipus de llegenda és «t» o «tv», perquè el primer element («Llegenda:») no es pot amagar.

Els dígits addicionals a l'esquerra són ignorats.

style Estils CSS Aquest paràmetre és opcional. Es fa servir per canviar el format de plantilla, l'estil i el disseny a través de la sintaxi CSS.

En combinació amb la llegenda, el CSS especificat s'aplica a tot el bloc.

Cel·les de taula[modifica el codi]

Paràmetre Descripció Notes
1 Tipus de dada Qualsevol dels següents valor canvia el color de fons de la cèl·la en que s'insereix:
o: Indica una versió antiga, sense suport
co: Indica una versió antiga, encara suportada
c: Indica una última versió estable
cp: Indica una darrera versió preliminar
p: Indica un proper llançament
2 Text Especifica el text que es mostrarà a la cel·la, en general un nombre de versió o el nom d'una versió específica.
style Estils CSS Aquest paràmetre és opcional. Es fa servir per canviar el format de plantilla, l'estil i el disseny a través de la sintaxi CSS.

Aquest paràmetre es pot inserir en una cel·la de la taula per fer complir les definicions CSS en aquesta cel·la.

sortKey Clau d'ordenació Aquest paràmetre és opcional. Una clau d'ordenació és una cadena invisible que s'utilitza per canviar la forma en què s'ordena una determinada cel·la a la taula. Per exemple, la frase «ACME's Bow» està ordenada juntament amb frases que comencen amb A. Afegit la clau d'ordenació «Bow» a la frase fa que sigui ordenada amb altres frases que comencen amb «B» (o, per ser més precisa, amb «Bow»).

Per a obtenir més informació sobre ordenació de taules vegeu: Taules amb ordenació.

Exemples[modifica el codi]

Quadre de llegenda[modifica el codi]

Descripció El que s'escriu Com es veu
Llegenda horitzontal
{{versió |l |show=110111}}
Llegenda:
Versió antiga
Versió antiga, amb suport
Darrera versió
Darrera versió preliminar
Proper llançament
Llegenda vertical
{{versió |lv |show=011101}}
Llegenda:
Versió antiga
Versió antiga, amb suport
Versió actual
Darrera versió preliminar
Proper llançament
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Llegenda horitzontal, taula
{{versió |t |show=11110}}
Llegenda: Versió antiga Versió antiga, amb suport Versió actual Darrera versió preliminar Proper llançament
Llegenda vertical, taula
{{versió |tv |show=01111}}
Llegenda:
Versió antiga
Versió antiga, amb suport
Versió actual
Darrera versió preliminar
Proper llançament
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Cel·les de taula[modifica el codi]

Descripció El que s'escriu Com es veu
Versió antiga, sense suport
{{versió |o |1.0}}
Una versió antiga, sense suport: 1.0
Versió antiga, encara suportada
{{versió |co |2.0}}
Una versió antiga, encara amb suport: 2.0
Última versió estable
{{versió |c |3.0}}
La darrera versió estable: 3.0
Darrera versió preliminar
{{versió |cp |4.0}}
La darrera versió preliminar d'un futur llançament: 4.0
Proper llançament
{{versió |p |5.0}}
Proper llançament: 5.0

Taules amb ordenació[modifica el codi]

La plantilla es pot utilitzar en taules amb ordenació. Si la columna versió es pot ordenar, la clau d'ordenació per defecte pren el valor del paràmetre versió. Si necessita una ordenació diferent, afegiu el paràmetre SortKey de la següent manera:

El que s'escriu Com es veu
{| class="wikitable sortable"
|-
! Versió !! Data !! Descripció
|-
| {{versió  |o  |1.0    |sortKey=1.0}}
| 2010-07-23 || Versió antiga, sense suport
|-
| {{versió  |co |2.0    |sortKey=2.0}}
| 2011-06-27 || Versió antiga, encara suportada
|-
| {{versió  |cp |3.0 DP |sortKey=3.0 A}}
| 2012-03-02 || Vista prèvia dels desenvolupadors
|-
| {{versió  |cp |3.0 CP |sortKey=3.0 B}}
| 2012-04-01 || Vista prèvia dels consumidors
|-
| {{versió  |cp |3.0 RC |sortKey=3.0 C}}
| 2012-05-25 || ''Release candidate''
|-
| {{versió  |c  |3.0    |sortKey=3.0 Z}}
| 2012-06-23 || Llançament
|-
| {{versió  |p  |4.0    |sortKey=4.0}}
| 2013-09-06 || Versió futura
|}
Versió Data Descripció
Una versió antiga, sense suport: 1.0 2010-07-23 Versió antiga, sense suport
Una versió antiga, encara amb suport: 2.0 2011-06-27 Versió antiga, encara suportada
La darrera versió preliminar d'un futur llançament: 3.0 DP 2012-03-02 Vista prèvia dels desenvolupadors
La darrera versió preliminar d'un futur llançament: 3.0 CP 2012-04-01 Vista prèvia dels consumidors
La darrera versió preliminar d'un futur llançament: 3.0 RC 2012-05-25 Release candidate
La darrera versió estable: 3.0 2012-06-23 Llançament
Proper llançament: 4.0 2013-09-06 Versió futura

Vegeu també[modifica el codi]