Корисник:Кадзо/Бот/Упутство

Подешавање аутоматског архивирања

Ставите следећи шаблон на врх странице коју желите да бот архивира:

{{Korisnik:Kadzo/Bot/archive
| algo    = old(...)
| archive = Naziv stranice na koju se arhivira sadržaj
[ostali parametri - ***pogledajte ispod***]
}}

Па, можда не баш тако (прочитајте испод који су све параметри неопходни), али то је отприлике то. Успут, шаблон је потпуно празан (нема никакав садржај), тако да не морате да бринете како ће страница изгледати након његовог додавања :) Бот очекује да види само један параметар по линији. Заграде за затварање шаблона }} морају да буду у засебној линији и пре њих не сме да буде празнина. Уколико читав шаблон ставите у једну линију (уместо као у горњем примеру), бот можда неће правилно функционисати.

Такође, шаблон мора да буде смештен:

1. пре првог ==поднаслова== на страници
2. на конкретној страници, а не на њеним подстраницама.

Примери

Замените „Разговор са корисником:Пример“ називом одговарајуће странице!

Уколико архивирање и даље не функционише, прочитајте испод о опцијама „минтхреадслефт“ и „минтхреадстоарцхиве“.

Пример 1

{{Korisnik:Kadzo/Bot/archive
| algo    = old(7d)
| archive = Razgovor sa korisnikom:Primer/1
}}

Ово омогућава архивирање садржаја са странице Разговор са корисником:Пример на страницу Разговор са корисником:Пример/1 и то оних поднаслова који су старији од 7 дана (рачунајући од најновијег коментара у том поднаслову). У овом примеру архива ће расти бесконачно. То и није баш препоручљиво (осим код слања садржаја у неку врсту „канте за ђубре“ која се периодично празни или уколико желите сами да одлучите када бот треба да пређе на следећу страницу за архивирање).

Пример 2

{{Korisnik:Kadzo/Bot/archive
| archiveheader       = {{zaglavlje arhive}}
| maxarchivesize      = 70K
| counter             = 1
| minthreadsleft      = 4
| minthreadstoarchive = 1
| algo                = old(31d)
| archive             = Razgovor sa korisnikom:Primer/%(counter)d
}}

Ово говори боту да архивира поднаслове старије од месец дана (31 дан) (остављајући 4 најновија поднаслова) са странице Разговор са корисником:Пример на страницу Разговор са корисником:Пример/1 (прочитајте испод о варијаблама) све док архива не достигне величину од 70 килобајта, након чега ће бот наставити да архивира садржај на страницу Разговор са корисником:Пример/2 (аутоматски подешавајући бројач - цоунтер - приликом снимања странице). Не заборавите да задате максималну величину архиве јер ће она, у супротном, наставити да расте бесконачно - као у првом примеру. Осим тога, бот у сваку архиву додаје {{заглавље архиве}} (можете да убаците и неки свој шаблон), што олакшава навигацију.

Пример 3

{{Korisnik:Kadzo/Bot/archive
| algo    = old(5d)
| archive = Razgovor sa korisnikom:Primer/Arhiva/%(year)d/%(monthname)s
}}

Код овог подешавања, поднаслови старији од 5 дана биће смештени у архиве у зависности од њиховог датума, односно у зависности од датума најновијег коментара у конкретном поднаслову. О варијаблама можете да прочитате испод.

Објашњење параметара

{{Korisnik:Kadzo/Bot/archive
| archiveheader       = 
| maxarchivesize      = 
| counter             = 
| minthreadsleft      = 
| minthreadstoarchive = 
| algo                = 
| archive             = 
}}

Параметар	Опис
арцхивехеадер	Шаблон или неки други садржај који ће бити стављен на врх архива. Овде је могуће коришћење варијабли. Вредност овог параметра мора да буде у једној линији! Користите шаблоне попут {{заглавље архиве}} уколико желите да додате више садржаја. Подразумевана вредност је {{заглавље архиве}}.
маxарцхивесизе	Максимална величина архиве пре промене бројача. Бот игнорише овај параметар уколико бројач није у употреби. Унесена вредност мора да буде у формату „бројК“, уз употребу великог латиничног слова „К“. На пример: маxарцхивесизе=256К
цоунтер	Тренутна вредност бројача. Уколико варијабла %(цоунтер)д није у употреби, бот игнорише овај параметар. Бот ће аутоматски мењати (апдејтовати) бројач када то буде неопходно.
минтхреадслефт	Минималан број поднаслова који треба да буду остављени на страници (како странице не би биле потпуно празне). Подразумевана вредност: 5
минтхреадстоарцхиве	Минималан број поднаслова који треба да буду архивирани. Бот неће архивирати страницу уколико би требало да се архивира мањи број поднаслова од задатог. Подразумевана вредност: 2
алго	Алгоритам који упућује бота како да одлучи да ли да архивира неки поднаслов или не. Сложене формуле (укључујући регеx матцхинг) ће бити омогућене касније, али за сада овај параметар мора да буде у формату олд(...) где ... одређује максималну старост поднаслова (у сатима или данима: 24х, 72х, 5д, 21д итд). Подразумевана вредност: олд(24х)
арцхиве	Назив странице на коју ће бити архивиран садржај. Овде је могуће коришћење варијабли, које омогућавају прављење архива са променљивим називом (као што је нпр. коришћење датума у наслову архиве). Имајте на уму да магичне речи и шаблони не раде код овог параметра, као и да архива мора да буде подстраница тренутне странице.

Променљиве

Променљива	Односи се на...
%(цоунтер)д	тренутна вредност бројача - цоунтер
%(yеар)д	година у наслову странице у коју се архивирају поднаслови
%(монтх)д	месец (број 1-12) у наслову странице у коју се архивирају поднаслови
%(монтхнаме)с	пун назив месеца из горњег примера
%(монтхнамесхорт)с	прва три слова у називу месеца из горњег примера

Неколико напомена:

• уверите се да не нисте забрљали последње слово након заграде (треба да буде латинично слово „д“ за целе бројеве и латинично слово „с“ за ниске)
• променљиве са целим бројем могу да почињу нулом:

  %(цоунтер)03д даје 013 уколико је вредност бројача - цоунтер број 13,

  %(монтх)02д даје 05 за месец мај итд.

Након што сте подесили архивирање

Бот се покреће периодично. Сачекајте следећи циклус и требало би да видите измене које је начинио бот у историји конкретних страница, под условом да има шта да се архивира. У опису измена би требало да буде дат и линк ка страници на коју је садржај архивиран.

Различити шаблони могу да се користе као заглавље, јер дају преглед и омогућавају лаку навигацију између архива. Обично се додају на врх страница. Неки од таквих шаблона су:

• {{zaglavlje arhive}}
• {{zaglavlje arhiva administratorska tabla}}
• {{zaglavlje arhiva članci za brisanje}}

а можете да направите и неко своје заглавље.

Одлагање или спречавање архивирања

Аутоматско архивирање одређеног поднаслова може да буде одложено или спречено додавањем супституисаног шаблона {{ДНАУ}} у тај поднаслов. Дакле, користите {{subst:DNAU}} да спречите архивирање поднаслова на неодређено, или {{subst:DNAU|<ceo_broj>}} да одложите архивирање поднаслова за <цео_број> дана. На пример, {{subst:DNAU|50}} ће одложити архивирање конкретног поднаслова за 50 дана.