Редактирование: Шаблон:Маршрутная карта/doc (раздел)

=== Ключевые слова ===
Модуль шаблона распознаёт и обрабатывает ключевые слова, расширяющие его функциональность. Все ключевые слова выглядят как {{code|-КлючевоеСлово[-параметры]}}. Параметры не всегда являются обязательными; между собой их нужно также разделять знаком {{code|-}}.

==== Сворачивающиеся блоки ====
Шаблон поддерживает сворачивающиеся блоки. Для их применения нужно указать начало и конец блока с помощью ключевых слов {{code|startCollapsible}} и {{code|endCollapsible}} соответственно (в точно таком написании, расположенные на отдельных строках). Блоки могут идти один за другим или могут быть вложены друг в друга, но при этом после {{code|startCollapsible}} обязательно должна идти строка без ключевых слов (при использовании функции замещения — две строки). Данная строка будет отображаться постоянно; оставшиеся строки будут добавляться или убираться снизу от нее.

Открывающее блок ключевое слово поддерживает три необязательных параметра.
# Изначальное состояние свёрнутости блока: {{code|collapsed}} (свёрнут, значение по умолчанию) или {{code|expanded}} (развёрнут).
# Использование замещения. При указании любого непустого значения (рекомендуется {{code|replace}}) вторая после {{code|startCollapsible}} строка будет использована для замещения первой строки в развёрнутом состоянии блока. (Фактически, вторая строка будет расположена ''поверх'' первой, перекрывая её).
# Свойства блока. Формат такой же, как и [[#Свойства строки|для обычных строк]]. Поддерживается {{code|bg}} — цвет фона всех строк блока, включая первую и строку замещения. Текстовые поля также будут отображены с данным фоном.

Параметры должны указываться именно в таком порядке. Если нет необходимости задавать какой-то из них, ограничивающие его дефисы ставятся подряд. Таким образом, возможны в том числе следующие записи: {{nobr|{{code|-startCollapsible}}}}, {{nobr|{{code|-startCollapsible-expand}}}}, {{nobr|{{code|-startCollapsible--replace}}}}, {{nobr|{{code|1=-startCollapsible-expand-replace-bg=silver}}}} и т. д.

Триггер <small>[развернуть] / [свернуть]</small> по умолчанию добавляется в крайне правую ячейку строки таблицы вместо второго примечания. Само примечание при этом будет расположено в том же поле, что и основной текст с первым примечанием, и может перекрыть их сверху. Для корректировки этого используйте параметр {{code|ширина текста}} (см. ниже). Для варианта использования маршрутной карты, при котором весь текст указывается только слева иконок, триггер целесообразно переместить в крайне левую ячейку строки, также вместо второго (левого) примечания. Для этого необходимо задать {{code|1=ширина текста = ,,,,,}}, либо другие необходимые значения, но с пустыми последними тремя полями. При этом текст триггера будет изменён на <small>[показать] / [скрыть]</small> (поскольку используется другой класс [[Википедия:Сворачивающиеся блоки|сворачивающихся блоков]]).

Поскольку сворачивающийся блок фактически представляет собой отдельную таблицу с независимым выравниванием столбцов, помещенную в объединённую ячейку основной диаграммы, для совпадения выравнивания иконок и текста зачастую необходимо пользоваться следующими правилами.
* Количество иконок в первой строке сворачивающегося блока, а при использовании функции замещения — и во второй строке, должно совпадать с максимальным числом иконок в ряд за всю таблицу. Точнее, ширина полосы иконок в первой строке (первых двух) с учётом использования пустых, половинных и др. иконок должна быть равна максимальной таковой ширине за всю таблицу. Для этого по краям полосы иконок можно добавить пустые иконки. Если внутри сворачивающегося блока есть строка с большей шириной полосы иконок, чем вне его, то необходимо увеличить ширину полосы одной из строк вне блока пустыми иконками.
* Если внутри сворачивающегося блока суммарная ширина текстовых полей одной из строк превышает таковую для всех строк вне блока; или если где-либо в диаграмме используется поле километража (времени); или если в первой строке (первых двух) задано достаточно длинное текстовое поле; и во всех случаях использования текста слева от иконок — необходимо указать параметр шаблона {{code|ширина текста}}. В нём фиксируется ширина используемых текстовых полей через запятую; при отсутствии единиц измерения (px, em и т. п.), подставляются пиксели.
** Если задано одно значение ({{code|1=ширина текста = 120}}), оно изменяет ширину столбца, в котором размещается основной текст справа с первым примечанием.
** Если задано три значения ({{code|1=ширина текста = 25,120,75}} или {{code|1=ширина текста = ,,75}}), оно изменяет ширину столбцов справа: километража, основной информации с первым примечанием и второго примечания.
** Если задано шесть значений ({{code|1=ширина текста = 50,110,25,25,120,75}} или {{code|1=ширина текста = ,120,25,,,}}), оно изменяет ширину столбцов слева и справа: второго левого примечания, основного теста слева с первым примечанием, километража слева, километража справа, основной информации справа с первым примечанием и второго примечания справа.
* Обычные значения для километража: 25px для текста «123,4»; 32px для «1234,5»; 12px для иконки {{tl|инвалид}}.
* Необходимо учитывать, что в строках, для которых не задано второе примечание, столбцы для него и для основной информации объединяются, и ширина такого поля не зависит напрямую от параметра {{code|ширина текста}}. Основной текст с первым примечанием при этом вполне могут превышать по ширине заданное для соответствующей колонки значение. Таким образом, для выбора ширины второго столбца справа ориентироваться надо на максимальную ширину основного текста только из тех строк, где есть второе примечание.
* При использовании функции замещения рекомендуется всегда задавать как минимум 72px для третьего правого столбца (или 50px для первого левого столбца), поскольку без этого некоторые браузеры (в том числе Google Chrome) могут отобразить строку замещения немного сдвинутой. Заданием ширины столбца основного текста также можно регулировать сокрытие теста замещённой (первой) строки.
* Параметр {{code|ширина текста}} помимо этого убирает 6px пустого пространства слева от иконок, остающиеся от столбца левого километража, если задать менее шести значений или если левые три значения будут пустыми. При задании шести значений, правые три из которых пусты, пустое пространство убирается справа, а триггер <small>[показать] / [скрыть]</small> переносится в самый левый столбец.

==== Текст в ширину таблицы ====
{{{{BASEPAGENAME}}|legend=no|заголовок=Схема станции|1=
STR\STR!~utSTRc2\utSTR3+1a!~uSTRc2\uSTR3+1
STR\utSTR3+1!~STR\utSTR3+1a!~utSTRc4\uSTRc4
-colspan-2
----
''Верхний уровень''
KRWgl+l\KRWgr+r\\
STR+BSlr\STR+BSlr\\~~Пригородные
STR+BSlr\STR+BSlr\\~~поезда
-colspan--style=padding-bottom:5px;
----
''Нижний уровень'' {{align|right|{{BSsplit|−6 m|−20 ft}}}}
-colspan-end
utSTR+1\utSTR+1\\
utSTR+BSr\utSTR+BSl\\~~Скоростной
utSTR+BSr\utSTR+BSl\\~~транспорт
}}
Чтобы вывести некоторый текст во всю ширину таблицы, применяется ключевое слово {{code|colspan}}. Следующие за ним строки будут обработаны как обычный викитекст и помещены в одну объединённую ячейку. Действие данного ключевого слова прекращается после указания на очередной строке {{code|-colspan-end}}. К открывающему ключевому слову может быть добавлен необязательный параметр — число строк к объединению (не включая само открывающие слово {{code|colspan}}). Указания {{code|-colspan-end}} в таком случае не требуется, но если оно встретится раньше, чем заданно строк, обработка ключевого слова закончится.

Вторым необязательным параметром является список свойств в [[#Свойства строки|стандартном формате]], которые будут применены к объединённой ячейке. Для colspan поддерживаются:
* {{code|bg}} — фон ячейки. Займет практически всю ширину таблицы, за исключением внутренних отступов (padding);
* {{code|align}} — выравнивание текста, напр. {{code|left}}, {{code|right}} или {{code|center}};
* {{code|style}} — дополнения к CSS-стилю ячейки, напр. {{code|padding:5px 0px;}}.

Поскольку текст, помещенный в данный блок, всё же передается в качестве параметра шаблона, элементы форматирования таблиц необходимо заменять на {{code|{{tl|!}} }}, {{code|{{tl|!-}}}}, {{code|{{tl|!}}}} и т. д. Помимо этого, пустые строки предварительно «проглатываются» и не оказывают влияния на подсчет строк к объединению и на форматирование текста. Для разбиения текста внутри блока на строки используйте {{code|<nowiki><br></nowiki>}}. До появления {{code|-colspan-end}} либо истечения строк счетчика, обработка других ключевых слов не производится.
{{clear}}

==== Строка-заполнитель ====
{{Маршрутная карта|заголовок=нет|легенда=нет|ширина текста=,,|1=
uKBHFa!~HUBaq\BHF brown!~HUBq\KBHFa orange!~HUBeq~~↙ {{code|-filler--#003399\\#FF6600}}
-filler--#003399\\#FF6600
uBHF!~HUBaq\BHF!~HUBq\BHF orange!~HUBeq~~↙ {{code|-filler--u\-\orange}}
-filler--u\-\orange
uKBHFe!~HUBaq\KBHFxe!~HUBq\KBHFxe orange!~HUBeq~~↙ {{code|-filler-40px-\ex\ex_orange<nowiki>~~текст</nowiki>}}
-filler-40px-\ex\ex_orange~~ ~~Пустой участок~~ ~~5 км~~bg=#ccccff
\exKBHFe\exKBHFe orange
}}
Вместо блока иконок строится таблица, имитирующая ряд иконок {{code|STR}} ({{bs-q|STR|0|15px}}) нужных цветов, но с возможностью выставить произвольную высоту (аналогично шаблону {{tl|BS!}}). Может применяться для разделения двух строк карты, если высота обычных иконок (20px) излишня. Ключевое слово — {{code|filler}}, первый параметр — высота строки, при его отсутствии используется {{code|5px}}. Второй параметр аналогичен обычной строке с тем же набором разделителей и параметров. Вместо названий иконок указываются RGB-коды очередной линии или же название набора иконок на Викискладе (см. {{tl|BS-color}} и [[:Commons:Category:Icons for railway descriptions/other colors|категорию]]). Например, вместо {{bs-q|uexSTR||15px}} указать {{code|uex}}, вместо {{bs-q|STR orange||15px}} — {{code|orange}}, вместо {{bs-q|exSTR orange||15px}} — {{code|ex_orange}}; для стандартного набора ({{bs-q|STR||15px}}) указать {{code|bahn}} или {{code|-}}. Каждая ячейка занимает 20px в ширину; отсутствие кода или названия ({{code|\\}}) оставляет ячейку пустой.
{{clear}}