Wikiversità:Monobook.js/WikEd

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 Wikiversità 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.

Screenshot

This is really attentiongrabbing, You're a very professional blogger. I have joined your rss feed and sit up for in search of extra of your fantastic post. Also, I have shared your site in my social networks! ddgckfabddgeekkf

Requisiti di sistema

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 Wikiversità ed aver installato il monobook.js

Come usarlo

Se avete installato il monobook condiviso basta aggiungere alla variabile toLoad il codice wed.
Altrimenti, basta aggiungere il codice copiato da sotto in fondo a Utente:TuoNick/monobook.js.

Funzioni

(Per una lista breve vedi sopra)

Trovi una descrizione completa dei pulsanti in Wikiversità: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:w: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~~ Al momento si basa sulla lingua inglese. Ancora da implementare la versione italiana.
- 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

Al momento esistono traduzioni in:

Inglese
Italiano
Portoghese
Sloveno
Tedesco

Problemi conosciuti

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 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 . 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 l'articolo. Controlla sempre le modifiche apportate prima di salvare
wikE non è compatibile con altri script che operano sull'editing del testo (vedi la sezione successiva per saper apportare le dovute correzioni).

Incompatibilità

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'e' possibilità che lo script concorrente possa funzionare se il wikEd viene disabilitato con il pulsante .

Rendere gli altri script compatibili con wikEd

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/Wikiversità: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

Se usi il monobook ufficiale non seguire queste istruzioni. Scopri cosa fare in Wikiversità: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 funzina con tutti i software Mediawiki:

1. Accedi a Wikiversità con il tuo nickname

2. Clicca il seguente link per modificare il tuo monobook: Speciale:myPage/monobook.js

3. Se non stai usando lo skin predefinito (monobook) scopri in Speciale:Preferences quale file devi modificare

4. Aggiungi questo codice alla pagina:

// install [[Wikiversità:Monobook.js/WikEd.js/Descrizione]]
document.write('<script type="text/javascript" src="'
+ 'http://en.wikipedia.org/w/index.php?title=User:Cacycle/wikEd.js'
+ '&action=raw&ctype=text/javascript&dontcountme=s"></script>');

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 dovrebbe vedersi in cima ad ogni pagina, vicino al link "esci"

Risoluzione dei problemi/FAQ

wikEd non si carica

Hai installato il tool ma il logo 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 (Strumenti → Opzioni → Contenuti → Attiva 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.

Per altri problemi guarda Wikiversità:Monobook.js/WikEd/Manuale.

Configurazione

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

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

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 ( /&lt;div&gt;(.*?)&lt;\/div&gt;/i.test(obj.changed.plain) ) {
    obj.changed.plain = obj.changed.plain.replace(/&lt;div&gt;(.*?)&lt;\/div&gt;/gi, '$1');
  }

// e aggiunge quella nuova
 else {
    obj.changed.plain = '&lt;div&gt;' + obj.changed.plain + '&lt;/div&gt;';
    obj.changed.plain = obj.changed.plain.replace(/(&lt;div&gt;)( *)(.*?)( *)(&lt;\/div&gt;)/, '$2$1$3$5$4');
  }

// mantiene selezionato il testo, bisogna rimuovere la formattazione con un secondo click
  obj.changed.keepSel = true;

  return;
}

Temi grafici

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

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 and Opera 9) a Cacycle.

Segnalazione problemi

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

Licenza

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

Io, creatore di quest'opera, la rilascio nel pubblico dominio. La norma vale in tutto il mondo.

Nei casi in cui questo non sia legalmente possibile:
Garantisco a chiunque il diritto di utilizzare, modificare e riprodurre quest'opera, con ogni scopo o finalità e senza alcuna condizione a meno che tale utilizzo non sia in contrasto con la normativa dello stato di riferimento.