Wikisource

Wikisource:Monobook.js

X rossa
 Questa pagina è inutilizzata o comunque obsoleta ed è mantenuta per scopi storici e di archivio.
O non ha più senso ed è superata, oppure il consenso è diventato poco chiaro. Se vuoi riaprire la discussione sull'argomento, puoi cercare di allargare la partecipazione della comunità con una segnalazione al bar.

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.

Installazione modifica

Per installare il monobook standard basta salvare questo codice nel proprio monobook.js 

// 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 [[Wikisource:Monobook.js/MonobookCompleto.js]]
// 
document.writeln('<script type="text/javascript" src="/w/index.php?title=Wikisource: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.

Configurazione modifica

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 è 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.
NB: la stringa racchiusa tra apici deve iniziare e finire con uno spazio.

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 Wikisource 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"
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"
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 Wikisource: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 Wikisource 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


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.

Personalizzazioni avanzate modifica

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

Tatoo modifica

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.

Aggiungi un pulsante alla toolbar modifica

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

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

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 ( ' ). Qui alcune icone per toolbar.
  • 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 ' )


Se il testo va inserito nella posizione del cursore modifica

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 ( ' ). Qui alcune icone per toolbar.
  • 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.

FAQ modifica

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 purgare 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-purga 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?
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 Wikisource: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 Wikisource: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?


Estratto da "https://it.wikisource.org/w/index.php?title=Wikisource:Monobook.js&oldid=2122224"