Шаблон:Маршрутная карта

Документация

[просмотр | править | история | обновить]

Этот шаблон реализован на основе Lua с использованием модуля Routemap.

Этот шаблон использует TemplateStyles и загружает следующие таблицы CSS-стилей:

Template:Маршрутная карта/styles.css

Шаблон: Маршрутная карта предназначен для построения маршрутных диаграмм на основе иконок BSicon и текстовых подписей. Шаблон является Lua-реализацией маршрутных схем и используется как современная замена старых BS-шаблонов.

Другое название этого шаблона — {{Routemap}}.

Использование

Минимальный вызов:

{{Маршрутная карта
|карта=
KBHFa~~конечная
HST~~следующая станция
}}

Типовой каркас:

{{Маршрутная карта
|navbar        = {{subst:PAGENAME}}
|заголовок     =
|цвет заголовка =
|цвет фона заголовка =
|цвет фона     =
|легенда       =
|сворачиваемый =
|свернуть      =
|выравнивание  =
|стиль         =
|вверху        =
|внизу         =
|ширина текста =
|карта         =
}}

Основные параметры:

|карта = или |1 =: код диаграммы.
|заголовок =: заголовок таблицы. Значения no, 0 или пустой заголовок убирают шапку.
|цвет заголовка =, |цвет фона заголовка =, |цвет фона =: основные цвета схемы.
|легенда =: имя страницы с условными обозначениями. Основные значения: жд, пути, автобус, дороги, водный, пешие, нет. Английские алиасы, используемые в enwiki: default, track, bus, road, canal, water, waterway, foot, footpath, walkway.
|сворачиваемый = и |свернуть =: управление сворачиванием всей таблицы.
|ширина текста =: ширина текстовых колонок; особенно полезна для сложных и сворачиваемых схем.
|inline =: убирает внешнюю рамку и заголовок, что удобно для встраивания в карточки.

Для совместимости шаблон также принимает английские имена параметров, например title, legend, text-width, map, footnote.

Несколько карт в одном шаблоне

Шаблон поддерживает несколько схем в одном контейнере:

|map1 =, |map2 =, … |map10 =
|map1-title =, |map2-title =, …
|map1-collapsible =, |map1-collapse =, …
|tw2 =, |text-width2 =, …

Если используется только одна схема, обычно достаточно параметра |карта = или |1 =.

Формат параметра «карта»

Каждая непустая строка внутри параметра |карта = образует одну строку диаграммы.

Основные разделители:

Код	Назначение
`\`	Разделяет иконки внутри одной строки
`~~`	Разделяет текстовые ячейки справа или слева от иконок
`!~`	Наложение иконок или текста в одной ячейке
`!@`	Ссылка для иконки
`!_`	Параметры всей ячейки
`__`	Параметры отдельной иконки или текстового объекта

Базовый пример

{{Маршрутная карта
|заголовок = Пример
|карта = 
KBHFa~~конечная
WASSERq\hKRZWae\WASSERq~~ ~~ ~~мост
LDER\INT\~~1 км~~станция~~пересадка
\KBHFe\BUS~~2 км~~конечная~~автобусный терминал
}}

Правила:

Иконки разделяются обратной косой чертой \.
Если после набора иконок указан только один разделитель ~~, следующий текст попадёт в основную текстовую колонку.
Для пустых текстовых колонок оставляйте пробелы между разделителями, чтобы последовательность тильд не воспринималась как подпись.

Текст внутри ряда иконок

Текстовая ячейка на месте иконки начинается со звёздочки:

*Текст
d*1
cd*Платформа

Перед * можно поставить префикс ширины BSicon:

o, c, d, cd, b, s, bs, w

Это позволяет делать узкие, половинные и широкие текстовые ячейки вместо обычной квадратной.

Наложения, ссылки и параметры

Примеры:

uSTRq!~STR2!~BHF
utBHF!@Superhub
BHF!_bg=#eef,style=border-radius:2px
*Текст__align=l,color=red

Кратко:

!~ накладывает объекты друг на друга.
!@ задаёт ссылку для иконки.
!_ применяет параметры ко всей ячейке.
__ применяет параметры к конкретной иконке или тексту в ячейке.

Наиболее полезные свойства:

bg, background, bgcolor
color, colour
b, bold
i, it, italic
align
fontsize
style
abbr

Текст слева от иконок

Для левого сайдбара используется разделитель ! ! между левыми текстовыми ячейками и набором иконок:

лево4~~лево3~~лево2~~лево1! !иконка\иконка~~право1~~право2~~право3~~право4

Этот режим полезен для сложных схем с двусторонними подписями. Для него особенно важно правильно подобрать |ширина текста =.

Сворачиваемые блоки

Строки, начинающиеся с дефиса, трактуются как ключевые слова. Основные:

Код	Назначение
`-startCollapsible`	Начало сворачиваемого блока
`-startCollapsible-collapsed`	Начало блока, свёрнутого по умолчанию
`-startCollapsible--replace`	Блок с заменяющей строкой
`-startCollapsible-collapsed-replace`	Блок с заменяющей строкой, свёрнутый по умолчанию
`-endCollapsible`	Конец сворачиваемого блока

Пример:

-startCollapsible-collapsed
\KBHFa\~~конечная
hSTRa@g
WASSERq\hKRZW\WASSERq~~ ~~ ~~мост
hSTRe@f
-endCollapsible

Сворачиваемая замена

Режим -replace позволяет показывать одну строку в свёрнутом состоянии и скрывать её при раскрытии блока.

Пример:

KBHFa~~конечная
-startCollapsible-collapsed-replace
\LSTR\~~скрытый участок
leer
\hSTRag\
WASSERq\hKRZW\WASSERq~~ ~~ ~~виадук
hSTRef
-endCollapsible

Особенности:

заменяющая и заменяемая строки должны быть не уже самой широкой обычной строки схемы;
для таких блоков почти всегда нужно задавать достаточную |ширина текста =;
если раскрытый блок должен полностью скрывать заменяющую строку, удобно использовать leer как пустой заполнитель;
на мобильных интерфейсах сворачиваемые элементы MediaWiki могут вести себя иначе, чем на десктопе.

Текстовые колонки и параметр «ширина текста»

|ширина текста = принимает:

1 значение: ширина основной правой текстовой колонки;
3 значения: право1, право2+3, право4;
6 значений: лево4, лево3+2, лево1, право1, право2+3, право4.

Значения можно задавать в px, em и других CSS-единицах. Если единица не указана, используется px.

Для сложных схем и сворачиваемых блоков имеет смысл сначала подобрать ширина текста, а уже затем косметически править отступы и стили.

Colspan и строки-заполнители

Недиаграммные строки на всю ширину:

-colspan
----
Текст на всю ширину таблицы
-colspan-end

или на фиксированное число следующих строк:

-colspan-2-style=border-bottom:1px solid #aaa;
----
Примечание
ещё одна строка

Строки-заполнители:

-filler--#003399\#FF6600
-filler-80px-\ex\ex_orange~~ ~~ ~~Пример текста~~ ~~bg=#007CC3

Форма:

-filler-<высота>-<содержимое строки>

Высота необязательна; содержимое задаёт цветовые столбики или упрощённый ряд иконок.

Краткий обзор синтаксиса

Элемент	Значение
`\`	Разделитель иконок
`~~`	Разделитель текстовых ячеек
`!~`	Наложение
`!@`	Ссылка иконки
`!_`	Параметры ячейки
`__`	Параметры отдельного объекта
`! !`	Разделитель между левым текстом и иконками

Переход со старых BS-шаблонов

Для старых маршрутных схем можно:

заменить шаблоны строк на их safesubst-варианты;
воспользоваться функцией convertbs из Модуль:Routemap;
переводить схему по частям, начиная с простых строк и только затем переходя к сворачиваемым блокам и colspan.

Пример вызова:

{{#invoke:Routemap|convertbs|<nowiki>
(исходная BS-map старая разметка)
</nowiki>}}

Встраивание в карточки

Для встраивания в карточки используйте inline=1. Это убирает внешнюю рамку и заголовок контейнера.

{{Маршрутная карта
|inline=1
|navbar={{subst:PAGENAME}}
|navbar pos=2
|карта=
KBHFa~~конечная
WASSERq\hKRZWae\WASSERq~~ ~~ ~~мост
}}

Подробное описание

Некоторые части описания могут быть устаревшими.

Формат описания диаграммы

Маршруты Eurostar

Условные обозначения

0:00

Лондон (Сент-Панкрас)

(c 2007 г.)

Лондон (Ватерлоо) (до 2007 г.)

0:14

Эббсфлит

0:29

Эшфорд

0:31

Евротоннель

Великобритания

Франция

0:51

0:55

Кале (Кале-Фретен)

1:22

Лилль (Лилль-Европа)

Франция

Бельгия

2:01

Брюссель (Южный вокзал)

2:16

Париж (Северный вокзал)

2:40

Диснейленд (Марн-ла-Вале — Шесси)

сезонные маршруты