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

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

Скорочення

ВП:Ш

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

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

Щодо технічних подробиць див.Довідка:Шаблони.

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

Шаблони і категорії

Докладніше: Вікіпедія:Категоризація

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

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

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

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

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

тематичні шаблони: Категорія:Шаблони:<тема шаблонів> (метакатегорія Категорія:Шаблони за темою (22)
шаблони-картки: Категорія:Шаблони:Картки:<тема шаблонів> (метакатегорія: Категорія:Шаблони:Картки (252))
навігаційні шаблони: Категорія:Навігаційні шаблони:<тема шаблонів> (метакатегорія: Категорія:Навігаційні шаблони (114))
шаблони юзербоксів: Категорія:Юзербокси:<тема шаблонів> (метакатегорія: Категорія:Юзербокси (103))

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

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

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

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

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

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

Категорія:Шаблони за темою (22)
Категорія:Шаблони Вікіпедії за призначенням (20)
Категорія:Шаблони Вікіпедії за стилем (8)
Категорія:Шаблони Вікіпедії за простором назв (12)
Категорія:Вікіконтейнери (3) (для шаблонів, що створюють контейнери див. Категорія:Шаблони контейнерів (10)

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

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

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

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

Докладніше: Вікіпедія:Документація шаблонів

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

Створена підсторінка документації для шаблону має носити назву /документація — українською, з малої.^[1]

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

Параметри шаблонів

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

Параметр шаблону (тут — Вікімедіа-шаблону; також: аргумент шаблону, часто поле шаблону) — віківміст, послідовність символів, яка передається рушієм MediaWiki для подальшої обробки як параметр шаблону і оброблюється парсером, як рядок символів Unicode.

Стандарти назв параметрів шаблонів

У різних вікі прийняті чи усталені, як найрозповсюдженіші, різні конвенції називання параметрів. Слід зауважити, що назва параметра сприймається як повнорядковий ідентифікатор (пробіли на початку чи в кінці рядків як ідентифікаторів, так і вмісту іменованих параметрів відкидаються), тобто великі і малі літери в послідовності назви створюють окремі ідентифікатори, як і наявність символу підкреслення "_".

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

Списки шаблонів

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

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

Див. також:

Авторські права

Авторські права — шаблони авторських прав, які слід використовувати при завантаженні зображень, аудіо- та відеофайлів.
Категорія:Шаблони:Авторські права (84).

Адміністрування

Категорія:Адміністративні шаблони (78)
- Категорія:Шаблони блокування (12)

Багатозначність

Докладніше: Категорія:Шаблони багатозначності і перенаправлень (42)

Шаблон Вигляд

Вікіпедія:Шаблони — термін, який має кілька значень. Ця сторінка значень містить посилання на статті про кожне з них.
Якщо ви потрапили сюди за внутрішнім посиланням, будь ласка, поверніться та виправте його так, щоб воно вказувало безпосередньо на потрібну статтю.

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

{{DisambigF}}
(для прізвищ)

Ця сторінка або розділ перелічує людей із прізвищем Шаблони. Якщо внутрішнє посилання, що повинно вказувати на окрему особу, привело вас сюди, будь ласка, поверніться та виправте це посилання, додавши до нього особове ім'я людини.

{{DisambigN}}
(для тезок і повних тезок)

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

Щодо інших людей з таким самим іменем та прізвищем див. (ім'я та прізвище).

У Вікіпедії є статті про інших людей із прізвищем (прізвище).

Ця стаття про 1. Про 2 див. 3.

Про 1 див. 2 та 3.

Шаблон	Вигляд
{{Детальніше}}	Докладніше: [[\|]]
{{Докладніше1}}	Детальніші відомості з цієї теми ви можете знайти в статті {{{1}}}.

Недосконалість статей

Докладніше: Вікіпедія:Шаблони:Незавершені статті

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

Докладніше: Категорія:Шаблони простору назв категорій

Шаблон Вигляд

Цей шаблон має використовуватися лише на сторінках категорій.

Категорія:Шаблони (21 К, 411 С)

Ця категорія містить сторінки з простору назв шаблонів. Вона є частиною адміністрування Вікіпедії і не повинна використовуватися для категоризації статей або сторінок з іншого простору назв.

Використання

Аби помістити шаблон до цієї категорії:

1) якщо в нього існує підсторінка документації — додайте на ній між тегами <includeonly> і </includeonly> рядок [[Вікіпедія:Шаблони]].

2) якщо підсторінка документації шаблону відсутня — безпосередньо в код шаблону:

<noinclude>

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

</noinclude>.

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

{{catmain template|Ім'я|Прізвище|para=кат=російське|para2=кат=російське}}

Головні шаблони для сторінок цієї категорії {{Ім'я|кат=російське}}, {{Прізвище|кат=українське}}.

{{catmain template|Категорія:Шаблони:Географія}}

Головні шаблони для сторінок цієї категорії розташовані в категорії Категорія:Шаблони:Географія (77).

{{category template notice|<шаблон , що додає сторінки до категорії>}}

Аби помістити сторінку в цю категорію, додайте до неї шаблон {{[[Шаблон:<шаблон, що додає сторінки до категорії>|<шаблон, що додає сторінки до категорії>]]}}.

{{catnav|space=a|topic=<Тема категорії>}}
(навігація між категоріями різних просторів назв на спільну тему)

Вікіпедія:Шаблони містить сторінки на тему «<Тема категорії>» з простору статей, вона не повинна містити сторінки з інших просторів назв.

Докладніше у статті [[<Тема категорії>]]

Категорії за темою «<Тема категорії>»:

Стиль

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