APRELKUN: Новая страница: «{{docpage}}{{template navigation}}{{СИШ}} :На этой странице могут быть описаны вещи, находящиеся в разработке. '''Summary''' — проект единого шаблона, предназначенного для замены информационных шаблонов, применяющихся в настоящее время. Суть...»

2024-06-12T15:29:59Z

Новая страница: «{{docpage}}<includeonly>{{template navigation}}</includeonly>{{СИШ}} :<i style="font-size:small;">На этой странице могут быть описаны вещи, находящиеся в разработке.</i> '''Summary''' — проект единого шаблона, предназначенного для замены информационных шаблонов, применяющихся в настоящее время. Суть...»

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

{{docpage}}<includeonly>{{template navigation}}</includeonly>{{СИШ}}
:<i style="font-size:small;">На этой странице могут быть описаны вещи, находящиеся в разработке.</i>
'''Summary''' — проект единого шаблона, предназначенного для замены информационных шаблонов, применяющихся в настоящее время.

Суть проекта состоит в обеспечении редакторов вспомогательными шаблонами, предназначенными для быстрого построения специализированных шаблонов — таких, как шаблоны для городов, животных и т. п.
{| width="40%" cellspacing="0" cellpadding="3" border="1" bgcolor="LightYellow" bordercolor="navy" style="float:right; margin-left:.5em; font-size:85%; line-height:1.4em;"
|-
!width="50%" bgcolor="Honeydew"|<font color="green">[[Файл:Pictogram voting support.svg.png|16px|text-top|link=|alt=(+)]] Преимущества</font>
!width="50%" bgcolor="LavenderBlush"|<font color="darkred">[[Файл:Pictogram voting oppose.svg.png|16px|text-top|link=|alt=(-)]] Недостатки</font>
|-
|valign="top"|<b>Простота создания новых шаблонов</b>
|valign="top"|<b>Удержание функциональности шаблонов в определённых рамках</b>
|-
|valign="top"|<b>Вёрстка их выполнена без таблиц</b>
|valign="top"|<b>Вероятность неверного отображения в старых/малораспространённых браузерах</b>
|-
|valign="top"|<b>Оформление вынесено в [[MediaWiki:Common.css|Common.css]]</b>
|valign="top"|<b>Невозможность гибко изменять оформление в каждом конкретном случае</b>
|-
|valign="top"|<b>Единообразие в оформлении всех страниц проекта</b>
|valign="top"|<b>Монотонность, скучность этого оформления</b>
|}

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

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

Вместо тегов <tt><div></tt> можно вставить откравающую и закрывающую секцию:
* '''{{tl|summary/header}}''' — заголовок с параметром '''style''', принимающим в качестве значения [[w-ru:CSS|CSS]] стили (в. т. ч. цвет фона и рамки), и параметром '''микроформат''', добавляющим корневой класс [[Справка:Микроформаты|микроформата]]
* '''{{tl|summary/footer}}''' — шаблон , завершающий карточку {{tl|summary}}.

Ширина карточки неизменяемая и равна 320px.

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

* '''{{tl|summary/title}}''' предназначен для создания основного заголовка шаблона. Параметры:
*# Текст заголовка (обязательный параметр). Если не указан, выводится название страницы.
*# Название аннотации {{comment|SMW|Semantic MediaWiki}}. Параметр из Традиции, в Циклопедии не используется.
*# Цвет заголовка (в любом допустимом для [[w-ru:CSS|CSS]] формате)
*# Размер заголовка (в любом допустимом для [[w-ru:CSS|CSS]] формате)
*# Цвет фона ([[w-ru:CSS|CSS]])
** '''микроформат''' — имя свойства микроформата, добавляемое через {{tl|Микроформат}}.
** '''значение микроформата''' — альтернативное не отображаемое значение вместо текста заголовка

* '''{{tl|summary/subtitle}}''' предназначен для создания текста, который нужно разместить после заголовка шаблона. Параметры:
*# Текст (обязательный параметр)
*# Название аннотации {{comment|SMW|Semantic MediaWiki}}. Параметр из Традиции, в Циклопедии не используется.
*# Видимый текст (при использовании аннотации). Параметр из Традиции, в Циклопедии не используется.
*# Цвет текста (по умолчанию серый)
** '''микроформат''' — имя свойства микроформата, добавляемое через {{tl|Микроформат}}.
** '''значение микроформата''' — альтернативное не отображаемое значение вместо текста заголовка

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

* '''{{tl|summary/section}}''' предназначен для создания разделов внутри шаблона. Первый параметр — заголовок раздела (секции). Второй параметр — тело раздела — последовательность {{tl|Summary/field}} внутри секции. Если второй параметр не задан, шаблон не делает ничего. '''Микроформат''' — добавление микроформата ко всей секции.

=== Строки ===
* '''{{tl|summary/line}}''' предназначен для размещения какого-либо текста в шаблоне. Параметры:
# — текст
# — цвет фона CSS
# — цвет текста CSS
* '''класс''' — CSS-класс
** '''микроформат''' — имя свойства микроформата.
** '''значение микроформата''' — альтернативное не отображаемое значение микроформата вместо значения из 1.

* '''{{tl|summary/cells}}''' — создаёт строку, разделённую на два столбца. Если указано только одно значение, растягивается на всю ширину, подобно {{tl|summary/line}}. Параметры:
*# значение левого поля
*# значение правого поля

* '''{{tl|summary/duo}}''' — создаёт двойное поле с одинарным или двойным заголовком. Параметры:
*# значение левого поля
*# значение правого поля
*# дополнительный текст правого поля
*# заголовок общий или левого поля (если указан заголовок правого)
*# заголовок правого поля
*# цвет фона заголовка в формате CSS. По умолчанию прозрачный.
*# цвет текста заголовка в формате CSS. По умолчанию чёрный.

=== Поля ===
* '''{{tl|summary/field}}''' предназначен для создания самых простых полей. Имеет всего два параметра:
*# — имя поля
*# — значение
** '''микроформат''' — имя свойства микроформата.
** '''значение микроформата''' — альтернативное не отображаемое значение микроформата вместо значения из 2.

* '''{{tl|summary/fields20}}''' — блок полей, до 20 штук. Нечётные параметры — имя поля; чётные — значение.
** '''микроформат''' — имя свойства микроформата для всего блока.
** '''значение микроформата''' — альтернативное не отображаемое значение для '''микроформат'''.
** '''микроформат1''' ... '''микроформат20''' — имена свойств микроформата для каждого отдельного значения (1 для 2 значения, 2 для 4-го ... 20-й — для 40-го).

=== Изображения ===
* '''{{tl|summary/image}}''' предназначен для вставки изображения в шаблон. Параметры (обязателен только первый):
*# Изображение в допустимых форматах. Возможные варианты:
*#* Название изображения без префикса, соответствующего пространству имён изображений. Например <code>Имя_изображения.jpg</code>.
*#* Вставка изображения в формате викиразметки <code><nowiki>[[Файл:Имя_изображения.jpg|thumb|center|310px|Описание]]</nowiki></code>.
*# Описание изображения.
*# Тип вывода изображения (thumb, none, framed и т. д.). По умолчанию — none.
*# Ширина изображения в пикселях. По умолчанию — 310пкс. Приставка «px»/«пкс» необязательна, если не указана, добавляется автоматически.
*# Расположение изображения. По умолчанию — центр.
{{note-inline}}На данный момент ширину картинки рекомендуется делать на 10 пикселей меньше, чем общая ширина шаблона. Это обусловлено дополнительными внутренними отступами изображения (3px отступ + 1px рамка + 1px рамка изображения).

=== Дополнительные секции ===

==== Герб и флаг ====
* '''{{tl|summary/gerbflag}}''' дополнительный шаблон, предназначенный для шаблонов государств и регионов. Вставляет изображения герба и флага. Параметры:
*# Имя файла герба (без пространства имён <code>Файл:</code>)
*# Имя файла флага (без пространства имён <code>Файл:</code>)
*# Название страны или региона в родительном падеже (кого ? чего ?).

==== Дата ====
* '''{{tl|summary/date}}''' — секция подобная {{tl|summary/field}}, предназначенная для форматированного отображения даты. Первый аргумент шаблона — заголовок поля. Второй — дата отображаемая в поле. Дата задается в форме <code>DD.MM.YYYY</code> и переводится в формат «32 мартобря 3000 года» автоматически. Также поддерживаются аргументы «категория», «ссылка» и «микроформат» аналогичные таковым у шаблона {{tl|дата}}. Пример использования шаблона:

<code><nowiki>{{summary/date|заголовок поля|DD.MM.YYYY}}</nowiki></code>

=== Пример ===
{| width="100%" cellpadding="5" cellspacing="0" border="1"
|-
!bgcolor="#eef"|Код
!bgcolor="#eef"|Как выглядит
|-
|valign="top" bgcolor="#fff"|<pre
style="
margin:.5em;
border:0;
background-color:transparent;
">{{summary/header|style=
background-color:whitesmoke;
}}
{{summary/title|Заголовок}}
{{summary/subtitle|Текст}}
{{summary/image|No image available1.png|Описание}}
{{summary/section|Заголовок секции 1|
{{summary/field|Поле 1|Значение 1}}
{{summary/field|Поле 2|Значение 2}}
{{summary/field|Поле 3|Значение 3}}
}}
{{summary/section|Заголовок секции 2|
{{summary/line|текст}}
}}
{{summary/gerbflag|No Picture.png|Flag of None.svg|региона}}
{{summary/date|Дата|01.01.2000}}
{{summary/cells|Текст 1|Текст 2}}
{{summary/duo|Текст 1|Текст 2||Заголовок 1|Заголовок 2|black|white}}
{{summary/footer}}
</pre>
|valign="top"|{{summary/header|style=
background-color:whitesmoke;
}}
{{summary/title|Заголовок}}
{{summary/subtitle|Текст}}
{{summary/image|No image available1.png|Описание}}
{{summary/section|Заголовок секции 1|
{{summary/field|Поле 1|Значение 1}}
{{summary/field|Поле 2|Значение 2}}
{{summary/field|Поле 3|Значение 3}}
}}
{{summary/section|Заголовок секции 2|
{{summary/line|текст}}
}}
{{summary/gerbflag|No Picture.png|Flag of None.svg|региона}}
{{summary/date|Дата|01.01.2000}}
{{summary/cells|Текст 1|Текст 2}}
{{summary/duo|Текст 1|Текст 2||Заголовок 1|Заголовок 2|black|white}}
{{summary/footer}}
|}

== Summarybox ==
Боковой блок в стиле Summary, размещаемый справа на странице. Этот вариант похож на упрощённую карточку Summary, выполняет роль контейнера для различных элементов (картинок, видео, таблиц и др.). Единственное отличие — вместо класса ''p-summary'' используется класс ''summarybox'':

<pre><div class="summarybox">
Тело шаблона
</div></pre>

В тело данного шаблона можно добавлять только секции {{tl|summary/title}} и {{tl|summary/line}}, а также картинки и вложенные списки. Ширину шаблона можно изменять через стили.

=== Пример ===
{| width="100%" cellpadding="5" cellspacing="0" border="1"
|-
!bgcolor="#eef"|Код
!bgcolor="#eef"|Как выглядит
|-
|valign="top" bgcolor="#fff"|<pre
style="
margin:.5em;
border:0;
background-color:transparent;
"><div class="summarybox" style="width:100px;">
{{summary/title|Заголовок}}
{{summary/line|[[Файл:No Picture.png|thumb|right|90px|Картинка]]}}
{{summary/line|текстовая строка}}
</div></pre>
|valign="top"|<div class="summarybox" style="width:100px;">
{{summary/title|Заголовок}}
{{summary/line|[[Файл:No Picture.png|thumb|right|90px|Картинка]]}}
{{summary/line|текстовая строка}}
</div>
|}

== Навигационный шаблон ==
Навигационный шаблон в стиле Summary, предназначенный для размещения внизу страниц. Данный шаблон использует те же подшаблоны-секции, что и карточка Summary. Они должны быть вложены внутрь элемента <tt><div></tt> с классом ''summarylist'':

<pre><div class="summarylist">
Навигационный шаблон Summary
</div></pre>

Для создания навигационного шаблона также можно использовать открывающую секцию '''{{tl|summary/navbox}}''' (вместо {{tl|summary/header}}). Параметры как и у {{tl|summary/header}}: '''style''', '''микроформат'''. В качестве закрывающей секции — {{tl|summary/footer}}.

В навигационный шаблон Summary можно встраивать также таблицы, они форматируются в стиле Summary.

Шаблон занимает по ширине 80% страницы.

=== Пример ===
{| width="100%" cellpadding="5" cellspacing="0" border="1"
|-
!bgcolor="#eef"|Код
|-
|valign="top" bgcolor="#fff"|<pre
style="
margin:.5em;
border:0;
background-color:transparent;
">{{summary/navbox}}
{{summary/title|Заголовок}}
{{summary/subtitle|Текст}}
{{summary/field|Поле 1|Значение 1}}
{{summary/field|Поле 2|Значение 2}}
{{summary/section|Заголовок секции 1|
{{summary/field|Поле 1|Значение 1}}
{{summary/field|Поле 2|Значение 2}}
{{summary/field|Поле 3|Значение 3}}
}}
{{summary/line|текстовая строка}}
{{summary/cells|Левая колонка|Правая колонка}}
{|
|+Таблица
|-
|Ячейка 1
|Ячейка 2
|Ячейка 3
|Ячейка 4
|Ячейка 5
|}
----
{{summary/subtitle|Текст}}
{{summary/footer}}</pre>
|-
!bgcolor="#eef"|Как выглядит
|-
|valign="top"|{{summary/navbox}}
{{summary/title|Заголовок}}
{{summary/subtitle|Текст}}
{{summary/field|Поле 1|Значение 1}}
{{summary/field|Поле 2|Значение 2}}
{{summary/section|Заголовок секции 1|
{{summary/field|Поле 1|Значение 1}}
{{summary/field|Поле 2|Значение 2}}
{{summary/field|Поле 3|Значение 3}}
}}
{{summary/line|текстовая строка}}
{{summary/cells|Левая колонка|Правая колонка}}
{|
|+Таблица
|-
|Ячейка 1
|Ячейка 2
|Ячейка 3
|Ячейка 4
|Ячейка 5
|}
----
{{summary/subtitle|Текст}}
{{summary/footer}}
|}

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

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

<includeonly>[[Категория:Шаблоны Summary]]</includeonly>

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