Шаблон:Генеалогическое древо/Документация
Этот шаблон служит для построения генеалогического древа, организационной структуры или блок-схемы на основе синтаксиса, напоминающего ASCII-графику. Древо отображается как HTML-таблица, использующая оформление CSS. В тексте можно использовать вики-коды для создания внутренних ссылок.
Указания
Схему следует открыть шаблоном {{עץ משפחה/התחלה}} и закрыть шаблоном {{עץ משפחה/סוף}}.
Между этими двумя шаблонами следует использовать шаблон {{עץ משפחה}}, при этом поочерёдно в одной строке пишут имена текстовых блоков и их подписи, а в следующей строке — управляющие символы плиток, которые создают соединения между текстовыми блоками.
Текстовые блоки
В основном текст шаблона делится на имена текстовых блоков и на подписи в них.
Имя — это внутреннее (и невидимое) имя текстового блока, и оно служит якорем для места, где текстовый блок появится на экране. А подпись — это содержимое, которое появится внутри текстового блока; она очень гибкая и может включать разнообразное содержимое.
Основная форма записи такова:
- имя текстового блока| имя текстового блока=внутренняя подпись текстового блока.
Например, в следующем примере:
- {{עץ משפחה| | | | סבא | | | |סבא=[[סבא]] שלי}}
Имя текстового блока в этом примере — слово «סבא», тогда как слова «סבא שלי» — это подпись, которая появится внутри текстового блока.
Вертикальная черта («|») обозначает дополнительный столбец в схеме.
Следует убедиться, что имя текстового блока одинаково в обоих местах, где оно записано.
Разница между именем и подписью
Когда программа распознаёт просто символ, она «знает», что речь идёт либо об управляющем символе, либо об имени текстового блока. Когда она распознаёт знак равенства («=»), она «знает», что речь идёт только о подписи.
В случае, если в шаблоне введено имя без соответствующей ему подписи, в отмеченном месте появятся символы имени, заключённые в фигурные скобки {{{שם}}}. В случае, если в шаблоне введена подпись без имени, на экране ничего не появится.
В части подписи можно добавлять обычные вики-символы, такие как выделение, подчёркивание, увеличенный текст, надстрочный текст, и даже сочетать другие шаблоны.
Пример
Следующий код:
{{עץ משפחה/התחלה}}
{{עץ משפחה| | | | סבא |~|ד|~| סבתא | | סבתא=סבתא שלי|סבא=סבא שלי}}
{{עץ משפחה| | | | | | | |)|-|-|-|,| }}
{{עץ משפחה| | | אמא |ד| אבא | |דודה| אמא=אמא שלי|אבא=אבא שלי|דודה=הדודה שלי}}
{{עץ משפחה| |.|-|-|-|+|-|-|-|,| | | }}
{{עץ משפחה| אח | | אני | | אחות | | | אח=אחי הגדול|אני='''אני!'''|אחות=אחותי הקטנה}}
{{עץ משפחה/סוף}}
Создаёт следующее древо:
| Мой дедушка | Моя бабушка | ||||||||||||||||||||||||
| Моя мама | Мой папа | Моя тётя | |||||||||||||||||||||||
| Мой старший брат | Я! | Моя младшая сестра | |||||||||||||||||||||||
Параметры
Шаблон создаёт одну строку в таблице генеалогического древа. Шаблон принимает до 99 числовых параметров (без имени), с помощью которых можно задать, как будет выглядеть строка. Каждый параметр представляет плитку или текстовый блок:
Плитки — это символы, состоящие из вертикальных и горизонтальных линий. Каждая плитка представлена одним символом — буквой, знаком препинания или цифрой. Пустая плитка представлена одним символом пробела. Ниже приводится список плиток и символов, которые их представляют:
|
|
|
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
- Примечания
- Плитки, отмеченные красным, ещё не перенесены в ивритский шаблон.
- Плитки, отмеченные светло-серым, — дубликаты, и они находятся там, где находятся, лишь для правильной вёрстки.
Текстовые блоки могут содержать вики-код. Содержимое текстовых блоков создаётся с помощью именованных параметров, в дополнение к параметру, задающему положение текстового блока. Длина каждого текстового блока — три плитки, и обычно у него чёрная граница шириной 2 пикселя. Имя текстового блока может содержать любой символ, но желательно избегать односимвольных имён, чтобы не допустить конфликта или путаницы с символами, обозначающими плитки.
оформления
Оформлением текстовых блоков можно управлять с помощью свойств גבול и עיצוב. Первое задаёт ширину границы в пикселях, а второе служит для добавления особого оформления средствами CSS. Например, следующий код:
Граница
{{עץ משפחה/התחלה}}
{{עץ משפחה|גבול=0|עיצוב=background:#dfd;| | אחת |ד| שתיים | |אחת=תיבה 1|שתיים=תיבה 2}}
{{עץ משפחה|גבול=0|עיצוב=background:#dfd;| | |.|-|^|-|,| | }}
{{עץ משפחה|גבול=0|עיצוב=background:#dfd;| | אחת | | שתיים | |אחת=תיבה 3|שתיים=תיבה 4}}
{{עץ משפחה/סוף}}
Создаст следующее древо:
| Ячейка 1 | Ячейка 2 | ||||||||||||||||
| Ячейка 3 | Блок 4 | ||||||||||||||||
оформления
Можно также добавить особое оформление для каждого текстового блока.
К имени текстового блока следует обращаться следующим образом:
|עיצוב_<<имя поля>>=формула оформления;
Например:
{{עץ משפחה/התחלה}}
{{עץ משפחה| | | | |לבן| | | | |לבן=תיבה לבנה}}
{{עץ משפחה| |.|-|-|`|!|'|-|-|,| }}
{{עץ משפחה|אדום |~|ירוק|~|כחול |אדום=תיבה אדומה|ירוק=תיבה ירוקה|כחול=תיבה כחולה
|עיצוב_אדום=background-color: #faa; border: 5px solid blue;
|עיצוב_ירוק=background-color: #afa;
|עיצוב_כחול=background-color: #aaf;
}}
{{עץ משפחה/סוף}}
Создающий следующее генеалогическое древо:
| Белый блок | |||||||||||||||||||||
| Красный блок | Зелёный блок | Синий блок | |||||||||||||||||||
Обратите внимание: когда хотят добавить оформление к определённым блокам, нужно убедиться, что имена блоков выровнены по правому краю (то есть справа от имени нет пробела, например: «|אדום |», а не «| אדום |»), иначе шаблон будет искать параметр оформления, начинающийся с пробела.
Также в шаблоне {{עץ משפחה/התחלה}} можно добавить оформление CSS с помощью именованного параметра עיצוב. Это оформление влияет на всю таблицу.
Ссылки
В схему можно добавлять вики-ссылки. Ссылки следует записывать во второй части, после знака равенства («=»). Например: יחי=[[יחי]]. (Это та часть, в которой можно добавлять вики-оформление, например выделение, подчёркивание и т. п.)
Дополнительные руководящие линии
Код генеалогического древа следует писать в шаблоне, поскольку речь идёт о сложном тексте, которому не стоит появляться в самих статьях. Для этого нужно создать новый шаблон, обычно под таким названием: «[[תבנית:עץ משפחת <שם משפחה>]]». Этот шаблон следует добавить в Категория:Генеалогические древа.