Перейти до вмісту

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

Матеріал з Хабадпедії
Редагування статей

Посібники з редагування

Додавання елементів на сторінку:

Інше:

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

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

Створення нового шаблону

Зверніть увагу: для створення нового шаблону в Хабадпедії і для внесення суттєвої зміни до наявного шаблону слугує сторінка Хабадпедія:Шаблон/Зал обговорень. Перш ніж відкривати обговорення, рекомендується порадитися щодо наявності шаблону або потреби в новому шаблоні на сторінці Хабадпедія:Довідковий стіл.

Технічне пояснення

Створення шаблону
Шаблон — це один із типів сторінок, що існують у Хабадпедії: щоб створити новий шаблон, потрібно створити нову сторінку, до якої буде внесено вміст шаблону (див. пояснення за посиланням). Шаблон розташований у просторі назв «Шаблон:».
Включення шаблону до статті
На будь-якій іншій сторінці, куди ви хочете додати (вміст) шаблону, напишіть у потрібному місці текст {{שם התבנית הרצויה}}. Вміст, який ви внесли до шаблону, з'явиться там під час попереднього перегляду або після збереження сторінки.

Приклад: якщо хочуть написати шаблон під назвою «חדש», потрібно написати:

[[תבנית:חדש]]

Після запису отримуємо такий результат:

Шаблон:Новий

Натискання на посилання відкриє нову сторінку редагування. Її потрібно редагувати, як будь-яку звичайну сторінку, і зберегти після закінчення редагування.

У кожному місці, куди хочуть додати шаблон, потрібно написати текст: :{{חדש}}

Основні принципи проєктування шаблонів

  • Для створення нового шаблону в Хабадпедії або для внесення суттєвої зміни до наявного шаблону слугує сторінка «Хабадпедія:Шаблон/Зал обговорень».
  • Перш ніж відкривати обговорення, рекомендується порадитися щодо наявності такого шаблону або потреби в новому шаблоні на сторінці «Хабадпедія:Довідковий стіл».
  • Як правило, навігаційні шаблони вноситимуться до простору статей тільки тоді, коли від них є користь для навігації, тому шаблон, у якому немає принаймні 5 наявних (синіх) статей, не показуватиметься в просторі статей. Крім того, вони мають відповідати правилам Хабадпедія:Петля теми.
  • Для параметрів, поширених у багатьох шаблонах, прийнято використовувати однакові назви, щоб полегшити роботу редакторам і забезпечити одноманітне використання, наприклад:
    • תמונה, כיתוב תצלום, צילום מסך, תמונה מייצגת, כיתוב, כותרת תמונה, תיאור תמונה
    • סמל, כיתוב סמל לוגו, סמליל, תמונה, כיתוב, כיתוב לוגו
    • מפה, כיתוב מפה תצלום, תמונה, כיתוב, כותרת מפה, תיאור מפה
  • Рекомендації щодо включення даних із Вікіданих — і особливо потрібно давати змогу локально перевизначати поля, що беруться з Вікіданих.
  • У навігаційних шаблонах, які прийнято включати внизу статей, прийнято використовувати Шаблон:Навігація або Шаблон:Навігація за групами, які дають змогу досягти одноманітності у зовнішньому вигляді навігації й дають чітку рамку, що створює ясну відмінність між шаблоном і вмістом статті.

Після створення шаблону

Після створення шаблону потрібно створити належну документацію, щоб полегшити його використання. Докладніше див. розділ нижче.

Новий шаблон слід віднести до відповідної категорії. Слід звернути увагу, що одна категорія потрібна для віднесення шаблону до категорій шаблонів, а інша категорія може додаватися шаблоном тільки на сторінках, до яких його додали (наприклад, сторінки для обслуговування).

Щоб дізнатися, як додати категорію тільки на сторінки, до яких включено шаблон, натисніть на посилання.

Підсумок процесу

Примітка – це рекомендований порядок етапів. Не обов'язково дотримуватися встановленого порядку, але для затвердження використання шаблону потрібно отримати схвалення в залі шаблонів.

  1. Перевірка потреби — довідковий стіл
  2. Пропозиція в Хабадпедія:Шаблон/Зал обговорень – обов'язково (важливе зауваження – для відкриття обговорення не обов'язково потрібні технічні знання. Обговорення призначене для розв'язання проблеми)
  3. Створення технічного рішення (бажано спершу на сторінці чернетки або на підсторінці)
  4. Документація для учасників та інших редакторів
  5. Підготовка до широкого використання – адаптація до системи перевірки параметрів
  6. Забезпечення доступності шаблону – адаптація до майстра шаблонів, публікація на відповідних сторінках

Різні способи додавання шаблону на сторінку й посилання на нього

Посилання на кшталт {{שם התבנית הרצויה}} вставить вміст шаблону на сторінку, тоді як посилання на кшталт [[תבנית:שם התבנית הרצויה]] буде внутрішнім посиланням, що веде на сторінку шаблону.

Копіювання вихідного коду шаблону

Додавання напису ס: перед назвою шаблону (або назвою сторінки, коли вона взята у фігурні дужки) спричиняє копіювання сторінки цілком зі сторінки-джерела, одноразово й без оновлення, так що під час повторного перегляду сторінки редагування неможливо буде дізнатися, що використовувався якийсь шаблон. Наприклад, якщо взяти шаблон {{@}}, додавання ס: матиме такий вигляд:

{{ס:@}}

А результат матиме такий вигляд:

-at-

А код під час редагування матиме такий вигляд:

[[קובץ:@@@.svg| -at- |link=|13px]]

Щоб проілюструвати ідею, можна зайти в пісочницю, додати туди шаблон {{@}}, а потім зберегти сторінку. Цей шаблон додає невелике зображення у вигляді знака «@». Якщо ми знову відкриємо пісочницю для редагування, то знайдемо доданий нами текст (тобто назву шаблону) без змін. Тепер додамо ס: після фігурних дужок і перед назвою шаблону (у цьому випадку назва шаблону — «@») і збережемо сторінку вдруге. Сторінка, як і раніше, показується й виглядає без змін, однак якщо ми знову ввійдемо в режим редагування сторінки, то виявимо, що збережений текст змінився, і тепер з'являється сам текст, який викликає появу зображення, – текст, що міститься у вихідному коді на сторінці шаблону {{@}}.

Цією можливістю можна користуватися у випадках, коли немає потреби знову оновлювати текст і вся мета – заощадити дію «копіювати-вставити». Масове використання ס: там, де немає потреби в оновлюваному шаблоні, може зменшити навантаження на сервери Хабадпедії. З іншого боку, недолік – відсутність динамічності в цієї функції: якщо на сторінці шаблону буде зроблено правку, зміна не відобразиться (не оновиться) на сторінці, куди було скопійовано шаблон. Тому використовувати цю функцію в навігаційних шаблонах у статтях не рекомендується.

Існує також невелика кількість шаблонів, які вимагають використання цієї можливості, наприклад {{הבהרת חשיבות}} або {{ציר זמן}}, — без використання цієї можливості вони не показуватимуться належним чином.

Вихідна іноземна назва ס: — subst:.

Порівняння

Нижче наведено порівняння звичайного шаблону й шаблону з префіксом ס::

Спосіб запису Відображення під час перегляду Вигляд сторінки редагування

{{אחרי התנגשות}}

Додав після конфлікту редагувань —

{{אחרי התנגשות}}

{{ס:אחרי התנגשות}}

Додав після конфлікту редагувань —

<span style="font-size: 75%">הוספתי לאחר התנגשות עריכה -</span>

Сторінки перенаправлення

Щойно створюють сторінку-перенаправлення з одного шаблону на інший шаблон, Хабадпедія звертатиметься до шаблону, що є ціллю сторінки-перенаправлення. Наприклад, запис шаблону {{עריכה}} або шаблону {{לעריכה}}, що перенаправляє на нього, призведе до одного й того самого результату.

Використання звичайної сторінки як шаблону

Будь-яку сторінку можна використовувати так, ніби вона є шаблоном, за допомогою Узяття її назви у дві фігурні дужки й додавання : (двокрапки) перед назвою:

{{:שם ערך}}

Наприклад, якщо ви хочете скопіювати весь вміст статті «Іврит» на певну сторінку, напишіть на цільовій сторінці текст:

{{:עברית}}

Зверніть увагу на знак двокрапки ( : ), що стоїть перед назвою статті («Іврит», у цьому випадку). Якщо у статті «Іврит» буде зроблено зміну, зміна відобразиться (оновиться) автоматично й на цільовій сторінці, без того щоб на ній було зроблено якусь зміну.

Подібним чином можна копіювати вміст інших сторінок, що не перебувають в основному просторі (просторі статей). Наприклад, щоб скопіювати весь вміст сторінки довідкового столу на певну сторінку, потрібно написати на ній такий текст:

{{חב"דפדיה:דלפק יעוץ}}

Зверніть увагу, що в цьому випадку не було додано двокрапку перед словом «Хабадпедія:». Подібним чином можна копіювати тексти з інших просторів назв, таких як «Учасник:», «Категорія:», «Обговорення Хабадпедії:» тощо.

Включення підсторінки до батьківської сторінки

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

Наприклад, щоб включити до сторінки «Шаблон:Навігація за групами» вміст підсторінки «Шаблон:Навігація за групами/Інструкція з використання», досить написати в ній:

{{/הוראות שימוש}}

І в разі такого використання шаблонів можна використовувати ס: і параметри.

Майстер шаблонів

Основна стаття – Довідка:Майстер шаблонів

Один із найпростіших способів додати (складний) шаблон на якусь сторінку — за допомогою «Майстра шаблонів»; особливо якщо до шаблону додано спеціальну документацію та підтримку для майстра (див. «Майстер шаблонів» у розділі «Документація шаблону»):

  • Щоб скористатися майстром, перебуваючи в режимі редагування, потрібно натиснути кнопку на верхній панелі інструментів. Майстер відкриє вікно, що дає змогу ввести назву потрібного шаблону зі списку. Після натискання на «Підтвердити» ви потрапите до самого майстра.
  • Або можна виділити весь шаблон, включно з усіма вже заповненими в ньому параметрами. Майстер збере ці значення зі сторінки, заповнить відповідні поля й покаже вам майстер.

Додаткові відомості можна прочитати в основній статті.

Редагування шаблону

Наявний шаблон можна відредагувати, знайшовши сторінку шаблону й натиснувши «Редагувати код» угорі сторінки, як і будь-яку сторінку, відкриту для редагування в Хабадпедії.

Ще один спосіб редагування шаблону – редагування сторінки, що містить шаблон: під областю редагування (під кнопками збереження й попереднього перегляду) натискання на заголовок «Шаблони, використані на цій сторінці:» відкриє список усіх шаблонів, що трапляються на сторінці (зокрема тих, які не включено й не написано явно на сторінці! Тобто шаблонів, що містяться всередині коду шаблонів, написаних на сторінці).

Зверніть увагу: слід враховувати, що внесення зміни до наявного шаблону вплине на багато сторінок, тому потрібно добре впевнитися, що зміна не порушує відображення шаблону або його роботу!

Спеціальні знаки

Деякі знаки потрібно записувати особливим чином, щоб вони з'явилися у вмісті шаблону:

Знак Спосіб запису в шаблоні
:
&#58;
;
&#59;
*
&#42;
#
&#35;

Знак | (вертикальна риска) розділяє параметри в шаблоні (див. нижче). Коли потрібно додати цей знак до вмісту шаблону, замість нього слід написати сполучення {{!}}. Приклад: щоб включити до шаблону текст «האולימפיאדה || מדליית זהב לספורטאי ישראלי», потрібно написати האולימפיאדה {{!}}{{!}} מדליית זהב לספורטאי ישראלי.

Ще один спосіб – використати тег <nowiki>XXXXX</nowiki>, так:Олімпіада <nowiki>||</nowiki> золота медаль ізраїльському спортсмену.

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

Визначення параметрів шаблону

Можна створювати прості шаблони, що містять заданий постійний текст, без можливості учасника впливати на їхній вміст і спосіб їх відображення. Більш просунута можливість – створювати шаблони з параметрами, для загальнішого використання, на вміст або оформлення яких можна по-різному впливати на кожній сторінці, де з'являється шаблон (точніше – у кожному «входженні» шаблону, оскільки один і той самий шаблон може використовуватися й з'являтися кілька разів на одній сторінці). Спосіб створення параметричного шаблону ідентичний створенню звичайного шаблону, і тому потрібно виконати всі кроки, описані в розділі «Створення нового шаблону». Існують два типи параметрів: іменований параметр і нумерований параметр.

Іменований параметр

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

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

{{{שם הפרמטר}}}

Використання параметра на цільовій сторінці відбуватиметься в такому порядку:

  1. Дві відкривні фігурні дужки (праві) (}})
  2. Назва шаблону
  3. Символ-роздільник — вертикальна риска (|)
  4. Назва параметра
  5. Знак рівності (=)
  6. Значення параметра
  7. Дві закривні фігурні дужки (ліві) ({{)

Для кожного додаткового параметра потрібно повторити кроки 3–6.

Приклад синтаксису шаблону з трьома параметрами:

{{שם תבנית|פרמטר1=ערך1|פרמטר2=ערך2|פרמטר3=ערך3}}

Практичний приклад шаблону з двома параметрами:

{{חדש|תמונה=פרפר.jpg|שם=משפחת הפרפרים}}

Наведений вище текст можна розгорнути й вертикально — у разі, коли параметрів багато або їхні значення довгі, — щоб поліпшити читабельність коду й полегшити орієнтування в ньому. Це ніяк не впливає на результат і на остаточний вигляд шаблону. Рекомендується стежити за тим, щоб розділові риски (|) розташовувалися на початку кожного рядка параметра. Приклад синтаксису:

{{שם תבנית
|פרמטר1=ערך1
|פרמטר2=ערך2
|פרמטר3=ערך3
}}

Нумерований параметр

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

{{{1}}}

У шаблоні, у якому є параметри {{{1}}}, {{{2}}} і {{{3}}}, звичайна форма запису на цільовій сторінці (за винятком особливих випадків (див. нижче)) не буде:

{{שם התבנית|1=ערך1|2=ערך2|3=ערך3}}

а так:

{{שם תבנית|ערך1|ערך2|ערך3}}

Наприклад:

{{חדש|פרפר.jpg|משפחת הפרפרים}}

Недолік використання такого шаблону в тому, що за великої кількості параметрів важко запам'ятати призначення й правильне місце кожного параметра, і легко переплутати порядок. З іншого боку, такий шаблон швидший у використанні (потрібно набирати менше символів) і позбавляє зайвої «бюрократії». Рекомендується використовувати цю форму тільки тоді, коли використовуються нечисленні параметри. Ще один недолік використання нумерованих параметрів — неможливо ввести знак рівності (=). Наприклад, у шаблоні {{חדש|פרפר.jpg|משפחת הפרפרים=butterfly family}} немає іменованих параметрів, однак шаблон сприйме «משפחת הפרפרים» як назву параметра, а «butterfly family» — як введене в нього значення, але, звісно, не знайде параметра з назвою «משפחת הפרפרים» і видасть повідомлення про помилку. Щоб обійти цю проблему, можна замість знаків рівності ввести такий код:

&#61;

Або використати шаблон із назвою «=»:

{{=}}

Як альтернативу можна поводитися з нумерованим параметром так, ніби він є іменованим параметром, і вказувати його явно під час використання шаблону: {{חדש|פרפר.jpg|‏2=משפחת הפרפרים = butterfly family}}

В одному шаблоні можна поєднувати іменовані й нумеровані параметри разом. Наприклад:

{{שם תבנית|חיה=חתול|2=שחור|מין=זכר|מבוית}}

Задання значення за замовчуванням для параметра

Для параметра можна задати значення за замовчуванням, так що коли до параметра не буде введено значення, з'явиться текст за замовчуванням. Щоб задати значення за замовчуванням для якогось параметра, наприклад для {{{שם הסרט}}}, потрібно додати вертикальну риску (|) після назви параметра, а за нею — текст за замовчуванням у такий спосіб:

{{{שם הסרט|טקסט ברירת מחדל}}}

Поширений приклад використання значення за замовчуванням — використання постійних системних шаблонів, таких як {{שם הדף בלי הסוגריים|}}, що повертає назву сторінки. Код:

{{{שם הסרט| {{שם הדף בלי הסוגריים|}} }}}

Дає змогу редакторам заповнити назву фільму, а якщо цей параметр залишився порожнім, замість параметра буде використано назву сторінки (без дужок).

Перевірка наявності параметра

Основна стаття – Довідка:Умовні оператори#Умова

Щоб перевірити, чи було шаблону передано параметр, можна виконати перевірку за допомогою такого умовного оператора:

{{#if: {{{param|}}} | Hooray...! | Darn...! }}

Результат: Darn...!

Або івритом:

{{#תנאי: {{{פרמטר|}}} | יש ערך...! | אין ערך...! }}Результат: אין ערך...!

У першому параметрі отримуємо результат, коли значення є, а в другому — коли значення немає.

Зміна параметрів у наявному шаблоні

Зверніть увагу: якщо в наявному шаблоні змінюють кількість параметрів або змінюють їхній порядок, зміна проявиться на всіх сторінках, до яких шаблон було вставлено до зміни, і це може призвести до непередбачених і небажаних результатів, таких як: вирвання речей із контексту, поява зайвого тексту, порушення в компонуванні шаблону й тексту і навіть помилка й повне невідображення шаблону. Варто серйозно обміркувати це під час зміни шаблону, і тим самим можна запобігти проблемі раніше, ніж вона виникла. Згідно з правилами Хабадпедії, також потрібно порадитися про це на сторінці Хабадпедія:Шаблон/Зал обговорень.

Задання шаблону як параметра

Якщо є параметри, що повторюються в кількох шаблонах, або технічно складна частина (наприклад, карта розташування), можна створити новий шаблон, який слугуватиме параметром і тим самим полегшить роботу користувачам шаблону. Новий шаблон фактично є модулем, своєрідною «чорною скринькою», до якої можна вставляти параметри, і користувачам не важливо, як він працює. Шаблон, що приймає шаблон як параметр, називається модульним шаблоном (наприклад: модульний шаблон {{משגר}} з модулем {{שלב במשגר}}).

Вміст, який показуватиметься тільки на сторінці шаблону або тільки на сторінках, що містять шаблон

Вміст, який показуватиметься тільки на сторінці шаблону

Іноді потрібно, щоб певний вміст показувався тільки на сторінці шаблону, а не на сторінках, що його містять (наприклад, пояснення щодо використання шаблону, категорія шаблону, інтервікі-посилання або голосування за вилучення шаблону). У цих випадках потрібно використовувати тег <noinclude> (івритом: не/не включай) у такий спосіб:

<noinclude>Вміст, який показується тільки в шаблоні, а не на сторінках, що його містять.</noinclude>

Зверніть увагу: під час використання тега <noinclude> слід упевнитися, що він розташований упритул до останнього символу, який має бути включено до сторінок, що містять шаблон. Наприклад, розміщення тега <noinclude> після переведення рядка призведе до включення зайвого порожнього рядка до сторінок, що містять шаблон, і може навіть спричинити проблеми верстки між текстом статті й таблицею, узятою із шаблону.

Прихований коментар у шаблоні

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

<noinclude><!-- текст примітки --></noinclude>

І це для того, щоб запобігти включенню прихованого тексту (призначеного для програміста) під час кожного вбудовування шаблону до сторінок Хабадпедії.

Вміст, який показуватиметься тільки на сторінках, що містять шаблон

Іноді потрібне зворотне становище: щоб певний вміст показувався або включався до сторінок, що містять шаблон, але не на самій сторінці шаблону (наприклад, категорії обслуговування – немає потреби, щоб сам шаблон з'являвся у списку сторінок, які потрібно обслуговувати, а тільки сторінки, до яких його додано (для цього можна скористатися також шаблоном: {{קטגוריה בתבנית}})). У цих випадках потрібно використовувати тег <includeonly> (івритом: включай тільки) у такий спосіб:

<includeonly>Вміст, який не показується на сторінці шаблону, але показується на сторінках, що його містять.</includeonly>

Рекомендація: як правило, оскільки сторінку шаблону прийнято відкривати відразу кодом шаблону (до документації та інструкцій із використання), рекомендується починати будь-який запис шаблону з тега <includeonly>.

Перевірка впливу змін у шаблоні на інші сторінки ще до його збереження

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

  1. Попередній перегляд сторінки з цим шаблоном — нова можливість, додана під час редагування сторінок у просторі шаблонів, що з'являється внизу сторінки редагування (під звичайними кнопками збереження). Ця можливість — найпростіша й найшвидша з двох.
  2. Пісочниця шаблонів — це службова сторінка, що дає змогу перевіряти шаблони, збережені в особистій чернетці учасника. Ця можливість складніша, але особливо корисна для перевірки змін у багатьох шаблонах одночасно.

Перший інструмент дуже простий у використанні: під час редагування шаблону під кнопками збереження внизу сторінки з'явиться додаткове вікно під заголовком «Попередній перегляд сторінки з цим шаблоном». У цьому вікні є єдине поле — «Заголовок сторінки», до якого можна ввести назву статті або сторінки, де використовується шаблон, і побачити, як зроблена в ньому зміна відображається на сторінці й впливає на неї.

Додаткові відомості й інструкції з використання також і другого інструмента див. в основній статті: «Довідка:Пісочниця для шаблонів».

Таблиці

Цей розділ неповний. Будь ласка, зробіть внесок у Хабадпедію й доповніть його. Можливо, подробиці про це є на сторінці обговорення. Причина: наведені приклади надто складні. Потрібно додати до кожного рядка пояснення його складових частин та їхнього призначення.
Основна стаття – Довідка:Таблиці

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

{{{שם הסרט}}}
Жанр {{{ז'אנר}}}
Тривалість {{{אורך}}}
Дата виходу {{{תאריך השקה}}}
{{{אתר אינטרנט}}}

Таблиця використовує два основні засоби: шаблон {{!}}, який показує вертикальну риску (|), і умовний оператор вигляду {{#תנאי:הפרמטר לבדיקה|מה לכתוב אם הפרמטר קיים|מה לכתוב אם הפרמטר אינו קיים}} (див. розділ «Перевірка наявності параметра»).

Покажемо на прикладі, як побудувати впорядковану таблицю: ми хочемо створити таблицю ліворуч для статей про фільми. Як видно, у цій таблиці показуються всі клітинки. Тепер змінимо всі параметри, крім параметра «назва фільму», так, щоб, якщо вони будуть порожніми, їхній рядок узагалі не показувався.

• Для кожного рядка, у якому два стовпці, потрібно використовувати такий код:

{{#תנאי:{{{פרמטר|<noinclude>-</noinclude>}}} |
{{!}} פרמטר
{{!}} {{{פרמטר}}}
{{!}}-
}}

При цьому напис «параметр» потрібно замінити назвою параметра.

• В останньому рядку, з параметром «אתר אינטרנט», є тільки один стовпець, вміст якого вирівняно по центру. Для рядків такого типу використовуємо такий код:

{{#תנאי:{{{פרמטר|<noinclude>-</noinclude>}}} |
{{!}} colspan="2" סגנון {{!}} {{{פרמטר}}}
{{!}}-
}}

При цьому напис «параметр» потрібно замінити назвою параметра, а напис «стиль» — потрібним стилем; у нашому випадку — вирівнюванням по центру.

• Нарешті, що стосується першого параметра, використовуємо значення за замовчуванням, так що коли назву фільму не задано, ми використовуємо замість неї назву статті. Повний код для цього прикладу та його результат – нижче:

{| class="wikitable" align="right"
! colspan="2" | {{{שם הסרט| {{שם הדף בלי הסוגריים|}} }}}
{{!}}-
{{#תנאי:{{{ז'אנר|<noinclude>-</noinclude>}}} |
{{!}} ז'אנר
{{!}} {{{ז'אנר}}}
{{!}}-
}}
{{#תנאי:{{{אורך|<noinclude>-</noinclude>}}} |
{{!}} אורך
{{!}} {{{אורך}}}
{{!}}-
}}
{{#תנאי:{{{תאריך השקה|<noinclude>-</noinclude>}}} |
{{!}} תאריך השקה
{{!}} {{{תאריך השקה}}}
{{!}}-
}}
{{#תנאי:{{{אתר אינטרנט|<noinclude>-</noinclude>}}} |
{{!}} colspan="2" style="text-align: center;" {{!}} {{{אתר אינטרנט}}}
}}
|}
Шаблони
Жанр {{{ז'אנר}}}
Тривалість {{{אורך}}}
Дата виходу {{{תאריך השקה}}}
{{{אתר אינטרנט}}}

Якщо ви використовуєте цей код усередині шаблону, а потім використовуєте цей шаблон, то побачите, що якщо не заповнити параметри «жанр», «тривалість», «дата виходу» і «вебсайт», їхній рядок не показуватиметься. «Живий» приклад такого використання можна знайти в шаблоні {{סרט}}. Зверніть увагу, що в цьому шаблоні в усіх клітинках використовуються стилі (усі клітинки мають пунктирну верхню межу).

Перевірка параметрів

Основна стаття – Хабадпедія:Система перевірки параметрів

Хабадпедія:Система перевірки параметрів дає змогу додати до шаблону опис параметрів, які він очікує отримати, і так виявляти неправильне використання шаблону (неправильна кількість параметрів, пропуск параметра, про який обов'язково повідомляти, тощо).

Оновлення шаблонів, категорій і пов'язаних сторінок

Іноді під час оновлення шаблонів можуть виникнути три неполадки:

  1. Шаблони, особливо якщо це шаблони, включені до шаблонів, не оновлюються.
  2. Сторінка з'являється в категоріях, з яких її було вилучено.
  3. Сторінка з'являється у списку сторінок, що посилаються на сторінку або на зображення, посилання на які було вилучено із шаблону. Це також призводить до того, що неможливо дізнатися, наскільки насправді використовуються застарілі зображення, такі як Stop hand.png.

Проблема виникає внаслідок неоновлення потрібних списків.

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

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

Невід'ємна частина створення шаблону — його документація, адже без документації не знатимуть, як ним користуватися. Ця проблема загострюється, що складніший шаблон (як правило, залежно від кількості параметрів у ньому). Якщо ви натрапили на шаблон без документації, можна запитати на сторінці обговорення шаблону або звернутися до творця шаблону (шукайте його ім'я на сторінці «Попередні версії») із проханням написати документацію.

Документація поділяється на документацію для програміста, що пояснює код і вбудована в нього у вигляді прихованих коментарів (див. розділ «Прихований коментар у шаблоні»), і документацію для («простого») користувача шаблону, що описує й демонструє різні способи його використання.

Прийнятий спосіб – створити підсторінку під назвою Шаблон:Назва шаблону/Документація і на ній пояснити, для чого призначено шаблон, спосіб його використання тощо.

На самій сторінці шаблону потрібно додати під тегом noinclude (який зазвичай уже існує) і в ньому додати {{תיעוד}}.

Як частину пояснення можна використовувати теги «<code>» і «<nowiki>» (шукайте відомості на сторінці «Довідка:Вікі-синтаксис»), щоб продемонструвати різні способи використання шаблону, як це зроблено на цій сторінці. Можна також скористатися шаблоном {{אופן השימוש}}.

Бажано розмістити

Хабадпедія:Букмарклети

Шаблон, адаптований для використання в букмарклетах, рекомендується позначити в документації за допомогою шаблону {{יש בוקמרקלט}}, і так само заохочувати використання букмарклетів.

Див. також

Повідомити про помилку на цій сторінці