Plantilla:Diagrama de sectors 2/ús
 | Aquesta és una subpàgina de documentació per a la Plantilla:Diagrama de sectors 2 Té la informació d'ús, les categories i qualsevol altre contingut que no forma part essencial del codi de la plantilla. |
 | Aquesta plantilla utilitza una crida a un mòdul de tipus Lua, nom que li ve del llenguatge Lua que utilitza. Per tant, si volguéssiu modificar-la, abans hauríeu d'estar familiaritzats amb aquest llenguatge i les funcions de l'extensió Scribunto. Vegeu com fer proves de plantilles.
Aquesta plantilla utilitza el següent mòdul: |
Per traduir o revisar la traducció al vostre idioma del mòdul, editeu amb compte Data:I18n/Chart.tab.
Paràmetres
[modifica]| nom del paràmetre | què fa | |
|---|---|---|
| en anglès | en català | |
| radius | radi | Número. El radi del pastís en píxels |
| delimiter | delimitador | Cadena delimitadora per separar els diversos valors de dades que s'assignen. Per defecte són els dos punts (:). |
| slices | sectors | Sectors, entre parèntesis. És una sintaxi alternativa a "sector 1", "sector 2", etc. Utilitzeu el delimitador dins del sector:
( Valor1 : Nom1 : Color1 : Enllaç1 ) ( Valor2 : Nom2 : Color2 : Enllaç2 ) ... Els valors són números. Els números poden ser números enters o fraccions decimals, o bé utilitzant la notació científica: 7.24e6, 7.240.000 o 7240000.00 són tots acceptables per 7 milions i 240 milers. Els noms són cadenes; podeu afegir un comentari que apareixerà en la llegenda (i no en el text emergent), precedint-lo per "--". Els colors són opcionals. Podeu utilitzar qualsevol color web, com ara "red" o "#FF0000". Es defineixen fins a 26 colors per defecte, (paleta Plotter)però si el diagrama té més de 26 sectors, heu de definir els colors del sector #27 i posteriors; però en aquest cas sempre és millor utilitzar els diagrames de columnes. Podeu escollir altres paletes (mireu Els enllaços poden ser enllaços externs o interns, inclosos els enllaços a ancoratges interns i paràgrafs del mateix article. |
| slice n | sector n | Sintaxi alternativa a "sectors". n és el número del sector, que comença per 1. Assegureu-vos de no saltar-vos-en cap: si definiu "sector 1", "sector 2", "sector 4", "sector 5" ..., i us salteu "sector 3", només es mostraran els dos primers sectors. Aquesta sintaxi no és compatible amb "sectors", és a dir, no s'han d'utilitzar conjuntament en la mateixa invocació. La sintaxi seria:
| sector 1 = Value1 : Nom1 : Color1 : Enllaç1 | sector 2 = Value2 : Nom2 : Color2 : Enllaç2 | ... Aquesta sintaxi us permet fer servir parèntesis en els noms, enllaços i colors. Tingueu en compte les altres observacions fetes en l'anterior opció referides als formats dels números i colors. |
| width | amplada | Número. Amplada del diagrama. Per defecte: serà el doble del radi. Ocasionalment l'amplada pot ser més gran per tal de fer proporcionalment més petit el pastís. |
| units prefix | unitat com prefix | Usat per precedir als números de les dades, de nul interès per la llengua catalana. Per exemple, amb "$" els valors es mostraran com a "$500" en lloc de "500". El guió baix ("_") es substitueix per espais, per permetre un espai entre el prefix i el valor. |
| units suffix | unitat com sufix | Usat per seguir als números de les dades. Per exemple, amb "Kg" els valors es mostraran com a "88Kg" en lloc de "88". El guió baix ("_") es substitueix per espais, per permetre un espai entre el valor i el sufix. |
| color palette | paleta de colors | Els colors que s’utilitzen per a acolorir cada sector, si no s'ha escollit un color. Pot:
|
| align | alineació | Pot ser esquerra (o left), centre (center) i dreta (o right). Per defecte el diagrama queda alineat a l'esquerra sense marges. Si està ajustat a la dreta o a l'esquerra el text de l'article fluirà per la seva esquerra o dreta respectivament. Estalvia haver de posar el diagrama dins d'un contenidor. |
| percent Obsolet! |
Afegeix el percentatge en els elements de la llegenda i en el text emergent dels sectors. Millor utilitzar |números en sectors= i |números en llegenda=.
| |
| numbers in slices | números en sectors | Determina quines dades es presenten com a text emergent en els sectors. Els valors poden ser "n", "p", "n p" o "p n". Referint-se "n" al nombre del valor i "p" al percentatge. En cas de dos valors, el segon apareixerà entre parèntesis. Si "números en sectors" i "números en llegenda" no estan assignats se'ls assignarà la "n" als dos (fora que sigui assignat "percentatge", en aquest cas se'ls assignarà "n p". |
| percent decimals | decimals del percentatge | Nombre de decimals que apareixeran en el percentatge, pot ser 0 o 1; o bé un número a partir del qual es mostrarà un decimal si la suma total de dades és major a aquell número. El valor predeterminat és 100. |
| Text fix | ||
| tooltip info | info emergent | Missatge d'informació de que passant el cursor del ratolí per sobre els elements del diagrama apareixerà text emergent. |
| title | títol | Text que apareixerà a dalt de tot del diagrama, en negreta i amb la mida de text una mica més gran. |
| title background | fons del títol | Color de fons del títol. No hi ha color predefinit (així, per defecte, no es pintarà). |
| subtitle | subtítol | Text que apareixerà a sota del títol. |
| subtitle background | fons del subtítol | Color de fons del subtítol. No hi ha color predefinit (així, per defecte, no es pintarà). |
| hide group legends Obsolet! |
Si l'assigneu, les llegendes del grup no es mostraran a sota del diagrama (per tal de que utilitzeu una llegenda personalitzada amb {{Llegenda}}). Qualsevol valor no buit significa "sí". Per dir "no", simplement no subministreu aquest paràmetre o deixeu el valor en blanc. | |
| numbers in legend | números en llegenda | Determina quines dades es presenten a continuació del nom del sector en la llegenda. Els mateixos valors i consideracions que |números en sectors=.
|
| legend title | títol de la llegenda | Text que apareixerà en negreta sobre la llegenda. |
| legend columns | columnes de la llegenda | Nombre de columnes per la llegenda, el nombre predeterminat és 1. |
| note | nota | Text que apareixerà a baix de tot del diagrama. |
Exemples
[modifica]Expressió mínima de la plantilla, assignant els valors per a tres sectors amb els seus noms
{{Diagrama de sectors 2
| sector 1 = 500 : 1r sector
| sector 2 = 1000 : 2n sector
| sector 3 = 1.500 : 3r sector
| sector 4 = 1,1e3 : 3r sector
}}
Els valors es poden proporcionar amb format "específic de l'idioma" (com ara 1.500), o la notació científica com 1,1e3 (=1.100). A les llegendes, sempre es mostraran números en mode ajustat al llenguatge (pot semblar diferent si el mòdul s'importa a altres wikis).
Assignant el radi[modifica]{{Diagrama de sectors 2
| sector 1 = 50 : 1r sector
| sector 2 = 100 : 2n sector
| sector 3 = 150 : 3r sector
| sector 4 = 120 : 4t sector
| radi = 70
}}
|
Utilització directa del mòdul[modifica]Per compatibilitat amb la utilització directa del mòdul, això dona el mateix resultat: {{#invoke:Chart/proves | pie chart
| sector 1 = 50 : 1r sector
| sector 2 = 100 : 2n sector
| sector 3 = 150 : 3r sector
| sector 4 = 120 : 4t sector
| radi = 70
}}
| ||||
|
| |||||
Utilitzant "sectors"[modifica]Una forma alternativa, més útil si s'edita directament des de modifica el codi i no amb l'editor visual (amb Insereix|Plantilla). {{Diagrama de sectors 2
| sectors =
(50 : 1r sector)
(100 : 2n sector)
(150 : 3r sector)
(120 : 4t sector)
| radi = 70
}}
|
Assignant una paleta[modifica]En dades semiquantitatives, pot ser útil assignar una paleta de colors progressiu. En aquest exemple suposarem el percentatge de massa forestal d'un territori, i per això assignarem la paleta de verds de Brewer (mireu #Selecció d'una paleta de colors). {{Diagrama de sectors 2
| sector 1 = 50 : Àrida
| sector 2 = 100 : Conreus
| sector 3 = 150 : Semiboscosa
| sector 4 = 120 : Boscosa
| radi = 70
| paleta de colors = Greens
}}
| ||||
|
| |||||
Amb colors personalitzats[modifica]Ocasionalment pot ser d'interès assignar un color que identifiqui alguns dels sectors. En aquest exemple posem un marró a les pattates, un groc als plàtans, etc. {{Diagrama de sectors 2
| sector 1 = 50 : Patates : Tan
| sector 2 = 100 : Plàtans : Yellow
| sector 3 = 150 : Maduixes : Crimson
| sector 4 = 120 : Peres : GreenYellow
| radi = 70
}}
|
Amb enllaços[modifica]{{Diagrama de sectors 2
| sector 1 = 50 : Patates : Tan : [[Patata]]
| sector 2 = 100 : Plàtans : Yellow : [[Plàtan]]
| sector 3 = 150 : Maduixes : : [[Maduixa]]
| sector 4 = 120 : Peres : GreenYellow: [[Pera (fruita)|Pera]]
| radi = 70
}}
En aquest exemple hem obviat el color per Maduixes, aleshores es pren el color corresponent de la paleta per defecte. | ||||
Amb moltes dades...[modifica]Si hi han moltes dades la llegenda surt exageradament llarga. {{Diagrama de sectors 2
|{{Diagrama de sectors 2
| sector 1 = 50 : 1r sector
| sector 2 = 100 : 2n sector
| sector 3 = 150 : 3r sector
| sector 4 = 120 : 4t sector
| sector 5 = 70 : 5è sector
| sector 6 = 20 : 6è sector
| sector 7 = 70 : 7è sector
| sector 8 = 20 : 8è sector
| radi = 70
}}
|
...arreglant la llegenda[modifica]Llavors és millor posar dos columnes per les llegendes, amb ( {{Diagrama de sectors 2
| sector 1 = 50 : 1r sector
| sector 2 = 100 : 2n sector
| sector 3 = 150 : 3r sector
| sector 4 = 120 : 4t sector
| sector 5 = 70 : 5è sector
| sector 6 = 20 : 6è sector
| sector 7 = 70 : 7è sector
| sector 8 = 20 : 8è sector
| radi = 70
| amplada = 240
| columnes de la llegenda = 2
}}
| ||||
Títol, subtítol i nota[modifica]{{Diagrama de sectors 2
| sector 1 = 50 : 1r sector
| sector 2 = 100 : 2n sector
| sector 3 = 150 : 3r sector
| sector 4 = 120 : 4t sector
| radi = 70
| títol = Text del títol, en negreta
| subtítol = Text del subtítol
| nota = Text de qualsevol anotació
}}
|
Color de fons pel títol i subtítol[modifica]Com que és text wiki admet l'ús d'enllaços: {{Diagrama de sectors 2
| sector 1 = 50 : 1r sector
| sector 2 = 100 : 2n sector
| sector 3 = 150 : 3r sector
| sector 4 = 120 : 4t sector
| radi = 70
| títol = Text del títol, en [[negreta]]
| fons del títol = Yellow
| subtítol = Text del subtítol{{efn|Nota referida al subtítol}}
| fons del subtítol = LightYellow
| nota = {{Notes}}
}}
| ||||
Text de qualsevol anotació |
|||||
Alineació del diagrama[modifica]{{Diagrama de sectors 2
| sector 1 = 50 : 1r sector
| sector 2 = 100 : 2n sector
| sector 3 = 150 : 3r sector
| sector 4 = 120 : 4t sector
| radi = 70
| alineació = dreta
}}
S'ha posat text amb |
Amb sufix i percentatge[modifica]{{Diagrama de sectors 2
| sector 1 = 50 : 1r sector
| sector 2 = 100 : 2n sector
| sector 3 = 150 : 3r sector
| sector 4 = 120 : 4t sector
| radi = 70
| amplada = 190
| unitat com sufix = _Kg
| percentatge = sí
}}
En aquest exemple s'ha augmentat l'amplada del diagrama per tal de que pugui aparèixer el sufix i el percentatge en una línia, sense augmentar el pastís. | ||||
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. |
| ||||
Ús de comentaris[modifica]Els comentaris no apareixen en el text emergent (quan es passa amb el cursor del ratolí per sobre dels sectors). {{Diagrama de sectors 2
| títol = [[Índex de Desenvolupament Humà|IDH]], nombre de països
| sector 1 = 58 : Molt alt--(0,8-1,0)
| sector 2 = 54 : Alt--(0,7-0,8)
| sector 3 = 39 : Mitjà--(0,55-0,7)
| sector 4 = 38 : Baix--(0,35-0,55)
| amplada = 180
| radi = 70
| paleta de colors = RdYlGn_i
}}
Els comentaris és el text després de "--". Observeu que s'ha optat per la paleta RdYlGn ( ), però en ordre invers afegint "_i", per assenyalar en vermell els de situació dolenta i en verd els de situació bona. |
Números del text emergent i llegenda[modifica]Es pot decidir quins números apareixeran a continuació de cada element de la llegenda i del text emergent. També s'ha afegit la informació de passar el cursor sobre els sectors, doncs en el contingut del text emergent hi ha el nombre que no apareix en la llegenda. {{Diagrama de sectors 2
| títol = [[Índex de Desenvolupament Humà|IDH]], nombre de països
| sector 1 = 58 : Molt alt--(0,8-1,0)
| sector 2 = 54 : Alt--(0,7-0,8)
| sector 3 = 39 : Mitjà--(0,55-0,7)
| sector 4 = 38 : Baix--(0,35-0,55)
| amplada = 180
| radi = 70
| paleta de colors = RdYlGn_i
| unitat com sufix = _països
| números en llegenda = p
| números en sectors = p n
| info emergent = sí
}}
| ||||
|
Passant el cursor del ratolí per sobre del pastís apareix informació emergent de les dades | ||||
Selecció d'una paleta de colors
[modifica]De forma predefinida, quan no se selecciona cap color queda assignada la paleta Plotter. Podem afegir una i i/o un número per indicar que l'ordre s'ha invertit i/o que es comença a seleccionar els colors a partir d'una posició.
| Paleta | Codi | Colors resultants | Nota |
|---|---|---|---|
| Plotter | Plotter | Ordre normal | |
| Plotter_i | Ordre invertit | ||
| Plotter_3 | El primer color és el 3r |
Exemple, si hi ha 4 grups o sèries de dades i hem seleccionat |color=Plotter, quedaran seleccionats els colors: .
Si bé es molt més recomanable per l'equilibri de colors la paleta Category20 i Category10, que queden definides en Categ20.
| Paleta | Codi | Colors resultants | Nota |
|---|---|---|---|
| Category20 (Quan n > 10) |
Categ20 | Ordre normal | |
| Categ20_3 | El primer color és el 3r | ||
| Categ20_i_3 | Ordre invertit | ||
| Category10 (Categ20 en el codi. Quan n < 11) |
Categ20 | Ordre normal (1r, 3r, 5è, .. de Category20) | |
| Categ20_2 | El primer color és el 2n (de Category20) | ||
| Categ20_3 | El primer color és el 3r (de Category20) | ||
| Categ20_i | Ordre invertit |
Exemple, si hi ha 4 grups o sèries de dades i hem seleccionat |color=Categ20_i_4, quedaran seleccionats els colors: .
Ocasionalment us pot ser d'interès altres plantilles, les de Cynthia Brewer, en el cas dels diagrames, principalment, les 8 últimes paletes:
Noms vàlids i representació completa del color per a cada paleta. Passant el cursor del ratolí per a sobre cada requadre apareix el número del color.
|
|
|
|
|
|
|
|
|
|
TemplateData
[modifica]Diagrama de sectors amb moltes possibilitats
| Paràmetre | Descripció | Tipus | Estat | |
|---|---|---|---|---|
| sectors | sectors slices | Valor, denominació (i opcionalment color i enllaç) de cada sector, entre parèntesi. L'assignació és incompatible amb "sector 1", "sector 2", etc., que segueix.
| Línia | opcional |
| sector 1 | sector 1 group 1 | Valor, denominació (i opcionalment color i enllaç) pel sector 1. El nom, la denominació (i opcionalment el color) han d'anar separats pel delimitador. L'assignació és incompatible amb "sectors"
| Línia | opcional |
| sector 2 | sector 2 group 2 | Valor, denominació (i opcionalment color i enllaç) pel sector 2. | Línia | opcional |
| sector 3 | sector 3 slice 3 | Valor, denominació (i opcionalment color i enllaç) pel sector 3 | Línia | opcional |
| sector 4 | sector 4 slice 4 | Valor, denominació (i opcionalment color i enllaç) pel sector 4 | Línia | opcional |
| sector 5 | sector 5 slice 5 | Valor, denominació (i opcionalment color i enllaç) pel sector 5 | Línia | opcional |
| sector 6 | sector 6 slice 6 | Valor, denominació (i opcionalment color i enllaç) pel sector 6 | Línia | opcional |
| sector 7 | sector 7 slice 7 | Valor, denominació (i opcionalment color i enllaç) pel sector 7 | Línia | opcional |
| sector 8 | sector 8 slice 8 | Valor, denominació (i opcionalment color i enllaç) pel sector 8 | Línia | opcional |
| sector 9 | sector 9 slice 9 | Valor, denominació (i opcionalment color i enllaç) pel sector 9. Si us fan falta més sectors els podeu entrar manualment canviant a editor de codi, però segurament és millor un diagrama de barres. | Línia | opcional |
| amplada | amplada width | Amplada del diagrama. Si es proporciona, ha de ser com a mínim de 200. Per defecte: 500. | Nombre | opcional |
| unitat com sufix | unitat com sufix units suffix | Usat per seguir als números de les dades en els missatges emergents. El guió baix ("_") es substitueix per espais, per permetre un espai entre el valor i el sufix.
| Línia | opcional |
| paleta de colors | paleta de colors color palette | Els colors que s’utilitzen per a acolorir cada sector. Altrament s'utilitzaran els colors personalitzats per a cada sector o bé la paleta Plotter. | Línia | opcional |
| alineació | alineació align | Pot ser "esquerra" (o "left"), "centre" ("center") i "dreta" (o "right"). Per defecte el diagrama queda alineat a l'esquerra sense marges. Si està ajustat a la dreta o a l'esquerra el text de l'article fluirà per la seva esquerra o dreta respectivament. Estalvia haver de posar el diagrama dins d'un contenidor. | Contingut | opcional |
| números en sectors | números en sectors numbers in slices | Determina quines dades es presenten com a text emergent en els sectors. Els valors poden ser "n", "p", "n p" o "p n". Referint-se "n" al nombre del valor i "p" al percentatge. En cas de dos valors, el segon apareixerà entre parèntesis. Si "números en sectors" i "números en llegenda" no estan assignats se'ls assignarà la "n" als dos (fora que sigui assignat "percentatge", en aquest cas se'ls assignarà "n p". | Línia | opcional |
| números en llegenda | números en llegenda numbers in legend | Determina quines dades es presenten a continuació del nom del sector en la llegenda. Els valors poden ser "n", "p", "n p" o "p n". Referint-se "n" al nombre del valor i "p" al percentatge. En cas de dos valors, el segon apareixerà entre parèntesis. Si "números en sectors" i "números en llegenda" no estan assignats se'ls assignarà la "n" als dos (fora que sigui assignat "percentatge", en aquest cas se'ls assignarà "n p". | Línia | opcional |
| decimals del percentatge | decimals del percentatge percent decimals | Nombre de decimals que apareixeran en el percentatge, pot ser 0 o 1; o bé un número a partir del qual es mostrarà un decimal si la suma total de dades és major a aquell número. El valor predeterminat és 100. | Nombre | opcional |
| info emergent | info emergent tooltip info | Missatge d'informació de que passant el cursor del ratolí per sobre els elements del diagrama apareixerà text emergent. | Booleà | opcional |
| títol | títol title | Text opcional que apareixerà a dalt de tot del diagrama, en negreta i amb la mida de text una mica més gran. | Línia | opcional |
| fons del títol | fons del títol title background | Color de fons del títol. No hi ha color predefinit (així, per defecte, no es pintarà). | Línia | opcional |
| subtítol | subtítol subtitle | Text opcional que apareixerà a sota del títol. | Línia | opcional |
| fons del subtítol | fons del subtítol subtitle background | Color de fons del subtítol. No hi ha color predefinit (així, per defecte, no es pintarà). | Línia | opcional |
| títol de la llegenda | títol de la llegenda legend title | Text que apareixerà en negreta sobre la llegenda. | Línia | opcional |
| columnes de la llegenda | columnes de la llegenda legend columns | Nombre de columnes per la llegenda, el nombre predeterminat és 1. | Nombre | opcional |
| nota | nota note | Text opcional que apareixerà a baix de tot del diagrama. | Contingut | opcional |