Шаблон:Chart/документація

Матеріал з Вікіпедії — вільної енциклопедії.
Перейти до навігації Перейти до пошуку

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 {{family tree}} template.

Basic example

[ред. код]

Цей код:

{{chart/start}}
{{chart| | | |БАБ |~|y|~| ДІД | |БАБ=Бабуся|ДІД=Дідусь}}
{{chart| | | | | | | |)|-|-|-|.| }}
{{chart| | | МАМ |y| ТАТ | |ДЕЙЗІ|МАМ=Мама|ТАТ=Тато|ДЕЙЗІ=[[Тітка Дейзі]]}}
{{chart| |,|-|-|-|+|-|-|-|.| | | }}
{{chart| ДЖО | | Яа  | | SIS | | |ДЖО=Мій брат Джо|Яа='''Я!'''|SIS=Моя молодша сестра}}
{{chart/end}}

видає це:

БабусяДідусь
МамаТатоТітка Дейзі
Мій брат ДжоЯ!Моя молодша сестра


Ця таблиця візуально відображає інформацію про те, що у мене є брат Джо і маленька сестра; моя мама вийшла заміж за мого батька; а батьки мого батька були бабуся і дідусь; а у батьків мого батька була ще одна дитина, тітка Дейзі. Наведений вище код створює таблицю розміром 9 рядків х 10 стовпців, як показано нижче.

Складний базовий приклад

[ред. код]

Цей код використовує {{chart top}}:

{{chart top|Приклад родинного дерева}}
{{chart/start|align=center}}
{{chart| | | |БАБ |~|y|~| ДІД | |БАБ=Бабуся|ДІД=Дідусь}}
{{chart| | | | | | | |)|-|-|-|.| }}
{{chart| | | МАМ |y| ТАТ | |DAISY|МАМ=Матуся|ТАТ=Татусь|DAISY=[[Тітка Дейзі]]}}
{{chart| |,|-|-|-|+|-|-|-|.| | | }}
{{chart| ДЖО | | Яа  | | СЕС | | |ДЖО=Мій брат Джо|Яа='''Я!'''|СЕС=Моя маленька сестра}}
{{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
Різне:
T2
G2
X
K
l4
U

Атрибути стилю

[ред. код]

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 1Box 2
Box 3Box 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 boxGreen boxBlue 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, and an optional |align= parameter to set the chart alignment.

Migration from familytree

[ред. код]

The {{chart}} template is largely compatible with the earlier {{family tree}} template. However, to use the additional functionality offered with this template, diagrams must be updated to use {{chart}} instead. Many {{family tree}} diagrams can be altered to use {{chart}} simply by replacing the wikitext familytree with chart. A few of the "mixed" tiles had to be renamed, and {{family tree}} 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 {{family tree}} {{chart}}
{ c
} d
# t
[ e
] f
  i
  j

The following list of tiles exist in {{Familytree}}, but do not exist in {{Chart}}. When converting from {{Familytree}} to {{Chart}} care must be taken to alter the tree so that these tiles are not used.

Hex Glyph Familytree Chart
47 G
{{{G}}}
4B K
{{{K}}}
54 T
{{{T}}}
55 U
{{{U}}}
58 X
{{{X}}}
62 b
{{{b}}}
63 c
{{{c}}}
Hex Glyph Familytree Chart
64 d
{{{d}}}
6A j
{{{j}}}
6B k
{{{k}}}
6E n
{{{n}}}
70 p
{{{p}}}
71 q
{{{q}}}
72 r
{{{r}}}

When converting from {{Familytree}} to {{Chart}} care must be taken with all the glyph mentioned in this section to generate tiles with {{Familytree}} are altered so that the tiles are not silently replaced with inappropriate tiles from {{Chart}}.

For example: the glyph "k" generates the tile
{{{k}}}
with {{Familytree}} but
with {{Chart}}

Lastly, if any uses of the {{family tree}} 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.

Див. також

[ред. код]