Шаблон:Картка

Документація шаблону[перегляд] [редагувати] [історія] [очистити кеш]

Цей шаблон використовується на близько 495 000 сторінках або близько 10% всіх сторінок. Для уникнення великомасштабних збоїв та непотрібного навантаження на сервер, будь-які зміни спочатку потрібно перевірити на підсторінках /пісочниці та /тестів цього шаблону, або у вашому особистому просторі. Потім перевірені зміни можуть бути впроваджені на цій сторінці єдиним редагуванням. Будь ласка, обговорюйте будь-які зміни на сторінці обговорення перед їхнім впровадженням.

Цей шаблон використовує Lua: Модуль:Картка (пісочниця)

Цей меташаблон дає можливість створювати шаблони-картки. Це означає, що він не повинен використовуватись у статті безпосередньо. Щоб отримати інформацію про те, як користуватися картками, див. Довідка:Картка.

Використання подібне до шаблону {{Навігаційна таблиця}}, але є деякі відмінності. Кожен рядок у таблиці може містити або «заголовок», або пару «мітка»/«текст», або лише «текст». Якщо ви визначаєте щоб рядок був і «заголовком», і парою «мітка»/«текст», то пару «мітка»/«текст» буде скасовано.

Якщо ви хочете вставити зображення, або інші дані де-небудь у іншому місці картки, просто використовуйте параметр «текст».

вбудовування • child

Детальніше дивіться розділ вбудовування. Якщо встановити значення параметра «так» (або «yes»), то така вбудована картка повинна мати назву, але не мати параметра ім'я. Цей параметр пустий по стандарту, щоб його увімкнути, встановіть значення «так» (або «yes»).

підкартка • subbox

Детальніше дивіться розділ підкартки. Якщо встановити значення параметра «так» (або «yes»), то така підкартка повинна мати назву, але не мати параметра ім'я. Цей параметр пустий по стандарту, щоб його увімкнути, встановіть значення «так» (або «yes»). Він не працює, якщо встановлено значення «так» (або «yes») в параметрі |вбудовування=.

nocat • decat

Якщо встановити значення параметра «так» (або «yes»), то поточна сторінка не автокатегоризована до категорій обслуговування, коли створення картка має певні проблеми або не має видимих розділів тексту. Залиште пустим по стандарту або встановіть значення «так», щоб активувати його.

автозаголовки • autoheaders

Якщо встановлено будь-яке не пусте значення, то заголовки, після яких немає полів тексту зі значеннями, не виводяться. Детальніше дивіться розділ «приховування заголовків, де всі їхні поля тексту є пустими».

ім'я • name

Назва сторінки шаблону, на яку повинні вказувати посилання «переглянути/обговорити/редагувати». Ви можете використовувати {{subst:PAGENAME}}. Якщо цей параметр буде опущено, посилання «переглянути/обговорити/редагувати» не відображатимуться.

Є два різні способи помістити у картку заголовок. Перший: усередині картки, другий: над карткою. Ви можете використовувати обидва разом, якщо вам подобається, або лише один або інший, або навіть жодного (хоча це не рекомендовано).

назва • title

Щоб помістити заголовок над карткою.

угорі • above

Щоб помістити заголовок в межах верхньої комірки картки.

угорі2 • above2

Додатковий текст, що відображається вгорі таблиці. Використовується, наприклад, для оригінальної назви.

зображення • image

Зображення у верхній частині шаблону. Використовуйте повний синтаксис зображення, наприклад [[Зображення:example.png|200px]]. Зображення вирівнюється по центру.

підпис • caption

Підпис зображення.

заголовок(n) • header(n)^[1]

Використовується для створення заголовка в рядку n.

мітка(n) • label(n)

Використовується для підпису тексту в рядку n.

текст(n) • data(n)

Текст у рядку n.

клас_рядка(n) • rowclass(n)

Клас рядка n.

внизу • below

Текст у нижній комірці картки.

стиль_тіла • bodystyle

Стиль усієї картки.

стиль_назви • titlestyle

Стиль назви над карткою.

стиль_угорі • abovestyle

Стиль назви в межах верхньої комірки картки. Типовим є стиль «font-size: large;» якщо ви хочете використовувати її для звичайного тексту, задайте стиль «font-size: medium;».

стиль_зображення • imagestyle

Стиль комірки, у якій знаходиться зображення. Включає також стиль підпису зображення.

стиль_підпису • captionstyle

Стиль підпису зображення.

стиль_заголовків • headerstyle

Стиль усіх заголовків.

стиль_міток • labelstyle

Стиль усіх міток.

стиль_тексту • datastyle

Стиль усіх комірок для тексту.

стиль_внизу • belowstyle

Стиль нижньої комірки.

Див. en:Wikipedia:WikiProject Microformats та microformats.org

клас_тіла

Цей параметр передається атрибуту «class» усієї картки.

клас_рядка_зображення(n)

Ці параметри передається атрибуту «class» для всього рядку таблиці, на якому є їхнє відповідне зображення.

клас_зображення

Цей параметр передається атрибуту «class» зображення.

клас(n)

Цей параметр передається атрибуту «class» комірки з текстом.

клас_назви

Цей параметр передається атрибуту «class» комірки з заголовком.

клас_внизу

Цей параметр передається атрибуту «class» нижньої комірки.

Наприклад, для реалізації мікроформату hCard додайте наступні параметри:

|клас_тіла = vcard
|клас1 = fn
|клас2 = org
|клас3 = url

Рядок з міткою, але без тексту, не відображається. Це дозволяє легко створювати необов'язкові рядки картки. Щоб зробити рядок необов'язковим, використовуйте параметр таким чином:

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

Таким чином, якщо в статті не визначено параметр «населення», рядок картки не відображатиметься.

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

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

Аналогічно можна організувати необов'язкові заголовки. Наступний приклад виводитиме заголовок «Структура», якщо параметри «вміст» і «розміщення» визначені:

{{Картка
|ім'я    = {{subst:PAGENAME}}
|назва   = Приклад необов'язкового заголовка
|заголовок1 = {{#if:{{{пункт 1|}}}{{{пункт 2|}}}{{{пункт 3|}}} |Необов'язковий заголовок}}
|мітка2  = Пункт 1
|текст2   = {{{пункт 1|}}}
|мітка3  = Пункт 2
|текст3   = {{{пункт 2|}}}
|мітка4  = Пункт 3
|текст4   = {{{пункт 3|}}}
}}

Ви також можете зробити, щоб заголовки автоматично приховувалися, коли їхній розділ пустий (не показуються рядки тексту).

Розгляньте цю ситуацію:

{{Картка
 | назва   = Приклад: заголовок з і без значення у параметрі текст
 | стиль_заголовків = background: lightgrey

 | заголовок1 = Заголовок1 з пустим розділом
 |  мітка2 = текст мітки2 |  текст2 =
 |  мітка3 = текст мітки3 |  текст3 =
 |  мітка4 = текст мітки4 |  текст4 =

 | заголовок5 = Заголовок5 зі значення у параметрі текст нижче
 |  мітка6 = текст мітки6 |   data6 = Деяке значення
}}

Якщо ви хочете приховати заголовок, коли не наявні значення в |текстN=, то використайте |автозаголовки=т:

{{Картка
 | назва   = Приклад: заголовок з і без значення у параметрі текст
 | автозаголовки = т
 | стиль_заголовків = background: lightgrey

 | заголовок1 = Заголовок1 з пустим розділом
 |  мітка2 = текст мітки2 |  текст2 =
 |  мітка3 = текст мітки3 |  текст3 =
 |  мітка4 = текст мітки4 |  текст4 =

 | заголовок5 = Заголовок5 зі значення у параметрі текст нижче
 |  мітка6 = текст мітки6 |  текст6 = Деяке значення
}}

Отже, заголовок1 буде відображено, якщо визначено будь-який з елементів1, елементів2 або елементів3. Якщо жоден з цих трьох параметрів не визначено, то заголовок не буде відображено та жоден путий рядок не з'явиться перед наступним видимим вмістом.

Зверніть увагу: якщо параметр текст мітить пусті елементи css, як |текст=<span style="background:yellow;"></span>, то це буде вважатися як не пусте значення (наявність параметра текст).

Якщо |автозаголовки=т, але є елементи, які ви не хочете, щоб викликали заголовок, то розмістіть |заголовокX=_BLANK_. Це буде вважатися як пустий заголовок і відділить його від наступних елементів.

{{Картка
 | назва   = Приклад: пустий заголовок з і без значення у параметрі текст
 | автозаголовки = т
 | стиль_заголовків = background: lightgrey

 | заголовок1 = Заголовок1 з пустим розділом
 |  мітка2 = текст мітки2 |  текст2 =
 |  мітка3 = текст мітки3 |  текст3 =
 |  мітка4 = текст мітки4 |  текст4 =

 | заголовок5 = _BLANK_
 |  мітка6 = текст мітки6 |  текст6 = Деяке значення, але не викликає заголовок1 чи показує заголовок5
}}

Тест-картка

Угорі
example.png
Лише заголовок
Лише текст
Усі три (заголовок)
Усі три (мітка)	Усі три (дані)
Мітка і текст (мітка)	Мітка і текст (дані)
Текст внизу

{{Картка
|ім'я         = Картка/документація
|стиль_тіла   = 
|назва        = Тест-картка
|стиль_назви  = 
|угорі        = Угорі
|зображення   = [[Зображення:example.png|200px]]
|стиль_зображення = 
|підпис       = example.png
|стиль_підпису = 
|стиль_заголовків = background:#ccf;
|стиль_міток  = background:#ddf;
|стиль_тексту = 

|заголовок1 = Лише заголовок
|мітка2  = 
|текст2  = 
|заголовок2 = 
|мітка3  = Лише мітка
|текст3  = 
|заголовок4 =
|мітка5  = 
|текст5  = Лише текст
|заголовок6 = Усі три (заголовок)
|мітка7  = Усі три (мітка)
|текст7  = Усі три (дані)
|заголовок8 =
|мітка9  = Мітка і текст (мітка)
|текст9  = Мітка і текст (дані)

|стиль_внизу = background:#ddf;
|внизу = Текст внизу
}}

Зверніть увагу: якщо мітка визначається без супровідного тексту, рядок не відображається, і коли заголовок визначається у тому ж рядку, що й текст, відображається тільки заголовок.

Для цього прикладу стиль_тіла = width:20em; і стиль_міток = width:33%;

Один шаблон картки може бути вбудований в інший при використанні параметра |вбудовування= (|child=). Ця функція може використовуватися для створення модульних карток або для створення краще визначених логічних розділів.

{{Картка
 |назва = Назва верхнього рівня
 |текст1 = {{Картка | вбудовування = так
    |назва = Перший підрозділ
    |мітка1 = Мітка 1.1
    |текст1 = Текст 1.1
   }}
 |текст2 = {{Картка | вбудовування = так
  |назва = Другий підрозділ
  |мітка1 = Мітка 2.1
  |текст1 = Текст 2.1
  }}
 |стиль_внизу = 
 |внизу = Текст внизу
}}

Зверніть увагу, що в прикладах вище, вбудована картка розміщена в полі текст, а не в полі заголовок. Тому підзаголовки розділів не виділяються жирним шрифтом, якщо явно не вказано відповідну розмітку. Щоб отримати заголовки розділів жирним шрифтом, розмістіть вбудовану картку в полі заголовок (але не в полі мітка, бо картка не буде відображена!), використавши або

{{Картка
 |назва = Назва верхнього рівня
 |заголовок1 = {{Картка | вбудовування = так
    |назва = Перший підрозділ
    |мітка1 = Мітка 1.1
    |текст1 = Текст 1.1
   }}
 |заголовок2 = {{Картка | вбудовування = так
    |назва = Другий підрозділ
    |мітка1 = Мітка 2.1
    |текст1 = Текст 2.1
   }}
 |стиль_внизу = 
 |внизу = Текст внизу
}}

або,

{{Картка
 |назва = Назва верхнього рівня
 |заголовок1 = Перший підрозділ
   {{Картка  | вбудовування = так
    |мітка1 = Мітка 1.1
    |текст1 = Текст 1.1
   }}
 |заголовок2 = Другий підрозділ
   {{Картка  | вбудовування = так
    |мітка1 = Мітка 2.1
    |текст1 = Текст 2.1
   }}
 |стиль_внизу = 
 |внизу = Текст внизу
}}

Зверніть увагу, що опущення параметра |title= та не включення жодного тексту перед вбудованою карткою, може спричинити помилкові порожні рядки таблиці, створюючи пропуски у візуальному представлені. Вивід сміття можна проігнорувати, використавши |rowstyleN=display: none, де N замінити на номер тексту/заголовка (data/header).

Альтернативним методом вбудування є використання |підкартка=так, що видаляє зовнішні межі з картки, але залишає внутрішню структуру. Однією переваг цього підходу є те, що батьківська картка і дочірня картка не повинні мати однакову структуру та поля міток і тексту не вирівнюються за батьковою і дочірньою карткою, бо вони не в одній батьківській таблиці.

{{Картка
 | стиль_заголовків = background-color: #eee;
 | стиль_міток  = background-color: #eee;
 | заголовок1 = Основний 1
 | заголовок2 = Основний 2
 |   текст3 = {{Картка | підкартка = так
    | стиль_заголовків = background-color: #ccc;
    | стиль_міток  = background-color:#ddd;
    | заголовок1 = Допоміжний 3-1
    | заголовок2 = Допоміжний 3-2
    |  мітка3 = Мітка 3-3    |   текст3 = Текст 3-3
   }}
 |   текст4 = {{Картка | підкартка = так
    | стиль_міток  = background-color: #ccc;
    |  мітка1 = Мітка 4-1    |   текст1 = Текст 4-1
   }}
 |  мітка5 = Мітка 5 |   текст5 = Текст 5
 | заголовок6 = Основний 6
}}

Подібну техніку вбудування можна використовувати всередині параметрів вмісту (content) деяких інших шаблонів, що створюють таблиці (такі як Sidebar):

{{Sidebar
 | navbar = off
 | headingstyle = background-color: #eee;
 | heading1 = Заголовок 1
 | heading2 = Заголовок 2
 | content3 = {{Картка | підкартка = так
    | стиль_заголовоків = background-color: #ccc;
    | стиль_міток = background-color: #ddd;
    | заголовок1 = Допоміжний 3-1
    | заголовок2 = Допоміжний 3-2
    |  мітка3 = Мітка 3-3 |   текст3 = Текст 3-3
   }}
 | content4 = {{Картка | підкартка = так
    | стиль_міток = background-color: #ccc;
    |  мітка1 = Мітка 4-1 |   текст1 = Текст 4-1
   }}
 | heading5 = Заголовок 5
}}

Зверніть увагу, що стандартне значення відступу (padding) батьківської комірки тексту, що містить підкартку, залишається видимим, тому підкартка є трохи вужчою ніж батьківська картка, а також є більший вертикальний пропуск між стандартними комірками батьківської картки ніж між комірками окремих підкарток.

Шаблон на поточний час виводить лише одне повідомлення про помилку, проте містить кілька категорій спостереження, що також містять інші помилки у використанні шаблону. Детальніше:

• К:Сторінки, що використовують шаблони картка з проігнорованими комірками параметра текст (10)
• К:Статті, що використовують шаблони картка без рядків параметра текст (2166)
• К:Сторінки, що використовують шаблони вбудованої картки з параметром назва (8)

Вказано два однакових параметри |<парам1>= та |<парам2>=, тому виведено значення параметра |<парам1>=

Ця помилка виводиться, якщо використано шаблон, що містять два заповнених однакових параметри (в основному, один англійською мовою, а інший українською мовою) такі як «назва» та «title». Наприклад, {{Картка |назва= {{{назва}}} |title={{{title}}}}}.

Щоб виправити цю помилку, видаліть зайвий параметр та його вміст об'єднайте з іншими параметром. Наприклад, {{Картка |назва= {{{назва|{{{title}}}}}}}}.

Сторінки з цією помилкою автоматично поміщаються в К:Сторінки, що використовують шаблони картка з двома однаковими параметрами (5).

Примітка: шаблон обробляє незліченну кількість рядків, але тут вказано лише 20. Просто розширте нумерацію за необхідності. Параметри мікроформату «клас…» також опущені, оскільки вони зазвичай не використовуються.

{{Картка
 |ім'я          = {{subst:PAGENAME}}
 |вбудовування  = 
 |підкартка     = 
 |infobox-width = 
 |стиль_тіла    = 
 |назва         = 
 |стиль_назви   = 

 |угорі         = 
 |стиль_угорі   = 
 |угорі2        = 
 |стиль_угорі2  = 

 |підзаголовок  = 
 |підзаголовок2 = 
 |стиль_підзаголовок = 

 |зображення    = 
 |зображення2   = 
 |стиль_зображення = 
 |підпис        = 
 |підпис2       = 
 |стиль_підпису = 

 |стиль_заголовків = 
 |стиль_міток   = 
 |стиль_тексту  = 
 |назва_модуля_вікіданих =

 |заголовок1 = <!--Зверніть увагу: Якщо використано заголовок1, то значення параметрів мітка1, текст1 та вікідані1 не буде виведено. Тому заголовок не може мати однаковий номер з цими параметрами.-->
 |мітка1    = 
 |текст1    = 
 |вікідані1 =
 |заголовок2 = 
 |мітка2    = 
 |текст2    = 
 |вікідані2 =
 |заголовок3 = 
 |мітка3    = 
 |текст3    = 
 |вікідані3 =
 |заголовок4 = 
 |мітка4    = 
 |текст4    = 
 |вікідані4 =
 |заголовок5 = 
 |мітка5    = 
 |текст5    = 
 |вікідані5 =
 |заголовок6 = 
 |мітка6    = 
 |текст6    = 
 |вікідані6 =
 |заголовок7 = 
 |мітка7    = 
 |текст7    = 
 |вікідані7 =
 |заголовок8 = 
 |мітка8    = 
 |текст8    = 
 |вікідані8 =
 |заголовок9 = 
 |мітка9    = 
 |текст9    = 
 |вікідані9 =
 |заголовок10 = 
 |мітка10    = 
 |текст10    = 
 |вікідані10 =
 |заголовок11 = 
 |мітка11    = 
 |текст11    = 
 |вікідані11 =
 |заголовок12 = 
 |мітка12    = 
 |текст12    = 
 |вікідані12 =
 |заголовок13 = 
 |мітка13    = 
 |текст13    = 
 |вікідані13 =
 |заголовок14 = 
 |мітка14    = 
 |текст14    = 
 |вікідані14 =
 |заголовок15 = 
 |мітка15    = 
 |текст15    = 
 |вікідані15 =
 |заголовок16 = 
 |мітка16    = 
 |текст16    = 
 |вікідані16 =
 |заголовок17 = 
 |мітка17    = 
 |текст17    = 
 |вікідані17 =
 |заголовок18 = 
 |мітка18    = 
 |текст18    = 
 |вікідані18 =
 |заголовок19 = 
 |мітка19    = 
 |текст19    = 
 |вікідані19 =
 |заголовок20 = 
 |мітка20    = 
 |текст20    = 
 |вікідані20 =

 |стиль_внизу = 
 |внизу       = 
 |стиль_внизу2 = 
 |внизу2       = 
}}

• {{Картка/рядок}} (обг. · викор. · ред.)