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

Документация шаблона [ просмотр ] [ правка ] [ история ] [ очистка ]

Этот шаблон используется для построения шаблонов маршрутных диаграмм . Это основанный на Lua преемник шаблонов {{ BS-map }} , которые были заменены {{Routemap}} в английской Википедии, но все еще используются в других вики.

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

{{ Routemap | navbar =  | navbar pos =  | navbar mini =  | title =  | title color =  | title bg =  | bg =  | inline =  | collapsible =  | collapse =  | legend =  | legend alt =  | float =  | style =  | top =  | footnote =  | text-width =  | map = }}

Разметка для параметра карты

Разметка для составления диаграммы в |map=параметре отличается от шаблонов на основе {{ BSrow }} . Главные отличия — разделители в каждой строке. Подшаблоны не нужны, так как новая строка в таблице просто создается возвратом каретки (переходом на новую строку).

Базовый

идентификатор значка \ идентификатор значка \ идентификатор значка

• Значки разделяются обратной косой чертой \ .
• Каждая группа иконок центрирована в своей строке. Безымянная иконка (в начале строки 5 на схеме) может использоваться как разделитель.
• Идентификатор каждой иконки можно увидеть в ее подсказке . Наведите курсор на иконки, чтобы увидеть их.

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

идентификатор значка \ идентификатор значка \ идентификатор значка ~~ расстояние/время ~~ основной текст ~~ замечание ~~ правое замечание

или

идентификатор значка \ идентификатор значка \ идентификатор значка ~~ основной текст

• Третью и четвертую пары тильд можно опустить, если за ними нет содержимого.
• После последнего идентификатора значка, если имеется только один набор « тильда -тильда» ( ), в основной текстовой ячейке вместо dist./time~~ будет отображаться следующий текст .
• Для разделения текстовых ячеек необходимо наличие как минимум одного пустого пробела; в противном случае тильды будут рассматриваться как подпись .

Текстовые ячейки в строках значков

* текст \d* текст \cd* текст ~~ основной текст

Звездочке, указывающей на текстовую ячейку, может предшествовать один из префиксов ширины BSicons. (Обычные BSicons имеют квадратную форму.)

Наложение значка, ссылка на значок, цвет фона и диапазон столбцов

• Разделитель наложения «восклицательный знак-тильда» ( !~) должен следовать за идентификатором значка, на который будет наложено наложение.
• Наложение практически не ограничено, но следует учитывать читаемость.
• Ширина базовой иконки определяет ширину комбинации, даже если она меньше, чем наложение. Значки выравниваются левыми краями вместе, так что они не будут центрироваться друг на друге, если они различаются по ширине. Если наложение выходит за пределы базовой иконки, оно наложится на следующую иконку (но не на наложение следующей иконки).
• При использовании наложения значка и ссылки на значок для одной и той же ячейки значка разделитель ссылки на значок ( !@) должен следовать за последним (верхним) идентификатором наложенного значка.
• Параметр цвета фона ( bg=) требует 5 наборов предшествующих текстовых разделителей, чтобы его можно было распознать, даже если в этой строке вообще нет текста.

Другие варианты форматирования

Ряды

Помимо bg=, есть несколько других параметров, разделенных запятыми ( ,), которые можно использовать для настройки отображения строки. Только bg=можно использовать для изменения отображения значков; все остальные влияют только на текстовые ячейки.

Отдельные ячейки/значки

значок !_bg=фиолетовый\* текст __align=l!~* больше текста __align=r,b= да

• Параметры для одного значка или текстовой ячейки (например BHF, *Text) начинаются с двух подчеркиваний ( __).
• Параметры для содержимого ячейки таблицы (стопка наложенных друг на друга объектов или один значок или текстовое поле без наложений) предваряются восклицательным знаком и подчеркиванием ( !_). Это должно следовать за ссылкой (если таковая имеется).
• Для последнего наложенного элемента в стеке индивидуальные параметры элемента (если таковые имеются) должны предшествовать параметрам стека.
• Большинство параметров такие же, как и для строк, но есть несколько дополнительных. Кроме того, значения для align=, bg=и color=переопределят значения параметров строк.

Складной

• Отрегулируйте параметр |text-width=(или |tw=) до тех пор, пока разрыв не исчезнет.
  • По умолчанию единицей измерения является «px», но допустимы и другие единицы, например «em».
  • Проверьте карту в другом браузере и в мобильном режиме и увеличьте ширину текста, если он не отображается.
• Номер значка первого ряда складной секции должен быть равен или больше номера значка самого широкого нескладного ряда.
  • Как и в примере 3.2, используйте пустой значок половинной ширины. ( d) в качестве заполнителя, когда вы смешиваете как нечетные, так и четные строки на одной карте.
• Изменение « свернуто » на « ноль » изменит состояние сворачиваемого раздела по умолчанию на развернутое.

Складная замена

• Ширина как заменяющих, так и заменяемых строк должна соответствовать ширине самой широкой несворачиваемой строки на диаграмме.
• Если вы хотите скрыть замененную строку после развертывания сворачиваемого элемента, используйте значок ( leer) как пустой заполнитель, как в примере 4.2.
• В любом случае, не забудьте обеспечить достаточную ширину текста. Здесь использование text-width=120 нарушит выравнивание иконок.
• Сворачиваемые элементы намеренно отключены в мобильном представлении, поэтому замененная строка никогда не будет видна. Помните об этом при создании диаграммы.

Двойная текстовая боковая панель

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

левое-левое замечание ~~ левое замечание ~~ левое основное сообщение ~~ левое расстояние/время !! ! идентификатор значка ~~ правое расстояние/время ~~ правое основное сообщение ~~ правое замечание ~~ правое-правое замечание

или

левый основной текст !! идентификатор значка ~~ правый основной текст

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

Двойная текстовая боковая панель, сворачиваемая

• Подать заявку |text-width=на устранение разрыва:
  • Только 1 значение:right main text+right remark
  • 3 значения, разделенные запятыми:right dist./time,right main text+right remark,right-right remark
  • 6 значений:Left-left remark,left remark+left main text,left dist./time,right dist./time,right main text+right remark,right-right remark
  • Если количество значений не равно 1, 3 или 6, весь параметр будет проигнорирован.
• Если ширина текста примечания справа-справа меньше необходимой, определение его ширины можно опустить, как в примере 6.1.
• Если конкретная текстовая ячейка не используется нигде на карте, определение ширины можно опустить, как в примере 6.2.
• Определите общую ширину таблицы с помощью {{{style}}}параметра, если {{{text-width}}}он сам по себе не может предотвратить разрыв.
• Если пустая ячейка значка сворачиваемой строки сжимается, используйте пустой значок ( leer) для исправления столбцов значков.

Заполняющие ряды

Обзор синтаксиса

Переход от устаревшего шаблона строки BS к разметке Routemap

Политика конвертации

Многие участники проекта English Route Diagram Template во время внедрения Routemap имели противоречивые мнения относительно обоснованности замены всех карт устаревших шаблонов строк BS на Routemap на основе Lua. Противники считают, что разметка карты Routemap слишком эзотерична для редакторов, незнакомых с разметкой Routemap, чтобы ее изменять. В то время как сторонники поддерживают полное преобразование для повышения производительности. На данный момент консенсус не достигнут, поэтому любой переход без масштабного обновления внешнего вида карты для отражения сервисных и/или структурных изменений в реальности должен осуществляться только с учетом следующих соображений:

• Карта шаблона устаревшей конструкции строки BS превысила ограничение на размер шаблона на странице трансляции, что означает, что шаблон не разворачивается до своего предполагаемого вида, а отображается только ссылка на страницу шаблона, поэтому существует настоятельная необходимость перевести карту в конструкцию Routemap, чтобы уменьшить размер включаемых данных после развертывания.
• Если нет проблем с размером шаблона, уважайте предпочтения первоначального участника первой завершенной версии диаграммы. Если этот участник оспаривает изменение Routemap, сохраните дизайн шаблона строки BS.

Технические возможности

Все шаблоны строк BS имеют созданные заменяемые аналоги; поэтому преобразование можно легко выполнить subst:, добавив в начало и конец /safesubstкаждого имени шаблона строки BS в карте. Например, измените {{BS2|STR|BHF|0|1|2|3|O1=uSTRq}}карту на {{subst:BS2/safesubst|STR|BHF|0|1|2|3|O1=uSTRq}}, затем опубликуйте изменения; это создаст STR!~uSTRq\BHF~~0~~1~~2~~3. Процесс можно ускорить, используя функцию «заменить все» расширенного инструмента редактирования или отдельного текстового редактора, такого как Notepad или Notepad++ , но правило поиска для шаблонов строк BS в идеале должно быть регулярным выражением , например \{\{(BS\d*(\-2)?)\|→ {{subst:$1/safesubst|, чтобы избежать шаблонов с похожими именами, такими как BSto и BSsplit, если они присутствуют в карте.

"Режим редактирования столбцов" позволяет избежать проблем с поиском и заменой, чтобы safesubst:эффективно добавлять все строки. Эта функция распространена в продвинутых текстовых редакторах, таких как Geany , ^[1] Notepad++ ^[2] и Sublime Text ^[3] .

Вы также можете использовать функцию «convertbs» модуля Module:Routemap.

Функция convertbs

Скопируйте и вставьте следующий код в любую область редактирования этой вики, возможно, на страницу карты, над которой вы работаете:

{{ #invoke : Routemap | convertbs |< nowiki ></ новики >}}

Затем скопируйте и вставьте исходный код карты BS-map или BS-table между <nowiki>тегами (альтернативно вставьте заголовок invoke convertbs перед исходным кодом карты и </nowiki>}}окончание после кода карты) и покажите предварительный просмотр . Он сгенерирует версию safesubst и покажет исходные версии (для сравнения) кода карты. Вы копируете код safesubst из области предварительного просмотра обратно в область редактирования, и вам следует удалить все, #invoke:Routemap|convertbsесли предварительный просмотр нового кода работает правильно.

В английской Википедии шаблон {{ subst:convertbs }} можно использовать в качестве сокращения:

{{subst:конвертировать|1=}}

Если это не работает, возможно, вы не скопировали часть соответствующего кода, например, разметку таблиц для диаграмм BS-таблиц, или скопировали код, который на самом деле принадлежит чему-то другому.

Встраивание в инфобокс

• Используйте {{{inline}}} для удаления заголовка и границы таблицы. При создании отдельного шаблона, который будет встроен в инфобокс, заключите inline=1 в <includeonly>...</includeonly>теги. Также {{{navbar pos}}} помогает лучше расположить {{ Navbar }} .

Шаблон данных

Это TemplateData для этого шаблона, используемого TemplateWizard, VisualEditor и другими инструментами. См. ежемесячный отчет об использовании параметров для Template:Routemap в статьях, основанных на его TemplateData.

TemplateData для карты маршрутов

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

Вышеуказанная документация включена из Template:Routemap/doc . ( edit | history ) Редакторы могут экспериментировать на страницах sandbox ( edit | diff) и testcases ( edit ) этого шаблона . Добавьте категории на подстраницу /doc . Подстраницы этого шаблона .