Довідка:Шаблони
Матеріал з Вікіпедії — вільної енциклопедії.
Шаблони у Вікіпедії є спеціальним класом сторінок, що їх вміст динамічно підставляється в текст інших сторінок при кожному їх перегляді.
Зміст |
[ред.] Загальна інформація
Сторінки шаблонів є повноцінними статтями для яких відведено власний простір імен «Шаблон:». У Вікіпедії їх дозволено правити усім користувачам.
Вікі-розмітка для виклику шаблону у статті:
{{Ім'я шаблону}}
При перегляді сторінки, замість цього тегу буде вставлено текст шаблону «Шаблон:Ім'я шаблону». Якщо шаблон ще не існує, то тег відображатиметься як «червоне» посилання на неіснуючу статтю. Щоб уникнути цього, переконайтесь перед збереженням сторінки що усі використані Вами шаблони існують, зробити це можна скориставшись функцією попереднього перегляду.
Якщо у головному просторі імен існує стаття із такою ж назвою що і ім'я шаблону, її можна використати як шаблон за допомогою наступної синтаксичної конструкції:
{{:Назва_статті}}
Якщо назва статті це зображення чи категорія, виклик шаблону поверне опис зображення чи категорії. Така можливість використовувати будь-яку статтю як шаблон дає змогу експериментувати із шаблонами не створюючи зайвих статей у просторі імен «Шаблон:» чи використовувати підписи та пояснення до зображень.
Пам'ятайте що назва статті чи шаблону чутлива до регістру.
Допускається рекурсивне включення шаблонів.
Значення змінних шаблону підставляються після того як шаблон буде вставлено в статтю, тобто, наприклад, якщо шаблон містить виклик змінної {{PAGENAME}}, вона поверне як значення назву статті у яку підставлено шаблон, а не ім'я шаблону.
При редагуванні сторінки внизу під віконцем редагування відображається список використаних у статті шаблонів, причому він відображатиметься навіть якщо редагується лише секція статті що не містить викликів шаблонів. Якщо шаблони викликаються рекурсивно, у цей список попадуть як шаблони верхнього, так і нижніх рівнів.
[ред.] Параметри шаблонів
Параметри шаблону застосовують в тому разі, коли необхідно передбачити можливість дописати в шаблон певну інформацію, оригінальну для кожної даної статті. Шаблон може не використовувати жодного параметру (наприклад шаблон:noimg), використовувати один параметр (наприклад шаблон:Messier) або використовувати багато параметрів (наприклад шаблон:Зображення).
Параметри шаблону можуть бути іменованими чи нумерованими. Варіанти синтаксису
- {{templatename|parname1=parvalue1|parname2=parvalue2}},
тоді у тексті шаблону слід посилатися на {{{parname}}};
- {{templatename|parvalue1|parvalue2}}, тоді у тексті шаблону слід використовувати {{{1}}}, {{{2}}}.
Зайві параметри (що не використовуються в тексті шаблону) ігноруються. Імена параметрів чутливі до регістру, пробілів, підкреслень та інших символів не з набору [a-z\-A-Z0-9] не допускаються.
Зверніть увагу на потрійні фігурні дужки при використанні параметрів!
Таким чином, механізм шаблонів виконує два типи підстановок:
- виклик шаблону (подвійні фігурні дужки) підмінюється вмістом шаблону;
- параметри шаблону (потрійні фігурні дужки) підмінюються значеннями параметрів шаблону.
Параметром шаблону може бути посилання на іншу статтю. Нехай наприклад в нас є Шаблон:
Початок {{{1}}} Кінець.
Тоді {{Шаблон| [[Main_Page|Головна сторінка]]}} буде розгорнуто в
Початок Головна сторінка Кінець.
Якщо деякий параметр «someparameter» не визначено, він передається нерозкритим текстом {{{someparameter}}} у викликаючу статтю, у випадку рекурсивного виклику його можна розкрити на наступному рівні.
Зауважте наступну різницю у викликах: виклик {{Шаблон||a}} встановлює значення першого параметру рівним порожній стрічці. Щоб присвоїти значення другому параметру не визначаючи значення першого скористайтесь викликом {{Шаблон||2=a}}.
Також, виклик {{Шаблон|a=b|c}} визначить параметр "a" і не встановить параметр "1", щоб правильно визначити обидва параметри, скористайтесь наступною синтаксичною конструкцією {{Шаблон|1=a=b|2=c}}.
[ред.] Перегляд вмісту шаблону
Переглядайте текст шаблону в режимі редагування, оскільки на простому перегляді змінні та інші шаблони, наприклад Шаблони, будуть замінені їх значеннями.
[ред.] Теги noinclude та includeonly
Ці теги застосовуються для відокремлення тексту, що має відображатись лише в самому шаблоні, але не відобпражатися в статтях, в які цей шаблон включено або навпаки.
Наприклад, для розміщення у шаблоні додаткової інформації - наприклад правил використання шаблону або категорії шаблону, яка не повинна відображатись в статтях, в яку включається даний шаблон, таку інформацію слід розмістити наступним чином: <noinclude>Додаткова інформація (''наприклад'': шаблон використовується для...)</noinclude>. В протилежному випадку - якщо нам слід закласти в шаблон інформацію, яка має відображатись в статтях, в яких цей шаблон включається, але не повинна впливати на сам шаблон (найчастіше це - категоризація статті) - слід писати <includeonly>Додаткова інформація, (''наприклад:'' [[Категорія статті]]) </includeonly>
[ред.] msgnw
Щоб переглянути текст шаблону можна також скористатися «чарівним» префіксом «msgnw:».
Наприклад: {{edited}} дасть
 |
Ця стаття в процесі редагування. Будь ласка, не редагуйте та не змінюйте її, оскільки Ваші зміни можуть бути втрачені. |
{{msgnw:edited}} дасть
{| align=center border=0 cellpadding=4 cellspacing=4 style="border: 1px solid #CC9; background-color: #FFFFF" |- | [[Зображення:Litkonkurs.jpg|50px]] | style="font-size: 90%" | '''Ця стаття в процесі редагування. Будь ласка, не редагуйте та не змінюйте її, оскільки Ваші зміни можуть бути втрачені.''' |} <includeonly>[[Категорія:Статті в процесі редагування]]</includeonly> <noinclude>[[Категорія:Шаблони:Недосконалі статті]]</noinclude>
[ред.] Посилання на редагування шаблону
Іноді бажано мати посилання на сторінку редагування шаблону в тексті самого шаблону(наприклад, якщо його вміст може часто змінюватися). Таке посилання можна «зашити» всередину самого шаблону, більш того, зробити саме шаблоном. Див. Шаблон:ed, приклад використання: {{ed|{{PAGENAMEE}}|{{NAMESPACE}}:{{PAGENAME}}}} дасть ред. Довідка:Шаблони.
[ред.] Обмеження й можливості
[ред.] Використання вкладених подвійних чи потрійних фігурних дужок всередині подвійних вкладених дужок
[ред.] Тег категорії в шаблоні. Проблема кешування
Якщо шаблон містить тег категорії, то у зазначену категорію відноситься не тільки шаблон, але також усі сторінки що його використовують, тому шаблони зручно використовувати для рубрикації статей.
З цим підходом пов'язана проблема кешування — якщо змінити категорію у шаблоні, статті де він використовуються будуть віднесені до нової категорії тільки після збереження будь-яких редагувань цих статей(важливим є збереження змін, саме редагування може бути порожнім).
Рекомендується використовувати категорії у шаблонах типу {{TODO}} для «маркування» статей певного типу, та не рекомендується використання у навігаційних шаблонах.
[ред.] Кешування
Редагування шаблону автоматично очищає кеш сервера від усіх статей що безпосередньо його використовують. Однак у випадах непрямого виклику (рекурсивний виклик, шаблони які залежать від параметрів і т.д.), внутрішній кеш системи не очищується і стандартний «Refresh» браузера може не працювати. У таких випадках використовуйте «action=purge», тобто переходьте по URL типу:
[{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAMEE}}|action=purge}} Очистити кеш сторінки]
що буде відображено як
Або Ви можете просто скористатися готовим шаблоном Шаблон:Purge: purge.
[ред.] subst
Використання «subst:» після подвійних фігурних дужок матиме наслідком підстановку тексту шаблону чи значення змінної на момент збереження сторінки у якій вони використовується.
Наприклад «timestamp»:
{{subst:CURRENTDAY}} {{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}, {{subst:CURRENTTIME}} (UTC)
підставиться при збереженні, як:
13 вересня 2005, 16:24
Тоді як
{{subst:Welcome}}
що використовується для привітання нових користувачів, відобразиться так:
[ред.] Див. також
Довідка:Шаблони:Приклад використання шаблону userbox
[ред.] Ласкаво просимо!
Вітаємо Вас в українській частині Вікіпедії. Щиро дякуємо за вже зроблений внесок до її покращення. Для початку пропонуємо переглянути деякі корисні поради:
- Краш-курс для новачків
- Поради для новачків
- Детальні довідки і поради
- Портал Спільноти
- Як редагувати статтю
- Як і для чого ми розвиваємо Вікіпедію
Сподіваємося, що Ви візьмете участь у подальшій роботі нашого спільного відкритого проекту. Ви можете ставити автоматичний підпис на сторінках обговорень за допомогою чотирьох знаків (~~~~). Якщо виникли запитання про проект, пошукайте відповідь на сторінці Вікіпедія:Довідка. Якщо відповідь на Ваше питання там відсутня, задайте запитання у Кнайпі чи комусь із постійних дописувачів. Ви також можете розповісти про свої інтереси на сторінці Вікіпедія:Інтереси учасників. Бажаємо успіхів!
Коли сторінка, викликана для включення, є сторінкою-перенаправленням, буде включено вміст сторінки на яку вказує редирект.
[ред.] Посилання на шаблон
Якщо використовуються посилання на шаблони як на звичайні статті, в цьому випадку передача параметрів неможлива.
[ред.] Історія змін для сторінок що містять шаблони
При перегляді історичних версій статей, що містять шаблони і/або зображення, завжди використовується поточна версія шаблону та зображень, тобто автоматична «абсолютна» реконструкція історичних версій композитних текстів є неможливою.
