Хабадпедія:Система перевірки параметрів/Виправлення помилок
У Хабадпедії широко використовуються шаблони. Система перевірки параметрів перевіряє, чи відповідають передані шаблону параметри його визначенню, і виявляє неправильне використання шаблону (неправильна кількість параметрів, пропуск параметра, який обов'язково вказувати, тощо), щоб його можна було виправити. Помилки параметрів можна побачити в Категорії:Помилки параметрів, зайти в проблемні статті й виправити.
Увімкнення системи
Щоб увімкнути систему перевірки параметрів так, щоб вона показувала вам повідомлення про помилки, заходять у Налаштування ← Гаджети, прокручують униз і вмикають «Показувати повідомлення про помилки системи перевірки параметрів» під заголовком «Моніторинг». От і все.
Відтепер у кожній статті, де є помилка параметрів, у верхньому меню з'явиться кнопка, яка повідомляє, що на сторінці є помилки параметрів в одному або кількох шаблонах. Число означає кількість шаблонів у статті, у яких є помилка.
При натисканні на кнопку відкривається форма, що показує список шаблонів із помилками на сторінці з переліком помилок у кожному шаблоні. У верхній частині форми кілька кнопок:
- Показ помилок: показ повідомлення про помилки параметрів у шаблоні перед кожним шаблоном із помилками
- Приховання помилок приховання повідомлень про помилки в тексті статті — помилки в самій формі й надалі відображаються
- Пояснення і вказівки — посилання на цю сторінку
- Припинити отримувати повідомлення вимкнення гаджета. Його можна знову увімкнути будь-коли через Налаштування ← Гаджети
Під кнопками — список шаблонів, що містять помилку. Праворуч від повідомлення — стрілка, спрямована вниз: натискання на стрілку переносить до місця на сторінці, де міститься шаблон із помилкою, а над шаблоном з'являється повідомлення про помилку для цього шаблону.
Після завершення виправлення помилки рекомендується використати опис редагування «виправлення параметрів» (є в полі описів редагувань) і так позначити виправлення. Позначка допомагає збирати інформацію про виправлення помилок і так може допомогти зрозуміти, через що виникають помилки.
Робота з помилками
Це сторінка вказівок і пояснень щодо виправлення помилок параметрів у шаблонах, позначених системою. У багатьох випадках виправлення такої помилки усуває ваду у відображенні сторінки, що означає: частина інформації, доданої редакторами на сторінку, не відображається або відображається неправильно, а можливо, навіть порушує відображення сторінки. Є також легкі технічні помилки, які фактично зовсім не впливають на відображення сторінки. Їх теж варто виправляти, оскільки це допомагає підтримувати «чисту кухню». І коли їх виправляють, це робиться значною мірою для того, щоб «підтримувати чисту кухню», щоб полегшити виявлення і швидке опрацювання нових помилок, багато з яких належать до першого типу. Останній «тип» помилок — тимчасові помилки, що виникають після зміни самого шаблону. Завжди або майже завжди така зміна супроводжується технічним виправленням шаблонів на сторінках за допомогою бота, і, як правило, опрацьовувати такі помилки вручну не потрібно.
На сторінці може бути одна помилка або кілька помилок. Коли на сторінці кілька шаблонів із помилкою параметрів, для кожного такого шаблону з'явиться повідомлення, причому в кожному повідомленні вказано назву шаблону з посиланням на сам шаблон і помилки — одна або більше. Посилання на шаблон корисне, щоб прочитати документацію і пояснення щодо правильного використання шаблону, у якому на поточній сторінці є помилка, і щоб знайти інші сторінки, де цей шаблон стоїть без помилки.
Виправлення шаблонів зазвичай виконується в редакторі вихідного коду, і перший крок до виправлення помилки — знайти шаблон у вихідному коді.
Пошук шаблону з помилкою
Часто помилка міститься в шаблоні типу «інформаційний шаблон», наприклад {{Особистість}} і його похідні, який трапляється на сторінці рівно один раз, і знайти його легко й просто за назвою шаблону, вказаною в повідомленні про помилку. Натомість такі шаблони, як {{Примітка}}, {{Загальне посилання}} та інші, можуть траплятися на сторінці багаторазово, і знайти конкретний шаблон, у якому є помилка, не так швидко.
Щоб допомогти, скористаємося «Показом помилок». При натисканні на нього повідомлення про помилки розміщуються на сторінці над шаблоном, а сам шаблон обводиться червоною рамкою. Потрібно знайти текст перед шаблоном або після нього і знайти цей текст у редакторі вихідного коду, і «неслухняний» шаблон, як правило, виявиться поруч із ним.
Пошук примітки, що містить шаблон із помилкою
Справа трохи ускладнюється, коли помилка міститься в шаблоні, який сам міститься в примітці: повідомлення і червона рамка з'являться в розділі «Примітки», тоді як помилка міститься в тексті, у тому місці, де стоїть {{Примітка}} або тег ref. Щоб знайти вікі-код, у якому помилка, спочатку натиснемо «Позначка». Примітку, яку потрібно виправити, буде позначено в розділі «Примітки». Тепер потрібно натиснути на число поруч із приміткою з помилкою — це число посилається на текст. Знаходять посилання на примітку у вигляді [16], і знову знаходять текст поблизу, переходять у режим редагування і знаходять примітку, а в ній — шаблон, що містить помилки.
Якщо ввімкнено бета-можливість «Попередній перегляд примітки» (у Налаштування ← Бета), наведення миші на посилання на примітку з тексту покаже повідомлення про помилку у спливному вікні попереднього перегляду.
Допоміжні інструменти
Під час роботи з помилками параметрів корисним допоміжним інструментом є майстер шаблонів:
- Знаходять і виділяють на сторінці шаблон, у якому є помилка. Потрібно стежити за тим, щоб виділити точно, починаючи з {{, що відкривають шаблон, і до }}, що закривають його.
- На панелі інструментів натисніть кнопку майстра, яка має такий вигляд: {{}}
- Майстер шаблонів знайде визначення відповідного шаблону, завантажить поточний шаблон і позначить помилкові поля рожевим тлом
- Майстер зніме забарвлення, коли поле буде виправлено. Коли всі поля вільні від помилок, тобто більше немає полів, що відображаються рожевим, підтверджують, і шаблон на сторінці виправлено.
Приклад можливої помилки і пояснення виправлення: припустімо, у шаблону є обов'язковий параметр під назвою «загальна вага». На сторінці стоїть «загальна вяга = 47 тонн». Через описку в назві параметра виникнуть дві помилки: відсутній обов'язковий параметр і параметр із помилковою назвою. У майстрі шаблонів ми зможемо знайти правильне значення для параметра з помилковою назвою, яке буде показано червоним, тоді як параметр із правильною назвою порожній. Перенесення правильного значення в правильний параметр виконується кількома рухами миші. Є низка помилок, які майстер виправляє автоматично — просто виділенням шаблону, відкриттям майстра і натисканням «Підтвердити».
Поширені види помилок і робота з ними
Параметри [1] не вказані у визначенні шаблону"
(або інше число; а також два числа)
- У шаблоні, де параметри базуються на назві
Параметр, що базується на назві, повинен містити вертикальну риску (|), щоб відокремити його від попереднього параметра, точну назву параметра (будь-яке відхилення від його точної назви у визначенні шаблону, як вона вказана на сторінці шаблону, не спрацює) і знак рівності (=) після назви параметра, щоб відокремити назву параметра від заповненого вмісту.
Повідомлення про помилку показується в кількох випадках:
- Коли значення параметра подано без зазначення його назви. Виправлення — додавання назви параметра і знака рівності (
=). Приклад: повідомлення про помилку і його виправлення (посилання не активне). - Коли стоїть зайва вертикальна риска, шаблон зчитує вимогу параметра; але коли він не з'являється одразу після неї, система розпізнає помилку. У такому разі потрібно видалити зайву риску. Іноді риска стоїть у зображенні, вставленому в шаблон, щоб керувати розміром зображення: якщо розмір стандартний, потрібно видалити
|250px(приклад помилки і її виправлення) (посилання не активне); якщо розмір нестандартний — потрібно поставити на зображення внутрішнє посилання, так:[[קובץ:aaa.jpg|150px]] - Ще одна можливість — знак рівності не поставлено після назви параметра, наприклад:
|תאריך לידה ט"ו באדר ב' תשכ"זзамість|תאריך לידה=ט"ו באדר ב' תשכ"ז. У такому разі потрібно додати знак рівності між назвою параметра і заповненим вмістом.
- У шаблоні, де параметри базуються на положенні
Можливо, параметрів більше, ніж приймає шаблон. Наприклад, параметри шаблону посилання на «Хабад Інфо» такі: {{קישור לחב"ד אינפו|שם הכתב|כותרת הכתבה|מזהה הכתבה|תאריך פרסום}}; якщо ми заповнимо шаблон {{קישור לחב"ד אינפו|שם הכתב|כותרת הכתבה|מזהה הכתבה|תאריך פרסום||}}, то отримаємо повідомлення Параметри [5, 6] не вказані у визначенні шаблону, оскільки в шаблону немає п'ятого і шостого параметрів.
«Параметри [улюблена страва] не вказані у визначенні шаблону»
Ця помилка з'являється, коли введено назву параметра, не вказану у визначенні шаблону. Спробуйте перевірити в історії версій, коли його було додано, — іноді йдеться про неправильну зміну, спричинену незнанням, і тоді варто просто виправити на правильну назву. Якщо йдеться про додавання нового параметра, спробуйте перевірити на сторінці шаблону, чи немає схожого параметра, який може підійти.
«Використання застарілих параметрів»
Загалом — не чіпати. Це тимчасова помилка, що виникає в ході перетворення шаблонів. Вона відома тим, хто займається шаблоном, і перебуває в роботі.
«Відсутні обов'язкові параметри [3]»
Помилка полягає в тому, що один або кілька параметрів (уміст дужок вказує на положення параметра або його назву), визначених у шаблоні як обов'язкові (наприклад: ідентифікатор статті на новинному сайті; без ідентифікатора статті посилання на головну сторінку сайту не приносить користі), не введені. Рішення — заповнити їх. Якщо ви не можете знайти правильне значення для відсутнього параметра, ви не зможете виправити цю помилку.
Дублювання параметрів
Є дві різні помилки типу «дублювання параметрів».
Перша з'являється, коли під час використання шаблону той самий параметр передається більше одного разу: {{שם התבנית| פרמטר 1 = א | פרמטר 1 = ב}}, або {{שם התבנית| פרמטר 1 = א | פרמטר 1 = א}}, або {{שם התבנית| פרמטר 1 = א | פרמטר 1 =}}. Ця помилка не пов'язана із «системою перевірки параметрів», що діє в Хабадпедії (і тому може з'являтися і в шаблонах, що не входять до системи), і відстежується самим вікі-рушієм. Сторінки, на яких є така помилка, з'являться в Категорії:Сторінки, що використовують параметри, які дублюються, у викликах шаблонів. Хоча ця помилка «не належить» до системи, в принципі вона схожа на помилки, які відстежує система, тому сама категорія пов'язана з верхньою частиною Категорії:Помилки параметрів. Пояснення і керівництво щодо виправлення цієї помилки наводяться на сторінці категорії.
Друга помилка типу «дублювання параметрів» трохи складніша: ця помилка може виникнути, коли один параметр визначений як «аліас» (alias, або на івриті «кінуй») іншого параметра і обидва параметри отримують значення. Визначення міститься в templatedata шаблону й означає, що значення можна передати шаблону за допомогою будь-якого з двох параметрів, як зручніше редактору. Якщо, наприклад, у шаблоні визначено перший параметр, що базується на порядку (параметр 1), з аліасом «вміст», два наступні виклики мають давати той самий результат: {{שם התבנית | מה פה קורה פה? }} або {{שם התבנית | תוכן = מה פה קורה פה? }}. Коли шаблону передають і параметр, і аліас, або в прикладі {{שם התבנית| מה פה קורה פה? | תוכן = אף אחד יודע. }}, неясно, яке з двох значень шаблон має використовувати, і результат може відрізнятися від наміру редактора. Помилка такого типу з'явиться в Категорії:Помилки параметрів — дублювання параметрів, і щоб виправити її, потрібно перевірити в templatedata, який параметр слугує «аліасом» іншого параметра, ввести потрібне значення лише в один із них, а інший видалити з виклику шаблону або принаймні очистити від умісту. У прикладі ми змінимо входження шаблону на сторінці на {{שם התבנית| תוכן = מה פה קורה פה? אף אחד יודע. }}. У Хабадпедії, як правило, аліаси не використовуються, і ця помилка рідкісна.