Wikibooks:Monobook.js/WikEd/Manuale

Wikibooks, manuali e libri di testo liberi.
Jump to navigation Jump to search

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]

wikEd - abilitazione, versione corrente e segnalazione d'errore[modifica]

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
WikEd logo.png 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.
WikEd disabled.png Disabilitato Questa icona viene mostrata se il tool è disabilitato. Cliccala per abilitarlo.
WikEd error.png 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]

I bottoni di formattazione appaiono sulla sinistra, proprio sopra l'area di testo.


Icona Nome Descrizione Area interessata
Riga Superiore
WikEd undo.png Annulla Annulla le modifiche. Equivale all'uso dell' "Undo" (Ctrl-Z sotto Windows). Tutto il testo
WikEd redo.png Ripristina Ripristina le modifche. Simile all'uso di Ctrl-Y sotto Windows. Tutto il testo
WikEd bold.png Grassetto Aggiunge o rimuove il grassetto ('''...'''). Area selezionata, parola indicata dal cursore o posizione del cursore
WikEd italic.png Corsivo Aggiunge o rimuove il corsivo (''...''). Area selezionata, parola indicata dal cursore o posizione del cursore
WikEd underline.png Sottolineato Aggiunge o rimuove la sottolineatura al testo (<u>...</u>). Area selezionata, parola indicata dal cursore o posizione del cursore
WikEd strikethrough.png Barrato Aggiunge o rimuove la barratura al testo (<s>...</s>). Area selezionata, parola indicata dal cursore o posizione del cursore
WikEd nowiki.png Nowiki Aggiunge o rimuove <nowiki> (<nowiki>...</nowiki>). Area selezionata, parola indicata dal cursore o posizione del cursore
WikEd superscript.png Apice Aggiunge o rimuove l'apice al testo (<sup>...</sup>). Area selezionata, parola indicata dal cursore o posizione del cursore
WikEd subscript.png Pedice Aggiunge o rimuove il pedice dal testo (<sub>...</sub>). Area selezionata, parola indicata dal cursore o posizione del cursore
WikEd ref.png 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
WikEd references.png 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
WikEd case.png Case (maiuscolo/minuscolo) Cicla tra minuscolo, Iniziali Maiuscole e TUTTO MAIUSCOLO. Area selezionata o parola indicata dal cursore
WikEd undo all.png Annulla tutto Torna alla versione originale. Tutto il testo
WikEd redo all.png Ripristina tutto Ripristina l'ultima versione. Tutto il testo
Riga Inferiore
WikEd wikilink.png Wikilink Aggiunge o rimuove un wikilink interno ([[...]]). Area selezionata, parola indicata dal cursore, o posizione del cursore
WikEd weblink.png Weblink Aggiunge o rimuove un link esterno ([...]). Area selezionata, parola indicata dal cursore, o posizione del cursore
WikEd decrease heading.png Intestazione- Decrementa il livello di intestazione. Rimuove =...=. Linea corrente o linee selezionate
WikEd increase heading.png Intestazione+ Aumenta il livello di intestazione. Aggiunge =...=. Linea corrente o linee selezionate
WikEd bullet list.png Lista puntata Converte i termini in una lista puntata aggiungendo all'inizio un *. Oltre i tre * vengono rimossi. Linea corrente o linee selezionate
WikEd number list.png Lista numerata Converte i termini in una lista numerata aggiungendo all'inizio un #. Oltre i tre # vengono rimossi. Linea corrente o linee selezionate
WikEd indent list.png Lista indentata Converte i termini in una lista indentata aggiungendo all'inizio un :. Oltre i tre : vengono rimossi. Linea corrente o linee selezionate
WikEd definition list.png 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
WikEd image.png Immagine Aggiunge una wiki-immagine. Inserisce [[Image:filename|thumb|widthpx|...]]. Parole selezionate o posizione del cursore
WikEd table.png Tabella Aggiunge una tabella. Le linee selezionate vengono convertite in celle. Linee selezionate o posizione del cursore
WikEd redirect.png 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)
WikEd wikify.png 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
WikEd textify.png 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
WikEd syntax.png Sintassi Aggiorna l'highlighting della sintassi. Area selezionata o tutto il testo

Pulsanti Trova e Sosituisci[modifica]

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


Icona Nome Descrizione
Riga Superiore
WikEd get selection.png Trova questo Copia il testo selezionato nel campo Cerca. Con un doppio click, il testo viene copiato anche nella casella Sostituisci.
WikEd find all.png Trova tutto Evidenzia tutte le occorrenze presenti nel testo, ma non sposta il cursore.
WikEd find prev.png Precedente Trova l'occorrenza precedente.
WikEd combo input.png 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.

WikEd find next.png Successivo Trova la prossima occorrenza cercando verso il basso.
WikEd jump top bottom.png 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.
WikEd jump prev.png Salta al precedente Salta all'ultima posizione modificata.
WikEd jump next.png Salta al successivo Torna all'ultima posizione precedente all'uso di Salta al precedente.
Riga Inferiore
WikEd clear find.png Svuota Svuota il campo. Puo' essere usato per cercare il testo selezionato o la parola indicata dal cursore.
WikEd replace all.png Sostituisci tutto Sostituisce tutte le occorrenze all'interno del testo selezionato e dell'intero documento.
WikEd replace prev.png Sostituisci il precedente Sostituisce l'occorrenza precedente. Prima evidenzia l'occorrenza, quindi la sostituisce dopo che viene schiacciato "Successivo".
WikEd combo input.png 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.
WikEd replace next.png Sostituisci il successivo Sostituisce la prossima occorrenza. Prima evidenzia l'occorrenza, quindi la sostituisce dopo che viene schiacciato "Successivo".
WikEd case sensitive.png 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.
WikEd regexp.png 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.
WikEd find ahead.png 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]

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 WikEd diff.png 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
WikEd fix basic.png 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
WikEd fix html.png 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
WikEd fix caps.png Correggi maiuscole Rende maiuscole le iniziali dei titoli e delle liste. Area selezionata o riga corrente
WikEd fix unicode.png 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
WikEd fix all.png Correggi tutto Combina i quattro pulsanti precedenti. Area selezionata o testo intero
WikEd fix reg-ex-typo.png 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
WikEd fix dash.png Correggi i trattini Corregge in trattini gli m-dashes ( — ), gli n-dashes ( – ), gli hyphens ( &hyphen; ), ed i meno ( − ). Area selezionata o riga corrente
WikEd fix punct.png Correggi punteggiatura Cancella gli spazi prima della punteggiatura. Area selezionata o riga corrente
WikEd fix math.png 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
WikEd fix chem.png 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
WikEd fix units.png 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]

I bottoni di controllo appaiono sulla destra, proprio sopra la casella di editing.


Icon Nome Descrizione
Riga Superiore
WikEd font size.png 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.
WikEd clear history.png Pulisci le cronologie Pulisce le cronologie dei campi "Trova", "Sostituisci" e "Oggetto" cancellando i cookie usati per registrarle.
WikEd align top.png Scrolla in su Scrolla la pagina in modo che la casella di editing si trovi in cima.
WikEd align buttons.png Bottoni di scrolling Scrolla la pagina in modo da portare in cima i pulsanti di modifica.
Bottom Row
WikEd logo.png 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.
WikEd syntax.png Sintassi Abilita l'evidenziazione automatica della sintassi. Questo valore e' mantenuto in tutte le finestre all'interno della presente sessione del browser.
WikEd source.png 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.
WikEd close toolbar.png 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.
WikEd using.png …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
WikEd fullscreen.png 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]

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


Icon Nome Descrizione
WikEd preview.png Anteprima Mostra sotto un'anteprima. Usa il programma indipendente Live Preview creato da Pilaf.
WikEd diff.png 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.
WikEd close.png Chiudi Chiude le finestre usate per Anteprima e Cambiamenti.
WikEd align top.png Scrolla in su Scrolla la pagina in modo da avere la casella di editing in cima.
WikEd align buttons.png Bottoni di scrolling Scrolla la pagina in modo da avere i bottoni di editing in cima.

Campo Oggetto[modifica]

Icon Nome Descrizione
WikEd clear summary.png Svuota l'oggetto Svuota il campo Oggetto. Viene mantenuto il nome del paragrafo (la parte compresa tra /*...*/), cancellato in caso di un secondo click.
WikEd combo input.png 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]

Nome Descrizione
WikEd blank.pngWikEd blank.pngWikEd blank.pngWikEd blank.png Strani spazi Caratteri vuoti non standard. Passa col cursore sul carattere per saperne il nome.
WikEd blank.pngWikEd blank.pngWikEd blank.pngWikEd blank.png Codice di controllo Codice di controllo. Passa col cursore sul carattere per saperne il nome.
WikEd tab.png Tab Carattere di tabulazione. Passa col cursore sul carattere per saperne il nome.
WikEd unknown.pngWikEd unknown.pngWikEd unknown.png
WikEd unknown.pngWikEd unknown.pngWikEd unknown.png
WikEd unknown.pngWikEd unknown.pngWikEd unknown.png
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]

wikEd non si carica[modifica]

Hai installato il tool ma il logo WikEd logo.png 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]

Il logo del wikEd e' mostrato in grigio WikEd disabled.png 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]

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

  • Hai disabilitato temporaneamente il wikEd cliccando su WikEd logo.png. 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]

Highlighting automatico della sintassi[modifica]

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.