Skabelon:Diagram/doc

Med denne skabelon kan man oprette simple diagrammer, bestående af kasser forbundet med linjer, baseret på en ASCII-lignende syntaks. Diagrammet vises som en HTML tabel ved hjælp af CSS kode, og man kan frit indsætte wiki formatering i kasserne. Den skabelon er en udbygning af Skabelon:Stamtræ.

Eksempel på anvendelse

Dette er den indtastede tekst:

{{Diagram/start|summary=Jeg har en bror, Hans og en lillesøster. Min mor er gift med min far. Min fars forældre havde endnu et barn, tante Margrethe.}}
{{Diagram| | | |FMo  |~|y|~| FaF | |FMo=Farmor|FaF=Farfar}}
{{Diagram| | | | | | | |)|-|-|-|.| }}
{{Diagram| | | MOR |y| FAR | |MARG |MOR=Mor|FAR=Far|MARG=[[Tante Margrethe]]}}
{{Diagram| |,|-|-|-|+|-|-|-|.| | | }}
{{Diagram|HANS | | MIG | | SøS | | |HANS=Min bror Hans|MIG='''Mig!'''|SøS=Min lillesøster}}
{{Diagram/end}}

Resultatet bliver således:

Farmor

Farfar

Mor

Far

Tante Margrethe

Min bror Hans

Mig!

Min lillesøster

Parametre

Skabelonen danner en linje i et diagram. Skabelonen kan rumme 50 parametre, som beskriver indholdet af linjen. Hver parameter skaber et element, som udfylder et felt i diagrammet, i form af en kasse eller en forbindende streg. Indholdet kan også være et blankt felt for at skabe luft. I takt med, at linjerne i diagrammet defineres, dannes det færdige diagram. Der er ingen direkte begrænsning i antallet af linjer.

De elementer (parametre), der kan anvendes, er listet herunder. Hvert element er repræsenteret af ét eller to bogstaver eller tegn, som er tilstræbt at skulle ligne, hvad der tegnes i det færdige felt. Tabellen nedenfor viser sammenhængen mellem parameter og færdigt felt.

Linjer:

,			.			`			'
^			v			(			)
-			!			+

Stiplede linjer:

F			7			L			J
A			V			C			D
~			:			%

Prikkede linjer:

S			T			Y			Z
W			M			G			H
P			Q			R

Blandede:

*

d

c

a

k

l

a2

k2

l2

t

y

h

b

m

n

b2

m2

n2

f

e

i

j

o

p

q

r

o2

p2

q2

r2

• Kasser kan peppes op med wiki formatering efter behag. Teksten i hver kasse specificeres via navngivne parametre, der indsættes i skabelonen. En parameter skal bestå af mindst to alfanumeriske tegn. I skabelonen viser man sammenhængen mellem parameter og færdigt indhold, jævnfør eksemplet ovenfor. Hver kasse er tre felter bred og har typisk en sort kant, der er to pixels tyk, men dette kan ændres efter forgodtbefindende.

• Hvad linjerne skal betyde eller symbolisere, bestemmer man sådan set selv. Når det drejer sig om slægtstavler, er der dog visse konventioner. De ubrudte linjer går mellem forældre og børn, mens de stiplede linjer går mellem ægtefæller. De prikkede linjer er nye i forhold til skabelonen stamtræ og kan for eksempel bruges til at vise uægteskabelige forbindelser, som ellers er svære at passe ind i systematikken. Anvender man linjerne i virksomhedsdiagrammer, kan de bruges til at symbolisere forskellige grader af ejerskab, og i skematiserede tidsserier, hvor kasserne symboliserede lande, kunne man forestille sig en anvendelse omkring alliancer, samhandel, indflydelse, eller alt muligt andet.

Noget om formatering

Kassernes udseende styres af to parametre, som kan anvendes efter behov:

• border ("kant") styrer tykkelsen af kassens kant, udtrykt i pixels. Hvis den sættes til nul, kommer der ingen kant.
• boxstyle ("stil") bruges til formatering af kassens udseende via CSS kode.

Her er et eksempel på formatering af et diagram:

{{Diagram/start}}
{{Diagram|border=0|boxstyle=background:#dfd;| | Dit |y| Dat | |Dit=Kasse 1|Dat=Kasse 2}}
{{Diagram|border=0|boxstyle=background:#dfd;| | |,|-|^|-|.| | }}
{{Diagram|border=0|boxstyle=background:#dfd;| | Dit | | Dat | |Dit=Kasse 3|Dat=Kasse 4}}
{{Diagram/end}}

Teksten danner dette diagram:

Kasse 1

Kasse 2

Kasse 3

Kasse 4

I eksemplet ovenfor havde hver linje sin egen kasseformatering, men man kan også formatere individuelle kasser:

{{Diagram/start}}
{{Diagram| | | | |CLEAR| | | | |CLEAR=Ufarvet kasse}}
{{Diagram| |,|-|-|'|!|`|-|-|.| }}
{{Diagram|RED  |~|GREEN|~|BLUE |RED=Rød kasse|GREEN=Grøn kasse|BLUE=Blå kasse
|boxstyle_RED  =background-color: #faa;
|boxstyle_GREEN=background-color: #afa;
|boxstyle_BLUE =background-color: #aaf;
}}
{{Diagram/end}}

giver dette resultat:

Ufarvet kasse

Rød kasse

Grøn kasse

Blå kasse

Bemærk: Når man definerer udseendet af individuelle kasser, skal kassens navn altid stå til venstre i det felt, der er afsat, (f.eks. "|RED  |" i stedet for "| RED |"), ellers leder skabelonen efter en parameter, der starter med et blankt felt.

I første linje, {{Diagram/start}} kan man definere et format, som bruges i hele diagrammet.

Flytning fra stamtræ

Skabelonen {{Diagram}} er baseret på funktionen {{Stamtræ}} og kan stort set anvendes med definitionerne herfra. For at anvende den ekstra funktionalitet, er det nødvendigt at omdøbe de eksisterende skabeloner til {{Diagram}}. Mange skabeloner skabt med {{Stamtræ}} kan ændres til {{Diagram}} blot ved at ændre wikiteksten stamtræ til Diagram. Det har dog været nødvendigt at omdøbe nogle af de "blandede" felter, så {{stamtræ}} skabeloner med disse felter skal ændres lidt. Desuden er der kommet to nye "blandede" felter, som kombinerer stiplede og almindelige linjer. Denne tabel viser ændringerne:

Felt	{{Stamtræ}}	{{Diagram}}
	{	c
	}	d
	#	t
	[	e
	]	f
		i
		j

Endelig skal man være opmærksom på, at hvis man har en {{Stamtræ}} skabelon, der slutter med |}}, skal den lodrette streg fjernes, så sidste celle i rækken enten indeholder tekst eller et mellemrum.

Fejlmeddelelser

• "Template:Diagram/cellb" skyldes teksten "|}}". Rettes til "| }}".
• "Template:Diagram/celltTemplate:Diagram/cellb" skyldes teksten "||". Rettes til "| |".
• "Template:Diagram/celly tTemplate:Diagram/celly b" skyldes teksten "|y |". Rettes til "|y|".