Шаблон:Archive

Из Википедије, слободне енциклопедије
Jump to navigation Jump to search
Документација шаблона[погледај] [уреди] [историја] [освежи]

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

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

{{MickiBot/archive
| algo    = old(...)
| archive = Назив странице на коју се архивира садржај
[остали параметри - ***погледајте испод***]
}}

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

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

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

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

Примери

Замените „Разговор са корисником:Пример“ називом одговарајуће странице!
Уколико архивирање и даље не функционише, прочитајте испод о опцијама „minthreadsleft“ и „minthreadstoarchive“.

Пример 1

{{MickiBot/archive
| algo    = old(7d)
| archive = Разговор са корисником:Пример/1
}}

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

Пример 2

{{MickiBot/archive
| archiveheader       = {{заглавље архиве}}
| maxarchivesize      = 70K
| counter             = 1
| minthreadsleft      = 4
| minthreadstoarchive = 1
| algo                = old(31d)
| archive             = Разговор са корисником:Пример/%(counter)d
}}

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

Пример 3

{{MickiBot/archive
| algo    = old(5d)
| archive = Разговор са корисником:Пример/Архива/%(year)d/%(monthname)s
}}

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

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

{{MickiBot/archive 
| archiveheader       = 
| maxarchivesize      = 
| counter             = 
| minthreadsleft      = 
| minthreadstoarchive = 
| algo                = 
| archive             = 
}}
Параметар Опис
archiveheader Шаблон или неки други садржај који ће бити стављен на врх архива. Овде је могуће коришћење варијабли. Вредност овог параметра мора да буде у једној линији! Користите шаблоне попут {{заглавље архиве}} уколико желите да додате више садржаја. Подразумевана вредност је {{заглавље архиве}}.
maxarchivesize Максимална величина архиве пре промене бројача. Бот игнорише овај параметар уколико бројач није у употреби. Унесена вредност мора да буде у формату „бројK“, уз употребу великог латиничног слова „K“. На пример: maxarchivesize=256K
counter Тренутна вредност бројача. Уколико варијабла %(counter)d није у употреби, бот игнорише овај параметар. Бот ће аутоматски мењати (апдејтовати) бројач када то буде неопходно.
minthreadsleft Минималан број поднаслова који треба да буду остављени на страници (како странице не би биле потпуно празне). Подразумевана вредност: 5
minthreadstoarchive Минималан број поднаслова који треба да буду архивирани. Бот неће архивирати страницу уколико би требало да се архивира мањи број поднаслова од задатог. Подразумевана вредност: 2
algo Алгоритам који упућује бота како да одлучи да ли да архивира неки поднаслов или не. Сложене формуле (укључујући regex matching) ће бити омогућене касније, али за сада овај параметар мора да буде у формату old(...) где ... одређује максималну старост поднаслова (у сатима или данима: 24h, 72h, 5d, 21d итд). Подразумевана вредност: old(24h)
archive Назив странице на коју ће бити архивиран садржај. Овде је могуће коришћење варијабли, које омогућавају прављење архива са променљивим називом (као што је нпр. коришћење датума у наслову архиве). Имајте на уму да магичне речи и шаблони не раде код овог параметра, као и да архива мора да буде подстраница тренутне странице.

Променљиве

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

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

  • уверите се да не нисте забрљали последње слово након заграде (треба да буде латинично слово „d“ за целе бројеве и латинично слово „s“ за ниске)
  • променљиве са целим бројем могу да почињу нулом:
    %(counter)03d даје 013 уколико је вредност бројача - counter број 13,
    %(month)02d даје 05 за месец мај итд.

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

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

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

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

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

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