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

Матеріал з Вікіпедії — вільної енциклопедії.
Перейти до навігації Перейти до пошуку
Скорочення
ВП:Ш

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

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

Використання[ред. код]

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

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

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

Включення[ред. код]

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

Transclusion-multiple-foo.svg

Підстановка[ред. код]

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

Параметри[ред. код]

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

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

Типи параметрів[ред. код]

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

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

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

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

Іменовані[ред. код]

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

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

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

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

Нумеровані[ред. код]

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

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

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

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

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

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

Документація шаблонів[ред. код]

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

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

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

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

Шаблони і категорії[ред. код]

Категоризація шаблонів[ред. код]

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

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

Категорії для шаблонів[ред. код]

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

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

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

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

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

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

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

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

Шаблони, що додають категорію[ред. код]

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

Списки шаблонів[ред. код]

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

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

Авторські права[ред. код]

Адміністрування[ред. код]

Багатозначність[ред. код]

Докладніше: Категорія:Шаблони багатозначності і перенаправлень (24)
Шаблон Вигляд
{{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 стовпці.
  • {{Легенда}} — показує рядок легенди з кольоровим квадратиком.

Мова[ред. код]

Навігаційні[ред. код]

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



Наука

Україна

інформатика

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



Картки[ред. код]

{{Картка}}
Категорія:Шаблони:Картки (к:17 с:173)

Загальні[ред. код]

Службові[ред. код]

Спільнота Вікіпедії[ред. код]

Обговорення, голосування[ред. код]

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

Юзербокси користувачів[ред. код]

Категорія:Юзербокси (95)

Користувачі, що ведуть блоги[ред. код]
Шаблон Вигляд
{{Користувачі, які мають свою веб-сторінку}}
WorldWideWeb
Цей користувач має власну Веб-сторінку
{{Вікі-відпустка}}

Див. також[ред. код]

Примітки[ред. код]