Aiuto:Accessori/WikEd

wikEd è un editor di testo completo che aggiunge funzioni di text-processing alle pagine di modifica di Cathopedia 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

(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

Funzioni

(Per una lista breve vedi sopra)

Trovi una descrizione completa dei pulsanti in Aiuto:Accessori/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 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
• 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 bug 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).
• Il pulsante di correzione unicode, e di conseguenza anche il pulsante per correggere tutto, interrpreta la stringa "uad" come uno spazio e la sostituisce.

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

<syntaxhighlight lang="javascript"> // copia il frame di wikEd (http://it.cathopedia.org/wiki/Cathopedia: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();
   }

} </syntaxhighlight>

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 eventuali errori in JavaScript ("Console degli errori" sotto "Strumenti" in Firefox). Se ne trovi qualcuno causato da wikEd scrivilo nella pagina dell'Oratorio.

Per altri problemi guarda Aiuto:Accessori/WikEd/Manuale.

Configurazione

wikEd è completamente configurabile, inclusi colori, lingua, bottoni e funzioni tramite variabili nelle proprie pagine javascript utente. 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;

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 "Oggetti 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 a una propria pagina javascript utente 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

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 e Opera 9) in Otatorio.

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

{{PD-Utente}}

Collegamenti esterni

• Aiuto Accessori/WikEd di it.wiki: il materiale ivi presente è stato rielaborato per Chatopedia e integrato