Постоянно защищенный шаблон
Из Википедии, бесплатной энциклопедии
Перейти к навигации Перейти к поиску
Документация по шаблону [ просмотреть ] [ изменить ] [ история ] [ очистить ]

Этот шаблон на основе Lua заменяет старые шаблоны на основе функций синтаксического анализатора {{ BS-map }} (и устаревшие {{ Заголовок железнодорожной линии }}, {{ BS-header }} и {{ BS-table }}) шаблоны для Википедии : Шаблоны диаграмм маршрутов, потому что диаграммы, созданные {{Routemap}}, загружаются быстрее.

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

{{Карта маршрута| navbar = | navbar pos = | navbar mini = | название = | цвет заголовка = | название bg = | bg = | встроенный = | складной = | свернуть = | легенда = | легенда alt = | float = | style = | верх = | сноска = | ширина текста = | карта =}}

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

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

{{Routemap Добавьте другие параметры, как |title=здесь.| карта =Разметка карты идет сюда! }}

Базовый

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

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

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

или же

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

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

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

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

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

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

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

Рядов

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

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

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

Складной

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

Разборная замена

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

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

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

левое-левое замечание ~~ левое замечание ~~ левый основной текст ~~ левое расстояние / время ! ! значок ID ~~ правое расстояние / время ~~ правый основной текст ~~ правое замечание ~~ правое-правое замечание

или же

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

Складная боковая панель с двойным текстом

  • |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 превысила предел размера шаблона на странице включения, что означает, что шаблон не расширяется до предполагаемого внешнего вида, а отображается только ссылка на страницу шаблона, поэтому существует неизбежная необходимость в переводе map в дизайн 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 ++ , но в идеале правилом поиска для шаблонов строк BS должно быть регулярное выражение , например \{\{(BS\d*(\-2)?)\|{{subst:$1/safesubst|, чтобы избегайте шаблонов с похожими именами, таких как BSto и BSsplit, если они присутствуют на карте.

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

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

Функция convertbs

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

{{#invoke: Routemap | convertbs | <nowiki></nowiki>}}

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

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

{{subst: convertbs | 1 =}}

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

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

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

Данные шаблона

Это документация TemplateData для этого шаблона, используемого VisualEditor и другими инструментами; см. ежемесячный отчет об использовании параметров для этого шаблона.

TemplateData для Routemap

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