Vai al contenuto

Wikibooks:Monobook.js/WikEd/Manuale

Wikibooks, manuali e libri di testo liberi.

Questa pagina vuole essere il manuale del wikEd, un editor di testo in formato RTF applicabile a Wikipedia e ad altri siti che girano su piattaforma Wikimedia.

Screenshot del wikEd

Spiegazione dei pulsanti

[modifica sorgente]

wikEd - abilitazione, versione corrente e segnalazione d'errore

[modifica sorgente]

Il seguente logo viene mostrato in cima alla pagina, vicino al link "esci". Posizionandosi con il cursore sopra al logo si possono ottenere informazioni circa la versione corrente. Per aggiornarlo all'ultima versione rilasciata è sufficiente svuotare la cache tenendo premuto Shift mentre si clicca Aggiorna, o premendo Shift-Ctrl-R.

Icon Nome Descrizione
Abilitato Usa questo pulsante per disabilitare wikEd. Lo spegnera' per tutte le finestre aperte e per le future sessioni. Clicca di nuovo il logo per ri-abilitarlo. wikEd non si carica se il database è bloccato o una pagina è protetta. Premendo questo pulsante si svuotano le cronologie delle caselle di testo.
Disabilitato Questa icona viene mostrata se il tool è disabilitato. Cliccala per abilitarlo.
Errore di caricamento Se un problema si verifica durante l'inizializzazione vedrai questa immagine. Puoi controllare nella "console degli errori" sotto "Strumenti" (Firefox) e segnalare il problema al creatore.

Bottoni di formattazione

[modifica sorgente]
I bottoni di formattazione appaiono sulla sinistra, proprio sopra l'area di testo.


Icona Nome Descrizione Area interessata
Riga Superiore
Annulla Annulla le modifiche. Equivale all'uso dell' "Undo" (Ctrl-Z sotto Windows). Tutto il testo
Ripristina Ripristina le modifche. Simile all'uso di Ctrl-Y sotto Windows. Tutto il testo
Grassetto Aggiunge o rimuove il grassetto ('''...'''). Area selezionata, parola indicata dal cursore o posizione del cursore
Corsivo Aggiunge o rimuove il corsivo (''...''). Area selezionata, parola indicata dal cursore o posizione del cursore
Sottolineato Aggiunge o rimuove la sottolineatura al testo (<u>...</u>). Area selezionata, parola indicata dal cursore o posizione del cursore
Barrato Aggiunge o rimuove la barratura al testo (<s>...</s>). Area selezionata, parola indicata dal cursore o posizione del cursore
Nowiki Aggiunge o rimuove <nowiki> (<nowiki>...</nowiki>). Area selezionata, parola indicata dal cursore o posizione del cursore
Apice Aggiunge o rimuove l'apice al testo (<sup>...</sup>). Area selezionata, parola indicata dal cursore o posizione del cursore
Pedice Aggiunge o rimuove il pedice dal testo (<sub>...</sub>). Area selezionata, parola indicata dal cursore o posizione del cursore
Ref Aggiunge o rimuove <ref name="" /><nowiki> (senza testo selezionato: '''<span style="color: red;"><nowiki><ref name=""/>; con testo selezionato: <ref name="">...</ref>). Area selezionata o posizione del cursore
References Aggiunge o rimuove <references/> (<references/>).
In caso di doppio click una piccola sezione in stile Wikipedia viene aggiunta (<div class="references-small"> <references/> </div>).
Posizione del cursore
Case (maiuscolo/minuscolo) Cicla tra minuscolo, Iniziali Maiuscole e TUTTO MAIUSCOLO. Area selezionata o parola indicata dal cursore
Annulla tutto Torna alla versione originale. Tutto il testo
Ripristina tutto Ripristina l'ultima versione. Tutto il testo
Riga Inferiore
Wikilink Aggiunge o rimuove un wikilink interno ([[...]]). Area selezionata, parola indicata dal cursore, o posizione del cursore
Weblink Aggiunge o rimuove un link esterno ([...]). Area selezionata, parola indicata dal cursore, o posizione del cursore
Intestazione- Decrementa il livello di intestazione. Rimuove =...=. Linea corrente o linee selezionate
Intestazione+ Aumenta il livello di intestazione. Aggiunge =...=. Linea corrente o linee selezionate
Lista puntata Converte i termini in una lista puntata aggiungendo all'inizio un *. Oltre i tre * vengono rimossi. Linea corrente o linee selezionate
Lista numerata Converte i termini in una lista numerata aggiungendo all'inizio un #. Oltre i tre # vengono rimossi. Linea corrente o linee selezionate
Lista indentata Converte i termini in una lista indentata aggiungendo all'inizio un :. Oltre i tre : vengono rimossi. Linea corrente o linee selezionate
Lista di definizione Converte i termini in una lista di definizione aggiungendo all'inizio un ; ed un : dopo la prima parola. Linea corrente o linee selezionate
Immagine Aggiunge una wiki-immagine. Inserisce [[Image:filename|thumb|widthpx|...]]. Parole selezionate o posizione del cursore
Tabella Aggiunge una tabella. Le linee selezionate vengono convertite in celle. Linee selezionate o posizione del cursore
Redirect Applica il redirect (#redirect [[...]]) alle parole selezionate o a quella nella posizione del cursore. Aggiunge il codice del redirect all'oggetto della modifica. Parole selezionate (cancella tutto il testo)
Wikifica Wikifica il testo incollato. Converte il contenuto del testo (preso da fonti tipo Word, voci di Wikipedia, o altre pagine web) in wiki code. Area selezionata o tutto il testo
Textifica Converte il testo incollato nella forma di testo. Toglie qualsiasi formattazione che il testo aveva prima di essere copiato, ad esempio grassetti e sottolineature, trasformandolo in semplice testo. Area selezionata o tutto il testo
Sintassi Aggiorna l'highlighting della sintassi. Area selezionata o tutto il testo

Pulsanti Trova e Sosituisci

[modifica sorgente]
Il pulsante trova e sosituisci appare alla destra dei
bottoni di formattazione, subito sopra all'area di editing.


Icona Nome Descrizione
Riga Superiore
Trova questo Copia il testo selezionato nel campo Cerca. Con un doppio click, il testo viene copiato anche nella casella Sostituisci.
Trova tutto Evidenzia tutte le occorrenze presenti nel testo, ma non sposta il cursore.
Precedente Trova l'occorrenza precedente.
Trova Il testo da cercare. Il menu' a tendina contiene le ultime stringhe cercate, precedute da indicatori per gestire il maiuscolo/minuscolo e le espressioni regolari. Selezionando una precedente ricerca, vengono settati in automatico anche i campi per il maiuscolo/minuscolo e le espressioni regolari.

Se "Trova mentre digiti" e' selezionato, il testo verra' cercato mentre si scrive nella casella di ricerca (non fa differenza tra minuscolo e maiuscolo e non usa espressioni regolari).

Se il campo e' vuoto, verra' cercato il testo selezionato o la parola evidenziata dal cursore. Il tasto Svuota puo' essere usato per pulire questo campo.

Successivo Trova la prossima occorrenza cercando verso il basso.
Salta su/giù' Si sposta in cima, o in fondo, alla casella di editing. Puo' essere usato per continuare una ricerca dopo la fine del documento.
Salta al precedente Salta all'ultima posizione modificata.
Salta al successivo Torna all'ultima posizione precedente all'uso di Salta al precedente.
Riga Inferiore
Svuota Svuota il campo. Puo' essere usato per cercare il testo selezionato o la parola indicata dal cursore.
Sostituisci tutto Sostituisce tutte le occorrenze all'interno del testo selezionato e dell'intero documento.
Sostituisci il precedente Sostituisce l'occorrenza precedente. Prima evidenzia l'occorrenza, quindi la sostituisce dopo che viene schiacciato "Successivo".
Sostituisci Il testo con cui sostituire. Il menu' a tendina contiene le ultime stringhe usate, precedute da due controlli per il maiuscolo/minuscolo e per le espressioni regolari. Selezionando una stringa precedente, vengono modificati anche i due controlli relativi.
Sostituisci il successivo Sostituisce la prossima occorrenza. Prima evidenzia l'occorrenza, quindi la sostituisce dopo che viene schiacciato "Successivo".
Controllo maiuscolo/minuscolo Abilita il controllo maiuscolo/minuscolo. Non modifica la ricerca durante la digitazione, che si comporta come se la casella non fosse segnata.
Espressione regolare Abilita la ricerca tramite l'uso di espressioni regolari. Non modifica la ricerca durante la digitazione, che si comporta come se la casella non fosse segnata. La sintassi utilizzata è quella delle espressioni regolari nei Javascript. All'interno del campo "Sostituisci" utilizza $1, $2... per riferirti alle occorrenze delle sottostringhe tra parentesi.
Trova mentre digiti Abilita la ricerca durante la digitazione nella casella "Trova". Se questo controllo e' selezionato, la ricerca avviene ogni volta che un carattere viene scritto nel campo "Trova". Il Trova mentre digiti e' indipendente dai due controlli per il maiuscolo/minuscolo e per le espressioni regolari. Si comporta come se non fossero selezionati.

Bottoni di correzione

[modifica sorgente]
I Bottoni di correzione appaiono alla destra di quelli di Ricerca, proprio sopra la casella di editing.


Dopo aver usato questi pulsanti controlla sempre le modifiche introdotte attraverso l'uso di per evitare effetti collaterali. Usa selezioni di testo che siano il più limitate possibile. Ricorda che le regole applicate sono molto semplici. Solo la correzione dei caratteri Unicode è veramente sicura.

Icon Nome Descrizione Area di testo interessata
Riga Superiore
Correzioni base Aggiunge spazi bianchi intorno alle intestazioni ed aggiunge linee vuote prima e dopo le stesse. In questo modo si aumenta la leggibilita' del testo anche se l'aspetto della voce non viene modificato. Area selezionata o intero testo
Correggi HTML Sostituisce i tag HTML con il relativo codice wiki. I tag ed i parametri non supportati vengono rimossi (per cui controllate bene le modifiche apportate) Area selezionata o testo intero
Correggi maiuscole Rende maiuscole le iniziali dei titoli e delle liste. Area selezionata o riga corrente
Correggi Unicode Corregge la rappresentazione dei caratteri Unicode trasformandoli nei caratteri attuali, dipendenti dal browser utilizzato. Questa è l'unica correzione sicura, le modifiche vengono applicate all'intero testo senza controllo del risultato. Area selezionata o intero testo
Correggi tutto Combina i quattro pulsanti precedenti. Area selezionata o testo intero
Correggi typo Al momento utilizza una versione inglese; non utilizzare Corregge i typo con l'utilizzo di una lista preconfezionata di errori comuni. Per essere utilizzata necessita della riga wikEdLoadRegExTypoFix = true; all'interno del monobook, prima del codice del wikEd, in caso contrario non viene mostrato. Area selezionata o testo intero
Riga Inferiore
Correggi i trattini Corregge in trattini gli m-dashes ( — ), gli n-dashes ( – ), gli hyphens ( ‐ ), ed i meno ( − ). Area selezionata o riga corrente
Correggi punteggiatura Cancella gli spazi prima della punteggiatura. Area selezionata o riga corrente
Correggi matematica Corregge alcuni errori di matematica fuori dai wikitag <math> wikitag: segni meno, moltiplicazioni ×, 10^3 diventa 103, +/- diventa ±. Area selezionata o riga corrente
Correggi chimica Correggi formule chimiche non formattate. Indici superiori ed inferiori, elementi in maiuscolo, e correzione delle frecce di reazione. Da usare solo su piccole porzioni di testo. Ad esempio: 2 Na+ + OH- + H2SO4 --> 2 h2o + Na2SO4 viene rimpiazzata da 2Na+ + OH- + H2SO4 → 2H2O + Na2SO4. Area selezionata o riga corrente
Correggi misure Corregge un gran numero di misure fisiche. Le misure devono essere precedute da un numero. Area selezionata o riga corrente

Bottoni di controllo del wikEd

[modifica sorgente]
I bottoni di controllo appaiono sulla destra, proprio sopra la casella di editing.


Icon Nome Descrizione
Riga Superiore
Zoom del testo Cambia lo zoom del testo nella casella di editing. Seleziona, a rotazione, tra piccolo, molto piccolo, grande per poi tornare a normale.
Pulisci le cronologie Pulisce le cronologie dei campi "Trova", "Sostituisci" e "Oggetto" cancellando i cookie usati per registrarle.
Scrolla in su Scrolla la pagina in modo che la casella di editing si trovi in cima.
Bottoni di scrolling Scrolla la pagina in modo da portare in cima i pulsanti di modifica.
Bottom Row
Usa wikEd Alterna la visione classica della casella di editing con la versione del wikEd. Torna temporaneamente allo standard. Questo valore e' mantenuto in tutte le finestre all'interno della presente sessione del browser. Premendo questo pulsante si azzerano le cronologie.
Sintassi Abilita l'evidenziazione automatica della sintassi. Questo valore e' mantenuto in tutte le finestre all'interno della presente sessione del browser.
Sorgente Mostra il codice sorgente del testo incollato o la sintassi del testo evidenziato. Viene mantenuto quasi esclusivamente per motivi di debugging. Modifica la porzione di testo selezionata. Il pulsante e' disabilitato per default, guarda gli esempi per sapere come abilitarlo.
Chiudi la toolbar Abilita o meno la toolbar standard. Questo valore modifica tutti le finestre di tutti i browser ed e' mantenuto nelle sessioni successive.
…Usando Permette l'aggiunta di "…usando wikEd" all'oggetto della modifica in fase di salvataggio. Questo valore modifica tutte le finestre di tutti i browser ed e' mantenuto nelle sessioni successive
Schermo intero Abilita la modalita' a schermo intero. Questo valore modifica tutti le finestre della sessione browser corrente. La modalita' a schermo intero viene disabilitata durante le anteprime.

Anteprima e modifiche

[modifica sorgente]
Questo piccolo gruppo di bottoni appare sulla destra, di fronte a Salva la pagina e Visualizza l'Anteprima.


Icon Nome Descrizione
Anteprima Mostra sotto un'anteprima. Usa il programma indipendente Live Preview creato da Pilaf.
Modifiche Mostra sotto i cambiamenti correnti. Usa il programma diff creato da Cacycle. Questo tool NON e' identico a quello standard perché non confronta la casella di editing con l'ultima versione salvata, ma con la versione che era stata aperta in modifica.
Chiudi Chiude le finestre usate per Anteprima e Cambiamenti.
Scrolla in su Scrolla la pagina in modo da avere la casella di editing in cima.
Bottoni di scrolling Scrolla la pagina in modo da avere i bottoni di editing in cima.

Campo Oggetto

[modifica sorgente]
Icon Nome Descrizione
Svuota l'oggetto Svuota il campo Oggetto. Viene mantenuto il nome del paragrafo (la parte compresa tra /*...*/), cancellato in caso di un secondo click.
Oggetto Il normale campo oggetto che, adesso, possiede un menu' a tendina. Nella parte superiore si puo' scegliere tra i valori inseriti in passato; i più recenti sono quelli in cima. Nella parte inferiore si puo' scegliere tra varie frasi predefinite (leggi in Configurazione le istruzioni su come cambiarle o aggiungerle). Il testo, o i testi, selezionati vengono aggiunti al contenuto del campo. La parte contenente il nome del paragrafo (/*...*/) viene rimossa dalla cronologia.

Highlighting e caratteri speciali

[modifica sorgente]
Nome Descrizione
Strani spazi Caratteri vuoti non standard. Passa col cursore sul carattere per saperne il nome.
Codice di controllo Codice di controllo. Passa col cursore sul carattere per saperne il nome.
Tab Carattere di tabulazione. Passa col cursore sul carattere per saperne il nome.



Tag non supportato Tag HTML sconosciuti o sconsigliati nei sistemi Mediawiki. Usa il tasto Correggi HTML per trasformarli in wikicode.

Risoluzione dei problemi / FAQ

[modifica sorgente]

wikEd non si carica

[modifica sorgente]

Hai installato il tool ma il logo non appare vicino ad "Esci" e i bottoni di wikEd non ci sono nella pagina di modifica. Prova a:

  • Svuotare la cache: tenendo premuto Shift clicca Aggiorna (o premi Ctrl-Shift-R)
  • Abilita i JavaScript nel tuo browser (StrumentiOpzioniContenutiAttiva JavaScript in Firefox)
  • Controlla nelle tue preferenze quale skin stai usando. Se non stai usando il Monobook devi rimpiazzare tutte le parole monobook.js con il tuo stile nella procedura di installazione, ad esempio Utente:TuoNickname/classic.js per lo skin Classic
  • Controlla eventuali errori in JavaScript ("Console degli errori" sotto "Strumenti" in Firefox). Se ne trovi qualcuno causato da wikEd scrivilo nella pagina di discussione del wikEd.

Tutti i bottoni sono scomparsi

[modifica sorgente]

Il logo del wikEd e' mostrato in grigio ed i bottoni non vengono mostrati.

  • Hai disabilitato il wikEd cliccando sul logo. Cliccaci di nuovo e lo riabiliterai.

I bottoni di formattazione sono scomparsi

[modifica sorgente]

I bottoni di configurazione vengono mostrati nelle pagine di modifica, ma gli altri pulsanti sono scomparsi.

  • Hai disabilitato temporaneamente il wikEd cliccando su . Cliccaci ancora per riabilitarlo. Ricorda che il valore di questo bottone e' conservato per tutte le finestre ed i tab della sessione di browser corrente.

Mancanza di alcune funzioni e altri difetti

[modifica sorgente]

Highlighting automatico della sintassi

[modifica sorgente]

Una delle cose più richieste è l'aggiornamento automatico dell'highlighting durante la digitazione ("live syntax highlighting").

Questa cosa non puo' essere implementata per ragioni tecniche. Ogni cambiamento automatico della finestra cancella o scombina la cronologia delle modifiche. Al fine di tenere in vita sia l'evidenziazione della sintassi che il sistema di annulla/ripristina, il metodo RTF dovrebbe essere completamente simulato via JavaScript. Questo è possibile, ma servirebbe troppo tempo per scrivere il codice, portandolo ad una dimensione di difficile gestione (al momento occupa circa 230 kB senza Anteprima, Diff e correzione automatica dei refusi), e potrebbe rendere inutilizzabile il sistema annulla/ripristina.