Шаблон:Карточка/doc

Материал из ChronoWiki
< Шаблон:Карточка
Версия от 23:51, 2 января 2020; Lirik (обсуждение | вклад) (1 версия импортирована)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к навигацииПерейти к поиску

Шаблон:Fmbox

Это меташаблон для создания шаблонов-карточек.

Параметры

Служебные

имя
Имя шаблона, необходимое для корректной работы служебных инструментов на всех страницах, где используется шаблон. Для простоты можно использовать {{subst:PAGENAME}}.
автозаголовки
Указание «да» приводит к автоматическому скрытию заголовков, после которых, вплоть до следующего заголовка, все поля пусты. Возможно использовать фиктивные заголовки «-» для прерывания области скрытия. Будет работать некорректно, если требуется указать два заголовка подряд — например, при использовании многоуровневых заголовков. В этом случае рекомендуется явно указать «нет» на случай смены значения по умолчанию с «нет» на «да».
from
Указывается элемент Викиданных, из которого берётся информация.

Основные

вверху
Текст, отображаемый вверху таблицы. Обычно это название предмета статьи.
вверху2
Дополнительный текст, отображаемый вверху таблицы. Обычно используется для оригинального названия.
вверху3
Дополнительный текст, отображаемый вверху таблицы.
изображение
Изображение, которое будет отображено под основным заголовком в правой части таблицы (правее заголовков/списков). Параметр изображение допускает стандартный викикод для отображения. Для разных типов параметра можно использовать {{Форматирование изображения}}. Обычно предпочтительнее использовать код {{wikidata|P18|{{{изображение|}}}|caption={{{описание изображения|}}}}}.
подпись
Подпись под изображением. Отображается только в том случае, если задано изображение. При использовании Шаблон:Tlp не заполняется.
изображение2
Дополнительное изображение.
изображение3
Дополнительное изображение.
заголовокn
Используется для создания заголовков в ряду. Этот и следующие 2 параметра работают при n≥1.
меткаn
Используется для подписи текста
текстn
Используется для принятия параметров в специализированных шаблонах-карточках.
викиданныеn
Подставляет значение из указанного параметра Викиданных в поле текста, если текст в этой строке определён. Если в поле текста передано значение -, то значение из Викиданных будет скрыто.
внизу
внизуn
Ячейка во всю ширину таблицы, располагающаяся внизу тела шаблона (то есть под заголовками/метками и текстом).

Стили

стиль_тела
Применяется ко всей карточке, обычно используется для указания её ширины, например, width:23em;
стиль_вверху
Применяется к полю «вверху», например, для указания цвета фона или изменения размера шрифта: font-size:medium;
стиль_вверхуn
Используется для изменения стиля дополнительного текста вверху таблицы, например, чтобы убрать курсивное начертание: font-style:normal;
стиль_изображения
Применяется к ячейке, в которой располагается изображение и его описание
стиль_изображенияn
Применяется к ячейке, в которой располагается дополнительное изображение
стиль_подписи
Применяется к подписи изображения
стиль_заголовков
С помощью этого стиля можно настроить отображение заголовков, в частности, указать цвет фона: background: #a3eea3;
стиль_заголовкаn
Применяется к конкретному заголовку в строке n
стиль_меток
Применяется к меткам
стиль_меткиn
Применяется к конкретной метке в строке n
стиль_текста
Применяется к тексту
стиль_текстаn
Применяется к конкретному тексту в строке n
стиль_внизу
Эти стили применяются не только в первому внизу, но и ко всем остальным — в отличие от стиль_вверху.
стиль_внизуn
CSS-стили, которые должны быть применены к нижним (указанными параметрами внизу и внизуn) ячейкам.

Возможности

Сдвоенные ячейки

Если для параметра текстn значение меткаn не определено, то текстn автоматически расширяется до 2 ячеек. Для выравнивания по левой стороне можно использовать следующий код:

|текст2        = {{{параметр|}}}
|стиль_текста2 = text-align:left;

Необязательные ячейки

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

|метка5 = Население
|текст5 = {{{население|}}}

Таким образом, если параметр население не будет определён, строка «Население» не будет отображена.

Необязательные заголовки

Таким же образом можно организовать необязательные заголовки. Следующий пример будет выводить заголовок «Структура», если параметры содержимое и размещение определены:

|заголовок5 = {{#if:{{{содержимое|}}}{{{размещение|}}}|Структура}}
|метка6     = Содержимое
|текст6     = {{{содержимое|}}}
|метка7     = Размещение
|текст7     = {{{размещение|}}}

Если есть заголовокN, то текстN и меткаN игнорируются. Если нет заданного заголовкаN, то показываются текстN и меткаN.

|заголовок1 = {{{заголовок1|}}}
|метка1     = {{{метка1|}}}
|текст1     = {{{текст1|}}}
|заголовок1 = заголовок_текст
|метка1     = метка_текст
|текст1     = текст_текст
заголовок_текст
|заголовок1 = 
|метка1     = метка_текст
|текст1     = текст_текст
метка_текст текст_текст

Оформление параметров

Для оформления параметра можно использовать функцию парсера «#if». Например, следующие строки добавят к параметру текст6 подпись кг, если этот параметр определён:

|метка6 = Масса
|текст6 = {{#if:{{{масса|}}} |{{{масса}}} кг}}

А расстановку ссылок на страницы можно организовать с помощью «#switch», например:

|метка6     = Раса
|текст6     = {{#switch:{{{раса|}}}
  |Европеоиды   = [[Европеоидная раса|Европеоиды]]
  |Негроиды     = [[Негроидная раса|Негроиды]]
  |Монголоиды   = [[Монголоидная раса|Монголоиды]]
  |{{{раса|}}}
}}

Пустой шаблон

{{Карточка
|имя              = {{subst:PAGENAME}}
|автозаголовки    = да

|стиль_вверху     = background:#cfe3ff;
|стиль_заголовков = background:#dcebff;
|стиль_внизу      = background:#dcebff;

|вверху           = 
|вверху2          = 
|изображение      = 

|заголовок1       = 

|метка2           = 
|текст2           = 
|викиданные2      = 

|метка3           = 
|текст3           = 
|викиданные3      = 

|метка4           = 
|текст4           = 
|викиданные4      = 

|метка5           = 
|текст5           = 
|викиданные5      = 

|метка6           = 
|текст6           = 
|викиданные6      = 

|метка7           = 
|текст7           = 
|викиданные7      = 

|метка8           = 
|текст8           = 
|викиданные8      = 

|метка9           = 
|текст9           = 
|викиданные9      = 

|метка10          = 
|текст10          = 
|викиданные10     =

 ...

|меткаN           = 
|текстN           = 
|викиданныеN      = 

|внизу            = 
}}<noinclude>
{{doc}}
</noinclude>

Примерный шаблон для карточки персоны

{{Карточка
|имя              = {{subst:PAGENAME}}
|автозаголовки    = да

|стиль_вверху     = background:#cfe3ff;
|стиль_заголовков = background:#dcebff;
|стиль_внизу      = background:#dcebff;

|вверху           = {{карточка/имя|{{{имя|}}}}}
|вверху2          = {{карточка/оригинал имени|{{{оригинал имени|}}}}}
|изображение      = {{wikidata|p18|{{{фото|}}}|caption={{{описание изображения|}}}|size={{{ширина|}}}}}

|метка1           = Имя при рождении
|текст1           = {{{имя при рождении|}}}
|викиданные1      = p1477

|метка2           = Дата рождения
|текст2           = {{wikidata/p569|{{{дата рождения|}}}|{{{дата смерти|}}}}}

|метка3           = Место рождения
|текст3           = {{{место рождения|}}}
|викиданные3      = p19

|метка4           = Дата смерти
|текст4           = {{wikidata/p570|{{{дата смерти|}}}|{{{дата рождения|}}}}}

|метка5           = Место смерти
|текст5           = {{{место смерти|}}}
|викиданные5      = p20

|метка6           = Гражданство
|текст6           = {{{гражданство|}}}
|викиданные6      = p27

|метка7           = Сценические имена / Прозвище
|текст7           = {{{прозвище|}}}
|викиданные7      = p1449

|заголовок8       = {{wikidata|p856|{{{сайт|}}}}}

|внизу            = {{карточка/Викисклад|{{{викисклад|}}}}}
}}

Конвертация из HTML

При переводе шаблонов, написанных на html (использующих элементы div), на основу карточки (в основе которой лежит элемент table) следует производить следующую коррекцию:

  • увеличить ширину (свойство width) главного фрейма на 10px;
  • уменьшить внутренний отступ (свойство padding) там же на 2px;
  • задать явно размер и жирность текста (свойство и параметр font-weight: normal и т. п.).

См. также