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

Материал из Википедии — свободной энциклопедии
(перенаправлено с «Шаблон:Routemap»)
Перейти к: навигация, поиск
[просмотр] [править] [история] [обновить]
(i) Документация
Другое название этого шаблона — {{Routemap}}.

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

Шаблон предназначен для отображения транспортных систем в виде диаграммы: железнодорожных линий, водных путей, автодорог и др.

Параметры шаблона
Параметр Описание Тип По умолчанию Авто-значение Статус
Заголовок таблицы заголовокtitle Заголовок таблицы. Значения «нет», «no» или «0» скроют шапку таблицы (при этом теряется возможность сворачивания) string пусто пусто необязательный
Цвет заголовка цвет заголовкаtitle color Цвет заголовка таблицы string #FFFFFF пусто необязательный
Цвет фона заголовка цвет фона заголовкаtitle bg color Цвет фона заголовка string #27404E пусто необязательный
Возможность свернуть таблицу сворачиваемыйcollapsible По умолчанию таблица сворачиваема, значения «no» или «0» уберут такую возможность string пусто пусто необязательный
Состояние свёрнутости таблицы collapse Допустимые значения: «collapsed», «autocollapse» и «[пусто]» (= «expanded») string пусто пусто необязательный
Ссылки на шаблон navbartnavbar Непустое значение параметра поместит ссылки на шаблон в левом верхнем углу; используйте {{subst:PAGENAME}} string пусто пусто необязательный
Расположение ссылок на шаблон navbar pos Значение «1» переместит ссылки под шапку таблицы, «2» — в низ таблицы string пусто пусто необязательный
Ссылка на легенду легендаlegend Имя страницы, содержащей легенду маршрута. Значения «нет», «no» или «0» скроют ссылку на легенду wiki-page-name Шаблон:Маршрутная карта/Условные обозначения пусто необязательный
Обтекание таблицы обтеканиеfloat Положение и обтекание внешней таблицы: «left», «right» или «none» string right пусто необязательный
Цвет фона цвет фонаbg Цвет фона всей таблицы string #F9F9F9 пусто необязательный
CSS-стиль таблицы стильstyle Дополнения к CSS-стилю внешней таблицы string пусто пусто необязательный
Подзаголовок или пояснение вверхуon top Пояснение вверху таблицы string пусто пусто необязательный
Пояснение, примечание внизуfootnote Пояснение внизу таблицы string пусто пусто необязательный
Ширина колонок с текстом ширина текстаtext-width Ширина колонок с текстом через запятую (рекомендовано при использовании сворачиваемых блоков) string пусто пусто необязательный
Карта маршрута 1map Карта маршрута в определённом ниже формате string пусто пусто обязательный

Замена множеству маршрутных шаблонов в виде единственного шаблона, поддерживает все их функции. Имеет всего один обязательный параметр — собственно карту пути.

Для копирования:

{{Маршрутная карта|заголовок= |цвет заголовка= |цвет фона заголовка= |collapse= |tnavbar={{subst:PAGENAME}}|ширина текста=,,|1=
<!-- набросайте на этом месте вашу карту -->
|внизу=
}}

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

Маршруты Eurostar
0:00 Лондон (Сент-Панкрас) (c 2007 г.)
Лондон (Ватерлоо) (до 2007 г.)
0:14 Эббсфлит
0:29 Эшфорд
0:31
Евротоннель
Великобритания
Франция
0:51
0:55 Кале (Кале-Фретен)
1:22 Лилль (Лилль-Европа)
Франция
Бельгия
2:01 Брюссель (Южный вокзал)
2:16 Париж (Северный вокзал)
2:40 Диснейленд (Марн-ла-Вале — Шесси)
сезонные маршруты
4:34 Лион (Пар-Дьё)
5:36 Авиньон (Центральный вокзал)
5:52 Авиньон — TGV
6:17 Экс-ан-Прованс — TGV
7:12 Мутье — Сален — Брид-ле-Бен
7:30 Эме — Ла Плань
7:51 Бур-Сен-Морис
Приведённые интервалы — кратчайшее время
движения по расписанию от Сент-Панкрас.
{{Маршрутная карта|заголовок=Маршруты Eurostar|ширина текста=25,110,90|1=
KBHFa~~0:00~~'''[[Лондон]] ([[Сент-Панкрас (вокзал)|Сент-Панкрас]])'''~~(c 2007 г.)
exKBHFa\STR\~~ ~~ ~~Лондон ([[Ватерлоо (вокзал)|Ватерлоо]]) (до 2007 г.)
exSTR\HST\~~0:14~~Эббсфлит
exKRWl\eKRWg+r\
HST~~0:29~~Эшфорд
TUNNELa~~''0:31''~~
tSTR!~lZOLL~~ ~~[[Евротоннель]]~~ ~~{{BSsplit{{!}}Великобритания|Франция|line=yes}}~~bg=#558cd3
TUNNELe~~''0:51''~~
HST~~0:55~~[[Кале]] (Кале-Фретен)
BHF~~1:22~~[[Лилль]] ([[Лилль-Европа]])
\KRWgl\KRW+r
\STR\STR!~lZOLL~~ ~~ ~~ ~~{{BSsplit{{!}}Франция|Бельгия|line=yes}}
KRW+l\KRWgr\KBHFe~~2:01~~'''[[Брюссель]] (Южный вокзал)'''
KBHFe\KRWgl\KRW+r~~2:16~~'''[[Париж]] ([[Северный вокзал (Париж)|Северный вокзал]])'''
\STR\KBHFe~~2:40~~[[Диснейленд (Париж)|Диснейленд]] (Марн-ла-Вале — Шесси)
-startCollapsible--replace
\CONTf\~~ ~~ ~~''сезонные маршруты''
KRW+l\KRWgr\
HST\KRWgl\KRW+r~~4:34~~[[Лион]] (Пар-Дьё)
STR\STR\KHSTe~~5:36~~ [[Авиньон]] (Центральный вокзал)
HST\STR\~~5:52~~Авиньон — [[TGV]]
KHSTe\STR\~~6:17~~[[Экс-ан-Прованс]] — TGV
HST~~7:12~~Мутье — Сален — Брид-ле-Бен
HSTd~~7:30~~Эме — Ла Плань
KHSTe~~7:51~~[[Бур-Сен-Морис]]
-endCollapsible-
|внизу=Приведённые интервалы — кратчайшее время<br/>движения по расписанию от Сент-Панкрас.
}}

Формат строк

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

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

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

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

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

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

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

Задание иконок

Выравнивание иконок
STR\\STR
STR\STR\STR
STR
STR\STR
HSTq
dHSTq\dHSTq
dSTR\dSTR
vSTR
STR\d
uSTRq\dSTR\fvSTR
uSTRq!~dSTR\fvSTR
dSTR!~uSTRq\fvSTR
uSTRq!~BHF!@Тестовская

Список кодов иконок приведён в каталоге пиктограмм. Более охватывающая версия есть на английской Википедии, полная категория — на Викискладе.

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

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

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

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

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

Казанское направление
на Москву
20,7
20,7 Люберцы I
Панки 22,8
23,7 Люберцы II
Томилино 25,4
на Кореневский завод
р. Пехорка
р. Пехорка
Красково 27,3
27,7 Коренёво
Малаховка 28,9
Удельная 31,5
Балластный Карьер
на Октябрьский
30,0 Овражки
Быково 33,4
на Гжель
на Раменское
{{Маршрутная карта|заголовок=Казанское направление|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\
}}

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

свойства~~пояснение 2~~поянение 1~~основная информация~~километраж! !иконки~~километраж~~основная информация~~пояснение 1~~пояснение 2~~свойства

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


Маршрутную карту можно расположить по левой стороне страницы, если основное основное направление текста — справа налево, или например, для размещения небольшой диаграммы слева при наличии основной диаграммы справа. Для этого шаблону необходимо передать параметр обтекание = left. При использовании в таком случае текста только слева иконок (перед символами ! !), результат будет абсолютно симметричен стандартному виду диаграммы.

Свойства строки

Пример изменения свойств
на Дмитров
на Александров I
Яхрома
Икша
на Поварово
на Москву
Совмещенный участок БКМЖД
и Савеловского направления

Свойства переопределяют то, как будет выведена строка. Каждое свойство имеет вид имя=значение, одно от другого отделяется символами !@. Для стандартной строки свойства указываются после примечания по правому краю, за пятым разделитем ~~. Если текст задается только слева от иконок, то свойства можно указать аналогичным образом перед наиболее левым примечанием слева, т. е. за четыре разделителя ~~ перед ! !. При указании свойств и слева, и справа, учитываться будут только правые.

На данный момент поддерживаются следующие свойства строки:

  • bg — задает цвет фона области иконок (но не текстовых полей). Предполагается, что внизу диаграммы (с помощью параметра внизу) будет дано описание выделенного таким образом участка. В качестве значения допускаются стандартные цвета HTML или RGB-коды с символом #, напр. silver или #С0С0С0. Фон меняется для соответствующей ячейки общей таблицы, по ширине равной максимальному для всей диаграммы числу иконок в строке; т. е. если в каком-то месте диаграммы присутствуют пять иконок в ряд, а фон поменять для строки с одной иконкой, область с измененным цветом в ширину будет равна пяти иконкам. Необходимо учитывать, что некоторые иконки имеют участки с непрозрачным фоном (#F9F9F9), которые могут стать заметными при изменении фона строки или таблицы.


Ключевые слова

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

Сворачивающиеся блоки

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

Открывающее блок ключевое слово поддерживает три необязательных параметра.

  1. Изначальное состояние свёрнутости блока: collapsed (свёрнут, значение по умолчанию) или expanded (развёрнут).
  2. Использование замещения. При указании любого непустого значения (рекомендуется replace) вторая после startCollapsible строка будет использована для замещения первой строки в развёрнутом состоянии блока. (Фактически, вторая строка будет расположена поверх первой, перекрывая её).
  3. Свойства блока. Формат такой же, как и для обычных строк. Поддерживается bg — цвет фона всех строк блока, включая первую и строку замещения. Текстовые поля также будут отображены с данным фоном.

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

Триггер [развернуть] / [свернуть] по умолчанию добавляется в крайне правую ячейку строки таблицы вместо второго примечания. Само примечание при этом будет расположено в том же поле, что и основной текст с первым примечанием, и может перекрыть их сверху. Для корректировки этого используйте параметр ширина текста (см. ниже). Для варианта использования маршрутной карты, при котором весь текст указывается только слева иконок, триггер целесообразно переместить в крайне левую ячейку строки, также вместо второго (левого) примечания. Для этого необходимо задать ширина текста = ,,,,,, либо другие необходимые значения, но с пустыми последними тремя полями. При этом текст триггера будет изменён на [показать] / [скрыть] (поскольку используется другой класс сворачивающиxся блоков).

Поскольку сворачивающийся блок фактически представляет собой отдельную таблицу с независимым выравниванием столбцов, помещенную в объединённую ячейку основной диаграммы, для совпадения выравнивания иконок и текста зачастую необходимо пользоваться следующими правилами.

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

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

Схема станции

Верхний уровень

Пригородные
поезда

Нижний уровень
−6 m
−20 ft
Скоростной
транспорт

Чтобы вывести некоторый текст во всю ширину таблицы, применяется ключевое слово colspan. Следующие за ним строки будут обработаны как обычный викитекст и помещены в одну объединённую ячейку. Действие данного ключевого слова прекращается после указания на очередной строке -colspan-end. К открывающему ключевому слову может быть добавлен необязательный параметр — число строк к объединению (не включая само открывающие слово colspan). Указания -colspan-end в таком случае не требуется, но если оно встретится раньше, чем заданно строк, обработка ключевого слова закончится.

Вторым необязательным параметром является список свойств в стандартном формате, которые будут применены к объединённой ячейке. Для colspan поддерживаются:

  • bg — фон ячейки. Займет практически всю ширину таблицы, за исключением внутренних отступов (padding);
  • align — выравнивание текста, напр. left, right или center;
  • style — дополнения к CSS-стилю ячейки, напр. padding:5px 0px;.

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

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

-filler--#003399\\#FF6600
-filler--u\-\orange
-filler-40px-\ex\ex_orange~~текст
Пустой участок 5 км

Вместо блока иконок строится таблица, имитирующая ряд иконок STR ( ) нужных цветов, но с возможностью выставить произвольную высоту (аналогично шаблону {{BS!}}). Может применяться для разделения двух строк карты, если высота обычных иконок (20px) излишня. Ключевое слово — filler, первый параметр — высота строки, при его отсутствии используется 5px. Второй параметр аналогичен обычной строке с тем же набором разделителей и параметров. Вместо названий иконок указываются RGB-коды очередной линии или же название набора иконок на Викискладе (см. {{BS-color}} и категорию). Например, вместо   (uexSTR) указать uex, вместо   (STR orange) — orange, вместо   (exSTR orange) — ex_orange; для стандартного набора (  (STR)) указать bahn или -. Каждая ячейка занимает 20px в ширину; отсутствие кода или названия (\\) оставляет ячейку пустой.

Категоризация

При ошибках в заполнении модуль шаблона помещает статьи в категорию Википедия:Статьи с неверно заполненными маршрутными картами.

См. также

Во избежание поломок страниц, использующих данный шаблон, желательно экспериментировать в своём личном пространстве.