Шаблон:Summary — различия между версиями

Текущая версия на 13:38, 7 августа 2019

Summary — система шаблонов и стилей, предназначенных для оформления шаблонов-карточек.

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

Построение шаблона

Тело шаблона должно находиться внутри элемента div с параметром class, включающим p-summary:

 
<div class="p-summary">
  Тело шаблона
</div>

Заголовок

• {{summary/title}} предназначен для создания основного заголовка шаблона. Параметры:
  1. Текст заголовка (обязательный параметр)
  2. Название аннотации
  3. Цвет заголовка (в любом допустимом для CSS формате)
  4. Размер заголовка (в любом допустимом для CSS формате)
  5. Цвет фона (по умолчанию, прозрачный)
• {{summary/subtitle}} предназначен для создания текста, который нужно разместить после заголовка шаблона. Параметры:
  1. Текст (обязательный параметр)
  2. Название аннотации SMW
  3. Видимый текст (при использовании аннотации)
  4. Цвет текста (по умолчанию, серый)
• {{summary/icon}} предназначен для создания значка, который будет размещён в левом верхнем углу. Параметры:
  1. Название файла значка (обязательно)
  2. Ширина значка (в натуральную величину по умолчанию).

Разделы

• {{summary/section}} предназначен для создания заголовков разделов внутри шаблона. Параметр — заголовок.

Поля

• {{summary/field}} предназначен для создания самых простых полей. Имеет всего два параметра: 1 — имя поля; 2 — значение

• {{summary/field/sem}} предназначен для создания полей со ссылкой или аннотацией. Имеет пять параметров (первые два обязательны):
  1. Имя поля. Если опущен, значение ниже будет показано во всю ширину карточки.
  2. Викитекст со значением или значениями поля (подробности ниже). Если пуст, ничего показано не будет.
  3. Название свойства. Не обязательно
  4. Альтернативный текст ссылки/аннотации. Использование больше не рекомендуется.
  5. Текст, идущий после ссылки/аннотации. Использование больше не рекомендуется.

  тип — страница (по умолчанию), строка, дата, место, число или координаты.

• {{summary/page/sem}} предназначен для создания полей со ссылкой или аннотацией, когда свойство имеет тип Страница. Имеет пять параметров (первые два обязательны):
  1. Имя поля. Если опущен, значение ниже будет показано во всю ширину карточки.
  2. Викитекст со значением или значениями поля (подробности ниже). Если пуст, ничего показано не будет.
  3. Название свойства. Не обязательно
  4. Альтернативный текст ссылки/аннотации. Использование больше не рекомендуется.
  5. Текст, идущий после ссылки/аннотации. Использование больше не рекомендуется.
  6. (или обратно) название обратного свойства. Названия страниц, для которых оно установлено равным названию страницы, куда вставлен шаблон, будут показаны первыми в списке значений поля.

• {{summary/string/sem}} предназначен для создания полей со ссылкой или аннотацией, когда свойство имеет тип Строка. Имеет пять параметров (первые два обязательны):
  1. Имя поля. Если опущен, значение ниже будет показано во всю ширину карточки.
  2. Викитекст со значением или значениями поля (подробности ниже). Если пуст, ничего показано не будет.
  3. Название свойства. Не обязательно
  4. Альтернативный текст ссылки/аннотации. Использование больше не рекомендуется.
  5. Текст, идущий после ссылки/аннотации. Использование больше не рекомендуется.

• {{summary/date/sem}} предназначен для создания полей дат со ссылкой или аннотацией. Имеет шесть параметров (первые два обязательны):
  1. Имя поля. Если опущен, значение ниже будет показано во всю ширину карточки.
  2. Викитекст со значением или значениями поля (подробности ниже). Если пуст, ничего показано не будет.
  3. Второе слово названия свойства. Не обязательно
  4. Текст, идущий после ссылки/аннотации. Использование больше не рекомендуется.
  5. альтернативный день и месяц для показа Использование больше не рекомендуется.,
  6. альтернативный год для показа. Использование больше не рекомендуется.

• В вышеприведённых шаблонах, второй параметр (значение) — строка с викитекстом, содержащим значения свойства SMW:
  • если строка не содержит викиссылок (таких, как [[значение]]), то она будет, по возможности, целиком интерпретирована, как значение свойства SMW,
  • если строка включает викиссылки, то каждая из них превратится в аннотацию Semantic MediaWiki, за исключением экранированных двоеточием (например, [[:no semantics please]]).

• {{summary/coord/sem}} предназначен для создания полей географических координат со ссылкой или аннотацией. Имеет три параметра:
  1. название поля, по умолчанию, Координаты»,
  2. значение координат, лучше всего, в виде вызова шаблона {{coord}},
  3. название свойства, по умолчанию, «Географические координаты».

Строки

• {{summary/line}} предназначен для размещения какого-либо текста в шаблоне. Параметр один — текст. Использование более не рекомендуется, лучше вызвать одну из разновидностей {{summary/field/sem}} без первого параметра.
• {{summary/line/url}} предназначен для вставки в шаблон отдельно идущей внешней ссылки. Параметры:
  1. URL (обязательный параметр)
  2. Текст ссылки

Изображения

• {{summary/image}} предназначен для вставки изображения в шаблон. Параметры (обязателен только первый):
  1. Название изображения без префикса, соответствующего пространству имён изображений.
  2. Описание изображения.
  3. Тип вывода изображения (thumb, none, framed и т. д.). По умолчанию — none.
  4. Ширина изображения. По умолчанию — 250пкс.
  5. Расположение изображения. По умолчанию — центр.

Дополнительно

• {{summary/cells}} предназначен для вывода информации внешне аналогично тому, как это делается в полях. Параметра два — содержимое левой части и содержимое правой части.

Переход

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

Старые шаблоны, позаимствованные из Русской Википедии, следует переделать в «оболочки» для новых шаблонов. Это нужно для того, чтобы в переносимых из Русской Википедии статьях нормально отображались их шаблоны.

Шаблоны Summary рекомендуется вызывать в шаблоне-карточке не прямо, а посредством вызова шаблона {{Карточка}}.

Система Summary описана как программный продукт в соответствующей статье.