Utente:.pier.bot./Manuale

Prerequisiti

1. Installare Python (Python.org versione 2.x, 3.x non testata)
2. Installare Pywikipedia (meta:Pywikipediabot)
3. Copiare gli script filtro.py e wiki_lib.py nella directory pywikipedia (qui gli script)
4. (facoltativo) modificare filtro.py per impostare una pagina differente per la scrittura dei report
5. disporre di un account per bot
6. modificare user-config.py per il proprio account

Manuale d'uso

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

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)
-append	Aggiunge le pagine, non sovrascrive il report
-head	Appende in testa (default)
-tail	Appende in coda
-cleanup	Ricontrolla le pagine già selezionate, ri-applicando il filtro (toglie le pagine non più esistenti o che non rispettano i criteri, non aggiunge pagine a quelle già selezionate)
-onlyshort	Clean-up solo per le pagine corte
-onlylong	Clean-up solo per le pagine lunghe
-progetti	Seleziona le voci nuove per i progetti

Per modificare la pagina wiki del report è necessario modificare il codice Python.

Esempi di comandi usati

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.