الگو:Tree chart/توضیحات

< الگو:Tree chart
نسخهٔ تاریخ ‏۱۶ ژانویهٔ ۲۰۲۲، ساعت ۰۵:۲۰ توسط fa.wikipedia.org>Huji (اصلاح شمار ستون‌ها)
(تفاوت) → نسخهٔ قدیمی‌تر | نمایش نسخهٔ فعلی (تفاوت) | نسخهٔ جدیدتر ← (تفاوت)

استفاده

هر بار استفاده از این الگو یک سطر شجره‌نامه را می‌سازد که شامل جعبه‌ها و خطوط وصل‌کننده است. این الگو را باید به همراه {{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}}

که می‌دهد:

جعبهٔ شفاف
جعبهٔ قرمزجعبهٔ سبزجعبهٔ آبی

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

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

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