Wikipedia:Monobook.js/WikEd

Da Wikipedia, l'enciclopedia libera.
Screenshot del wikEd in azione

Per favore contribuite a far funzionare wikEd con IE7 e Opera9, contattate Cacycle.

wikEd è un editor di testo completo che aggiunge funzioni di text-processing alle pagine di modifica di Wikipedia e di altri tool Mediawiki. Attualmente funziona solo per Firefox ed altri browser Mozilla. wikEd è un editor di testo di tipo Rich Text Format e pseudo-WYSIWYG, e possiede alcune caratteristiche tipiche di Mediawiki. Leggi il manuale per avere una descrizione di tutte le funzioni e dei bottoni presenti.

Il tool verrà aggiornato continuamente:
Per aggiornarsi all'ultima versione disponibile bisogna tener premuto il tasto Shift e cliccare Aggiorna, oppure premere Ctrl-Shift-R.

Breve elenco delle funzioni[modifica | modifica sorgente]

(Per una lista più dettagliata vedi sotto)
  • Incollare testo formattato, ad esempio da MS-Word (incluse le tabelle)
  • Conversione del testo formattato in wikicode
  • Highligthing (evidenziazione) della sintassi Wiki
  • Espressioni regolari di ricerca e sostituzione del testo
  • "Visualizza anteprima" e "Mostra cambiamenti" indipendente dal server
  • Editing a schermo intero
  • Correzione con un click di errori comuni
  • Cronologia nei campi oggetto, ricerca e sostituzione
  • Supporto multilingue

Requisiti di sistema[modifica | modifica sorgente]

  • Un browser Mozilla (Firefox 1.5 o superiore, Mozilla 1.3 o superiore, o SeaMonkey) (per favore contribuite a rendere wikEd funzionante in IE7 o Opera 9, lasciate un commento a Cacycle)
  • wikEd potrebbe rallentare il caricamento di pagine troppo lunghe su computer non molto potenti
  • È necessario essere registrati su Wikipedia ed aver installato il monobook.js

Come usarlo[modifica | modifica sorgente]

Exquisite-kfind.png Per approfondire, vedi Wikipedia:Monobook.js/WikEd/Manuale.

Se avete installato il monobook condiviso basta aggiungere alla variabile toLoad il codice wed.
Altrimenti, basta aggiungere il codice copiato da sotto in fondo al tuo monobook.js.

Funzioni[modifica | modifica sorgente]

(Per una lista breve vedi sopra)

Trovi una descrizione completa dei pulsanti in Wikipedia:Monobook.js/WikEd/Manuale.

wikEd aggiunge le seguenti funzioni (sotto forma di pulsanti) sopra alla casella di editing:

  • Incollare testo formattato, ad esempio da MS-Word o MS-Excel
  • Convertire il testo formattato in wikicode (incluse le tabelle)
  • Incollare e convertire pagine wiki senza dover passare dalla pagina di modifica per ottenere il sorgente
  • Highlighting (evidenziazione) della sintassi wiki
  • "Trova" e "Sostituisci" utilizzando espressioni regolari
  • Trova mentre digiti
  • "Visualizza anteprima" in modo indipendente dal server (come quello utilizzato nel QuickEdit)
  • "Mostra cambiamenti" in modo indipendente dal server, usa lo script en:User:Cacycle/diff per la colorazione di aggiunte, cancellazioni e spostamenti di testo
  • Cronologia dei campi oggetto, trova e sostituisci con l'uso di menù a tendina (la cronologia non viene persa tra diverse sessioni ed è accessibile da finestre differenti)
  • Esempi di "Oggetto della modifica" predefiniti e customizzabili
  • Correzione con un click degli errori più comuni:
    • Sostituzione di caratteri Unicode con il carattere attuale (dipendente dal browser)
    • Correzioni di errori di scrittura con l'uso di RegExTypoFix
    • Formule chimiche e matematiche
    • Doppi spazi e righe vuote
    • Trattini
    • Unità di misura
    • Trasformazione del codice HTML in wikicode (incluse le tabelle)
    • Iniziale maiuscola per i titoli e le liste
  • Editing a schermo intero
  • Tutti i bottoni hanno descrizioni in popup (passando sopra con il mouse)
  • Salta alla posizione dell'ultima modifica
  • Completamente configurabile, incluse le immagini dei pulsanti ed i colori (via CSS)
  • Selezione intelligente del testo, ad esempio "parola indicata dal cursore" o "riga corrente"
  • Modifica della dimensione del carattere nella finestra di modifica
  • Compatibile con la toolbar presente sopra la casella di editing e con i link inseriti sotto
  • Può essere disabilitata con un semplice click, senza modificare il proprio "monobook"
  • Possibilità di inserire bottoni e funzioni personalizzate

Traduzioni[modifica | modifica sorgente]

Al momento esistono traduzioni in:

  • Inglese
  • Italiano
  • Portoghese
  • Sloveno
  • Tedesco

Problemi conosciuti[modifica | modifica sorgente]

  • Non usare il pulsante "Indietro" dopo aver salvato una pagina, usa la linguetta "Modifica" per ricaricare la pagina. In caso contrario potrebbe essere ricaricata la versione originale, cancellando le modifiche che avevi apportato.
  • Se usi un vecchio computer, o modifichi una pagina particolarmente lunga, potresti velocizzarne il caricamento disabilitando temporaneamente il wikEd cliccando sul pulsante WikEd logo.png.
  • wikEd si basa sul formato interno rich-text del browser. Questa cosa può causare i seguenti inconvenienti:
    • Incollare testo dalle pagine HTML genera interi paragrafi vuoti prima e dopo il testo inserito. Disabilita temporaneamente il wikEd (vedi sopra).
    • L'evidenziazione del testo appena inserito deve essere chiesta manualmente premendo il tasto WikEd syntax.png. Se il pulsante non viene premuto il testo viene mostrato con un colore errato.
    • Mozilla sostituisce le tabulazioni con quattro spazi mentre si incolla del testo. Per poter incollare le tabulazioni devi disabilitare il wikEd.
  • Un baco di Mozilla, a volte, sposta il cursore in cima quando si edita del testo incollato.
  • Fai molta attenzione ad usare il testo per correggere i piccoli errori. Ci sono casi in cui questa funzione può danneggiare la voce. Controlla sempre le modifiche apportate prima di salvare
  • wikEd non è compatibile con altri script che operano sull'editing del testo (vedi la sezione successiva per saper apportare le dovute correzioni).

Incompatibilità[modifica | modifica sorgente]

In generale, wikEd è incompatibile con qualsiasi script che opera sulla casella di modifica del testo. Il motivo è che sosituisce la normale casella con una propria versione della stessa. C'è possibilità che lo script concorrente possa funzionare se il wikEd viene disabilitato con il pulsante WikEd logo.png.

Rendere gli altri script compatibili con wikEd[modifica | modifica sorgente]

La casella di edit del wikEd, come già detto, è un frame di tipo rich-text, mentre la casella di editing standard ha l'id wpTextbox1, ed è del tipo Javascript textarea. Gli sviluppatori possono rendere compatibile il loro script con wikEd semplicemente copiandosi il testo contenuto nel frame nella casella standard prima di modificarlo, e rimettendolo a posto alla fine. Il codice seguente è compatibile con vari browser ed indipendente da wikiEd:

// copia il frame di wikEd (http://it.wikipedia.org/wiki/Wikipedia:Monobook.js/WikEd.js) nella casella "wpTextbox1"
if (typeof(wikEdUseWikEd) != 'undefined') {
    if (wikEdUseWikEd == true) {
        WikEdUpdateTextarea();
    }
}
 
// fai le modifiche che vuoi a "wpTextbox1"
 
// copia il risultato da "wpTextbox1" al frame di wikEd
if (typeof(wikEdUseWikEd) != 'undefined')
    if (wikEdUseWikEd == true) {
        WikEdUpdateFrame();
    }
}

Installazione[modifica | modifica sorgente]

Se usi il monobook ufficiale non seguire queste istruzioni. Scopri cosa fare in Wikipedia:Monobook.js

Se invece non usi il monobook condiviso, copia il codice mostrato qui sotto nel tuo monobook.js (o quello relativo allo skin che usi). È necessario possedere un account wikipedia ed essere loggati per poter installare ed usare il tool. Dopo aver salvato, svuota la cache per vederlo all'opera: tieni premuto Shift mentre clicchi Aggiorna (o premi Ctrl-Shift-R). Attenzione: Non copiare tutto il codice dello script nella tua pagina, non otterresti in automatico gli aggiornamenti!

Questa installazione funziona con tutti i software Mediawiki:

1. Accedi a Wikipedia con il tuo nickname
2. Clicca il seguente link per modificare il tuo monobook: [[[:Template:Editurl:Speciale:myPage/vector.js]] action=edit Speciale:myPage/vector.js]
3. Se non stai usando lo skin predefinito (vector) scopri in Speciale:Preferences quale file devi modificare
4. Aggiungi questo codice alla pagina:
// install Wikipedia:Monobook.js/WikEd.js/Descrizione
mw.loader.load('//en.wikipedia.org/w/index.php?title=User:Cacycle/wikEd.js&action=raw&ctype=text/javascript');
Se la tua pagina contiene già del codice, fai attenzione a non aggiungere questo tra i simboli /*...*/.
5. Salva la pagina
6. Rinfresca la cache: tenendo premuto Shift clicca Aggiorna (o premi Ctrl-Shift-R)
7. Il logo di wikEd WikEd logo.png dovrebbe vedersi in cima ad ogni pagina, vicino al link "esci"

Nota: ricorda che, se non usi il Monobook, in alternativa puoi abilitare WikiEd anche semplicemente abilitando la relativa voce fra gli Accessori in Speciale:Preferenze.

Risoluzione dei problemi/FAQ[modifica | modifica sorgente]

wikEd non si carica[modifica | modifica sorgente]

Hai installato il tool ma il logo WikEd logo.png non appare vicino ad "Esci" e i bottoni di wikEd non ci sono nelle pagine 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 vector 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.

Per altri problemi guarda Wikipedia:Monobook.js/WikEd/Manuale.

Configurazione[modifica | modifica sorgente]

wikEd è completamente configurabile, inclusi colori, lingua, bottoni e funzioni. Setta tutte le variabili che vuoi attraverso il tuo monobook.js. Leggi la prima parte del codice del wikEd per sapere quali sono le variabili disponibili. Hanno tutte un '||' nella definizione, come:

 // dimensione del carattere iniziale della finestra (percentuale)
 var wikEdTextZoom = wikEdTextZoom || 100;

Tutte le configurazioni devono essere messe all'inizio del monobook.

Esempi di configurazione[modifica | modifica sorgente]

Trasforma i termini evidenziati in wikilink e seguili (usa il tasto destro per avere un menù che permetta di farlo):

 var wikEdFollowHighlightedLinks = true;

Cambia lo stile di evidenziazione:

 var wikEdFrameCSS = [];
 wikEdFrameCSS['.wikEdLinkName'] = 'color: #00a000; font-weight: bold;';

Modifica l'immagine su di un pulsante:

  var wikEdImage = [];
  wikEdImage['logo'] = '6/67/my_logo.png';

Cambia il testo di un pulsante:

 var wikEdText = [];
 wikEdText['wikEdLogo alt'] = 'wikEd';
 wikEdText['wikEdLogo text'] = 'wikEd {wikEdProgramVersion}, clicca per disabilitare';

Aggiungi i tuoi "Ogetti della modifica" predefiniti:

 wikEdComboPresetOptions = [];
 wikEdComboPresetOptions['summary'] = [
  'super-duper mega edit', 'copyedit', 'risposta', 'articolo creato', 'modificato incipit',
  'corretto wikilink', 'typo', 'rimosso spam', 'rollback',
  'vandalismo', 'foramttazione', '{wikEdUsing}'
 ];

Aggiungi una espressione regolare al campo trova/sostituisci:

 wikEdComboPresetOptions = [];
 wikEdComboPresetOptions['find'] = [
  '\n +', 'wiked'
 ];
 wikEdComboPresetOptions['replace'] = [
  '\n', '\'\'\'wikEd\'\'\''
 ];

Cambia lo stile di interfaccia:

 var wikEdMainCSS = [];
 wikEdMainCSS['.wikEdButton'] = 'background: blue;';

Abilita il pulsante Source per mostrare il codice sorgente del testo incollato o della sintassi evidenziata:

 var wikEdShowSourceButton = true;

Sposta i bottoni sotto la casella di edit:

 var wikEdButtonsOnTop = false;

Cambia la dimensione delle cronologie:

 var wikEdHistoryLength = [];
 wikEdHistoryLength['find'] = 15;
 wikEdHistoryLength['replace'] = 15;
 wikEdHistoryLength['summary'] = 20;

Cambia il testo da aggiungere in automatico all'oggetto:

 var wikEdSummaryUsing = '… usando wikEd';

Bottoni personalizzati[modifica | modifica sorgente]

Puoi aggiungere bottoni e funzioni personalizzate a due toolbar, una a destra dei bottoni di formattazione (custom1) e l'altra a destra di quelli di correzione (custom2). Aggiungi il seguente codice al tuo monobook.js prima del codice del wikEd:

// definisci i bottoni personali (id, class, popup title, image src, width, height, alt text, onClick and parameters)
var wikEdButton = [];
wikEdButton[100] = ['wikEdDiv', 'wikEdButton', 'Make the selection a html DIV element', 'http://upload.wikimedia.org/wikipedia/commons/6/67/WikEd_logo.png', '16', '16', 'DIV', 'javascript:WikEdEditButton(this, this.id, null, TestHandler);' ];
wikEdButton[101] = ['wikEdTest', 'wikEdButton', 'This is a test button', 'http://upload.wikimedia.org/wikipedia/commons/0/07/WikEd_disabled.png', '16', '16', 'Test', 'javascript:WikEdEditButton(this, this.id, null, TestHandler);' ];
 
// definisci le toolbar personali (id outer, class outer, id inner, class inner, height, grip title, button numbers)
var wikEdButtonBar = [];
wikEdButtonBar['custom1'] = ['wikEdButtonBarCustom1',  'wikEdButtonBarCustom1',  'wikEdButtonsCustom1',  'wikEdButtonsCustom1',  44, 'My custom buttons', [100, 'br', 101] ];
wikEdButtonBar['custom2'] = ['wikEdButtonBarCustom2',  'wikEdButtonBarCustom2',  'wikEdButtonsCustom2',  'wikEdButtonsCustom2',  44, 'My custom buttons', [100, 'br', 101] ];
 
// definisci la funzione richiamata da ogni pulsante
 
function TestHandler(obj) {
 
// seleziona il testo da modificare (tutto, selezione, cursore, parola sul cursore, riga sul cursore, parola selezionata o riga selezionata)
  WikEdGetText(obj, 'selection, cursor');
  if (obj.selection.plain != '') {
    obj.changed = obj.selection;
  }
  else {
    obj.changed = obj.cursor;
  }
 
// effettua i cambiamenti sul testo non formattato
 
// toglie la formattazione precedente
  if ( /<div>(.*?)<\/div>/i.test(obj.changed.plain) ) {
    obj.changed.plain = obj.changed.plain.replace(/<div>(.*?)<\/div>/gi, '$1');
  }
 
// e aggiunge quella nuova
 else {
    obj.changed.plain = '<div>' + obj.changed.plain + '</div>';
    obj.changed.plain = obj.changed.plain.replace(/(<div>)( *)(.*?)( *)(<\/div>)/, '$2$1$3$5$4');
  }
 
// mantiene selezionato il testo, bisogna rimuovere la formattazione con un secondo click
  obj.changed.keepSel = true;
 
  return;
}

Temi grafici[modifica | modifica sorgente]

Se non ti piace la colorazione o vuoi usare altri bottoni, nessun problema, puoi crearti il tuo "tema" personale modificando il wikEdMainCSS ed il wikEdFrameCSS.

Internet Explorer e altri browser[modifica | modifica sorgente]

wikEd, attualmente, non funziona con Internet Explorer o altri browser diversi dai sistemi Mozilla. Il tool si basa su dei JavaScript indipendenti dal browser, per cui non dovrebbe essere difficile renderlo compatibile. Se volete aiutare lo sviluppo di queste versioni lasciate commenti o segnalazioni di errore (soprattutto per MS Internet Explorer 7 e Opera 9) a Cacycle.

Segnalazione problemi[modifica | modifica sorgente]

Lascia la segnalazione di un problema nella discussione di en:User_talk:Cacycle/wikEd. Lascia anche un breve avviso nella discussione dell' utente.

Licenza[modifica | modifica sorgente]

La licenza si intende rilasciata da Cacycle, il creatore del tool

{{PD-Utente}}