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 forbedringen er basert på den eldre Familytree malen.

This template produces one row in a "family tree"-like chart consisting of boxes and connecting lines based loosely on an ASCII art-like syntax. It is meant to be used in conjunction with {{chart/start}} and {{chart/end}}. The chart is displayed as HTML tables using CSS attributes, and may contain arbitrary wiki markup within the boxes. This implementation was based on the now-deprecated {{familytree}} template.

Grunnleggende eksempel

Denne koden:

{{chart/start|summary=An example family tree}}
{{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.

The |summary=text parameter of {{chart/start}} should be used to describe the overall layout of the tree. This summary is for accessibility: it is read aloud to visually impaired readers who use screen readers, and is invisible to sighted readers.

Parameters

The template accepts up to 50 unnamed parameters with each parameter specifying a tile or a box.

• Boxes can contain arbitrary wiki markup. The content of each box is specified using additional named parameters appended to the template call. Each box is three tiles wide and normally has a black border two pixels wide. Boxes can have any name that is a valid template parameter name, subject to a minimum of two alphabetical characters.
• Tiles are line drawing symbols used to connect the boxes. They consist of various styles of horizontal and vertical lines along with corners and crossings as needed. Tiles are specified using their one- or two-character name: for the most common tiles, that character is more or less approximate to the tile's appearance. A special case of a tile is the empty tile, specified by a single space character. A table of available tiles is given below.

Solid lines:

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

Dashed lines:

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

Dotted lines:

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

Mixed:

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

||

Style attributes

The appearance of the boxes in a row may be controlled by the following optional template parameters:

• border specifies the width of the box border in pixels,
• boxstyle can be used to append arbitrary CSS declarations directly to the box style attributes. For example, the following code:

{{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}}

produces this chart:

Box 1

Box 2

Box 3

Box 4

Style attributes can even be set for individual boxes within each row, as in the example below:

{{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}}

which produces this:

Clear box

Red box

Green box

Blue box

'Note:' When specifying style attributes for individual named boxes, make sure the box names are aligned to the left side of the area reserved for them in the template call (as in "|RED  |" instead of "| RED |" in the example above), otherwise the template will end up looking for a style parameter with spaces in its name.

The {{chart/start}} template also accepts an optional style parameter that can be used to set CSS styles for the entire diagram.

Migration from familytree

The {{chart}} template is largely compatible with the earlier {{familytree}} template. However, to use the additional functionality offered with this template, diagrams must be updated to use {{chart}} instead. Many {{familytree}} diagrams can be altered to use {{chart}} and its sub-templates simply by replacing the wikitext familytree with chart. A few of the "mixed" tiles had to be renamed, and {{familytree}} diagrams using these tiles will have to make a few changes. Additionally, two new "mixed" tiles have been added, joining solid lines to dashed lines. The following table summarises the differences:

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

Lastly, if any uses of the {{familytree}} template end with |}}, that vertical bar should be removed, leaving the last cell in that row containing either some text or a space.

The familytree.js tool below can be used to convert between syntaxes. Just change the start tag when in edit view, then click "Art → Templates" to toggle back to wikitext view. The other templates will be updated to match.

Errors

• "Template:Chart/cellb" will be caused by any instance of |}} - change this to | }}.
• "Template:Chart/celltTemplate:Chart/cellb" will be caused by any instance of || - change this to | |, or; |}} - change this to | }}.
• "Template:Chart/celly tTemplate:Chart/celly b" will be caused by any instance of |y | - change this to |y|.

See also

• familytree.js – tool to easily create or update diagrams using these templates
• Category:Family tree templates