Wikibooks: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 Wikibooks 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

Breve elenco delle funzioni

(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

• 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 Wikibooks 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 Wikibooks: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 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/Wikibooks: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 Wikibooks: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 Wikibooks 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 [[Wikibooks: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 Wikibooks: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 alle due barre, uno a destra dei bottoni di formattazione (custom1) e l'altro a destra dei bottoni di correzione (custom2). Aggiungi il seguente codice al tuo monobook.js prima del wikEd:

// define  custom buttons (id, class, popup title, image src, width, height, alt text, onClick and parameters)
var wikEdButton = [];
wikEdButton[100] = ['wikEdDiv', 'wikEdButton', 'Seleziona un DIV HTML', 'http://upload.wikimedia.org/wikipedia/commons/6/67/WikEd_logo.png', '16', '16', 'DIV', 'javascript:WikEdEditButton(this.id, null, TestHandler);' ];
wikEdButton[101] = ['wikEdTest', 'wikEdButton', "Questo e" un bottone di prova', 'http://upload.wikimedia.org/wikipedia/commons/0/07/WikEd_disabled.png', '16', '16', 'Test', 'javascript:WikEdEditButton(this.id, null, TestHandler);' ];

// definisci barre personali (id, class, button numbers)
var wikEdButtonBar = [];
wikEdButtonBar['custom1'] = ['wikEdButtonsCustom1', 'wikEdButtonsCustom1', [100, 'br', 101] ];
wikEdButtonBar['custom2'] = ['wikEdButtonsCustom2', 'wikEdButtonsCustom2', [100, 'br', 101] ];

// dichiara la funzione lanciata cliccando sul pulsante

function TestHandler(obj) {

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