Mal:Chart/doc

{{#invoke:Message box|mbox |image= |imageright= |style= |textstyle= |text=This is a documentation subpage for Mal:Chart.
It contains usage information, categories and other content that is not part of the original mal page. |small= |smallimage= |smallimageright= |smalltext= |category= |all= |date= }}

Bruk

Denne malen lager en rad i et slektstre, som består av bokser forbundet med linjer basert løselig på ASCII kunst-syntaksen. Malen er ment å brukes sammen med {{chart/start}} og {{chart/end}} og vises som HTML, ved hjelp av CSS som definerer utseendet. I boksene kan det også kobles opp mot andre artikler. Denne malen er basert på den eldre Familytree malen og er kompatibel med den nåværende Chart malen.

Grunnleggende eksempel

Denne koden:

{{chart/start|sammendrag=Slektstre eksempel}}
{{chart| | | |FM |~|y|~| FF | |FM=Farmor|FF=Farfar}}
{{chart| | | | | | | |)|-|-|-|.| }}
{{chart| | | MOR |y| FAR | |ASTRID|MOR=Mor|FAR=Far|ASTRID=[[Tante Astrid]]}}
{{chart| |,|-|-|-|+|-|-|-|.| | | }}
{{chart| OLA | | MEG  | | SØS | | |OLA=Min bror Ola|MEG='''Meg!'''|SØS=Min lillesøster}}
{{chart/end}}

gir dette resultatet:

Farmor

Farfar

Mor

Far

Tante Astrid

Min bror Ola

Meg!

Min lillesøster

Dette diagrammet visualiserer at jeg har en bror som heter Ola og en lillesøster, min mor er gift med min far og min fars foreldre kalles farmor og farfar, min fars foreldre har også et barn til som kalles Tante Astrid. Sammendragsteksten |tekst= bør brukes til å beskrive hva diagrammet inneholder.

Parametere

Denne malen aksepterer opptil 50 ikke navngitte parametere, hver av disse angir en flis eller boks.

• Bokser kan i tillegg til tekst inneholde linker til andre sider og innholdet i hver boks er angitt ved å bruke ekstra navneparametere knyttet til malens formål. Hver boks er tre fliser bred og har normalt en svart marg som er to piksler bred. Bokser kan ha hvilket som helst navn, så lenge de er gyldige mal parameter navn, disse skal minimum ha to bokstaver.
• Fliser er linjefigurer som sammen brukes for å knytte sammen boksene. De inneholder varierende typer av horisontale og vertikale linjer, samt hjørner og kryss som behøves. Disse flisene er spesifisert ved å bruke en kode på en eller to symboler. Denne koden er mer eller mindre sammenlignbart med figuren på flisen som skal brukes. Det finnes også tomme fliser, som brukes for å lage mellomrom og koden er da et tomt mellomrom, en oversikt over tilgjengelige fliser sees under:

Heltrukne linjer:

!	||	,	||	v	||	.	||
-	||	)	||	+	||	(	||
			`	||	^	||	'	||

Stiplede linjer:

:	||	F	||	V	||	7	||
~	||	D	||	%	||	C	||
			L	||	A	||	J	||

Prikkede linjer:

Q	||	S	||	M	||	T	||
P	||	H	||	R	||	G	||
			Y	||	W	||	Z	||

Kombinert:

j

||

y

||

r

||

m

||

r2

||

m2

||

d

||

*

||

c

||

f

||

t

||

e

||

k

||

a

||

l

||

o

||

b

||

p

||

k2

||

a2

||

l2

||

o2

||

b2

||

p2

||

i

||

h

||

q

||

n

||

q2

||

n2

||

Utseende attributer

Utseende til boksene på en rad kan styres ved hjelp av følgende valgfrie mal parametere:

• border beskriver bredden av boksens marg i piksler.
• boxstyle kan brukes for å knytte andre CSS koder direkte til boksens utseende, eksempelvis denne koden:

{{chart/start}}
{{chart|border=1|boxstyle=background:green;  | | FOO |y| BAR | |FOO=Box 1|BAR=Box 2}}
{{chart | | |,|-|^|-|.| | }}
{{chart|border=3|boxstyle=background:yellow; | | FOO | | BAR | |FOO=Box 3|BAR=Box 4}}
{{chart/end}}

gir dette resultatet:

Box 1

Box 2

Box 3

Box 4

Utseende attributer kan også brukes for å bestemme utseende av individuelle bokser innenfor en linje, som i eksempelet under:

{{chart/start}}
{{chart| | | | |CLEAR| | | | |CLEAR=Clear box}}
{{chart| |,|-|-|'|!|`|-|-|.| }}
{{chart|RED  |~|GREEN|~|BLUE |RED=Red box|GREEN=Green box|BLUE=Blue box
|boxstyle_RED  =background-color: red;
|boxstyle_GREEN=background-color: green;
|boxstyle_BLUE =background-color: blue;
}}
{{chart/end}}

som gir dette resultatet:

Clear box

Red box

Green box

Blue box

'Note:' Ved å spesifisere utseende attributer for individuelle navngitte bokser, må boksens navn være plassert til venstre i området reservert for dette i malen (som i "|RED  |" isteden for "| RED |" i eksempelet over), ellers vil malen se etter utseende parametere med mellomrom i navnet.

{{chart/start}} malen aksepterer også en valgfri utseende parameter som kan bli brukt til å bestemme CSS utseende for hele diagrammet.

Overflytting fra den gamleFamilytree malen.

{{chart}} malen er baser på og story sett kompatibelt med den tidligere Familytree malen. Men for å bruke de ekstra funksjonene som denne malen tilbyr, må diagrammet oppdateres ved å bruke {{chart}} isteden. De fleste av de eldre {{familytree}} diagrammene kan bli oppdatert ved å bruke {{chart}} og under-malene ved å bytte ut koden familytree med chart. Noen få av de kombinerte flisene måtte omdøpes og {{familytree}} diagrammer som bruker disse flisene må gjøre forandringer. I tillegg er to kombinerte fliser lagt til, disse førte til at man kan føye stiplede linjer til heltrukne. Følgende oversikt viser forskjellene:

Tile	{{familytree}}	{{chart}}
||{||c
||}||d
||#||t
||[||e
||]||f
|| ||i
|| ||j

Det må også nevnes at hvis {{familytree}} malen ender med |}}, så bør den vertikale linjen bli fjernet, slik at den blir erstattet med enten tekst eller et tomt mellomrom. familytree.js verktøyet under kan bli brukt til å konvertere mellom syntaksene. Endre start tag i redigeringsmodus og trykk "Art → Templates" for å skifte tilbake til wikitekst modusen. Ved å gjøre dette vil alle de tilhørende malene bli oppdatert for å passe.

Feilmeldinger

• "Template:Chart/cellb" Forårsakes ved å bytte |}} - til | }}.
• "Template:Chart/celltTemplate:Chart/cellb" Forårsakes ved å bytte || - til | |, eller |}} - til | }}.
• "Template:Chart/celly tTemplate:Chart/celly b" Forårsakes ved å bytte |y | - til |y|.

Se også

• familytree.js – Et verktøy for enkelt å lage eller oppdatere diagrammer som kan brukes i malene.
• :Category:Family tree templates