Plantilla:Versió
Documentació de la plantilla [ mostra ] [ modifica el codi ] [ mostra l'historial ] [ refresca ]Descripció[modifica]
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]
| Versió | Any | Canvis significatius |
|---|---|---|
| 1.0 | 2010 | Versió antiga |
| 1.8 | 2011 | Versió antiga, amb suport |
| 2.0 | 2012 | Darrera versió |
| 3.0 | 2025 | Proper llançament |
Llegenda: Versió antiga Versió antiga, amb suport Darrera versió Darrera versió preliminar Proper llançament |
Quan evitar el seu ús[modifica]
- 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]
Quadre de llegenda[modifica]
| Paràmetre | Descripció | Notes |
|---|---|---|
1
|
Tipus de llegenda | Qualsevol dels següents valors genera un quadre de llegenda. Els valors permesos són:
|
show
|
Contingut de la llegenda | Aquest paràmetre és opcional. Per defecte, el quadre de la llegenda conté els següents 6 elements:
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.
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]
| 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:
|
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]
Quadre de llegenda[modifica]
| Descripció | El que s'escriu | Com es veu | |||||
|---|---|---|---|---|---|---|---|
| Llegenda horitzontal | {{versió |l |show=110111}}
|
Llegenda: Versió antiga Darrera versió Darrera versió preliminar Proper llançament | |||||
| Llegenda vertical | {{versió |lv |show=011101}}
|
Versió antiga Lorem ipsum dolor sit amet, consectetur adipiscing 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.
Versió antiga, amb suport Versió actual Proper llançament | |||||
| Llegenda horitzontal, taula | {{versió |t |show=11110}}
|
| |||||
| Llegenda vertical, taula | {{versió |tv |show=01111}}
|
|
Cel·les de taula[modifica]
| Descripció | El que s'escriu | Com es veu |
|---|---|---|
| Versió antiga, sense suport | {{versió |o |1.0}}
|
1.0 |
| Versió antiga, encara suportada | {{versió |co |2.0}}
|
2.0 |
| Última versió estable | {{versió |c |3.0}}
|
3.0 |
| Darrera versió preliminar | {{versió |cp |4.0}}
|
4.0 |
| Proper llançament | {{versió |p |5.0}}
|
5.0 |
Taules amb ordenació[modifica]
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
|} |
|
Vegeu també[modifica]
| La documentació de més amunt està transclosa de Plantilla:Versió/ú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. |