Wikipedia

Utente:ItwikiBot/Archiver/man

< Utente:ItwikiBot‎ | Archiver

Utente:ItwikiBot/Archiver è una pagina che può essere usata come template e inserita nelle pagine di discussione per permetterne l'archiviazione automatica con frequenza giornaliera, attraverso il bot ItwikiBot.

Attraverso dei parametri si può configurare il nome della pagina dove spostare le discussioni, quali discussioni archiviare e con quali modalità. Il bot utilizza lo script archivebot.py.

Per poter essere archiviata ogni discussione deve avere almeno una firma valida, essa serve al bot per attribuire l'età alla discussione, in base alla firma più recente. Se una discussione è priva di firme non viene archiviata e il bot analizza solo le altre discussioni della pagina. In questi casi è necessario aggiungere alla discussione i template {{Nf}} o {{Non firmato}} avendo cura di (1) substarli e (2) specificare anche il fuso orario come avviene nelle normali firme (CET o CEST tra parentesi). Esempi:
  • col template {{Nf}}: {{subst:nf|20:30, 9 ago 2018 (CEST)|1.2.3.4}}
  • col template {{Non firmato}}: {{subst:non firmato|1.2.3.4|20:30, 9 ago 2018 (CEST)}}

Parametri modifica

Nel seguente elenco sono descritti i parametri che si possono utilizzare per configurare l'archivazione, l'unico obbligatorio è "archive". È importante tuttavia usare anche il parametro "algo", perché il suo valore predefinito è di un giorno: se non lo si ridefinisce verranno archiviate tutte le discussioni più vecchie di un solo giorno.

Nota: archivebot non supporta i parametri lasciati senza valore dopo l'uguale. Se un parametro non è utilizzato, invece di rimuovere solo il valore, va eliminato anche il nome del parametro, altrimenti l'archiviazione di quella pagina non viene effettuata.


  • archive: il nome della pagina dove archiviare le discussioni. Deve essere una sottopagina della pagina corrente e non può essere un redirect. Sono supportate le variabili. Esempio: Discussioni utente:Esempio/Archivio%(counter)d
  • algo Algoritmo per determinare quanto vecchio è l'ultimo commento in ogni discussione per essere archiviata. Deve essere nella forma: old(<age>) dove <age> è il valore minimo (in ore o giorni: 24h, 72h, 5d, 21d etc.). Il default è old(24h).
  • counter: il valore iniziale di counter. Il bot aggiornerà automaticamente il suo valore. Il default è 1.
  • maxarchivesize: la dimensione massima dell'archivio prima di incrementare counter. È ignorato se counter non viene usato. I valori devono avere il formato #B, #K, #M, o #T, per esempio: maxarchivesize=256K. Il default è 1000M.
  • minthreadsleft: il numero minimo di discussioni da lasciare nella pagina. Il default è 5.
  • minthreadstoarchive: il numero minimo di discussioni da archiviare alla volta. Il default è 2.
  • archiveheader: contenuto da usare come header negli archivi. Questo parametro supporta l'uso di variabili. Il valore non può avere più linee. Viene di solito valorizzato con un template apposito. Il valore di default è {{Avviso archivio}}.

(legenda colori)

{{Utente:ItwikiBot/Archiver
|archive =
|algo =
|counter =
|maxarchivesize =
|minthreadsleft =
|minthreadstoarchive =
|archiveheader =
}}

Variabili modifica

Nel seguente elenco sono descritte le variabili che possono essere utilizzate nei parametri "archive" e "archiveheader".

  • %(counter)d il valore corrente del counter
  • %(year)d l'anno della discussione che si sta archiviando
  • %(month)d il numero del mese della discussione che si sta archiviando, compreso tra 1 e 12
  • %(monthname)s il nome del mese della discussione che si sta archiviando
  • %(monthnameshort)s le prime tre lettere del nome del mese della discussione che si sta archiviando

Esempi modifica

Nei seguenti esempi sono riportati alcuni modelli di configurazione. Gli esempi fanno riferimento all'archiviazione della pagina di discussione di utente di nome "Esempio".

Archivio con date modifica

Archiviazione in sottopagine di nome "Archivio numAnno", delle discussioni più vecchie di 90 giorni. 

{{Utente:ItwikiBot/Archiver
|algo = old(90d)
|archive = Discussioni utente:Esempio/Archivio %(year)d
}}

Archiviazione in sottopagine di nome "Archivio/numAnno mese", delle discussioni più vecchie di 90 giorni. 

{{Utente:ItwikiBot/Archiver
|algo = old(90d)
|archive = Discussioni utente:Esempio/Archivio/%(year)d %(monthname)s
}}

Archivio incrementale modifica

Archiviazione in sottopagine "Archivio num", delle discussioni più vecchie di 90 giorni: quando la sottopagina in cui si sta archiviando supera i 70 Kb ne viene creata una nuova con il numero successivo. Anche una sola discussione è archiviata (minthreadstoarchive=1). Il numero minimo di discussioni da lasciare è quattro (minthreadsleft = 4). 

{{Utente:ItwikiBot/Archiver
|algo = old(90d)
|archive = Discussioni utente:Esempio/Archivio%(counter)d
|counter = 1
|maxarchivesize = 70K
|archiveheader = {{Avviso archivio}}
|minthreadstoarchive = 1
|minthreadsleft = 4
}}

Archivio statico modifica

Archiviazione in una sola sottopagina Archivio delle discussioni più vecchie di 90 giorni. 

{{Utente:ItwikiBot/Archiver
|algo = old(90d)
|archive = Discussioni utente:Esempio/Archivio
}}

Pagine correlate modifica

Estratto da "https://it.wikipedia.org/w/index.php?title=Utente:ItwikiBot/Archiver/man&oldid=120151954"