Plantilla:Diagrama de sectors 2

Documentació de la plantilla [ mostra ] [ modifica el codi ] [ mostra l'historial ] [ refresca ]

Per traduir o revisar la traducció al vostre idioma del mòdul, editeu amb compte Data:I18n/Chart.tab.

Paràmetres

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 |paleta de colors=). 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: No ser assignat, llavors s'utilitzaran els colors de la paleta Plotter, vegeu al final de tot. Assignar una paleta alternativa, vegeu al final.
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

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

1r sector: 500 2n sector: 1.000 3r sector: 1.500 3r sector: 1.100

Assignant el radi {{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 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 }}
1r sector: 50 2n sector: 100 3r sector: 150 4t sector: 120	1r sector: 50 2n sector: 100 3r sector: 150 4t sector: 120
Utilitzant "sectors" 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 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 }}
1r sector: 50 2n sector: 100 3r sector: 150 4t sector: 120	Àrida: 50 Conreus: 100 Semiboscosa: 150 Boscosa: 120
Amb colors personalitzats 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 {{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.
Patates: 50 Plàtans: 100 Maduixes: 150 Peres: 120	Patates: 50 Plàtans: 100 Maduixes: 150 Peres: 120
Amb moltes dades... 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 Llavors és millor posar dos columnes per les llegendes, amb (|columnes de la llegenda=, i assignar una amplada, que sigui suficient per a contenir dues columnes, sempre major al doble del radi. {{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 }}
1r sector: 50 2n sector: 100 3r sector: 150 4t sector: 120 5è sector: 70 6è sector: 20 7è sector: 70 8è sector: 20	1r sector: 50 2n sector: 100 3r sector: 150 4t sector: 120 5è sector: 70 6è sector: 20 7è sector: 70 8è sector: 20
Títol, subtítol i nota {{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 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 del títol, en negreta Text del subtítol 1r sector: 50 2n sector: 100 3r sector: 150 4t sector: 120 Text de qualsevol anotació	Text del títol, en negreta Text del subtítol 1r sector: 50 2n sector: 100 3r sector: 150 4t sector: 120
Alineació del diagrama {{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 {{lorem}} per fer evident que està alineat (i amb un marc) a la dreta, sense necessitat de fer servir una taula on incloure el diagrama.	Amb sufix i percentatge {{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.
1r sector: 50 2n sector: 100 3r sector: 150 4t sector: 120 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.	1r sector: 50 Kg (11,9%) 2n sector: 100 Kg (23,8%) 3r sector: 150 Kg (35,7%) 4t sector: 120 Kg (28,6%)
Ús de comentaris 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 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í }}
IDH mundial Molt alt (0,7-0,8): 58 Alt (0,55-0,7): 54 Mitjà (0,8-1,0): 39 Baix (0,35-0,55): 38	IDH mundial Molt alt (0,55-0,7): 30,7% Alt (0,8-1,0): 28,6% Mitjà (0,7-0,8): 20,6% Baix (0,35-0,55): 20,1% Passant el cursor del ratolí per sobre del pastís apareix informació emergent de les dades

Selecció d'una paleta de colors

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.

Seqüencial (1-9)

YlGn                                     YlGnBu                                     GnBu                                     BuGn                                     PuBuGn

PuBu                                     BuPu                                     RdPu                                     PuRd                                     OrRd

YlOrRd                                     YlOrBr                                     Purples                                     Blues                                     Greens

Oranges                                     Reds                                     Greys

Divergent (1-11)

PuOr                                             BrBG                                             PRGn

PiYG                                             RdBu                                             RdGy

RdYlBu                                             Spectral                                             RdYlGn

Qualitativa (1-8/12)

Accent                                 Dark2                                 Paired

Pastel1                                     Pastel2                                 Set1

Set2                                 Set3

TemplateData

Diagrama de sectors amb moltes possibilitats

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à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. Exemple (12 : Nom1 : Red : Enllaç1) (24 : Name2 : Green : Enllaç2) ...	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" Exemple 12 : Nom primer : Red : Enllaç1	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. Exemple Amb "Kg" els valors es mostraran com a "88Kg" en lloc de "88".	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