الگو:Tree chart/doc

با الگو:Graph:Chart اشتباه نشود.

استفاده

هر بار استفاده از این الگو یک سطر شجره‌نامه را می‌سازد که شامل جعبه‌ها و خطوط وصل‌کننده است. این الگو را باید به همراه {{Tree chart/start}} و {{Tree chart/end}} استفاده کرد. شجره‌نامه با استفاده از خصوصیت‌های سی‌اس‌اس به شکل جدول اچ‌تی‌ام‌ال نمایش داده می‌شود و ممکن است زبان نشانه‌گذاری ویکی نیز در جعبه‌ها به کار رفته باشد. طراحی الگو بر اساس الگوی سابق {{شجره‌نامه}} است که استفاده از آن مذموم شد.

مثال ساده

این کد:

{{Tree chart/start|align=center|summary=مثال شجره‌نامه}}
{{Tree chart| | | |GrMa |~|y|~| GRP | |GrMa=بی‌بی|GRP=آقاجان}}
{{Tree chart| | | | | | | |)|-|-|-|.| }}
{{Tree chart| | | DAD |y| MOM | |SARAH|DAD=بابا|MOM=مامان|SARAH=[[خاله سارا]]}}
{{Tree chart| |,|-|-|-|+|-|-|-|.| | | }}
{{Tree chart| ALI | | ME  | | SIS | | |ALI=[[علی کوچولو]]|ME='''بنده!'''|SIS=همشیره}}
{{Tree chart/end}}

می‌دهد:

بی‌بی

آقاجان

بابا

مامان

خاله سارا

علی کوچولو

بنده!‏

همشیره

این شجره‌نامه نشان می‌دهد که بنده برادر کوچکتری دارم به نام علی کوچولو و یک آبجی. مادرم ۲۰ سال پیش با پدرم ازدواج کرد. پدر و مادر مادرم را آقاجان و بی‌بی خطاب می‌کنم؛ والدین مادرم دختر دیگری دارند که ما بچه‌ها خاله سارا صدایش می‌کنیم. کد بالا جدولی با ۹ سطر و ۱۸ ستون ایجاد می‌کند که در زیر می‌بینیدش.

ساختار جدولی که با کد بالا درست می‌شود

مثال سادهٔ تاشو

این کد از {{chart top}} استفاده می‌کند:

{{chart top|مثال شجره‌نامه}}
{{Tree chart/start|align=center}}
{{Tree chart| | | |GrMa |~|y|~| GRP | |GrMa=بی‌بی|GRP=آقاجان}}
{{Tree chart| | | | | | | |)|-|-|-|.| }}
{{Tree chart| | | DAD |y| MOM | |SARAH|DAD=بابا|MOM=مامان|SARAH=[[خاله سارا]]}}
{{Tree chart| |,|-|-|-|+|-|-|-|.| | | }}
{{Tree chart| ALI | | ME  | | SIS | | |ALI=[[علی کوچولو]]|ME='''بنده!'''|SIS=همشیره}}
{{Tree chart/end}}
{{chart bottom}}

که می‌دهد:

پارامترها

این جدول تعداد نامعینی از پارامترهای بی‌نام را قبول می‌کند که هر پارامتر نشان‌دهندهٔ یک کاشی یا جعبه است.

• جعبه‌ها می‌توانند حاوی زبان نشانه‌گذاری ویکی باشند. محتوای هر جعبه را پارامتر نامدار دیگری که بعداً تعریف می‌شود مشخص می‌کند. عرض هر جعبه به اندازهٔ سه کاشی است و به صورت پیش‌فرض کادری به ضخامت دو پیکسل دارد. جعبه‌ها می‌توانند هر نامی که برای الگو معتبر باشد داشته باشند، به شرطی که دست‌کم دو نویسهٔ الفبایی داشته باشند.
• کاشی‌ها نمادهای خطوط وصل‌کنندهٔ جعبه‌ها به همدیگر هستند. کاشی‌ها شامل خطوط افقی و عمودی به همراه گوشه‌ها و تقاطع‌های مورد نیاز در چندین سبک گوناگون هستند. کاشی‌ها با استفاده از نام یک یا دو حرفی مخصوصشان مشخص می‌شوند: در مورد بیشتر کاشی‌ها، نویسه کمابیش شبیه ظاهر کاشی است. کاشی خالی نوع خاصی از کاشی هست که با یک نویسهٔ فاصله مشخص می‌شود. جدولی از کاشی‌های در دسترس در زیر آمده است.

خطوط توپر:

!			,			v			.
-			)			+			(
			`			^			'

خطوط تیره‌دار:

:			F			V			7
~			D			%			C
			L			A			J

خطوط نقطه‌دار:

Q			S			M			T
P			H			R			G
			Y			W			Z

عمودی توپر افقی تیره‌دار:

fy		y		ye
f		t		e
fh		h		he

عمودی تیره‌دار افق توپر:

dj		j		jc
d		*		c
di		i		ic

عمودی نقطه‌دار افقی توپر:

kr		r		rl
k		a		l
kq		q		ql

عمودی نقطه‌دار افقی تیره‌دار:

kr2		r2		rl2
k2		a2		l2
kq2		q2		ql2

عمودی توپر افقی نقطه‌دار:

om		m		mp
o		b		p
on		n		np

عمودی تیره‌دار افقی نقطه‌دار:

om2		m2		mp2
o2		b2		p2
on2		n2		np2

متفرقه (آن‌هایی که زمینه‌شان خاکستری است در الگوی {{شجره‌نامه}} نبودند یا تغییر کرده‌اند):

k3		T2		l3		b3
G2		X		K		l4
		U		E

خصوصیات سبک

ظاهر جعبه‌ها در هر سطر را می‌توان با استفاده از پارامترهای اختیاری زیر تغییر دارد:

• border ضخامت کادر جعبه را به پیکسل تعیین می‌کند،
• با boxstyle می‌توان هر اعلامیهٔ دلخواهی از سی‌اس‌اس را به خصوصیات سبک جعبه افزود. مثلاً کد زیر:

{{Tree chart/start}}
{{Tree chart|border=1|boxstyle=color:white; background:green; | | FOO |y| BAR | |FOO=جعبهٔ اول|BAR=جعبهٔ دوم}}
{{Tree chart| | |,|-|^|-|.| | }}
{{Tree chart|border=3|boxstyle=background:yellow; | | FOO | | BAR | |FOO=جعبهٔ سوم|BAR=جعبهٔ چهارم}}
{{Tree chart/end}}

که می‌دهد:

جعبهٔ اول

جعبهٔ دوم

جعبهٔ سوم

جعبهٔ چهارم

حتی می‌توان خصوصیات سبک هر جعبه در سطر را به شکل تکی مشخص کرد، چنانکه در پایین می‌بینید:

{{Tree chart/start}}
{{Tree chart| | | | |CLEAR| | | | |CLEAR=جعبهٔ شفاف}}
{{Tree chart| |,|-|-|'|!|`|-|-|.| }}
{{Tree chart|RED  |~|GREEN|~|BLUE |RED=جعبهٔ قرمز|GREEN=جعبهٔ سبز|BLUE=جعبهٔ آبی
|boxstyle_RED  =color:white; background-color: red;
|boxstyle_GREEN=color:yellow; background-color: green;
|boxstyle_BLUE =color:white; background-color: blue;
}}
{{Tree chart/end}}

که می‌دهد:

جعبهٔ شفاف

جعبهٔ قرمز

جعبهٔ سبز

جعبهٔ آبی

نکته: وقتی خصوصیات سبک یک جعبه را به صورت تکی مشخص می‌کنید، مطمئن شوید نام جعبه به سمت چپ منطقهٔ اختصاص‌یافته به آن چسبیده است (مثل "|RED  |" به جای "| RED |" در مثال بالا)

الگوی {{Tree chart/start}} نیز پارامتر اختیاری |style= را می‌پذیرد که می‌تواند سبک‌های سی‌اس‌اس کل شجره‌نامه را تغییر دهد و نیز پارامتر اختیاری |align= که با استفاده از آن می‌توان تراز شجره‌نامه را عوض کرد.

جستارهای وابسته

• راهنما:ساخت شجره‌نامه: راهنمای جامع‌تر به همراه چند مثال
• رده:الگو:شجره‌نامه
• الگو:Tree list
• الگو:Ahnentafel