Вікіпэдыя:Прылады

Праграмы ў Вікіпэдыі

Гэта інфармацыйная старонка.

Яна не апісвае ніякае правіла ці рэкамэндацыю, але спрабуе патлумачыць пэўныя аспэкты складзеных у Вікіпэдыі нормаў, традыцыяў, тэрміналёгіі ці практыкі. Яна можа паказваць дасягнутыя ўзроўні кансэнсусу і згоды.

Скарачэньне: ВП:ПРЫЛАДЫ

Прыла́ды Вікіпэ́дыі — JavaScript- або CSS-код, даступны для падлучэньня праз налады ўліковага запісу. Функцыянаваньне прыладаў забясьпечвае пашырэньне MediaWiki пад назвай Гаджэты.

Шматлікія прылады спачатку паўставалі як карыстальніцкія скрыпты. Пасьля ўхвалы такіх скрыптоў яны перайшлі ў разрад агульных прыладаў.

Агульныя патрабаваньні да прыладаў

Дзеля ўводу прылады ў беларускай Вікіпэдыі яна звычайна мусіць адпавядаць наступным умовам:

Прылады мусяць працаваць нават без аніякай дадатковай канфігурацыі. Іх можна наладжваць ва ўласным common.js, але павінны працаваць і бяз гэтага.
Прылады мусяць быць сумяшчальныя з усімі асноўнымі броўзэрамі, т. б., не павінны спыняцца з памылкамі.
Прылады мусяць функцыянаваць у большасьці асноўных броўзэраў (міжброўзэрная сумяшчальнасьць). Выключэньні павінны быць яўна апісаныя.
Дубляваньне прыладаў варта рабіць толькі з уважлівых прычынаў.
Калі зборы скрыптоў маюць розныя задачы, то мусяць быць разьдзеленыя.
Прылады, якія патрабуюць дазволаў, павінны быць пазначаныя, і ў выпадку адсутнасьці патрэбных дазволаў ветліва тлумачыць адмову працы.
Прылады, якія працуюць не ва ўсіх тэмах афармленьня, павінны паведамляць пра гэта.

Усталяваньне

Прылады ўсталёўваюцца адміністратарамі інтэрфэйсу гэткім чынам:

Дадайце ніжэйшы загаловак і код скрыпта на старонку MediaWiki:Gadget-назва-скрыпта.js
Пры жаданьні дадайце ніжэйшы загаловак і CSS-код на старонку MediaWiki:Gadget-назва-скрыпта.css
Дадайце апісаньне скрыпта на старонку MediaWiki:Gadget-назва-скрыпта. У апісаньні падайце спасылку на дамашнюю старонку і/або старонку дапамогі і пры неабходнасьці апішыце броўзэрныя патрабаваньні.

Дадайце ў MediaWiki:Gadgets-definition пад адпаведнай сэкцыяй

 * назва-скрыпта|назва-скрыпта.js[|назва-скрыпта.css|іншы_скрыпт.js|...]

Цяпер прылада павінна зьявіцца ў Спэцыяльныя:Gadgets.

Камэнтары

Камэнтары ці папярэджаньні можна дадаваць у шаблёны апісаньня прыладаў двума спосабамі:

цэтлікам noinclude (бачным на старонцы апісаньня з спасылкамі): <noinclude> камэнтар </noinclude>
HTML-камэнтаром (бачным толькі ў крынічным тэксьце):

Дададзеныя такім чынам камэнтары будуць аўтаматычна прапушчаныя ў працэсе стварэньня старонкі.

Загаловак

У файлы прыладаў неабходна дадаць загаловак па прыкладзе:

/*  _____________________________________________________________________________
 * |                                                                             |
 * |                   === УВАГА: ФАЙЛ ГЛЯБАЛЬНАЙ ПРЫЛАДЫ ===                    |
 * |         Зьмены на гэтай старонцы закрануць мноства карыстальнікаў.          |
 * |           Перад выпраўленьнямі абмяркуйце зьмены ў абмеркаваньні            |
 * |                  ці на [[Абмеркаваньне Вікіпэдыі:Прылады]]                  |
 * |_____________________________________________________________________________|
 * 
 * Імпартавана з вэрсіі XXXX за ДАТУ з [[КРЫНІЦА_СКРЫПТА]]
 * КАРОТКАЕ_АПІСАНЬНЕ глядзіце на [[ХАТНЯЯ_СТАРОНКА_СКРЫПТА]]
 */

Дапомныя прылады

Прылада з ключавым словам default уключаецца для ўсіх чытачоў Вікіпэдыі, а адключыць яе могуць толькі зарэгістраваныя ўдзельнікі.

Прылада з апісаньнем [default|rights=minoredit] будзе аўтаматычна ўключаная толькі для зарэгістраваных удзельнікаў.

Усталяваныя прылады

Удзельнікі могуць праглядзець сьпіс усіх даступных прыладаў у адпаведнай сэкцыі старонкі наладаў:

Налады → Прылады

Сьпіс усіх дзейных прыладаў з спасылкамі на файлы іхніх скрыптоў глядзіце на старонцы Спэцыяльныя:Gadgets.

Глядзіце таксама

MediaWiki talk:Gadgets-definition — абмеркаваньне тэхнічных падрабязнасьцей стварэньня і падтрымкі прыладаў
Special:GadgetUsage — статыстыка выкарыстаньня скрыптоў
mw:Extension:Gadgets — старонка прыладаў на бачыне Mediawiki
mw:Gadget kitchen — дапаможнік у напісаньні прыладаў