Utilizator:Robotul Arhivar/config/doc

Pentru a activa arhivarea automată pentru o pagină nu trebuie decât să introduceţi în pagina respectivă, înainte de prima secţiune de conţinut, următorul format:

{{Utilizator:Robotul Arhivar/config|vechime=(date vechime)|arhiva=(date arhivă)|minor=(opţiune minor)|mod=(opţiune mod)}}

Ordinea parametrilor nu este importantă. Parametrii vechime şi arhiva sunt obligatorii.

Date vechime

Parametrul vechime trebuie specificat în următorul format: (număr) (unitate).

(unitate) trebuie să fie unul dintre:

z – zile
s – săptămâni (7 zile calendaristice)
l – luni (31 de zile calendaristice)
a – ani (365 de zile calendaristice)

(număr) este numărul de astfel de unităţi care determină vârsta minimă de arhivare.

Exemple date vechime:

3z – vor fi arhivate secţiunile vechi de cel puţin trei zile
2s – două săptămâni
1l – o lună

Date arhivă

Parametrul arhiva indică numele paginii în care se va opera arhivarea. El trebuie să fie numele unui articol. Opţional se pot include următorii parametri:

<anul> – este înlocuit dinamic cu anul aferent datei ultimului comentariu din secţiunea arhivată
<luna> – este înlocuit dinamic cu luna aferentă datei ultimului comentariu din secţiunea arhivată
<ziua> – este înlocuit dinamic cu anul aferent datei ultimului comentariu din secţiunea arhivată

Atenţie! dacă utilizaţi <luna> trebuie în mod necesar să utilizaţi şi <anul>; dacă utilizaţi <ziua> trebuie în mod necesar să utilizaţi atât <luna> cât şi <anul>, altfel formatul este considerat incorect şi pagina nu este arhivată. Motivul este că s-ar crea ambiguitate, dacă de exemplu aţi folosi numai <ziua> atunci ar rezulta 31 de arhive în care s-ar stoca arbitrar secţiunile care s-au încheiat în ziua din lună aferentă arhivei respective, indiferent de luna şi anul datei ultimului comentariu.

Exemple date arhivă:

Discuţie utilizator:Gutza/Arhiva – toate discuţiile se vor arhiva în această pagină.
Discuţie utilizator:Gutza/Arhiva <anul> – discuţiile încheiate în 2007 se vor arhiva în Discuţie utilizator:Gutza/Arhiva 2007; cele din 2008 se vor arhiva în Discuţie utilizator:Gutza/Arhiva 2008 şi aşa mai departe.
Wikipedia:Cafenea/Arhivă/<anul>/<luna> – discuţiile din septembrie 2008 se vor arhiva în Wikipedia:Cafenea/Arhivă/2008/septembrie, cele din octombrie în Wikipedia:Cafenea/Arhivă/2008/octombrie şi aşa mai departe.

Opţiunea „minor”

Parametrul minor specifică în ce măsură modificările pe care le face robotul vor fi marcate ca minore. În mod „auto” acţiunea de marcare a unei modificări este minoră iar operaţiunea de arhivare nu este; dacă se efectuează ambele operaţiuni într-o singură modificare, modificarea nu este minoră. Parametrul poate lua oricare dintre valorile:

1 – orice modificare pe această pagină este minoră. Util pentru pagini de discuţie ale utilizatorilor (modificările minore operate de roboţi nu produc mesajul „aveţi mesaje noi”).
0 – nicio modificare pe această pagină nu este minoră.
auto – valoarea implicită, comportamentul este cel descris în paragraful introductiv.

Opţiunea „mod”

Parametrul mod indică dacă arhiva este cronologică sau invers cronologică. Dacă arhiva este invers cronologică şi pagina cu arhiva conţine text care trebuie să rămână la începutul paginii, atunci textul de început trebuie delimitat explicit de secţiunile arhivate cu „__TOC__” (vezi de exemplu sursa paginii Wikipedia:Reclamaţii/Arhivă/2008). Parametrul poate lua una dintre valorile:

sufix – valoarea implicită, secţiunile arhivate sunt adăugate la sfârşitul arhivei.
prefix – secţiunile arhivate sunt adăugate la începutul arhivei. Vezi notele din paragraful introductiv.

Exemple

Exemple de utilizare a formatului:

{{Utilizator:Robotul Arhivar/config|vechime=2s|minor=1|arhiva=Discuţie utilizator:Gutza/Arhiva <anul>}}

Formatul este recunoscut corect şi dacă este împrăştiat pe mai multe linii:

{{Utilizator:Robotul Arhivar/config|
  vechime=1l|
  arhiva=Wikipedia:Cafenea/Arhivă/<anul>/<luna>
}}

Note

Definiţia secţiunii din punctul de vedere al robotului este o secţiune de nivel 2 („==titlu==”).
Textul dinaintea primei secţiuni nu este arhivat niciodată.
Textul de la sfârşitul paginii este considerat ca făcând parte din ultima secţiune şi va fi arhivat ca atare.
Secţiunile care încep cu formatul {{nu arhiva}} nu sunt arhivate indiferent de vechime.
Robotul decide dacă să arhiveze o secţiune sau nu pe baza datelor din semnături.
- Întotdeauna data secţiunii este considerată ca fiind cea mai recentă dată în format standard întâlnită în secţiunea respectivă
- Dacă robotul întâlneşte o secţiune în care nu recunoaşte nicio dată atunci introduce el un comentariu HTML în care marchează data la care a întâlnit prima dată secţiunea respectivă.
- Dacă vă modificaţi semnătura în aşa fel încât data nu mai este formatată în formatul standard, robotul nu o va recunoaşte şi vă va ignora mesajele.
Atenţie la vandali, aceştia pot modifica oricare dintre parametrii formatului, cu efecte nedorite asupra funcţionării robotului. Pentru a preveni dezastrele robotul nu acceptă vechimi nule pentru arhivare (vechime=0z).
Formatul de configurare trebuie să se afle în mod explicit înainte de prima secţiune din pagină:
- Dacă formatul este inclus într-o secţiune oarecare sau la sfârşitul paginii nu este luat în seamă şi pagina nu este arhivată.
- Formatul trebuie să apară în mod explicit în sursa paginii, robotul nu îl caută în corpul altor formate incluse.