Utente:Salvatore Ingala/scripts/Commandline: differenze tra le versioni

Versione delle 00:47, 19 dic 2006

Versione attuale delle 15:59, 4 apr 2011

(37 versioni intermedie di 2 utenti non mostrate)

Riga 1:

<div style="background: #FFA0A0">

'''Questa documentazione non è aggiornata!''' Quello che c'è scritto è ancora vero, ma si possono fare molte più cose! :-)

</div>

{{Vedi anche|/Manuale completo}}

La '''Commandline''' è uno strumento che ho scritto per velocizzare il lavoro di [[Progetto:patrolling|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 [[GUI|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 ==

Basta aggiungere IN CIMA al [[Speciale:Mypage/monobook.js|vostro monobook]] il codice che segue:

=== Modalità ''normale'' ===

Per chi ha il [[Wikipedia:Monobook.js|Monobook standard]], è sufficiente aggiungere l'opzione "cmd" alla variabile <code>toLoad</code>.

=== Vecchia maniera ===

Per chi non ha il Monobook standard, basta aggiungere al [[Speciale:Mypage/monobook.js|vostro monobook]] il codice che segue:

<pre><nowiki>

Line 17 ⟶ 29:

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).

Il motivo per cui il codice va aggiunto in cima è una incompatibilità con il [[Wikipedia:Monobook.js|monobook standard]] che non sono riuscito a rintracciare. La situazione è comunque temporanea.

Se usate l'estensione del monobook WikEd, date anche un'occhiata [[#Non_mi_funziona_alt.2Bz|qua]], prima.

== Come si usa ==

Line 23 ⟶ 37:

[[Immagine:Salvatore_Ingala-Esempio_commandline.png|frame|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+dz (lo so che è lo stesso tasto che si usa per cancellare le pagine, ma se avete la Commandline non funzioneràfunziona, piùprovate percon quello scopo :P — ciò potrebbe cambiare nella versione definitivashift+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 ==

Line 29 ⟶ 43:

La sintassi dei comandi è molto semplice:

:<code>comando#parametro1#parametro2#...</code>

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.

Line 35 ⟶ 49:

È possibile concatenare più comandi:

:<code>comando1#parametro1#parametro2#...#comando2#parametro1#parametro2#...</code>

In questo caso, è necessario indicare tutti i parametri eccetto, eventualmente, quelli dell'ultimo comando, che, sarannose eventualmentemancanti, 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.

Line 54 ⟶ 68:

| w|| w|| w#argomento|| Inserisce il template <nowiki>{{W}}</nowiki> (Da wikificare).

|-

| s|| s|| s#argomentoargomenti|| Inserisce il template <nowiki>{{S}}</nowiki> (Stub). <code>argomento</code> può essere della forma <code>argomento1<nowiki>|</nowiki>argomento2</code>, conformemente al template [[Template:S|S]]

|-

| p|| p|| p#motivo#argomento|| Inserisce il template <nowiki>{{P}}</nowiki> (nNPOV).

|-

| e|| e|| e#motivo#argomento|| Inserisce il template <nowiki>{{E}}</nowiki> (da controllare per enciclopedicità dubbia).

|-

| t|| t|| t#lingua#argomento|| Inserisce il template <nowiki>{{T}}</nowiki> (da tradurre).

|-

| o|| o|| o#argomento|| Inserisce il template <nowiki>{{O}}</nowiki> (Orfana).

|-

| categorizzare|| cat|| categorizzare|| Inserisce il template <nowiki>{{da categorizzare}}</nowiki> in fondo alla voce.

Line 70 ⟶ 90:

| purge|| pu|| purge|| Pulisce la cache del server. Ha senso solo come ultimo comando della riga.

|}

I comandi <code>a</code>, <code>c</code>, <code>w</code>, <code>s</code>, <code>p</code>, <code>e</code>, <code>t</code>, <code>categorizzare</code>, <code>unire</code>, <code>fixformat</code>, <code>replace</code>, <code>benvenuto</code> sono in grado di aprire automaticamente la pagina in modifica (così si risparmia di dover prima cliccare su "modifica" e poi aprire la commandline).

Il parametro ''argomento'' dei comandi <code>a</code>, <code>c</code>, <code>w</code>, <code>s</code>, <code>p</code>, <code>e</code>, <code>t</code> supporta il '''completamento automatico''' se l'argomento è uno di quelli noti indicati in [[Aiuto:Abbozzo]]. Il parametro ''lingua'' di <code>t</code> supporta il completamento automatico per la maggior parte delle lingue elencate [[:Categoria:Da finire di tradurre|qui]]; indicando le prime tre lettere si è sicuri che non ci siano ambiguità (come ''rumeno'' e ''russo'', per esempio). Quindi <code>s#mat</code> equivale a <code>s#matematica</code>. Naturalmente il software non è in grado di risolvere da solo i casi di ambiguità; in situazioni del genere, il software sceglierà il primo della lista in ordine alfabetico (dunque, ad esempio, <code>s#bio</code> equivale a <code>s#biografie</code> e non <code>s#biologia</code>).

=== Inutilities ===

Line 88 ⟶ 112:

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

::<code>s#matematica#cat</code> o anche solo <code>s#mat#cat</code>

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

::<code>s#biografie|arte</code> o anche solo <code>s#bio|arte</code>

:Segnalare una voce di letteratura da aiutare:

::<code>a#WND#letteratura</code>

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

::<code>rep#perchè#perché#diff</code>

== Uso avanzato ==

=== Fixformat ===

Il comando <code>fixformat</code> è completamente configurabile, essendo possibile sostituire la lista di sostituzioni standard con una lista personale. Per far ciò, basta inserire nel proprio monobook.js codice simile a questo:

<pre><nowiki>

fixformat_list = new Array(

[regexp1, subst1],

[regexp2, subst2],

. . .

[regexp_n, subst_n]

);

</nowiki></pre>

ponendo attenzione al fatto che l'ultima riga non si chiude con la virgola. Ad esempio:

<pre><nowiki>

fixformat_list = new Array(

[/ anzich(è|e')/g, "anziché"],

[/ affinch(è|e')/g, "affinché"],

[/ bench(è|e')/g, " benché"],

[/ cioé/g, " cioè"],

[/ nonch(è|e')/g, " nonché"],

[/ perch(è|e')/g, " perché"],

[/ poich(è|e') /g, " poiché "],

[/ quì /gi, " qui "],

[/ quà /gi, " qua "],

[/ qual'è /gi, " qual è "],

[/ sè /gi, " sé "],

[/si' /g, "sì"],

[/ tr(è|e'|é) /g, " tre "]

);

</nowiki></pre>

per fare alcune sostituzioni di errori comuni (questi esempi, in realtà, sono già presenti nelle sostituzioni standard). È anche possibile modificare il ''subject'' del comando:

<pre><nowiki>

fixformat_subject = "subject diverso da quello standard; ";

</nowiki></pre>

== Storico versioni ==

*2.2: Correzioni minori

*2.1: Aggiunti comandi ''grep'', ''uniq'' e ''sleep''. Corretto un bug. Introdotta la modalità ''safe mode'' per motivi di sicurezza.

*2.0: Adesso le funzioni che agiscono in modifica aprono automaticamente la pagina in modifica, se è il caso. Aggiunte numerose funzioni (per il momento non documentate) e potenziato il linguaggio con l'aggiunta di variabili e espansione dinamica del codice (documentazione mancante, per ora).

*1.0.3: Reso compatibile con [http://en.wikipedia.org/wiki/User:Cacycle/wikEd WikEd] (grazie a [[Utente:Jalo|Jalo]] per il prezioso aiuto).

*1.0.2: Corretti 2 bug su Internet Explorer.

*1.0.1: Migliorata gestione della hotkey; ora funziona anche alt+z; bugfix. Aggiunto comando "o" per il template <nowiki>{{O}}</nowiki>.

*1.0: Prima versione pubblica.

== Risoluzione dei problemi ==

=== Ho il [[Wikipedia:Monobook.js|Monobook standard]] ma non vedo la commandline, perché? ===

Assumo che abbia già purgato la cache del tuo browser...<br />

Hai aggiunto "cmd" (senza apici) nella variabile toLoad?

==== No ====

Fallo! -_-

==== Sì ====

Ricordati che prima e dopo di "cmd", nella variabile toLoad, deve esserci uno spazio.

=== Non mi funziona alt+z ===

Hai installato l'estensione WikEd?

==== No ====

Contattami, potrebbe trattarsi di un bug.

==== Sì ====

Se hai installato la WikEd tramite il Monobook Standard, non dovrebbe succedere. Se hai installato la WikEd senza il monobook standard, assicurati di caricare il codice della WikEd PRIMA di quello della commandline, altrimenti alt+z non funzionerà quando ci si trova all'interno dell'area di modifica. È un problema noto e probabilmente non ci si può far nulla :)

=== Ovviamente non ho risolto il mio problema. E adesso? ===

Non c'erano dubbi. Adesso non ti resta che [[Utente:Salvatore Ingala|contattarmi]] e sperare che sappia risolvere il tuo problema.

== Note ==