Панель інструментів
Іншими мовами
Довідка:Шаблони
Шаблони у Вікіпедії є спеціальним класом сторінок, що їх вміст динамічно підставляється в текст інших сторінок при кожному їх перегляді.
Зміст |
[ред.] Загальна інформація
Сторінки шаблонів є повноцінними статтями для яких відведено власний простір імен «Шаблон:». У Вікіпедії їх дозволено правити усім користувачам.
Вікі-розмітка для виклику шаблону у статті:
{{Ім'я шаблону}}
При перегляді сторінки, замість цього тегу буде вставлено текст шаблону «Шаблон:Ім'я шаблону». Якщо шаблон ще не існує, то тег відображатиметься як «червоне» посилання на неіснуючу статтю. Щоб уникнути цього, переконайтесь перед збереженням сторінки що усі використані Вами шаблони існують, зробити це можна скориставшись функцією попереднього перегляду.
Якщо у головному просторі імен існує стаття із такою ж назвою що і ім'я шаблону, її можна використати як шаблон за допомогою наступної синтаксичної конструкції:
{{:Назва_статті}}
Якщо назва статті це зображення чи категорія, виклик шаблону поверне опис зображення чи категорії. Така можливість використовувати будь-яку статтю як шаблон дає змогу експериментувати із шаблонами не створюючи зайвих статей у просторі імен «Шаблон:» чи використовувати підписи та пояснення до зображень.
Пам'ятайте що назва статті чи шаблону чутлива до регістру.
Допускається рекурсивне включення шаблонів.
Значення змінних шаблону підставляються після того як шаблон буде вставлено в статтю, тобто, наприклад, якщо шаблон містить виклик змінної {{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}} дасть
{{ambox |type=protection |image=[[Image:Crystal Clear action configure.png|40px]] |text='''Ця {{#fffff3:{{NAMESPACE}} |=стаття |Обговорення=сторінка обговорення |Категорія=сторінка категорії |Довідка=сторінка довідки |Портал=сторінка порталу |Шаблон=сторінка шаблону |Користувач=сторінка користувача |Обговорення користувача=сторінка обговорення користувача |Wikipedia=сторінка проекту |Wikipedia talk=сторінка обговорення проекту }} <span style='color: blue'>в процесі редагування</span> {{{1|певний час}}}.''' <p><span style='color: blue'>Будь ласка, не редагуйте та не змінюйте її, оскільки Ваші зміни можуть бути втрачені</span>. |text-small=Якщо ця сторінка [{{fullurl:{{FULLPAGENAME}}|action=history}} давно не редагувалася] (кілька днів!), будь ласка приберіть цей шаблон.<p>Це повідомлення призначене для допомоги уникнення конфліктів редагування; будь ласка приберіть його між сеансами редагувань, щоб дати іншим користувачам можливість поліпшити цю сторінку. }}<includeonly>{{#f0f1ff:{{{категорія}}}|ні||[[Категорія:Статті в процесі редагування|!{{PAGENAME}}]]}}</includeonly><noinclude> [[Категорія:Шаблони:Недосконалі статті]] [[dsb:Pśedłoga:Bu wobźěłany]] [[eo:Ŝablono:Redaktas]] [[hsb:Předłoha:Bu wobdźěłany]] [[ru:Шаблон:Редактирую]]</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
Коли сторінка, викликана для включення, є сторінкою-перенаправленням, буде включено вміст сторінки на яку вказує редирект.
[ред.] Посилання на шаблон
Якщо використовуються посилання на шаблони як на звичайні статті, в цьому випадку передача параметрів неможлива.
[ред.] Історія змін для сторінок, що містять шаблони
При перегляді історичних версій статей, що містять шаблони і/або зображення, завжди використовується поточна версія шаблону та зображень, тобто автоматична «абсолютна» реконструкція історичних версій композитних текстів є неможливою.
