Utente:Timendum/Javascript

Un JavaScript è, in parole semplici, un programmino che manipola una certa pagina HTML, se volete piú informazioni potete fare riferimento alla relativa pagina enciclopedica.

Per migliorare la fruibilità di Teknopedia io stesso ho creato alcuni script che facilitano alcune operazioni. Visto che non ci guadagno niente (né vorrei farlo) né ho modo di controllare il mio "lavoro", mi farebbe molto piacere che scriviate qualcosa nella pagina di discussione, per avvertirmi che il mio sbattimento è stato utile a qualcuno.

Se avete commenti, pareri o proposte utilizzate la pagina di discussione di questa voce, se invece trovate degli errori (grammaticali, di sintassi) o delle imperfezioni in questa pagina sentitevi pure liberi di modificarla direttamente :)

Il software MediaWiki permette all'utente di scrivere ed eseguire un proprio file javascript, in questo modo si può ulteriormente modificare l'interfaccia e facilitare i propri compiti. Questa possibilità è abilitata di default e aspetta solo di essere sfruttata.

Per utilizzare questa caratteristica, basta modificare (o creare) un file chiamato "monobook.js", e che si trova in Utente:NomeUtente/monobook.js (ovviamente sostituite NomeUtente con il vostro nick!). Lì aggiungete tutto quello che volete

Dall'alto della mia esperienza (del tutto inesistente e pressapochista) mi sento di consigliarvi prima di tutto di tenere il file ordinato, una riga che inizia con "//" viene percepita come un commento, possono essere utilizzate per ricordare a che serve la parte successiva o dove avete preso quel pezzo di codice.

Inoltre il nostro amato (e odiato) MediaWiki tende a sostituire troppo quando si scrive un file javascript, quindi è buona norma iniziare il proprio monobook.js con "// '" e terminarlo con "''// ", in modo da tenerlo a bada.

Ecco un esempio di un buon file monobook.js

// <nowiki>
// Primo script: Nome
// Serve a fare questo questo e questo
// Preso da [[qui]]
..
// Secondo script: Nome
..
..
// </nowiki>

ATTENZIONE: WikiSign non è più supportato a causa dei cambiamenti avvenuti nei javascript di mediawiki, utilizzare la nuova funzione di Toolbar.

Toolbar è la nuova versione di ToolbarButton aggiunge alla toolbar predefinita (la toolbar è la barra dei pulsanti sopra l'area di modifica del testo, quella con il grassetto, corsivo, firma, immagine, eccetera) almeno la maggior parte) alcuni bottoni (a scelta) e ne può togliere altri (sempre a scelta). I bottoni aggiungibili sono "Da wikificare", "da aiutare", "Benvenuto" e i tre pulsanti per votare, mentre si possono togliere tutti i bottoni predefiniti. Se hai idee per nuovi pulsanti non esitare a contattarmi!

ATTENZIONE: lo script è compatibile con Firefox in cui è stato scritto quindi molto testato, con Mozilla Suite grazie a Superchilum e con Internet Explorer, ma senza molti test; su altri browser dovrebbe andare senza problemi, ma non ho ricevuto notizie.

Vorrei anche invitare gli utenti a seguire le istruzioni per l'installazione e a non creare una copia personale, se ognuno ha il suo non si va avanti insieme.

Un ringraziamento a tutti gli utenti che hanno contribuito, sono veramente tanti, abbastanza da rendere questo script di tutti, io ho solo messo insieme.

Lo stesso argomento in dettaglio: Utente:Timendum/Toolbar Immagini.

Inoltre vorrei sottolineare che il codice è tutto scritto da me, ma mi sono ispirato anche al codice di Salvatore Ingala e alle immagini di っ (trovate su Commons).

Per gli utenti meno tecnici o più sbrigativi, ho provveduto con un esempio di installazione a passi.

Per "installare" questo script bisogna modificare il proprio "monobook.js" (vedi istruzioni sopra) e aggiungere le seguenti righe:

// <nowiki>
var dell = "elenco separato da spazi dei bottoni da togliere";
var agg = "elenco separato da spazi dei bottoni da aggiungere";
document.writeln('<script type="text/javascript" src="/w/index.php?title=Utente:Timendum/Toolbar.js&action=raw&ctype=text/javascript&dontcountme=s"></script>');
// 
</nowiki>

Nota: visto che potrei sempre migliorare questo script (l'ho già fatto), vi consiglio di tenere d'occhio questa pagina e di mettere un link nel vostro monobook.js (prima del <nowiki>!).

Tramite il paramentro dell si specifica quali pulsanti si vogliono cancellare, tramite agg quelli da aggiungere; una piccola nota, in realtà i pulsanti non vengono cancellati ma solo non vengono disegnati, diciamo resi "invisibili". Le sigle devono essere separate da spazi. Qui le sigle (in ordine da sinistra a destra):

gra = Grassetto
cor = Corsivo
lin = Link interno
ext = Link esterno
== = Sottointestazione
img = Immagine
med = GMedia file
mat = Formula matematica
now = Nowiki
sig = Firma
hr = Linea orizzontale
red = Redirect

Alcuni esempi:

var dell = "hr med";

Così si elimina Linea orizzontale e File Multimediale

var dell = "gra cor lin == hr";

In questo modo si eliminano i comandi brevi (di pochi caratteri).

var dell = "";

Infine così non si elimina niente.

Con il paramentro agg si aggiungono pulsanti alla toolbar, qui la lista è limitata ai pulsanti che sono stati creati fin'ora, non li ho fatti tutti io, anzi, molti sono contributi in vari modi; se avete suggerimenti o altri pulsanti non esitate a contattarmi! La sintassi per scegliere i bottoni da aggiungere è sempre quella, basta mettere tutte le sigle separate da spazio, non è possibile stabilire l'ordine di aggiunta, è fissato.

I pulsanti da aggiungere sono divisi in 3 categorie: visibili sempre, solo per gli articoli, solo per le discussioni utente. Qui le sigle (in ordine di aggiunta e con autore):

Sempre
sign = Firma personalizzata (per sopperire la mancaza di WikiSign), per dettagli vedi sotto.
strk = Per rendere il testo barrato
under = Per sottolineare il testo
sml = Testo piccolo
pre = Testo <pre>Preformattato</pre>
tt = Testo <code>con font fisso</code> (il pre ma questo può essere messo in mezzo ad un paragrafo)
tmpl = Template ({{ }}) facile
ttl = Link al Template tramite {{tl}} subst: 
comm = Per i commenti (<!-- -->)
typo = Corregge comuni errori di battitura (vedi sotto)
voto = Aggiunge i tre pulsanti di voto (+1, -1 e 0) con subst: (per evitare troppi template) e il pulsante "#" che inserisce "# ~~~~ per le votazioni
voca = Aggiunge quattro pulsanti per gestire le votazioni alle cancellazioni ( {{canc fatte}} {{CR}} {{CE}} {{CQ}}
delg = Segna da "Cancellare subito" ({{Cancella subito}})
Voci
cat = Per aggiugnere categorie facilmente
gall = Creare gallerie
vedi = Template {{vedi anche}}
stu = Segnala come Stub (Aggiunge il [[:Template:Stub]])
wik = Segnala come "Da wikificare" (Template:W)
aiu = Segnala come "Da aiutare" chiedendo una motivazione (Template:A)
pov = Segnala come non neutrale (Template:P)
ctrl = Segnala come ""Da controllare" (Template:C)
cate = Segnala come "Da categorizzare"
uni = Segnala come "Da unire"
red = Crea Redirect
dsmb = Crea Disambigua
cncp = Segna da "Cancellare subito" per violazione di Copyright, chiede la fonta ({{cancelcopy}})
del = Segna da "Cancellare subito" ({{Cancella subito}})
ctrcp = Segna come possibile violazione di copyright ({{Controlcopy}})
unv = Segna come non verificata ({{Unverified}})
bloc = Pulsanti per segnalare i blocchi ( {{Avvisobloccoparziale}})
ref = 2 Pulsanti:  uno che mette  <ref></ref> e uno che mette <references />
Utenti
ben = Aggiunge il template di benvenuto
adel = Avvisa della cancellazione di una pagina, chiede voce
vand = Aggiunge la nota sul vandalismo (Template:Vandalismo)
test = Avvisa un utente della cancellazione di un suo test
avcpy = Avvisa un utente di una violazione di Copyright chiedendo i parametri
spam = Avviso sullo spam
licim = Avvisa un utente della mancanza di licenza su una immagine chiedendo i parametri

Se tra le aggiunte c'è "sign" è necessario specificare due nuovi dettagli, per configurare la firma. Prima ci serve capire come funziona la firma, se non vi intaressa passate direttamente sotto per i "precotti". Il bottoncino della firma non fa altro che aggiungere del testo nello spazio attorno al cursore lampeggiante del testo, ne può aggiungere una prima e una dopo, attualmente aggiunge solo --~~~~ prima del cursore, in modo che una volta messa la firma si sia pronti a scrivere dopo di questa, nel codice "installato" la firma consiste in Timen.dum (cioè la firma base) prima del cursore e ~~~~~ (cioè la data) dopo di esso, così si è pronti a scrivere tra il proprio nick e la data. Modificando i parametri wikisign_pre e wikisign_post si può cambiare la firma stessa, chiaramente la prima variabile rappresenta il testo da aggiungere davanti e la secondo quello da aggiungere dopo il cursore. Ricordatevi sempre di mettere il testo tra '.

Ecco come bisogna impostare le due variabili per alcuni risultati

var wikisign_pre = '~~~~';
var wikisign_post = '';

Per la firma normale ma senza i due --

var wikisign_pre = '~~~';
var wikisign_post = '~~~~~';

Per la firma normale ma senza i due --, con il cursore la firma vera e propria e la data

Il tasto Typo può fare molte cose, per ora si limita a correggere alcuni errori di italiano, sistema i vari segni strani (ad esempio ’ “) e sostituisce ai codici HTML i relativi caratteri. Potrebbe fare qualcosa in più, ma per ora non mi azzardo, se avete qualche regexp pronta, mandatemela pure, io ne ho in cantina alcune ma sono da testare.

Qualche esempio, ma vi ricordo che la Toolbar è fatta per essere modificata :)

var wikisign_pre = '~~~ ';
var wikisign_post = '~~~~~';
var dell = "med hr sign";
var agg = "wik stu voto sign";

Questa è la mia configurazione al momento della prima stesura di questo testo

var wikisign_pre = '~~~~';
var wikisign_post = '';
var dell = "sign";
var agg = "sign";

Così si ottiene solo il risultato di eliminare i "--" dalla firma.

Una guida per sbrigativa per gli utenti meno informatici:

• Apro il mio monobook in modalità edit; si trova in Utente:IlTuoNick/monobook.js
• Aggiungo le righe

// ToolbarButton
// Vedi [[Utente:Timendum/Javascript]]
// <nowiki>
var dell = "gra cor lin ext == img med mat now sig hr red";
var agg = "sign strk under sml pre tt tmpl ttl comm typo voto cat gall vedi wik stu aiu cate uni red dsmb cncp del ctrcp bloc ben adel vand test avcpy spam licim";
var wikisign_pre = '~~~~';
var wikisign_post = '';
document.writeln('<script type="text/javascript" src="/w/index.php?title=Utente:Timendum/Toolbar.js&action=raw&ctype=text/javascript&dontcountme=s"></script>');
// </nowiki>

• mantengo tra le virgolette nella riga di dell i codici dei pulsanti che mi voglio togliere. Di seguito un esempio di come potrebbe diventare:

var dell = "med hr sign";

• mantengo tra le virgolette nella riga di agg i codici dei pulsanti che mi voglio aggiungere. Di seguito un esempio di come potrebbe diventare::

var agg = "voto sign";

• salvo, premo F5 e provo a vedere se è cambiato qualcosa.