Шаблон: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}} предназначен для создания основного заголовка шаблона. Параметры:
- Текст заголовка (обязательный параметр). Если не указан, выводится название страницы.
- Название аннотации SMW. Параметр из Традиции, в Циклопедии не используется.
- Цвет заголовка (в любом допустимом для CSS формате)
- Размер заголовка (в любом допустимом для CSS формате)
- Цвет фона (CSS)
- микроформат — имя свойства микроформата, добавляемое через {{Микроформат}}.
- значение микроформата — альтернативное не отображаемое значение вместо текста заголовка
- {{summary/subtitle}} предназначен для создания текста, который нужно разместить после заголовка шаблона. Параметры:
- Текст (обязательный параметр)
- Название аннотации SMW. Параметр из Традиции, в Циклопедии не используется.
- Видимый текст (при использовании аннотации). Параметр из Традиции, в Циклопедии не используется.
- Цвет текста (по умолчанию серый)
- микроформат — имя свойства микроформата, добавляемое через {{Микроформат}}.
- значение микроформата — альтернативное не отображаемое значение вместо текста заголовка
Разделы
- {{summary/section}} предназначен для создания разделов внутри шаблона. Первый параметр — заголовок раздела (секции). Второй параметр — тело раздела — последовательность {{Summary/field}} внутри секции. Если второй параметр не задан, шаблон не делает ничего. Микроформат — добавление микроформата ко всей секции.
Строки
- {{summary/line}} предназначен для размещения какого-либо текста в шаблоне. Параметры:
- — текст
- — цвет фона CSS
- — цвет текста CSS
- класс — CSS-класс
- микроформат — имя свойства микроформата.
- значение микроформата — альтернативное не отображаемое значение микроформата вместо значения из 1.
- {{summary/cells}} — создаёт строку, разделённую на два столбца. Если указано только одно значение, растягивается на всю ширину, подобно {{summary/line}}. Параметры:
- значение левого поля
- значение правого поля
- {{summary/duo}} — создаёт двойное поле с одинарным или двойным заголовком. Параметры:
- значение левого поля
- значение правого поля
- дополнительный текст правого поля
- заголовок общий или левого поля (если указан заголовок правого)
- заголовок правого поля
- цвет фона заголовка в формате CSS. По умолчанию прозрачный.
- цвет текста заголовка в формате CSS. По умолчанию чёрный.
Поля
- {{summary/field}} предназначен для создания самых простых полей. Имеет всего два параметра:
- — имя поля
- — значение
- микроформат — имя свойства микроформата.
- значение микроформата — альтернативное не отображаемое значение микроформата вместо значения из 2.
- {{summary/fields20}} — блок полей, до 20 штук. Нечётные параметры — имя поля; чётные — значение.
- микроформат — имя свойства микроформата для всего блока.
- значение микроформата — альтернативное не отображаемое значение для микроформат.
- микроформат1 ... микроформат20 — имена свойств микроформата для каждого отдельного значения (1 для 2 значения, 2 для 4-го ... 20-й — для 40-го).
Изображения
- {{summary/image}} предназначен для вставки изображения в шаблон. Параметры (обязателен только первый):
- Изображение в допустимых форматах. Возможные варианты:
- Название изображения без префикса, соответствующего пространству имён изображений. Например
Имя_изображения.jpg
. - Вставка изображения в формате викиразметки
[[Файл:Имя_изображения.jpg|thumb|center|310px|Описание]]
.
- Название изображения без префикса, соответствующего пространству имён изображений. Например
- Описание изображения.
- Тип вывода изображения (thumb, none, framed и т. д.). По умолчанию — none.
- Ширина изображения в пикселях. По умолчанию — 310пкс. Приставка «px»/«пкс» необязательна, если не указана, добавляется автоматически.
- Расположение изображения. По умолчанию — центр.
- Изображение в допустимых форматах. Возможные варианты:
Примечание: На данный момент ширину картинки рекомендуется делать на 10 пикселей меньше, чем общая ширина шаблона. Это обусловлено дополнительными внутренними отступами изображения (3px отступ + 1px рамка + 1px рамка изображения).
Дополнительные секции
Герб и флаг
- {{summary/gerbflag}} дополнительный шаблон, предназначенный для шаблонов государств и регионов. Вставляет изображения герба и флага. Параметры:
- Имя файла герба (без пространства имён
Файл:
) - Имя файла флага (без пространства имён
Файл:
) - Название страны или региона в родительном падеже (кого ? чего ?).
- Имя файла герба (без пространства имён
Дата
- {{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}} |
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
текстовая строка
Левая колонка Правая колонка
Текст
|
Переход
В процессе перехода на единый шаблон выгодно также пересмотреть набор используемых в работе шаблонов и параметры, в них использующиеся. Делать это нужно с учётом требований специалистов, в области которых находится этот шаблон, и удобства использования в нём аннотаций.
Старые шаблоны, позаимствованные из других проектов, следует переделать в «оболочки» для новых шаблонов. Это нужно для того, чтобы в переносимых из других проектов статьях нормально отображались их шаблоны.