Utente:Salvatore Ingala/scripts/Commandline

La Commandline è uno strumento che ho scritto per velocizzare il lavoro di patrolling rendendo disponibili da tastiera, con brevi comandi, funzioni che tipicamente sono presenti nella Toolbar personalizzata che tutti i buoni patrollatori hanno adottato (v. Wikipedia:Monobook.js).

Per quanto le interfacce grafiche (e l'invenzione del mouse) abbiano migliorato la curva di apprendimento degli utenti, di certo non hanno velocizzato l'uso da parte dell'utente esperto. Questo strumento è scritto per i nostalgici :)

La versione corrente è ancora in fase alpha, perciò pazientate per la versione definitiva. :)

Installazione

Modalità normale

Per chi ha il Monobook standard, è sufficiente aggiungere l'opzione " cmd " alla variabile toLoad.

Vecchia maniera

Per chi non ha il Monobook standard, basta aggiungere al vostro monobook il codice che segue:

//Commandline.
// Vedi [[Utente:Salvatore_Ingala/scripts/Commandline]]
// 
document.writeln('<script type="text/javascript" src="/w/index.php?title=Utente:Salvatore_Ingala/commandline.js&action=raw&ctype=text/javascript&dontcountme=s"></script>');

In teoria dovrebbe essere compatibile con qualunque codice precedente.

Se doveste avere problemi, provate ad inserire il suddetto codice in cima al vostro monobook anziché in fondo. Se ancora non funziona, contattatemi, farò il possibile per risolvere il problema (ma non si fornisce alcuna garanzia né sul tempismo, né sulla qualità dell'assistenza :P).

Come si usa

Esempio di uso della Commandline

La Commandline è del tutto invisibile, a parte un link che viene aggiunto nella barra "strumenti", sulla sinistra. Cliccando su di esso, compare la riga di comando. Che fate?! Avete cliccato? Abbiamo detto che si usa dalla tastiera! Per fare comparire la finestrella che vi chiede istruzioni basta premere shift+alt+z. La finestra di popup che compare, naturalmente, non contiene nessuna istruzione, perciò leggete prima le istruzioni :P. Quando compare la riga di comando, non dovete far altro che inserire il comando e premere Invio.

I comandi

La sintassi dei comandi è molto semplice:

comando#parametro1#parametro2#...

Il tasto # è usato come separatore. Il numero di parametri previsti varia a seconda dei comandi. Non è però necessario imparare a memoria lunghe liste di prototipi di comandi: se non inserite i parametri, vi verranno chiesti tramite apparizioni successive della riga di comando (la finestra riporterà anche una breve descrizione del parametro richiesto, ad es.: "Motivo"). NOTA: non è possibile inserire il cancelletto # all'interno di un parametro, ma è possibile farlo se si digita il parametro lasciato vuoto in una delle apparizioni successive della riga di comando.

È possibile concatenare più comandi:

comando1#parametro1#parametro2#...#comando2#parametro1#parametro2#...

In questo caso, è necessario indicare tutti i parametri eccetto, eventualmente, quelli dell'ultimo comando, che, se mancanti, saranno richiesti tramite finestra di popup.

Quando non vi è ambiguità, si può indicare anche solo l'inizio del nome di un comando, e la sofisticatissima intelligenza artificiale della Commandline capirà lo stesso.

Lista dei comandi

Ecco la lista dei comandi attualmente supportati. La tabella indica nell'ordine: il nome del comando, il prefisso equivalente consigliato (non necessariamente il prefisso minimo possibile, ma usando questi si riduce la possibilità di ambiguità con comandi futuri), la sintassi completa di parametri, una breve descrizione.

Comando	Prefisso	Sintassi completa	Descrizione
a	a	a#motivo#argomento	Inserisce il template {{A}} (da aiutare); il significato dei parametri è ovvio.
c	c	c#motivo#argomento	Inserisce il template {{C}} (da controllare).
w	w	w#argomento	Inserisce il template {{W}} (Da wikificare).
s	s	s#argomenti	Inserisce il template {{S}} (Stub). `argomento` può essere della forma `argomento1\|argomento2`, conformemente al template S
p	p	p#motivo#argomento	Inserisce il template {{P}} (nNPOV).
e	e	e#motivo#argomento	Inserisce il template {{E}} (da controllare per enciclopedicità dubbia).
categorizzare	cat	categorizzare	Inserisce il template {{da categorizzare}} in fondo alla voce.
unire	unire	unire#voce	Inserisce il template {{da unire}}; richiede il titolo della voce simile.
fixformat	fix	fixformat	Sostituzioni automatiche (nessun parametro).
replace	rep	replace#cerca#sostituiscicon	Funzione cerca e sostituisci. Supporta le regexp.
benvenuto	ben	benvenuto	Messaggio di benvenuto per i nuovi utenti (nessun parametro).
purge	pu	purge	Pulisce la cache del server. Ha senso solo come ultimo comando della riga.

Il parametro argomento dei comandi a, c, w, s, p, e supporta il completamento automatico se l'argomento è uno di quelli noti indicati in Aiuto:Abbozzo. Quindi s#mat equivale a s#matematica. Naturalmente il software non è in grado di risolvere da solo casi di ambiguità; in questi casi, il software sceglierà il primo della lista in ordine alfabetico (dunque, ad esempio, s#bio equivale a s#biografie e non s#biologia).

Inutilities

Di seguito alcuni comandi che, probabilmente, non vi servono (o forse si):

Comando	Prefisso	Sintassi completa	Descrizione
save	save	save	Simula la pressione del tasto "Salva la pagina". Ha senso solo come ultimo comando della riga.
preview	prev	preview	Simula la pressione del tasto "Visualizza anteprima". Ha senso solo come ultimo comando della riga.
diff	diff	diff	Simula la pressione del tasto "Mostra cambiamenti". Ha senso solo come ultimo comando della riga.

Qualche esempio

Inserire una voce tra gli stub di matematica e segnalarla 'da categorizzare':

s#matematica#cat o anche solo s#mat#cat

Inserire una voce tra gli stub relativi alle biografie e all'arte:

s#biografie|arte o anche solo s#bio|arte

Segnalare una voce di letteratura da aiutare:

a#WND#letteratura

Sostituire tutte le occorrenze di perchè in perché e controllare i cambiamenti effettuati:

rep#perchè#perché#diff

Note

Qualsiasi feedback è gradito! Anche solo per dirmi: guarda il tuo tool fa schifo e non lo userò mai. :P

Pagine correlate

Wikipedia:Monobook.js