Шаблон:Summary/Документация

На этой странице могут быть описаны вещи, находящиеся в разработке.

summary — проект единого шаблона, предназначенного для замены информационных шаблонов, применяющихся в настоящее время.

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

Преимущества	Недостатки
Простота создания новых шаблонов	Удержание функциональности шаблонов в определённых рамках
Вёрстка их выполнена без таблиц	Вероятность неверного отображения в старых/малораспространённых браузерах
Оформление вынесено в Common.css	Невозможность гибко изменять оформление в каждом конкретном случае
Единообразие в оформлении всех страниц проекта	Монотонность, скучность этого оформления

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

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

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

Заголовок

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

Разделы

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

Поля

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

Строки

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

Изображения

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

Переход

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

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