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

=== Формат строк ===
Параметр 1 определяет вывод строк карты маршрута. Каждая строка в самом простом формате выглядит следующим образом:

 первая иконка'''\'''вторая иконка\третья иконка и т. д.'''~~'''название станции

Полный формат при задании текста только справа иконок может быть таким:

 иконка1\иконка2 и т. д.~~километраж или время~~основная информация~~пояснение мелким шрифтом~~пояснение по правому краю~~свойства строки

Основная информация выводится обычным шрифтом с выравниванием по левому краю, пояснения и километраж — уменьшенным шрифтом. Первое пояснение выводится следом за основной информацией, второе пояснение — в том же поле, но с выравниванием по правому краю. Километраж (или время) отображается отдельной колонкой между иконками и основным текстом. Для изменения форматирования текста в каком-либо поле рекомендуется использовать [[Википедия:Маршрутные шаблоны#Вспомогательные шаблоны|вспомогательные шаблоны]], {{tl|align}}, блоки {{code|<nowiki><span></nowiki>}} и др. О задании свойств см. ниже.

Километраж, информация, пояснения и свойста не обязательны: после иконок можно вообще ничего не указывать, либо же оборвать задание строки после нужного количества текстовых полей. Для пропуска ненужных параметров можно заменить их пробелом, к примеру код {{code|WBRÜCKE~~34,7~~ ~~мост}} выведет инонку, километраж и уменьшенный текст «мост». Если в строке после иконок только одна пара тильд, то считается, что указана основная информация о пункте (а не километраж); для указания только километража (времени) используйте {{code|иконки~~''км''~~}}.

Шаблону в качестве параметра <code>1</code> можно передать сколько угодно строк (разделённых как обычный викитекст). Пустые строки «проглатываются» и не влияют на итоговую таблицу, в том числе в начале и в конце, а также в блоке colspan. Для разбиения текстовых полей на строки используйте {{code|<nowiki><br></nowiki>}} или {{tl|BSsplit}} (параметры которого, возможно, придётся разделять не {{code|<nowiki>|</nowiki>}}, a {{code|{{tl|!}}}}).

==== Задание иконок ====
{{{{BASEPAGENAME}}|заголовок=Выравнивание иконок|collapsible=no|legend=no|1=
STR\\STR~~{{code|STR\\STR}}
STR\STR\STR~~{{code|STR\STR\STR}}
STR~~{{code|STR}}
STR\STR~~{{code|STR\STR}}
HSTq~~{{code|HSTq}}
dHSTq\dHSTq~~{{code|dHSTq\dHSTq}}
dSTR\dSTR~~{{code|dSTR\dSTR}}
vSTR~~{{code|vSTR}}
STR\d~~{{code|STR\d}}
uSTRq\dSTR\fvSTR~~{{code|uSTRq\dSTR\fvSTR}}
uSTRq!~dSTR\fvSTR~~{{code|uSTRq!~dSTR\fvSTR}}
dSTR!~uSTRq\fvSTR~~{{code|dSTR!~uSTRq\fvSTR}}
uSTRq!~BHF!@Тестовская~~{{code|uSTRq!~BHF!@Тестовская}}
}}
Список кодов иконок приведён в [[Википедия:Маршрутные шаблоны/Каталог пиктограмм|каталоге пиктограмм]]. Более полная версия есть в [[:commons:BSicon/Catalogue|каталоге на Викискладе]].

Коды иконок отделяются друг от друга обратной косой чертой ({{code|\}}), их количество в строке не ограничено. При отсутствии кода между двумя чертами ({{code|\\}}) вместо иконки отображается пустое пространство, равное по ширине стандартной иконке (по умолчанию 20px). Для отображения пустой иконки ({{bs-q||no}}) используйте код {{code|leer}}; доступны пустые иконки четвертной ширины: {{bs-q|c}}, половинной: {{bs-q|d}}, трёхчетвертной: {{bs-q|cd}} и двойной: {{bs-q|b}}.

Блок с иконками выравнивается по центру соответствующей области для каждой строки по отдельности. Таким образом, если в одной строке указаны три иконки, а в следующей одна, то она будет расположена ровно под центральной из трёх сверху. Иконки, в коде которых присутствует префикс {{code|d}}, — половинной ширины: две такие иконки, идущие подряд, прижимаются друг к другу и занимают столько же места, как и одна обычная. Иконки, представляющие пару параллельных путей, напр. {{bs-q|vSTR}}, соответствуют двум иконкам половинной ширины с одним путём в каждой. (В некоторых браузерах при использовании функции увеличения выравнивание иконок может сбиваться на несколько пикселей, в особенности половинных и т. п.)

В одну «ячейку» можно поместить несколько иконок, наложенных поверх друг друга. Код накладываемой сверху иконки указывается после кода нижней через символы {{code|!~}}; таким же образом можно добавить ещё одну и т. д. Поддерживается неограниченное количество наложений. При наложении половинной иконки поверх обычной верхняя выравнивается по левому краю нижней; если обычную наложить поверх половинной, то с другими иконками они будут выравниваться, как половинная, но верхняя будет также перекрывать часть иконки, следующей за ними справа.

Переход на страницу файла с иконкой при нажатии на иконку отключён. Ссылку, по которой должна вести самая верхняя иконка в ячейке, можно добавить, приписав {{code|!@имя страницы}} после кодов всех иконок в ячейке, например, {{code|uSTRq!~BHF!@Тестовская}} (переход на статью о платформе [[Тестовская]]).
{{clear}}

==== Текст слева и справа от иконок ====
{{{{BASEPAGENAME}}|заголовок=Казанское направление|1=
vCONTg~~ ~~ ~~на Москву
~~20,7! !vINT~~20,7~~Люберцы I
SHI1+l\SHI1+r
Панки~~22,8! !HST\BHF~~23,7~~Люберцы II
Томилино~~25,4! !HST\ABZg3!~lCONT3f~~ ~~ ~~на Кореневский завод
р. Пехорка~~ ~~ ~~! !WBRÜCKE\WBRÜCKE~~ ~~ ~~ ~~р. Пехорка
Красково~~27,3! !HST\HST~~27,7~~Коренёво
Малаховка~~28,9! !HST\ÜWBr
Удельная~~31,5! !d\HST\ABZrg\dKBSTr~~ ~~ ~~Балластный Карьер
на Октябрьский~~ ~~! !dCONTgq\ABZlg\BHF\d~~30,0~~Овражки
Быково~~33,4! !BHF\CONTf~~ ~~ ~~на Гжель
на Раменское~~ ~~! !CONTf\
}}
<pre><nowiki>{{Маршрутная карта|заголовок=Казанское направление|1=
vCONTg~~ ~~ ~~на Москву
~~20,7! !vINT~~20,7~~Люберцы I
SHI1+l\SHI1+r
Панки~~22,8! !HST\BHF~~23,7~~Люберцы II
Томилино~~25,4! !HST\ABZg3!~lCONTf3~~ ~~ ~~на Кореневский завод
р. Пехорка~~ ~~ ~~! !hKRZWae\hKRZWae~~ ~~ ~~ ~~р. Пехорка
Красково~~27,3! !HST\HST~~27,7~~Коренёво
Малаховка~~28,9! !HST\ÜWBr
Удельная~~31,5! !d\HST\ABZg+l\dKBSTeq~~ ~~ ~~Балластный Карьер
на Октябрьский~~ ~~! !dCONTgq\ABZg+r\BHF\d~~30,0~~Овражки
Быково~~33,4! !BHF\CONTf~~ ~~ ~~на Гжель
на Раменское~~ ~~! !CONTf\
}}</nowiki></pre>

Возможен вывод текста с обеих сторон от иконок, как вариант — только слева. Дополнительные текстовые поля отделяются от остальной части строки двумя восклицательными знаками через пробел ({{code|! !}}), формат — симметричен:
 свойства~~пояснение 2~~поянение 1~~основная информация~~километраж! !иконки~~километраж~~основная информация~~пояснение 1~~пояснение 2~~свойства

Все параметры не обязательны. Выравнивание текстовых полей слева симметрично выравниванию текстовых полей справа. Если с левой стороны только одно текстовое поле (то есть нет пары тильд), то считается, что указан основной текст слева. Для указания слева только километража, используйте {{code|~~''км''! !иконки}}.

{{{{BASEPAGENAME}}|заголовок=Текст только слева|float=left|ширина текста = ,,,,,|collapse=collapsed|1=
Каширская! !CPICla teal!~HUB84\fCPICr!~HUB82
Варшавская! !BHF teal\
ТЧ-7 Замоскворецкое~~ ~~! !ABZlf teal\KDSTr teal
Каховская! !KBHFe teal!~HUB84\BHF grey!~HUB82
}}
Маршрутную карту можно расположить по левой стороне страницы, если основное основное направление текста — справа налево, или например, для размещения небольшой диаграммы слева при наличии основной диаграммы справа. Для этого шаблону необходимо передать параметр {{code|1=обтекание = left}}. При использовании в таком случае текста только слева иконок (перед символами {{code|! !}}), результат будет абсолютно симметричен стандартному виду диаграммы.
{{clear}}

==== Свойства строки ====
{{{{BASEPAGENAME}}|заголовок=Пример изменения свойств|collapsible=no|legend=no|1=
CONTg~~на Дмитров
\ABZrg\CONTfq~~ ~~ ~~на Александров I
BHF~~ ~~Яхрома~~ ~~ ~~bg=silver
LSTR~~ ~~ ~~ ~~ ~~bg=silver
BHF~~ ~~Икша~~ ~~ ~~bg=silver
CONTgq\ABZrf\~~ ~~ ~~на Поварово
CONTf~~на Москву
|внизу=<div style="background:silver;padding:3px;">Совмещенный участок БКМЖД<br>и Савеловского направления</div>
}}
Свойства переопределяют то, как будет выведена строка. Каждое свойство имеет вид {{code|1= имя=значение}}, одно от другого отделяется символами {{code|!@}}. Для стандартной строки свойства указываются после примечания по правому краю, за пятым разделителем {{code|~~}}. Если текст задается только слева от иконок, то свойства можно указать аналогичным образом ''перед'' наиболее левым примечанием слева, то есть за четыре разделителя {{code|~~}} перед {{code|! !}}. При указании свойств и слева, и справа, учитываться будут только правые.

На данный момент поддерживаются следующие свойства строки:
* {{code|bg}} — задает цвет фона области иконок (но не текстовых полей). Предполагается, что внизу диаграммы (с помощью параметра {{code|внизу}}) будет дано описание выделенного таким образом участка. В качестве значения допускаются стандартные [[wikipedia:ru:цвета HTML|цвета HTML]] или RGB-коды с символом #, напр. {{code|silver}} или {{code|#С0С0С0}}. Фон меняется для соответствующей ячейки общей таблицы, по ширине равной максимальному для всей диаграммы числу иконок в строке; то есть если в каком-то месте диаграммы присутствуют пять иконок в ряд, а фон поменять для строки с одной иконкой, область с измененным цветом в ширину будет равна пяти иконкам. Необходимо учитывать, что некоторые иконки имеют участки с непрозрачным фоном (#F9F9F9), которые могут стать заметными при изменении фона строки или таблицы.
{{clear}}