Wikipedia:Monobook.js

Da Wikipedia, l'enciclopedia libera.

Il codice MediaWiki permette l'esecuzione di uno script (monobook.js) che facilita l'utilizzo di Wikipedia attraverso semplici tool.
Il linguaggio usato per la sua codifica è JavaScript e chiunque può crearsene uno personalizzato.
Lo script è, in realtà, una sottopagina utente; la tua è questa. Ogni modifica apportata al suo codice richiede una pulizia della cache per essere applicata (premi CRTL-F5 dopo aver salvato la pagina).

Per facilitare la vita di tutti quelli che non hanno familiarità con queste cose, è stata creata una versione standard e molto completa, che può essere facilmente installata e configurata.

In ogni caso ricordati che:

• Se hai problemi puoi leggere le FAQ in fondo alla pagina o chiedere aiuto qui.
• Se hai nuove proposte o qualche tool che non è ancora stato inserito, parlane qui.

Indice 1 Installazione 2 Configurazione 3 Aggiornamenti 3.1 20 novembre 2006 3.2 26 novembre 2006 3.3 9 dicembre 2006 3.4 20 dicembre 2006 3.5 5 gennaio 2007 3.6 14 gennaio 2007 3.7 15 gennaio 2007 3.8 26 gennaio 2007 3.9 31 gennaio 2007 3.10 14 febbraio 2007 3.11 22 febbraio 2007 3.12 24 febbraio 2007 3.13 27 febbraio 2007 3.14 2 marzo 2007 3.15 6 marzo 2007 3.16 15 marzo 2007 3.17 10 aprile 2007 3.18 11 aprile 2007 3.19 Evoluzioni delle versioni 4 Personalizzazioni avanzate 4.1 Tatoo 4.2 Aggiungi un pulsante alla toolbar 4.2.1 Se il testo va inserito in cima o in fondo alla pagina 4.2.2 Se il testo va inserito nella posizione del cursore 5 FAQ 6 Voci correlate

[modifica] Installazione

// Elenco dei tool da caricare.

var toLoad="purg led ns0 lks orol tabs nav stru unw allp tbar avan cwtch popup nms chat cmd qed wed since goo rch edt ver vpop vfol bot";



//Monobook Modulare
//Lancia il vero monobook
// Vedi [[Wikipedia:Monobook.js/MonobookCompleto.js]]
// 
document.writeln('<script type="text/javascript" src="/w/index.php?title=Wikipedia:Monobook.js/MonobookCompleto.js&action=raw&ctype=text/javascript&dontcountme=s"></script>');

A questo codice si possono aggiungere altri script a scelta dell'utente aggiungendo il relativo codice dopo questo.

Attenzione: per un corretto funzionamento del monobook.js, è assolutamente necessario installare anche il monobook.css copiandolo nel proprio. Invece di copiare tutto il css nel proprio, si può anche aggiungere nel proprio monobook.css la riga:

@import "http://it.wikipedia.org/w/index.php?title=Wikipedia:Monobook.js/monobook.css&usemsgcache=yes&action=raw&ctype=text/css&smaxage=2678400";

[modifica] Configurazione

Dalla versione 4.x il monobook.js è modulare, ovvero potete scegliere cosa installare (per default viene installato tutto).

Per modificare la lista dei tool installati è disponibile uno strumento grafico accessibile dal portlet "strumenti" e intitolato "Setup", che consente di modificare la lista dei moduli (elencati sotto).

Se non volete usare il tool grafico, è sufficiente aprire il vostro monobook in modifica ed editare la linea che inizia con "var toLoad=".

Questa riga contiene una serie di sigle, una per ogni tool da importare.

Le sigle devono essere separate da spazi e quella che segue è la lista dei tool disponibili (altri potrebbero essere aggiunti in futuro, per cui consiglio di mettere questa pagina tra gli Osservati Speciali, vedi il paragrafo Aggiornamenti).

Sigla	Tool inserito	Note
purg	Aggiunge tab "purge"
led	Aggiunge tab "ultima modifica"
ns0	Aggiunge tab "0"	Apre in modifica la sezione 0 della pagina
lks	Personalizza i link nella barra in alto	Pagina utente, discussione, preferenze, ...
orol	Aggiunge l'orologio in alto a destra
tabs	Aggiunge i tab "Messaggi talk" e "strumenti vari"
chat	Aggiunge un link diretto alla chat di wikipedia	Il link verrà aggiunto nella barra superiore
nav	Aggiunge tutti i link nel portlet "navigazione"
newp	Aggiunge "Pagine nuove" nel menù "navigazione"	Non è necessario se avete già specificato "nav"
mjs	Aggiunge 'monobook.js' nel menù "navigazione"	Non è necessario se avete già specificato "nav"
mcss	Aggiunge 'monobook.css' nel menù "navigazione"	Non è necessario se avete già specificato "nav"
sand	Aggiunge "Sandbox" nel menù "navigazione"	Non è necessario se avete già specificato "nav"
blk	Aggiunge "Block Log" nel menù "navigazione"	Non è necessario se avete già specificato "nav"
csu	Aggiunge "Cancella subito" nel menù "navigazione"	Non è necessario se avete già specificato "nav"
pca	Aggiunge "Pagine da cancellare" nel menù "navigazione"	Non è necessario se avete già specificato "nav"
stub	Aggiunge "Stub" nel menù "navigazione"	Non è necessario se avete già specificato "nav"
admin	Aggiunge "Admin" nel menù "navigazione"	Non è necessario se avete già specificato "nav"
prob	Aggiunge "Utenti problematici" nel menù "navigazione"	Non è necessario se avete già specificato "nav"
aut	Aggiunge "Autorizzazione ottenute" nel menù "navigazione"	Non è necessario se avete già specificato "nav"
vand	Aggiunge "Vandalismi in corso" nel menù "navigazione"	Non è necessario se avete già specificato "nav"
rich	Aggiunge "Richieste agli amministratori" nel menù "navigazione"	Non è necessario se avete già specificato "nav"
bot	Aggiunge il link alla pagina dei contributi del proprio bot nel menù "navigazione"	Non è necessario se avete già specificato "nav", per specificare il nome del proprio bot è necessario scrivere var nomeBot="MioBot"; nel proprio monobook.js.
stru	Aggiunge tutti i link nel portlet nel menù "strumenti"
uec	Aggiunge "user edit count" nel menù "strumenti"	Non è necessario se avete già specificato "stru"
log	Aggiunge "Log" nel menù "strumenti"	Non è necessario se avete già specificato "stru"
whois	Aggiunge "Whois" nel menù "strumenti"	Non è necessario se avete già specificato "stru"
newp	Aggiunge "Pagine nuove" nel menù "strumenti"	Non è necessario se avete già specificato "stru"
unw	Aggiunge "non seguire" nella pagina degli Osservati Speciali
allp	Aggiunge il pulsante "AllPages" nel box di ricerca
tbar	Aggiunge tutti i pulsanti alla Toolbar
aiu	"A"iutare	Non è necessario se avete già specificato "tbar"
con	"C"ontrollare	Non è necessario se avete già specificato "tbar"
pov	"P"OV	Non è necessario se avete già specificato "tbar"
wiki	"W"ikificare	Non è necessario se avete già specificato "tbar"
stu	"S"tub	Non è necessario se avete già specificato "tbar"
enc	"E"nciclopedicità dubbia	Non è necessario se avete già specificato "tbar"
tra	Da tradurre	Non è necessario se avete già specificato "tbar"
voto	Votazioni: +1/0/-1	Non è necessario se avete già specificato "tbar"
cocp	Controlcopy	Non è necessario se avete già specificato "tbar"
cacp	Cancelcopy	Non è necessario se avete già specificato "tbar"
cat	Categorizzare	Non è necessario se avete già specificato "tbar"
test	Test	Non è necessario se avete già specificato "tbar"
prom	Promozionale	Non è necessario se avete già specificato "tbar"
benv	Benvenuto	Non è necessario se avete già specificato "tbar"
canc	Da cancellare	Non è necessario se avete già specificato "tbar"
caut	Avvisocancellautente	Non è necessario se avete già specificato "tbar"
cimm	Cancella subito	Non è necessario se avete già specificato "tbar"
cviol	ViolazioneCopyright	Non è necessario se avete già specificato "tbar"
aviol	Avvisocopyviol	Non è necessario se avete già specificato "tbar"
avand	Vandalismo	Non è necessario se avete già specificato "tbar"
yc	Cartellino giallo	Non è necessario se avete già specificato "tbar"
rc	Cartellino rosso	Non è necessario se avete già specificato "tbar"
spam	Avviso spam	Non è necessario se avete già specificato "tbar"
uni	Da unire	Non è necessario se avete già specificato "tbar"
bpar	Avvisobloccoparziale	Non è necessario se avete già specificato "tbar"
edw	Avvisoeditwar	Non è necessario se avete già specificato "tbar"
bnpov	AvvisobloccoNPOV	Non è necessario se avete già specificato "tbar"
tras	Trasferimento	Non è necessario se avete già specificato "tbar"
orf	Orfana	Non è necessario se avete già specificato "tbar"
wip	WIP	Non è necessario se avete già specificato "tbar"
cgr	Da correggere	Non è necessario se avete già specificato "tbar"
aimm	Avvisoimmagine	Non è necessario se avete già specificato "tbar"
unv	Unverified	Non è necessario se avete già specificato "tbar"
date	Date personali	Non è necessario se avete già specificato "tbar"
grz	Grazie	Non è necessario se avete già specificato "tbar"
ndis	Nota disambigua	Non è necessario se avete già specificato "tbar"
dis	Disambigua	Non è necessario se avete già specificato "tbar"
vedan	Vedi anche	Non è necessario se avete già specificato "tbar"
mon	Monitoraggio	Non è necessario se avete già specificato "tbar"
gall	Gallery	Non è necessario se avete già specificato "tbar"
ref	References	Non è necessario se avete già specificato "tbar"
ipro	Interprogetto	Non è necessario se avete già specificato "tbar"
sbo	Scroll box	Non è necessario se avete già specificato "tbar"
sot	Testo sottolineato	Non è necessario se avete già specificato "tbar"
small	Testo piccolo	Non è necessario se avete già specificato "tbar"
bar	Testo barrato	Non è necessario se avete già specificato "tbar"
case	Trasforma maiuscolo in minuscolo e viceversa	Non è necessario se avete già specificato "tbar"
br	Tasto "a capo"	Non è necessario se avete già specificato "tbar"
cate	Aggiunge [[Categoria:]]	Non è necessario se avete già specificato "tbar"
sef	Aggiunge {{senza fonti}}	Non è necessario se avete già specificato "tbar"
cne	Aggiunge {{citazione necessaria}}	Non è necessario se avete già specificato "tbar"
dmo	Aggiunge {{dmoz}}	Non è necessario se avete già specificato "tbar"
noinc	Aggiunge <noinclude>	Non è necessario se avete già specificato "tbar"
incor	Aggiunge {{Incorso}}	Non è necessario se avete già specificato "tbar"
agg	Aggiunge {{Da aggiornare}}	Non è necessario se avete già specificato "tbar"
prob	Aggiunge {{Problematico}}	Non è necessario se avete già specificato "tbar"
avan	Anti-vandal tool
cwtch	Category watch
popup	Popup di navigazione
nms	Ricerca in un namespace
cmd	Aggiunge la command line	per l'attivazione premere alt+z
qed	QuickEdit. Permette la modifica veloce di una sezione	Si può, opzionalmente, configurare come descritto in QuickEdit.js
wed	wikEd. Nuova casella di editing con nuove funzionalità	Il manuale d'uso si trova in Wikipedia:Monobook.js/WikEd/Manuale
since	Novità. Si accede alla pagina degli Osservati Speciali ma vengono mostrate solo le modifiche apportate dopo l'ultima visita	Fa uso di cookie (come abilitarli)
goo	Ricerca con Google e Yahoo. Permette la ricerca in Wikipedia sfruttando i motori Google e Yahoo
rch	crea un piccolo tasto sulla sinistra della pagina che consente di visualizzare le modifiche più recenti della voce sulla quale si è (Descrizione e immagini d'esempio)
edt	permette di editare i titoli delle pagine
ver	potenzia la funzione di verifica delle versioni
vpop	patrolling retroattivo (VPopSpeed)
vfol	Vandal Fighter on Line	Funziona solo con Firefox e, forse, con Mozilla e Netscape

Alcune di queste sigle sono cumulative. Ad esempio, se aggiungete "tbar" installate tutti i bottoni della Toolbar, non è necessario elencarli tutti.
L'ordine con cui inserite i codici non è importante.

[modifica] Aggiornamenti

Per permettere di capire velocemente cosa è stato aggiunto o tolto, verranno elencate qui le modifiche.

[modifica] 20 novembre 2006

• Aggiunto tab "Ultimo edit" (codice "led")
• Aggiunto tab "0", modifica della sezione 0 (codice "ns0")
• Aggiunto bottone "Cartellino rosso" (codice "rc")
• Aggiunto richieste agli amministratori (codice "rich")
• Aggiunto chat Wikipedia (codice "chat")
• Eliminato "Strumenti monobook" (era stato aggiunto per errore)
• Fixato bug menù di sinistra
• Fixato bug su link alla chat

[modifica] 26 novembre 2006

• Aggiunto tasto con template scroll box
• Aggiunto tasto con template "Promozionale"

[modifica] 9 dicembre 2006

• Corretto problema che bloccava il funzionamento del Category Watch.
• Aggiunto "Tatoo" al nuovo paragrafo Personalizzazioni avanzate.

[modifica] 20 dicembre 2006

• Aggiunta la command line, per l'attivazione è necessario aggiungere la variabile cmd nel proprio monobook.

[modifica] 5 gennaio 2007

• Aggiunto il template {{O}} ^(uso) alla toolbar.--Ş€ņpãİ-27 - せんぱい scrivimi 15:49, 5 gen 2007 (CET)

[modifica] 14 gennaio 2007

• Aggiunto "Aggiungi un pulsante alla toolbar" alle personalizzazioni avanzate

[modifica] 15 gennaio 2007

• Aggiunto QuickEdit (codice qed)

[modifica] 26 gennaio 2007

• Aggiunti nuovi pulsanti alla toolbar.

[modifica] 31 gennaio 2007

• Aggiunti 2 nuovi pulsanti

[modifica] 14 febbraio 2007

• Aggiunto wikEd (codice wed)
• Aggiunto Novità (codice since)
• Aggiunta ricerca con Google e Yahoo (codice goo)
• Aggiunto tasto di visualizzazione ultime modifiche (codice rch)

[modifica] 22 febbraio 2007

• Aggiunta la trasfomazione del testo da maiuscolo in minuscolo e viceversa (codice case)
• Aggiunti i titoli editabili. Si può editare il titolo della pagina utilizzandolo per spostarsi velocemente su un'altra voce

[modifica] 24 febbraio 2007

• Fix titoli editabili e aggiunta "notiziario di aggiornamento monobook"

[modifica] 27 febbraio 2007

• Potenziamento funzione di verifica.

[modifica] 2 marzo 2007

• Aggiunto tasto dmoz (codice dmo o tbar)
• Aggiunto VPopSpeed (codice vpop)

[modifica] 6 marzo 2007

• Aggiunto il Setup grafico nel portlet "strumenti".

[modifica] 15 marzo 2007

• Aggiunto link ai contributi del proprio bot (codice bot)
• Aggiunto VFonLine (codice vfol)

[modifica] 10 aprile 2007

• Aggiunti vari tasti alla toolbar.

[modifica] 11 aprile 2007

• Aggiunto tasto "Problematico" (codice prob)

[modifica] Evoluzioni delle versioni

• ver. 4.2.
• ver. 4.2.5. fix a bug menù
• ver. 4.2.6. fix di alcuni bug
• ver. 4.3.1. nuove funzionalità
• ver. 4.5. aggiunta la command line
• ver. 4.5.2. sistemato template benvenuto ed aggiunte variabili
• ver. 4.6.5. implementato il template {{O}} ^(uso) ed eliminato il vecchio template {{orfana}}
• ver. 4.7.0. fix vari
• ver. 4.7.5. fixxata la posizione dei template
• ver 4.7.1 aggiunto il quick edit
• ver. 4.8.3. vari fix ed aggiunta della firma al quick edit
• ver. 5.0.0. fix vari e aggiunta di nuovi tasti alla toolbar.
• ver. 5.1.1. fix per I.E. e miglioramento funzioni toolbar.
• ver. 5.3.0. aggiunti due nuovi pulsanti
• ver. 6.0.1. aggiunta del wikied e fix vari
• ver. 6.1.1. aggiunta visualizzazione rapida delle ultime modifiche della pagina
• ver. 6.3.0. aggiunta dei titoli editabili e del notiziario.
• ver. 6.4.0. vari fix + potenziamento verifica
• ver. 6.5.1. aggiunto tasto "dmoz" e funzione di retropatrolling
• ver. 6.7.0. Aggiunta interfaccia grafica ("Setup") per la configurazione del monobook.
• ver. 6.7.1. Aggiunto link ai contributi del proprio bot (codice bot).
• ver. 6.8.1. Aggiunto il virtual fighter online.
• ver. 6.8.9. aggiunti vari pulsanti alla tool bar

[modifica] Personalizzazioni avanzate

Ovvero, cose da fare se siete abbastanza esperti.
Se non lo siete, e lo volete fare lo stesso, basta chiederlo.

[modifica] Tatoo

Girovagando su alcune pagine utente ho trovato un'utile applicazione del codice usato per il template {{Icona del titolo}}. In pratica viene creata un'icona, sempre visibile nell'angolo in basso a destra del browser, utile per raggiungere velocemente un determinato Progetto. Se vi interessa potete inserire nel vostro monobook il codice che trovate in fondo al mio, e crearvi una sottopagina utente chiamata Tatoo in cui inserire il codice adattato prendendolo da questo.

[modifica] Aggiungi un pulsante alla toolbar

Questo paragrafo si riferisce ai pulsanti che servono solo a voi. Se pensate che un pulsante sia utile anche per gli altri parlatene qui.

Per poter inserire un nuovo pulsante nella vostra toolbar basta inserire in fondo al proprio monobook il seguente codice:

function personalButtons()
{
  AGGIUNGERE QUI UNA RIGA PER PULSANTE SECONDO I CRITERI SPIEGATI SOTTO
}
addLoadEvent(personalButtons);

[modifica] Se il testo va inserito in cima o in fondo alla pagina

La riga da aggiungere e':

addToolbarButton('tb-xxx', 'javascript:addText("Testo da inserire", "Oggetto della modifica", Dove inserirlo)',
  'Indirizzo URL dell'immagine', 'Testo alternativo', 'Titolo immagine');

Dove:

• Testo da inserire: È il testo da aggiungere alla pagina (va racchiuso tra doppi apici ")
• Oggetto della modifica: È il contenuto del campo oggetto (va racchiuso tra doppi apici ")
• Dove inserirlo: È un numero. 0 significa "in cima", 1 significa "in fondo" (non servono gli apici)
• Indirizzo URL dell'immagine: Non è il nome dell'immagine, bensì il suo indirizzo sul server (ovvero il link che, nella pagina dell'immagine, sta subito sotto a lei). L'immagine non viene ridimensionata, per cui deve già essere delle dimensioni giuste (22 pixel). (va racchiuso tra apici semplici ' )
• Testo alternativo: Testo da visualizzare se l'immagine non può essere caricata (va racchiuso tra apici semplici ' )
• Titolo immagine: Scritta che viene mostrata fermandosi sul pulsante col cursore (va racchiuso tra apici semplici ' )

[modifica] Se il testo va inserito nella posizione del cursore

La riga da aggiungere e':

addToolbarButton('tb-xxx', 'javascript:addTextAtCursor("Prima","Oggetto","Dopo",offset)',
  'Indirizzo URL dell'immagine', 'Testo alternativo', 'Titolo immagine');

Dove:

• Prima: È il testo da aggiungere prima della selezione (se e' stato selezionato del testo)
• Oggetto: È l'oggetto della modifica
• Dopo: È il testo da aggiungere dopo la selezione (se non c'e' la selezione viene accodato al precedente)
• Offset: È un numero che dice di quanto va spostato il cursore rispetto al posizionamento standard (e' opzionale, e non viene usato quasi mai)
• Indirizzo URL dell'immagine: Non è il nome dell'immagine, bensì il suo indirizzo sul server (ovvero il link che, nella pagina dell'immagine, sta subito sotto a lei). L'immagine non viene ridimensionata, per cui deve già essere delle dimensioni giuste (22 pixel). (va racchiuso tra apici semplici ' )
• Testo alternativo: Testo da visualizzare se l'immagine non può essere caricata (va racchiuso tra apici semplici ' )
• Titolo immagine: Scritta che viene mostrata fermandosi sul pulsante col cursore (va racchiuso tra apici semplici ' )

In questo modo il comportamento dei tasti e':

• Se c'e' del testo selezionato: aggiunge davanti alla selezione "Prima", aggiunge dietro "Dopo" e mantiene selezionato il testo originale
• Se non c'e' del testo selezionato: aggiunge "PrimaDopo" al posto del cursore e piazza il cursore tra Prima e Dopo.

[modifica] FAQ

Questa è una lista delle domande più comuni con le relative risposte

Ho salvato il codice nel mio monobook ma non è cambiato niente. Cosa devo fare?

• Ricordati di svuotare la cache (CTRL-F5).

Ancora niente...

• Hai abilitato i Javascript sul tuo browser? (come abilitarli). Gia' che ci sei, controlla che siano abilitati anche sul firewall.

Niente da fare. Altri suggerimenti?

• Ricordati di copiare anche questo monobook.css nel tuo e ri-svuota la cache.

Alcuni tool o collegamenti mi compaiono due volte. Perché?

• Probabilmente non hai cancellato il vecchio codice del tuo monobook. Alcuni dei tool più usati in passato sono stati inclusi in questo, per cui il codice appare duplicato.

L'ordine delle icone nella Toolbar non mi piace. Si può cambiare?

• Al momento no. Ma se otterrò troppe proteste per questo mi impegnerò a prepararlo per la prossima versione.

E l'ordine dei collegamenti nel menù a sinistra?

• Idem come sopra.

I tool installati funzionano tutti tranne due. Perché?

• Se i tool che non funzionano sono il primo e l'ultimo della tua stringa di configurazione, è probabile che tu non abbia lasciato uno spazio all'inizio e alla fine della stringa:

(es: var toLoad=" aaa bbb ccc ")

È normale che alcuni collegamenti appaiano e scompaiano a seconda della pagina aperta?

• Sì. Per limitare l'ingombro dei tool, la loro presenza è stata limitata alle pagine per cui servono.

Ho un'idea riguardo ad una cosa da aggiungere al monobook. A chi lo dico?

• Prova a fare un fischio in Wikipedia:Monobook.js/Richieste, che ne parliamo!

Avevo uno script che non è stato incluso in questo monobook. Posso continuare ad usarlo? E come faccio?

• Sì, puoi usarlo. Basta che tu inserisca il codice di questo monobook prima del tuo tool all'interno del monobook.js. Già che ci sei, spiega il tuo tool in Wikipedia:Monobook.js/Richieste, se lo troviamo utile anche per altri utenti potremmo aggiungerlo nelle versioni future.

Ho fatto come hai detto nella risposta precedente, ma è venuto fuori un gran casino. Che faccio?

• Per pura sfortuna il tuo tool non è compatibile (ma non disperare). Chiedi aiuto in Wikipedia:Monobook.js/Aiuto. Qualche anima pia ti aiuterà.

Come al solito il mio problema non è elencato nelle FAQ o queste non mi hanno aiutato a risolverlo. E adesso?

• Esiste sempre una misera assistenza in Wikipedia:Monobook.js/Aiuto. Spiegaci il problema che proviamo a trovare una soluzione.

[modifica] Voci correlate

• Wikipedia:Monobook.js/MonobookCompleto.js - Contiene il vero monobook.js
• Wikipedia:Monobook.js/Richieste - Se avete idee da proporre fatelo qui
• Wikipedia:Monobook.js/Aiuto - Assistenza per problemi con il il monobook.js
• Wikipedia:Monobook.js/monobook.css - Va installato anche questo per funzionare
• Wikipedia:Monobook.css - L' altro monobook
• JavaScript - Il linguaggio usato per la codifica
• MediaWiki:Monobook.js - Il monobook.js di default di Mediawiki