Differenze tra le versioni di "Wikicontrib.sh"

[versione bozza][versione verificata]
(Creata pagina con "'''wikicontrib.sh''' è un semplice [http://it.wikipedia.org/wiki/Bash Bash script] creato da Son Gohan che permette di calcolare il numero di contributi ...")
 
 
(3 versioni intermedie di uno stesso utente non sono mostrate)
Riga 1: Riga 1:
 
'''wikicontrib.sh''' è un semplice [http://it.wikipedia.org/wiki/Bash Bash script] creato da [[Utente:Son Gohan|Son Gohan]] che permette di calcolare il numero di contributi di qualunque utente di wiki.metin2.it.
 
'''wikicontrib.sh''' è un semplice [http://it.wikipedia.org/wiki/Bash Bash script] creato da [[Utente:Son Gohan|Son Gohan]] che permette di calcolare il numero di contributi di qualunque utente di wiki.metin2.it.
 +
 +
'''versione attuale''': 1.0
  
 
== Funzionamento dello script ==
 
== Funzionamento dello script ==
Riga 44: Riga 46:
  
 
== Come scaricare il tool ==
 
== Come scaricare il tool ==
Il tool è disponibile per il download qui: [http://www63.zippyshare.com/v/52329839/file.html wikicontrib.sh v1.0]
+
Il tool è disponibile per il download qui: [https://drive.google.com/file/d/0BzqX2zkMQ6wnMmF4eHFxWEtIYm8/edit?usp=sharing wikicontrib.sh v1.0]
  
 
Una volta scaricato, si lancia nel seguente modo:
 
Una volta scaricato, si lancia nel seguente modo:
Riga 52: Riga 54:
 
* da questo momento è possibile lanciare lo script usando il comando sopra riportato.
 
* da questo momento è possibile lanciare lo script usando il comando sopra riportato.
  
 +
== Requisiti di sistema ==
 +
* Una shell, preferibilmente <code>bash</code>, altrimenti anche <code>zsh</code> o <code>sh</code> (bash è di norma la shell di default presente su qualunque sistema Unix-like, compreso OS X);
 +
* Il programma <code>wget</code>, solitamente preinstallato su sistemi Unix-like, o in alternativa <code>curl</code> (in questo caso però sarà necessario decommentare e commentare le apposite due righe nello script).
 
[[Categoria:Tool]]
 
[[Categoria:Tool]]

Versione attuale delle 13:35, 31 mag 2014

wikicontrib.sh è un semplice Bash script creato da Son Gohan che permette di calcolare il numero di contributi di qualunque utente di wiki.metin2.it.

versione attuale: 1.0

Funzionamento dello script

Lo script funziona scaricando temporaneamente le pagine html della wiki corrispondenti alle pagine "Contributi Utente", eseguendo un parsing su di esse e contando il numero di modifiche per ogni pagina di contributi, fornendo quindi il numero totale di modifiche effettuate dall'utente in questione. Naturalmente è necessario essere connessi a Internet per scaricare queste pagine.

Utilizzo del tool

wikicontrib.sh viene lanciato da linea di comando da un qualunque terminale UNIX che supporti Bash (tipicamente: qualunque distribuzione Linux e MacOS). L'utilizzo base è il seguente:

./wikicontrib.sh <nome_utente>

dove <nome_utente> sta ovviamente per il nome dell'utente del quale si desiderano contare i contributi. NOTA BENE: se il nome dell'utente in questione è composto da più parole, sostituire ogni spazio con un underscore.

Il numero di edit viene di default mostrato a schermo. È possibile però redirigere l'output su file (vedi sezione: Opzioni).

Opzioni

Oltre al nome_utente è possibile passare allo script le seguenti opzioni:

--dump <nome_file> Appende una riga con il formato "nome_utente numero_edit" al file chiamato nome_file
--help Fornisce un messaggio di istruzioni sull'utilizzo del tool.

L'opzione --dump è utile se si vogliono generare liste: in tal caso è infatti sufficiente lanciare lo script in un ciclo nel seguente modo:

for i in $(cat lista_nomi.txt); do
        ./wikicontrib.sh $i --dump lista_edit.txt
done

Questo comando conta i contributi di tutti i nomi contenuti in "lista_nomi.txt" e restituisce un file "lista_edit.txt" contenente:

Nome_1     123
Nome_2     456
...

dove la prima colonna contiene tutti i nomi di "lista_nomi.txt" e la seconda i rispettivi edit.

NOTA BENE: il numero di edit restituito può in certi casi non essere preciso al 100%; comunque solitamente non differisce di molto dal valore vero.

Come scaricare il tool

Il tool è disponibile per il download qui: wikicontrib.sh v1.0

Una volta scaricato, si lancia nel seguente modo:

  • Aprire un terminale (in OSX si chiama "Terminal.app"; su Linux può avere vari nomi a seconda del DE)
  • spostarsi nella cartella contenente lo script (tipicamente: `cd ~/Downloads`)
  • eseguire un `chmod +x wikicontrib.sh` per rendere lo script eseguibile
  • da questo momento è possibile lanciare lo script usando il comando sopra riportato.

Requisiti di sistema

  • Una shell, preferibilmente bash, altrimenti anche zsh o sh (bash è di norma la shell di default presente su qualunque sistema Unix-like, compreso OS X);
  • Il programma wget, solitamente preinstallato su sistemi Unix-like, o in alternativa curl (in questo caso però sarà necessario decommentare e commentare le apposite due righe nello script).