Циклопедия скорбит по жертвам террористического акта в Крокус-Сити (Красногорск, МО)

Шаблон:Summary/field

Материал из Циклопедии
Перейти к навигации Перейти к поиску
(i) Документация [просмотр] [править] [история] [обновить]

{{Summary/field}} · Документация · Обсуждение · Подстраницы · Где используется
На этой странице могут быть описаны вещи, находящиеся в разработке.

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

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

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

Карточка Summary

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

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

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

Вместо тегов <div> можно вставить откравающую и закрывающую секцию:

  • {{summary/header}} — заголовок с параметром style, принимающим в качестве значения CSS стили (в. т. ч. цвет фона и рамки), и параметром микроформат, добавляющим корневой класс микроформата
  • {{summary/footer}} — шаблон , завершающий карточку {{summary}}.

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

Заголовок

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

Разделы

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

Строки

  • {{summary/line}} предназначен для размещения какого-либо текста в шаблоне. Параметры:
  1. — текст
  2. — цвет фона CSS
  3. — цвет текста CSS
  • класс — CSS-класс
    • микроформат — имя свойства микроформата.
    • значение микроформата — альтернативное не отображаемое значение микроформата вместо значения из 1.
  • {{summary/cells}} — создаёт строку, разделённую на два столбца. Если указано только одно значение, растягивается на всю ширину, подобно {{summary/line}}. Параметры:
    1. значение левого поля
    2. значение правого поля
  • {{summary/duo}} — создаёт двойное поле с одинарным или двойным заголовком. Параметры:
    1. значение левого поля
    2. значение правого поля
    3. дополнительный текст правого поля
    4. заголовок общий или левого поля (если указан заголовок правого)
    5. заголовок правого поля
    6. цвет фона заголовка в формате CSS. По умолчанию прозрачный.
    7. цвет текста заголовка в формате CSS. По умолчанию чёрный.

Поля

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

Изображения

  • {{summary/image}} предназначен для вставки изображения в шаблон. Параметры (обязателен только первый):
    1. Изображение в допустимых форматах. Возможные варианты:
      • Название изображения без префикса, соответствующего пространству имён изображений. Например Имя_изображения.jpg.
      • Вставка изображения в формате викиразметки [[Файл:Имя_изображения.jpg|thumb|center|310px|Описание]].
    2. Описание изображения.
    3. Тип вывода изображения (thumb, none, framed и т. д.). По умолчанию — none.
    4. Ширина изображения в пикселях. По умолчанию — 310пкс. Приставка «px»/«пкс» необязательна, если не указана, добавляется автоматически.
    5. Расположение изображения. По умолчанию — центр.

Note Примечание: На данный момент ширину картинки рекомендуется делать на 10 пикселей меньше, чем общая ширина шаблона. Это обусловлено дополнительными внутренними отступами изображения (3px отступ + 1px рамка + 1px рамка изображения).

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

Герб и флаг

  • {{summary/gerbflag}} дополнительный шаблон, предназначенный для шаблонов государств и регионов. Вставляет изображения герба и флага. Параметры:
    1. Имя файла герба (без пространства имён Файл:)
    2. Имя файла флага (без пространства имён Файл:)
    3. Название страны или региона в родительном падеже (кого ? чего ?).

Дата

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

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

Пример

Код Как выглядит
{{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}}

Заголовок

Текст
Описание

Заголовок секции 1

Поле 1
Значение 1
Поле 2
Значение 2
Поле 3
Значение 3

Заголовок секции 2

текст
Герб региона
Флаг региона
Дата
1 января 2000 года
Текст 1
Текст 2
Заголовок 1
Заголовок 2
Текст 1
Текст 2

Summarybox

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

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

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

Пример

Код Как выглядит
<div class="summarybox" style="width:100px;">
{{summary/title|Заголовок}}
{{summary/line|[[Файл:No Picture.png|thumb|right|90px|Картинка]]}}
{{summary/line|текстовая строка}}
</div>

Заголовок

Картинка
текстовая строка

Навигационный шаблон

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

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

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

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

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

Пример

Код
{{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}}
Как выглядит

Заголовок

Текст
Поле 1
Значение 1
Поле 2
Значение 2

Заголовок секции 1

Поле 1
Значение 1
Поле 2
Значение 2
Поле 3
Значение 3
текстовая строка
Левая колонка
Правая колонка
Таблица
Ячейка 1 Ячейка 2 Ячейка 3 Ячейка 4 Ячейка 5

Текст

Переход

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

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