Prerequisiti
[modifica | modifica wikitesto]- Installare Python (Python.org versione 2.x, 3.x non testata)
- Installare Pywikipedia (meta:Pywikipediabot)
- Copiare gli script filtro.py e wiki_lib.py nella directory pywikipedia (qui gli script)
- (facoltativo) modificare filtro.py per impostare una pagina differente per la scrittura dei report
- disporre di un account per bot
- modificare user-config.py per il proprio account
Manuale d'uso
[modifica | modifica wikitesto]Lanciare da riga di comando con le opzioni desiderate. Senza parametri il default è equivalente a:
filtro.py -sizeshort:1000 -size:4000 -days:0 -start:0 -num:100 -file:report
Elenco delle possibili opzioni
[modifica | modifica wikitesto]| Opzione | Utilizzo |
|---|---|
| -? | Presenta l'aiuto per le opzioni |
| -debug | Abilita le stampe (locali) di debug |
| -nofile | Non salva il file locale del report |
| -nopage | Non salva la pagina wiki del record |
| -start:n | Specifica l'offset (in giorni) da cui partire (0=oggi, 1=ieri, n=oggi-n) |
| -days:n | Numero di giorni da esaminare (riferiti alla data di partenza) |
| -num:n | Specifica il numero di pagine da esaminare (se day è 0 è il numero totale di pagine, se day non è 0 è il numero di pagine del blocco) |
| -size:x | Dimensione minima della pagina per essere inclusa nelle pagine lunghe |
| -sizeshort:x | Dimensione massima della pagina per essere inclusa nelle pagine corte |
| -file:nome | Specifica il nome del file di report (default: report) |
| -progetti | Seleziona le voci nuove per i progetti |
Per modificare la pagina wiki del report è necessario modificare il codice Python.
Esempi di comandi usati
[modifica | modifica wikitesto]filtro.py -num:100 -size:4500 -start:1 -days:7
Crea il report, parte dalle voci di ieri, ogni 100 pagine controlla la data, si ferma alla data odierna (esclusa dal calcolo) - 7 giorni (esempio: lanciando il filtro il lunedì considera tutte le pagine fino al lunedì precedente). Modifica la dimensione minima per le pagine lunghe (da 4000 a 4500, non quella per le corte)
filtro.py -append -num:100 -size:4500 -start:1 -days:3
Aggiunge in testa al report esistente (sia lunghe che corte) le nuove pagine degli ultimi 3 giorni.
filtro.py -append -tail -num:100 -size:4500 -start:7 -days:14
Aggiunge in coda al report esistente, parte da una settimana fa, ogni 100 pagine controlla la data, si ferma alla data odierna (esclusa) - 14 giorni (quindi considera, più o meno, non la settimana precedente, che viene eliminata, ma quella ancora antecedente).
filtro.py -cleanup -onlyshort
Esegue la pulizia del report (solo pagine corte) già esistente. Utile per togliere le pagine che nel frattempo sono state taggate con qualche template (o non sono più corte). Può darsi che sia più veloce ricreare il report ex-novo.