Вікіпэдыя:Прылады/HotCat: розьніца паміж вэрсіямі
Змесціва выдалена Змесціва дададзена
д артаграфія, пунктуацыя, інтэрвікі |
дакумэнтацыя паводле ен-вікі і команс |
||
Радок 1:
{{Скарачэньне|ВП:HOTCAT}}
[[Файл:HotCat.png|міні|Выбар катэгорыі ў HotCat]]
'''HotCat''' — [[Вікіпедыя:Гаджэты|гаджэт]], прызначаны для хуткай рэкатэгарызацыі старонак пры дапамозе [[JavaScript]]. Пасьля яго актывацыі (ва [[Спэцыяльныя:Preferences|ўстаноўках удзельніка]] за гэта адказвае адмысловая опцыя ''
Вэрсія скрыпту, што выкарыстоўваецца ў [[Беларуская Вікіпэдыя|Беларускай Вікіпэдыі]], знаходзіцца па наступнай спасылцы: [[MediaWiki:Gadget-HotCat.js]].
== Усталёўка ==
Для актывацыі прылады дастаткова ва [[Спэцыяльныя:Preferences|ўласных усталёўках]] паставіць пстрычку насупраць ''уключыць HotCat для дадаваньня, зьмены або выдаленьня катэгорыяў'' на ўкладцы ''Гаджэты'' tab.
Іншы спосаб:
# Скапіруйце ніжэй пададзены тэкст і ўстаўце яго ўнізе старонкі [[Спэцыяльныя:Мая старонка/skin.js|вашага скрыпту]]:<br><code>importScript('[[MediaWiki:Gadget-HotCat.js]]');</code >
# Захавайце старонку
# [[Вікіпэдыя:Абнаўленьне кэшу|Абнавіце кэш вашага браўзэру]]
# Карыстайцеся!
== Ужываньне ==
Калі загрузка старонкі скончаная, HotCat пачынае пошук панэлі катэгорыяў. Калі гэтыя катэгорыі бачныя, ён дадае спасылкі для лёгкага выдаленьня, зьмяненьня і даданьня катэгорыяў:
[[Файл:HotCat enwp Category bar.png|800пкс|Панэль катэгорыяў, мадыфікаваная HotCat-ам]]
* '''«(-)»''' пасьля катэгорыі: аўтаматычнае [[#Выдаленьне катэгорыі|выдаленьне катэгорыі]]
* '''«(±)»''' пасьля катэгорыі: па пстрычцы адчыняецца вакно для [[#Замена катэгорыі|зьмяненьня катэгорыі]]
* '''«(+)»''' у канцы сьпісу катэгорыяў: па пстрычцы адчыняецца вакно для [[#Даданьне катэгорыі|даданьня катэгорыі]]
* '''«(+<sup>+</sup>)»''' у пачатку: дазваляе зьмяненьне, выдаленьне і даданьне [[#Праца з усім сьпісам|некалькіх катэгорыяў]]
* '''«(↓)»''' пасьля катэгорыі: пры пстрычцы адчыняецца вакно ўводу тэксту і сьпіс усіх падкатэгорыяў.
* '''«(↑)»''' пасьля катэгорыі: пры пстрычцы адчыняецца вакно ўводу тэксту і сьпіс усіх надкатэгорыяў.
Калі HotCat вызначае, што пэўная катэгорыя зьмешчаная не на старонцы, а перададзеная праз шаблён, то ''не'' паказвае такія катэгорыі. Такім чынам, магчыма рэдагаваць толькі тыя катэгорыі, якія зьмяшчае ўласна артыкул.
Спасылкі '''«(↓)»''' і '''«(↑)»''' не паказваюцца для няісных катэгорыяў (пазначаных чырвоных колерам). Калі катэгорыя існуе, але ня ўтрымлівае падкатэгорыяў/не ўваходзіць у катэгорыі, вакно ўводу тэксту адчыніцца, аднак сьпіс прапановаў будзе адсутнічаць. Глядзіце таксама сэкцыю «[[#Пашуковікі|Пашуковікі]]».
=== Выдаленьне катэгорыі ===
Каб выдаліць катэгорыю, пстрыкніце спасылку '''«(-)»''' пасьля назвы катэгорыі. HotCat выдаляе яе аўтаматычна. Пры гэтым загружаецца вакно рэдагаваньня артыкулу, выдаляецца катэгорыя з тэксту артыкулу, і старонка захоўваецца.
=== Замена катэгорыі ===
Каб замяніць катэгорыю, пстрыкніце спасылку '''«(±)»''' пасьля назвы катэгорыі. Пры гэтым адчыняецца [[#Вакенца ўводу|вакно ўводу]], дзе вы можаце зьмяніць назву катэгорыі на новую. Слова «Катэгорыя» ўводзіць не патрэбна.
=== Даданьне катэгорыі ===
Каб дадаць катэгорыю, пстрыкніце спасылку '''«(+)»''' ў канцы панэлі катэгорыяў. Пры гэтым адчыняецца [[#Вакенца ўводу|вакно ўводу]], дзе вы можаце ўвесьці назву новай катэгорыі. Слова «Катэгорыя» ўводзіць не патрэбна.
=== Вакенца ўводу ===
[[Файл:HotCat Input Box plain.png|справа|Вакенца ўводу HotCat-у]]
Вакенца ўводу складаецца з полю для ўводу тэксту (назвы катэгорыі), іконкі-індыкатара і кнопак ''«OK»'' і ''«Cancel»''.
Індыкатар паведамляе, існуе або не ўведзеная вамі катэгорыя. Значок [[Файл:P_no.svg|20пкс]] азначае, што такое катэгорыі няма. Вы, тым ня меней, можаце захаваць зьмяненьні, але гэтакія спасылкі будуць мець чырвоны колер, як і ўсе няісныя артыкулы. Значок [[Файл:P_yes.svg|20пкс]] паказвае, што ўведзеная вамі катэгорыя існуе.
[[Файл:HotCat suggestions.png|справа|Вакно ўводу HotCat-у са сьпісам прапановаў]]
Калі вы пачынаеце ўвод тэксту, HotCat паказвае сьпіс магчымых прапановаў над або пад вакном уводу. Для выбару пасуючае катэгорыі пстрыкніце на прапанове. Двайная пстрычка на тэксьце прапановы ня толькі падставіць гэтую катэгорыю ў вакно ўводу, але й аўтаматычна захавае гэтае зьмяненьне так, нібыта была націснутая кнопка ''«OK»''. Сьпіс прапановаў напаўняецца [[#Пашуковікі|пошукавым рухавіком]], абраным у сэлектары між сьпісам і тэкставым полем уводу.
[[Файл:HotCat suggestions 2.png|справа|Вакно ўводу HotCat-у са сьпісам прапановаў]]
У паказаным прыкладзе ўручную быў уведзены тэкст «Alps of», а HotCat вывеў сьпіс магчымых працягаў. Першая прапанова аўтаматычна зьявілася ў вакне ўводу, але яна вылучаная, таму будзе перазапісаная, калі працягнуць набор тэксту. Наступны ўвод « S» адпаведна зьмяншае сьпіс магчымых прапановаў.
Пстрыканьне на «Alps of Switzerland» скапіюе гэты тэкст у вакенца ўводу і зачыніць сьпіс прапановаў (бо іншых прапановаў — то бок катэгорыяў, якія б пачыналіся з «Alps of Switzerland» — няма).
Пстрычка па кнопцы ''«Cancel»'' скасуе апэрацыю, а выбар ''«OK»'' паведамляе HotCat-у пра неабходнасьць захаваньня ўведзенай катэгорыі.
=== Праца з усім сьпісам ===
[[Файл:HotCat save button.png|міні|У шматзаменным рэжыме ўсе зьмяненьні захоўваюцца толькі пасьля таго, як будзе націснутая кнопка ''«Save»'']]
Лучыва карыстальніка HotCat-у мінімалістычнае і прызначанае для як мага прасьцейшае і хутчэйшае катэгарызацыі. Пстрыкаючы па спасылцы '''«(-)»''' для выдаленьня катэгорыі, вы атрымоўваеце неадкладнае выкананьне, як і ў выпадках з даданьнем або зьмяненьнем катэгорыі.
Тым ня меней, HotCat прадастаўляе магчымасьць рэдактару зьмяняць некалькі катэгорыяў адразу. Калі пстрыкнуць спасылку '''«(+<sup>+</sup>)»''' ў пачатку панэлі катэгорыяў, HotCat запускае шматзаменны рэжым. Пры гэтым спасылка '''«(+<sup>+</sup>)»''' замяняецца на кнопку ''«Save»'', і ўсе зьмены, якія вы ўнясеце падчас рэдагаваньня, будуць захаваныя на старонцы толькі пасьля націсканьня на гэтую кнопку. Першапачаткова гэтая кнопка будзе неактыўнай, пакуль вы не ўнясеце якія-небудзь зьмены ў сьпісе катэгорыяў.
{{-}}
[[Файл:HotCat multimode.png|800пкс|У шматзаменным рэжыме зьмены паказваюцца пры праглядзе старонкі, але захоўваюцца толькі пасьля таго, як будзе націснутая кнопка ''«Save»'']]
Шматзаменны рэжым запускаецца таксама і ў выпадку, калі вы ўжо адкрылі тэкставае вакно для ўводу катэгорыі і, акрамя таго, спрабуеце дадаць або зьмяніць яшчэ катэгорыю.
У гэтым рэжыме захаваньне зьменаў ''не'' прыводзіць да аўтаматычнага захаваньня праўкі. Замест гэтага вашыя зьмяненьні і вакно для рэдагаваньня артыкулу адлюстроўваюцца на экране, дазваляючы вам зрабіць яшчэ якія-кольвечы выпраўленьні ўручную. Пасьля кожнае зьмененае катэгорыі HotCat дадасьць спасылкі '''«(×)»'''. Яны дзейнічаюць як кнопкі «скасаваньня правак»; апошняе зьмяненьне гэтай катэгорыі будзе скасаванае. Выдаленыя катэгорыі будуць адлюстраваныя <s>перакрэсьленымі</s>. Усе зьмененыя, але незахаваныя катэгорыі HotCat падсьвеціць іншым колерам фону.
Калі націснуць кнопку ''«Save»'', HotCat заносіць усе зьмяненьні на старонку і адчыняе вакно рэдагаваньня артыкулу, паказваючы ўнесеныя зьмены. Пераканайцеся, што скрыпт зрабіў менавіта тое, што вы намерваліся зьдзейсьніць, і пасьля захавайце старонку, як вы гэта робіце пасьля звычайнага рэдагаваньня.
== Для прасунутых ==
=== Як пазьбегнуць аўтазахаваньня ===
Зазвычай HotCat аўтаматычна захоўвае рэдагаваньне аднае катэгорыі. Аднак калі вам неабходна наўзамен гэтага адчыніць вакно рэдагаваньня, замест наўпроставае пстрычкі на кнопцы ''«OK»'' трэба пстрыкнуць на яе з папярэдне заціснутай клявішай-мадыфікатарам. На кампутарах з усталяванай Windows гэта клявіша [[ctrl]], на Apple-кампутарах — [[Cmd (клявіша)|Cmd]].
=== Ключы сартаваньня ===
У катэгорыі можна таксама задаваць ключ сартаваньня. Для гэтага пасьля назвы катэгорыі дапішыце вэртыкальную рысу ('''«|»'''), пасьля якое ўпішыце ключавое слова/словы, якія будуць выкарыстоўвацца для сартаваньня артыкулу ў гэтай катэгорыі.
* Увод «Нешта» дадасьць новую катэгорыю «Нешта» без ключу сартаваньня, або зьменіць існую катэгорыю на «Нешта» з захаваньнем ранейшага ключу.
* Увод «Нешта|Ключ» дадасьць новую або зьменіць існую катэгорыю на «Нешта», у абодвух выпадках замяніўшы ключ сартаваньня на «Ключ».
* Увод «Нешта|» (з вэртыкальнай рыскай на канцы) дадасьць новую катэгорыю «Нешта» без ключу сартаваньня, або зьменіць існую катэгорыю на «Нешта|» з выдаленьнем ранейшага ключу сартаваньня.
=== Пашуковікі ===
Паміж сьпісам прапановаў і полем для ўводу тэксту ёсьць сэлектар пашуковікаў для выбару мэтаду пошуку, які напаўняе сьпіс прапановаў. HotCat падтрымоўвае неабмежаваную колькасьць пошукавых рухавікоў.
Паслугачы МэдыяВікі прапануюць два асноўыя спосабы пошуку катэгорыяў. Першы — пераборам сьпісу старонак вікі. Гэты сьпіс заўжды актуальны, але строга альфабэтны і рэгістразалежны, таму «падобныя» прапановы (напрыклад, «[[:Катэгорыя:Bláhnjúkur|Bláhnjúkur]]» пры ўводзе «Blahn») ня будуць паказвацца. Другі пошукавы рухавік — той, што ўжываецца пры пошуку старонак у Вікіпэдыі праз вакно пошуку. Ён знаходзіць «падобныя» прапановы і рэгістранезалежны, але шукае толькі па праіндэксаваных старонках, якія абнаўляюцца з пэўным інтэрвалам, і таму можа не паказваць некалькі нядаўна створаных катэгорыяў.
Дапомна HotCat камбінуе абодва гэтыя спосабы, каб атрымаць у выніках як «падобныя» прапановы, ''так і'' новыя катэгорыі. Аднак каб зрабіць гэта, яму неабходна зрабіць два запыты да паслугача. Звычайна гэта ня ёсьць праблемай, але калі на марудных злучэньнях гэта займае працяглы час, вы можаце скарыстацца выбарам пашуковіку, каб выбраць той, спосаб, які вам больш пасуе. Можна таксама [[#Наладкі карыстальніка|сканфігураваць пашуковікі]], якія HotCat павінен выкарыстоўваць дапомна.
Акрамя гэтых двух рухавікоў, HotCat прадастаўляе яшчэ два, больш спэцыялізаваныя пашуковікі. Першы можа выкарыстоўвацца для пошуку падкатэгорыяў у катэгорыі, якая зараз уводзіцца. Другі вяртае бацькоўскія катэгорыі. Абодва пашуковікі могуць вяртаць пустыя вынікі, тады сьпіс прапановаў ня будзе паказаны (напрыклад, калі была ўведзеная няісная катэгорыя або такая, у якой адсутнічаюць падкатэгорыі). У гэтым выпадку пасьля першага ўводу такі пошукавы рухавік аўтаматычна замяняецца на дапомны.
Пошук субкатэгорыяў можа займаць пэўны час, асабліва калі катэгорыя ўтрымоўвае шмат старонак (ня толькі падкатэгорыяў). Падчас выкананьня гэтага запыту поле ўводу тэксту блякуецца і не дапускае ўводу тэксту. Калі на працягу агляднага часу яно не стане даступным, проста націсьніце ''«Cancel»''.
=== Наладкі карыстальніка ===
Поўны сьпіс магчымасьцяў HotCat вы можаце паглядзець на [[:commons:Help:Gadget-HotCat|старонцы дакумэнтацыі ў Wikimedia Commons]].
== Гісторыя ==
Першапачаткова HotCat быў распрацаваны для [[Wikimedia Commons]] [[:commons:User:Magnus Manske|Магнусам Манске]], пазьней дапрацоўваўся і адаптаваўся для Вікіпэдыі шматлікімі іншымі, у тым ліку [[:en:User:Lupo|Lupo]], [[:en:User:Dschwen|Dschwen]], [[:en:User:TheDJ|TheDJ]], [[:en:User:Superm401|Superm401]] and [[:en:User:Merlissimo|Merlissimo]] і іншымі.
Вэрсія скрыпту, што выкарыстоўваецца ў [[Беларуская Вікіпэдыя|Беларускай Вікіпэдыі]], адпаведная той, што [[:commons:MediaWiki:Gadget-HotCat.js|знаходзіцца ў Вікісховішчы]], але зь іншымі даўніманымі наладкамі карыстальнікаў.
== Сумяшчальнасьць ==
Як і для многіх іншых скрыптоў у Вікіпэдыі, для працы HotCat неабходны браўзэр, сумяшчальны з [[DOM]] 2-га ўзроўню.
* [[Firefox]] 2 — 4: поўная сумяшчальнасьць
* [[Google Chrome]]: поўная сумяшчальнасьць
* [[Internet Explorer]] 6 — 8: поўная сумяшчальнасьць
* [[Konqueror]]: поўная сумяшчальнасьць
* [[Opera]]: поўная сумяшчальнасьць
* [[Safari]] 3 — 4: поўная сумяшчальнасьць
* Safari 2: нязначная праблема з адлюстроўваньнем спасылкі '''«±»''' (зьмяніць).
Поўны сьпіс сумяшчальнасьці з браўзэрамі можна пабачыць на [[:commons:Help:Gadget-HotCat#Browser compatibility|старонцы дакумэнтацыі ў Wikimedia Commons]].
Для вываду сьпісу катэгорыяў выкарыстоўваецца [[Ajax]]. Калі выключаны [[Javascript]], скрыпт ня будзе працаваць. Калі Javascript уключаны, але адлучаны Ajax, HotCat будзе мець магчымасьць дадаваць, зьмяняць і выдаляць адзінкавыя катэгорыі, але ня будуць выводзіцца прапановы па катэгорыях, а таксама ня будзе працаваць [[#Праца з усім сьпісам|шматзаменны рэжым]].
[[Катэгорыя:Вікіпэдыя:Гаджэты]]
| |||