Константин Крылов: Новая страница: «'''Summary''' — система шаблонов и стилей, предназначенных для оформления шаблонов-карточек.…»

2019-08-07T13:38:32Z

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

Новая страница

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

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

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

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

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

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

=== Заголовок ===

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

=== Разделы ===

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

=== Поля ===

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

* '''{{tl|summary/field/sem}}''' предназначен для создания полей со ссылкой или аннотацией. Имеет пять параметров (первые два обязательны):
*# Имя поля. Если опущен, значение ниже будет показано во всю ширину карточки.
*# Викитекст со значением или значениями поля (подробности ниже). Если пуст, ничего показано не будет.
*# Название свойства. Не обязательно
*# Альтернативный текст ссылки/аннотации. Использование больше не рекомендуется.
*# Текст, идущий после ссылки/аннотации. Использование больше не рекомендуется.
*: <tt>тип</tt> — <tt>страница</tt> (по умолчанию), <tt>строка</tt>, <tt>дата</tt>, <tt>место</tt>, <tt>число</tt> или <tt>координаты</tt>.

* '''{{tl|summary/page/sem}}''' предназначен для создания полей со ссылкой или аннотацией, когда свойство имеет тип ''[[Тип:Страница|Страница]]''. Имеет пять параметров (первые два обязательны):
*# Имя поля. Если опущен, значение ниже будет показано во всю ширину карточки.
*# Викитекст со значением или значениями поля (подробности ниже). Если пуст, ничего показано не будет.
*# Название свойства. Не обязательно
*# Альтернативный текст ссылки/аннотации. Использование больше не рекомендуется.
*# Текст, идущий после ссылки/аннотации. Использование больше не рекомендуется.
*# (или <tt>обратно</tt>) название обратного свойства. Названия страниц, для которых оно установлено равным названию страницы, куда вставлен шаблон, будут показаны первыми в списке значений поля.

* '''{{tl|summary/string/sem}}''' предназначен для создания полей со ссылкой или аннотацией, когда свойство имеет тип ''[[Тип:Строка|Строка]]''. Имеет пять параметров (первые два обязательны):
*# Имя поля. Если опущен, значение ниже будет показано во всю ширину карточки.
*# Викитекст со значением или значениями поля (подробности ниже). Если пуст, ничего показано не будет.
*# Название свойства. Не обязательно
*# Альтернативный текст ссылки/аннотации. Использование больше не рекомендуется.
*# Текст, идущий после ссылки/аннотации. Использование больше не рекомендуется.

* '''{{tl|summary/date/sem}}''' предназначен для создания полей дат со ссылкой или аннотацией. Имеет шесть параметров (первые два обязательны):
*# Имя поля. Если опущен, значение ниже будет показано во всю ширину карточки.
*# Викитекст со значением или значениями поля (подробности ниже). Если пуст, ничего показано не будет.
*# Второе слово названия свойства. Не обязательно
*# Текст, идущий после ссылки/аннотации. Использование больше не рекомендуется.
*# альтернативный день и месяц для показа Использование больше не рекомендуется.,
*# альтернативный год для показа. Использование больше не рекомендуется.

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

* '''{{tl|summary/coord/sem}}''' предназначен для создания полей [[Тип:Географические координаты|географических координат]] со ссылкой или аннотацией. Имеет три параметра:
*# название поля, по умолчанию, [[Географические координаты|Координаты]]»,
*# значение координат, лучше всего, в виде вызова шаблона {{tl|coord}},
*# название свойства, по умолчанию, «[[Свойство:Географические координаты|Географические координаты]]».

=== Строки ===

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

=== Изображения ===

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

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

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

== Переход ==

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

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

{| class="standard"
! summary !! Заглушка !! В Википедии
|-
| [[Шаблон:Таксон|Таксон]] || [[Шаблон:Taxobox|Taxobox]] || [[wikipedia:ru:Шаблон:Taxobox|Taxobox]]<br />[[wikipedia:en:Template:Taxobox|Taxobox]]
|-
| [[Шаблон:Вики-проект|Вики-проект]] || ||
|-
| [[Шаблон:Город РФ|Город РФ]] || || [[wikipedia:ru:Шаблон:Город России|Город России]]
|-
| || [[Шаблон:Химический элемент|Химический элемент]] || [[wikipedia:ru:Шаблон:Химический элемент|Химический элемент]]<br />[[wikipedia:en:Template:Elementbox|Elementbox]]
|-
| || [[Шаблон:Вещество|Вещество]] || [[wikipedia:ru:Шаблон:Вещество|Вещество]]<br />[[wikipedia:en:Template:Chembox|Chembox]]
|}

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

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

Шаблон:Summary - История изменений

Константин Крылов: Новая страница: «'''Summary''' — система шаблонов и стилей, предназначенных для оформления шаблонов-карточек.…»