[просмотр] [править] [история] [обновить]
Документация
Familytree (дословно «семейное дерево») — шаблон для рисования простых генеалогических деревьев.
Использует таблицы HTML с CSS-атрибутами. «Листья» дерева могут содержать произвольный вики-код.
Внешний вид
Вики-код:
{{familytree/start}}
{{familytree | | | | БАБ |~|y|~| ДЕД | | БАБ=Бабушка |ДЕД=Дедушка}}
{{familytree | | | | | | | |)|-|-|-|.| |}}
{{familytree | | | МА |y| ПА | |ТЕТЯ | МА=Мама |ПА=Папа |ТЕТЯ=[[Тетя Мэй]]}}
{{familytree | |,|-|-|-|+|-|-|-|.| | | |}}
{{familytree | БР | | Я | | СЕС | | | БР=Ваня |Я='''Я'''|СЕС=Ира}}
{{familytree/end}}
Результат:
|
|
|
Бабушка |
|
|
|
Дедушка |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Мама |
|
Папа |
|
Тетя Мэй |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Ваня |
|
Я |
|
Ира |
|
|
|
Параметры
- Шаблон {{familytree}} добавляет одну строку в таблицу генеалогического древа. Шаблон может содержать до 90 неназванных параметров, описывающих содержание таблицы. Каждый параметр определяют tiles (параметры плитки) или box (параметры окна/ячейки).
- Параметр tiles (дословно «плитки») — образующие линии символы, позволяющие нарисовать как горизонтальные, так и вертикальные линии, а также задать параметры углов их пересечения. Плитка задаются с помощью односимвольных символов, которые более или менее приблизительно задают форму и внешний вид линий. Особый случай — пустая «плитка» (ее отсутствие), указывающаяся одним пробелом. Поддерживаемые «плитки»:
Сплошные линии:
, |
|
. |
|
` |
|
' |
|
^ |
|
v |
|
( |
|
) |
|
- |
|
! |
|
+ |
|
|
|
Пунктирные линии:
F |
|
7 |
|
L |
|
J |
|
A |
|
V |
|
C |
|
D |
|
~ |
|
: |
|
% |
|
|
|
Смешанные линии:
* |
|
} |
|
{ |
|
é |
|
è |
|
Ä |
|
? |
|
# |
|
y |
|
h |
|
ÿ |
|
Ÿ |
|
> |
|
Y |
|
] |
|
[ |
|
ä |
|
À |
|
< |
|
- Пример кода плиток из образца дерева выше:
|,|-|-|-|+|-|-|-|.|
.
- Параметр boxes («окна» или «ячейки») — область, где расположена информация о члене семьи. Может содержать произвольную вики-разметку. Содержимое окна задается с помощью дополнительных именованных параметров добавляется в шаблон вызова. Например, стандартно кадая ячейка дерева имеет ширину три плитки и черную рамку шириной 2 пикселя. Однако в дальнейшем эти параметры могут быть изменены. В В окно ячейки можно ввести любое имя, которое является допустимым — не больше ширины трех плиток (без нарушения стиля), хотя простые и короткие имена персонажей тоже следует избегать, чтобы предотвратить путаницу с символами параметра tiles.
- Пример кода ячейки из образца дерева выше:
| МА |
.
Стилевое оформление
Внешний видом окон можно управлять с помощью дополнительных параметров style (стиля), border (границ) и boxstyle (индивидуального стиля ячеек).
- параметр style (стиля), принимаемый самим шаблоном {{familytree/start}}, используется для установки CSS-стилей для всего древа. (См. Пример 1)
- Значение по умолчанию — 100%.
- Параметр border (граница) задает ширину окна и границу в пикселях. (См. Пример 2)
- Может быть использован в окне атрибутов стиля, рядом с параметром boxstyle, для создания индивидуального стиля отдельной ячейки. (См. белую ячейку из Примера 3)
- Значение по умолчанию — 2.
- Параметр boxstyle (стиль окна) может быть использован для добавления произвольных CSS-параметров для строки. (См. Пример 2)
- Может быть использован непосредственно в окне атрибутов стиля индивидуально для определенной ячейки. (См. Пример 3)
- Цвет по умолчанию — прозрачный.
Все приведенные способы оформления могут быть комбинированы. Существуют также и другие возможности изменения стиля таблицы-древа.
Пример 1
{{familytree/start|style=font-size:120%;line-height:100%;}}
{{familytree | |ОТЕЦ |y|МАТЬ | ОТЕЦ=Егор Гайдар |МАТЬ=Мария Стругацкая}}
{{familytree | | | | |!| | | | }}
{{familytree | | | |ДОЧЬ | | | ДОЧЬ=Мария Гайдар}}
{{familytree/end}}
Пример 2
{{familytree/start}}
{{familytree|border=0|boxstyle=background:#dfd;| | FOO |y| BAR | |FOO=Окно 1 |BAR=Окно 2}}
{{familytree|border=0|boxstyle=background:#dfd;| | |,|-|^|-|.| | }}
{{familytree|border=0|boxstyle=background:#dfd;| | FOO | | BAR | |FOO=Окно 3 |BAR=Окно 4}}
{{familytree/end}}
|
Окно 1 |
|
Окно 2 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Окно 3 |
|
Окно 4 |
|
|
Пример 3
{{familytree/start}}
{{familytree| | | | |БЕЛ | | | | |БЕЛ=Белая ячейка
|boxstyle_БЕЛ =border: 0;}}
{{familytree| |,|-|-|'|!|`|-|-|.| |}}
{{familytree|КРАС |~|ЗЕЛ |~|СИН |КРАС=Красная ячейка |ЗЕЛ=Зеленая ячейка |СИН=Синяя ячейка
|boxstyle_КРАС =background-color: #faa;
|boxstyle_ЗЕЛ =background-color: #afa;
|boxstyle_СИН =background-color: #aaf;}}
{{familytree/end}}
|
|
|
|
Белая
ячейка
(без границ) |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Красная
ячейка |
|
Зеленая
ячейка |
|
Синяя
ячейка |
|
|
Заметки
- При определении атрибутов стиля для отдельного имени окна убедитесь, что поле имена выравниваются по левой стороне области, отведенные для них в шаблоне по названию (как в «
|СИН |
» вместо «| СИН |
» в приведенном выше примере). В противном случае шаблон будет в конечном итоге выглядеть в качестве стилего параметра с пробелами в его имени.
- Либо при использовании пробела в коде ячейки (делается для визуального восприятия, т. е. «
| СИН |
») не забывать пробел в параметре boxstyle после подчерка: |boxstyle_ СИН
.
См. также
Во избежание поломок страниц, использующих данный шаблон, желательно экспериментировать в своём личном пространстве.