Шаблон:SM pic

|style="background-color:{{{1}}};"|[[File:SMicon {{{2}}}.svg|link=]]

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

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

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

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

У каждого графического файла имеется фигурная «дырка» прозрачного цвета (transparent), через которую может просвечивать цвет фона данной ячейки, изображая фигурку (кружок, линию и т. п.) нужного цвета; непрозрачная часть файла имеет белый цвет (в более редких случаях серый или голубой), который визуально соответствует цвету фона всей остальной схемы (в тех ячейках, где нет графических файлов). Это позволяет давать фигуркам произвольный цвет, в отличие от стандартных файлов, применямых для железнодорожных схем, где цвет является частью самого файла и существуют файлы для ограниченного количества цветов.

Имена графических файлов

Имена графических файлов имеют вид SMicon X color.svg, где:

X обозначает форму прозрачной дырки и может иметь значения:
- O — кружок (обычная станция),
- OO — кружок с непрозрачной дыркой в середине прозрачной дырки (станция, позволяющая экспресс-поезду проследовать её без остановки),
- OQ — квадратик с чёрным контуром (обозначение цвета в легенде),
- NS, WE, NE, SE, SW, NW — участок линии (первые два прямые, остальные изогнутые),
- X — перекрёсток двух участков,
- 3-N, 3-E, 3-S, 3-W — Т-образный перекрёсток (можно использовать для обозначения тупиков),
- N-X, E-X, S-X, W-X — развилка на 3 направления,
- E-NS, E-WN, E-WS, N-SE, N-SW, N-WE, S-NE, S-NW, S-WE, W-EN, W-ES, W-NS — развилка на 2 направления,
- T-NS, T-WE, T-NE, T-SE, T-SW, T-NW — переход между двумя станциями;

color задаёт цвет для непрозрачной части файла и:
- либо отсутствует вместе с предшествующим пробелом (что обозначает белый цвет, используемый по умолчанию),
- либо представляет собой HTML-название цвета и на данный момент существует только для названий lightgrey (что может использоваться для перспективных либо исторических участков схемы) и lightblue (что может использоваться для участков схемы, проходящих над или под водой).

Шаблоны, их параметры и последовательность использования

Три шаблона служат для оформления всей схемы:

{{SM before}} — ставится в самом начале схемы и создаёт таблицу, а также придаёт ей стандартное «сворачиваемое» оформление, принятое для навигационных шаблонов (которое можно отменить при помощи параметра class=plain). Первый параметр задаёт заголовок схемы, видимый в её свёрнутом режиме. Следующие три параметра представляют собой фрагменты CSS-кода, подставляемые в разные части шаблона (шаблон содержит начало вложенных последовательно div’ов с классами NavFrame и NavContent и таблицы; эти параметры добавляют CSS к ним всем по порядку);
{{SM head}} — ставится сразу после {{SM before}} до первой строки таблицы и размечает столбцы нужной ширины. Единственный параметр задаёт количество столбцов. Максимальное значение параметра 10, значение по умолчанию также 10. Если нужно более 10 столбцов, шаблон ставится несколько раз подряд таким образом, чтобы в сумме получилось нужное количество столбцов (например, для 35 столбцов он ставится 3 раза без параметров и один раз с параметром 5);
{{SM after}} — ставится в самом конце схемы и закрывает таблицу и всё остальное, что открыто шаблоном {{SM before}}.

В середине таблицы используются:

обычные обозначения строк (|-), расставляемые без помощи шаблонов;
обычные обозначения ячеек (|), которые можно заполнять чем угодно, но так, чтобы не нарушалась общая структура со стороной ячейки 20 пикселей (например, какими-нибудь графическими файлами с указанным размером 20px или x20px);
шаблоны, перечисленные ниже, каждый из которых уже включает в себя обозначение ячейки (|) и какое-либо наполнение для неё.

Шаблоны для ячеек:

{{SM empty}} — серия из нескольких пустых ячеек подряд в строке. Единственный параметр задаёт количество ячеек, значение по умолчанию 1. В конце строки таблицы справа дополнять строку до нужного количества ячеек при помощи этого шаблона не обязательно;
{{SM text}} — текст, который выходит за пределы ячейки, не разрушая таблицу. Параметры:
- первый параметр — цвет текста (по умолчанию чёрный),
- второй параметр — сам текст,
- третий параметр (опциональный) — значение для CSS-тега text-align,
- четвёртый параметр (опциональный) — значение для CSS-тега width,
- link — ссылка, идущая с текста,
- td — возможность передать HTML-атрибуты в ячейку таблицы, например colspan=4,
- side — указание, в какую сторону от текущей ячейки должен простираться текст (поддерживаемые значения: left, right, top, bottom; в двух последних случаях строится вертикальный текст, идущий снизу вверх, то есть нижняя линия строки справа);
{{SM pic}} — произвольный графический файл из имеющегося набора. Параметры:
- первый параметр — цвет фона, который будет просвечивать через прозрачную дырку (поскольку значение этого параметра подставляется в style, то можно сюда передать дополнительный код, который тоже будет подставлен в style),
- второй параметр — переменная часть имени файла (включающая X и color),
- o — размеры эллипса, который надо дополнительно нарисовать, чтобы обвести несколько клеток, например чтобы обозначить пересадочный узел, в формате CSS (пример: width:40px;height:20px),
- n, w, c, e, s — название статьи о станции, которая будет изображена в виде белой точки внутри клетки соответственно сверху, слева, в середине, справа, снизу;
{{SM cross}} — перекрёсток, раскрашенный в два цвета линий. Параметры:
- первый параметр — цвет той из двух линий, которая проходит как бы «под» другой,
- второй параметр — H, V, NE, SE, SW, NW — направление второй линии (горизонтальное, вертикальное или по дуге),
- третий параметр — цвет второй из двух линий,
- четвёртый параметр (опциональный) — другая форма дырки вместо X,
- пятый параметр (опциональный) — третий цвет: в обычной ситуации цвета идут в порядке первый, второй, первый (что и создаёт эффект прохождения первого цвета «под» вторым), а если он задан, то первый, второй, третий,
- type — продолжение имени файла после буквы X (или того, что задано в четвёртом параметре) до точки (то есть только цвет непрозрачной части, по умолчанию белый),
- o, n, w, c, e, s — как в шаблоне {{SM pic}};
{{SM auto}} — оболочка для шаблона {{SM cross}}. Дополнительные параметры:
- dir1, dir2, dir3 — каждый из них в отдельности вычисляется как значение для направления линии (эти параметры используются только при переданном в параметр auto значении line);
- draw1, draw2, draw3, coef1, coef2, coef3 — аналогично, форма дырки и коэффициент использования для маршрута (только при переданном в параметр auto значении route);
- auto — если передано значение line или route, шаблон работает в автоматическом режиме, обращаясь к шаблону {{SM cross}} или {{SM pic}} с наиболее подходящими направлением и цветами на основании дополнительных параметров; если же в параметр auto передано другое значение, то просто вызывается шаблон {{SM cross}} и все остальные параметры передаются в него;
- color — опциональный цвет для первой линии (в простейших случаях именно вторая красится вычисляемым серым или красным);
{{SM dot}} — кружок, обозначающий станцию. Параметры:
- до 5 неименованных параметров — цвета (если их более одного, то кружок станции раскрашивается в горизонтальные полоски),
- type — продолжение имени файла после буквы O до точки (по умолчанию пусто, то есть файл с простым кружком и белой непрозрачной частью),
- link — ссылка, идущая с кружка,
- title — текст всплывающей подсказки,
- cur — способ выделения станции на случай, если она должна быть выделена как «текущая» в контексте данной статьи: выделение производится добавлением цветного ободка при помощи одного из файлов: , первый из них используется по умолчанию, а остальные требуют передать в этом параметре слово Blue, Pink или Red,
- param1, param2, param3, param4 — текстовые значения, которые задаются при станции, чтобы она могла быть выделена как текущая (например, условные обозначения линий, к которым станция относится),
- param — текстовое значение, передаваемое из статьи в шаблон со схемой и далее сюда, здесь оно сопоставляется с параметрами param1, param2, param3, param4, заданными при станции, и если оно совпадает с одним из них, то станция выделяется как текущая;
{{SM dotv}} — как {{SM dot}}, но при наличии нескольких цветов полоски строятся не горизонтальные, а вертикальные;
{{SM dotx}} — как {{SM dot}}, но цветов ровно 4 и кружок делится на 4 четверти разных цветов;
{{SM smart}} — совмещение функциональности шаблонов, выводящих кружок станции и текст. Параметры:
- до 5 неименованных параметров — цвета,
- dir — пусто (по умолчанию), v или x — выбор одного из шаблонов {{SM dot}}, {{SM dotv}} или {{SM dotx}},
- type, cur, param, param1, param2, param3, param4 — то же, что у этих шаблонов,
- text — текст, который выводится и сам по себе как текст, и как всплывающая подсказка при кружке; если задать значение auto, то текст будет построен как значение, переданное в параметре link, но без уточнения; цвет текста берётся из первого параметра, если нет второго и последующих, в противном случае чёрный,
- label — отдельный параметр для текста, если надо, чтобы он отличался от всплывающей подсказки,
- link — ссылка для текста и кружка,
- side — то же, что у шаблона {{SM text}},
- X, Y — смещение текста относительно кружка по двум координатам.

Каждый вызов шаблона пишется с новой строки.

Остальные шаблоны в категории вызываются из других шаблонов (только для случая, когда схема строится в мелком масштабе и размер станции меньше, чем клетка), использовать их не нужно:

{{SM o}} — эллипс, охватывающий несколько клеток и изображающий пересадочный узел. В единственном параметре задается по синтаксису css высота и ширина.
{{SM s}} — белая точка диаметром 6 пикселей, расположенная в заданном месте в пределах клетки, изображающая станцию и снабжённая ссылкой на статью о ней. В первом параметре задаются координаты по синтаксису css, а во втором название статьи о станции.