Вікіпедія:Шаблони

Скорочення
ВП:Ш

Шаблони Вікіпедії — це спеціальний клас сторінок Вікіпедії, які можна включити в інші сторінки. Усі такі сторінки мають у назві префікс Шаблон:, він позначає простір назв шаблонів.

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

ВикористанняРедагувати

Докладніше: Довідка:Шаблони

Зазвичай шаблони використовуються наступним чином: у подвійних фігурних дужках {{ }} прописується назва шаблону — частина назви сторінки шаблону одразу після префіксу простору назв Шаблон:. У включеннях шаблонів перша літера одразу після префіксу простору назв Шаблон: може бути і великою, і маленькою. Наприклад: {{Назва шаблону}} або {{назва шаблону}}. Для відокремлення назви шаблону від його параметрів, а також наступних параметрів один від одного використовується вертикальна риска (пайп) (|). Існують нумеровані та іменовані параметри (наприклад, параметр (date= у шаблонах упорядкування — іменований параметр, оскільки має власну назву; нумеровані параметри не мають власної назви). Для увімкнення деяких параметрів необхідно надати їм чітко визначене значення (наприклад, {{Navbox|name=Box}}), тоді як для увімкнення інших параметрів вистачає, якщо надати їм будь-яке значення (усе залежить від того, як ці параметри прописані в коді шаблону). Для чіткого окреслення порядку нумерованого параметра перед його значенням можна додати його номер (наприклад, 1= для першого параметра).

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

ВключенняРедагувати

Включення — це стандартне використання шаблону, що являє собою включення вмісту певної сторінки (зазвичай шаблону) в іншу сторінку, вказавши назву доданої сторінки. При такому використанні вміст доданої сторінки (шаблону) не переноситься до коду цільової сторінки. Подібно до того, як будь-яка назва сторінки може стати посиланням, якщо її розмістити у подвійних квадратних дужках, будь-яка назва сторінки може стати шаблоном, якщо її розмістити у подвійних фігурних дужках, {{Простір назв:Назва сторінки}}. Шаблони можуть бути одночасно включені на багатьох різних сторінках, тому зміни, внесені до шаблону, автоматично відображаються на всіх сторінках, у які він був включений. У цьому прикладі зображено шаблон «B», код якого містить лише слово foo, та як його включення відображається на сторінках, у яких він включений.

ПідстановкаРедагувати

На відміну від включення, при використанні підстановки код шаблону переноситься безпосередньо в тіло сторінки. Для підстановки шаблону використовується {{subst:Назва шаблону}}. На сторінках документації шаблонів має бути чітко прописано, якщо вони використовуються з підстановкою.

ПараметриРедагувати

Параметр шаблону — це інструмент, який може бути використаний за допомоги функцій парсера — розширення рушія MediaWiki. Функції парсера використовуються при створенні та використанні (включенні) шаблонів, зокрема інфобоксів. Параметри шаблону застосовують у тому разі, коли необхідно передбачити можливість дописати в шаблон певну інформацію, оригінальну для кожної даної статті.

У коді вікірозмітки характерною особливістю параметра є його розміщення в потрійних фігурних дужках всередині коду шаблону.

Типи параметрівРедагувати

Розрізняють два типи параметрів шаблонів:

  • іменовані параметри: напр. {{{назва параметра}}}, {{{населення}}}, {{{вартість}}} тощо,
  • нумеровані параметри (неіменовані): напр. {{{1}}}, {{{2}}}, {{{3}}} тощо.

  У різних мовних розділах Вікіпедії затверджені чи усталені (як найпоширеніші) різні конвенції найменування параметрів. Однак, слід зважити на те, що параметри в MediaWiki по-різному сприймають великі та малі літери, тому, наприклад, {{{еквівалент НАТО}}} та {{{еквівалент нато}}} — це два різні параметри. Крім того, пробіли та нижні підкреслення сприймаються так само по-різному, тому {{{еквівалент НАТО}}} i {{{еквівалент_НАТО}}} — це теж два різні параметри.

Без аргументованої необхідності у назвах іменованих параметрів слід використовувати малі літери, за винятками: метапараметри (параметри, призначені для самого шаблону), або, коли вони позначають власну назву, акронім, наприклад, ЄДРПОУ.

ІменованіРедагувати

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

{{Шаблон|назва=вміст|назва2=вміст2}}

викликає шаблон під назвою Шаблон, параметр назва включає вміст, а параметр назва2 включає вміст2. Порядок іменованих параметрів у вихідному коді не має значення, тому результат буде ідентичним, якщо прописати так:

{{Шаблон|назва2=вміст2|назва=вміст}}

НумерованіРедагувати

Нумеровані параметри прописуються наступним чином:

{{Шаблон|вміст|вміст2}}

  Нумеровані параметри можна (а іноді й потрібно) прописувати в шаблоні як іменовані, надавши кожному параметру відповідний порядковий номер за типом: |1=вміст|2=вміст2.

Прописавши так, одержимо аналогічний результат:

  • нумерування параметрів:
{{Шаблон|1=вміст|2=вміст2}}
  • зміна порядку параметрів:
{{Шаблон|2=вміст2|1=вміст}}
  • так теж можна:
{{Шаблон|вміст|2=вміст2}}
{{Шаблон|2=вміст2|вміст}}
  • а так уже неправильно:
{{Шаблон|1=вміст|вміст2}}
{{Шаблон|вміст2|1=вміст}}

  Насправді нумеровані параметри є іменованими параметрами, імена яких є послідовними номерами. Коли всі параметри у вихідному коді названі, то їхній порядок не має значення.

Значення за замовчуваннямРедагувати

У шаблонах, які приймають параметри, можна прописувати значення за замовчуванням. Вони створюються додаванням символу "|" перед потрійними фігурними дужками, що закривають параметр. Можливі три варіанти:

  • значення за замовчуванням відсутнє, наприклад, {{{1}}}, {{{назва міста}}} тощо. Якщо цей параметр не буде заповнений, шаблон відображатиме його назву.
  • порожнє значення за замовчуванням, наприклад, {{{1|}}}, {{{назва міста|}}} тощо. Якщо у включенні відповідний параметр не заповнений, шаблон, залежно від налаштувань, не покаже нічого або покаже порожній рядок.
  • прописуване значення за замовчуванням, наприклад, {{{1|100%}}}, {{{назва міста|Київ}}}, {{{2|{{{3}}}}}}, {{{2|{{{місто|}}}}}} тощо. Якщо відповідний параметр не заповнений, буде показано значення чи параметр після символу "|".

  Текст значення за замовчуванням прописується після символу "|". Це може бути порожнє місце, рядок символів, число, але й також інший параметр (він також може бути умовним параметром) або навіть шаблон з параметрами чи без.

Документація шаблонівРедагувати

Якщо шаблон достатньо специфічний і місткий, аби мати власну документацію, створіть її. Зазвичай створюється окрема підсторінка документації. Для цього використовується спеціальний шаблон {{Документація}} — до коду редагованого шаблону слід додати в кінці: <noinclude>{{Документація}}</noinclude>. Створена підсторінка документації шаблону має зватися /документація — українською, з малої літери[1].

Приклад: Нехай створюваний вами шаблон називається Шаблон:X. Тоді необхідно створити підсторінку з ім'ям Шаблон:X/документація і додати на ній опис використання шаблону та роботи його параметрів. Для відображення документації на сторінці шаблону на ній має бути проставлене включення шаблону {{Документація}} таким чином, як наведено в попередньому абзаці. Після цього на сторінці шаблону Шаблон:X у зеленому віконці відображатиметься його документація.

Якщо документація закоротка для створення окремої підсторінки, тобто її обсяг не перевищує двох-трьох рядків, використовуйте {{Документація|текст=}} — це не створює окрему сторінку документації, адже документація наводиться безпосередньо на сторінці редагованого шаблону. Така документація називається інлайн-документацією.

  Інлайн-документація не має містити лише категорії та інтервікі!

Нерідко буває, коли шаблон зазнає змін, а документація продовжує відображати застарілі особливості використання шаблону. Якщо ви помітили невідповідність між кодом шаблону та його документацією, будь ласка, виправіть її, якщо маєте розуміння та достатні вміння, або повідомте про це у технічній Кнайпі чи досвідченішим користувачам-редакторам шаблонів.

Шаблони і категоріїРедагувати

Категоризація шаблонівРедагувати

У процесі створення шаблону категоризуйте його за допомоги додавання коду: <noinclude>[[Категорія:Шаблони:<тема>]]</noinclude> щонайменше в одну з підкатегорій категорії «Шаблони».

Якщо в шаблону є сторінка документації, розмістіть категорію саме на сторінці документації. [⇨]

Категорії для шаблонівРедагувати

Категорії простору назв шаблонів називаються із префіксами штучного підпростору назв, через двокрапку. Нижче наведені приклади іменування категорій шаблонів із відповідними батьківськими категоріями:

Така стандартна схема іменування категорій значно спрощує пошук категорій і дозволяє автоматизувати маніпуляції з просторами назв (наприклад, див. Категорія:Шаблони для маніпуляцій з простором).

  В інших вікіпроектах (напр. англійська Вікіпедія) такого стандарту іменування категорій шаблонів не існує.

При створенні категорії шаблонів, будь ласка, позначте її шаблоном {{Категорія шаблонів}} або {{Навігація для категорій}} з їхніми відповідними параметрами.

Метакатегорії, або категорії-контейнери для шаблонівРедагувати

Категорії-контейнери або метакатегорії — це такі категорії, що містять лише підкатегорії і групують їх (підкатегорії) за певною ознакою.

Головні метакатегорії шаблонів:

Усі категорії шаблонів, які позначені шаблоном {{Категорія шаблонів}} потрапляють у метакатегорію спостереження Категорія:Категорії шаблонів Вікіпедії (2499).

Шаблони, що додають категоріюРедагувати

Деякі шаблони автоматично додають категорії на сторінки, у які вони включені. Для можливості вимкнення категоризації сторінки власного включення шаблон повинен обробляти стандартизований параметр |nocat= (аналог boolean типу даних, де умовою true є наявність будь-якого вмісту), який залишається невизначеним або визначеним порожнім. Його слід заповнювати лише при використанні шаблону на сторінках, на яких треба вимкнути автоматичну категоризацію цим шаблоном.

Списки шаблонівРедагувати

Для зручності користування, шаблони окрім категорій наведені також на оглядових сторінках (підсторінках цієї сторінки) та згруповані за темами, а також в категорії Категорія:Списки шаблонів (63).

  Усі розділи та шаблони в оглядових статтях мають сортуватися за темами, потім — за абеткою (спершу — латинські, за ними — кириличні).

Авторські праваРедагувати

АдмініструванняРедагувати

БагатозначністьРедагувати

Докладніше: Категорія:Шаблони багатозначності і перенаправлень (30)
Шаблон Вигляд
{{Disambig}}
{{DisambigG}}
{{DisambigF}}
(для прізвищ)
{{DisambigN}}
(для тезок і повних тезок)
{{Otheruses}}
{{Otherpersons|<ім'я та прізвище>}}
{{Othernames|<прізвище>}}
{{About|1|2|3}}
{{For|1|2|3}}
Шаблон Вигляд
{{Детальніше}}
Докладніше: [[|]]
{{Докладніше1}}

Детальніші відомості з цієї теми Ви можете знайти в статті {{{1}}}.

Недосконалість статейРедагувати

Шаблони для категорійРедагувати

Докладніше: Категорія:Шаблони простору назв категорій
Шаблон Вигляд
{{Categoryredirect}}
{{Категорія шаблонів}}
{{catmain template|Ім'я|Прізвище|para=кат=російське|і т.д.}}
{{catmain template|Категорія:Шаблони:Географія}}
{{category template notice|<шаблон , що додає сторінки до категорії>}}
{{catnav|space=a|topic=<Тема категорії>}}
(навігація між категоріями різних просторів назв на спільну тему)
Вікіпедія:Шаблони містить сторінки на тему «<Тема категорії>» з простору статей, вона не повинна містити сторінки з інших просторів назв.
Докладніше у статті [[<Тема категорії>]]
Категорії за темою «<Тема категорії>»:

СтильРедагувати

  • {{TOC right}} — TOC (зміст) плаваючий у правому верхньому куті, зручний для використання з довгими вузькими таблицями змісту.
  • {{2}}/{{3}}/{{4}} — шаблони для розбиття тексту на 2/3/4 стовпці.
  • {{Легенда}} — показує рядок легенди з кольоровим квадратиком.

МоваРедагувати

НавігаційніРедагувати

Категорія:Навігаційні шаблони (287) {{navbox}}



Наука

Україна

інформатика

Напої- {{Напій}} — Категорія:Шаблони:Напої (к:1 с:4)



КарткиРедагувати

Картки — шаблони, що наводять стандартизовану інформацію про предмет статті. Картки можуть бути «довільної форми» або частково автоматизовані на основі параметрів.

Використання шаблону-картки у будь-якій статті не є обов'язковим, але і не заборонене. Питання, чи використовувати шаблон-картку, яку шаблон-картку використовувати, та які частини картки використати, визначається через обговорення та прийняття консенсусного рішення серед редакторів, по кожній окремій статті.

Див. також

ЗагальніРедагувати

СпеціальніРедагувати

Спільнота ВікіпедіїРедагувати

Обговорення, голосуванняРедагувати

Смайлики:  {{Смайл}}!  {{Усмішка}}!  {{Не розумію}}!  {{Автор смалить}}

Юзербокси користувачівРедагувати

Категорія:Юзербокси (94) та її підкатегорії містять невеличкі шаблони, якими користувачі можуть заявити про приналежність до певної групи: за місцем народження, інтересами, внеском, і так далі й тому подібне. Див. списки юзербоксів за темами ↓

Шаблон Вигляд
{{Вікі-відпустка}}

Див. такожРедагувати

ПриміткиРедагувати