Questa è la documentazione per WikEd, un accessorio che può essere abilitato in Preferenze/Accessori. Il relativo script si trova in MediaWiki:Gadget-WikEd.js.
In caso di problemi scrivere nella pagina di discussione segnalandola all'Officina. Per informazioni generiche chiedere allo Sportello informazioni.
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 wikitesto]
(Per una lista più dettagliata vedi sotto)

Requisiti di sistema

[modifica | modifica wikitesto]

Funzioni

[modifica | modifica wikitesto]
(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:

Traduzioni

[modifica | modifica wikitesto]

Al momento esistono traduzioni in:

Problemi conosciuti

[modifica | modifica wikitesto]

Incompatibilità

[modifica | modifica wikitesto]

In generale, wikEd è incompatibile con qualsiasi script che opera sulla casella di modifica del testo. Il motivo è che sostituisce 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

[modifica | modifica wikitesto]

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();
    }
}

Risoluzione dei problemi/FAQ

[modifica | modifica wikitesto]

wikEd non si carica

[modifica | modifica wikitesto]

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:

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

Configurazione

[modifica | modifica wikitesto]

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

[modifica | modifica wikitesto]

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', 'formattazione', '{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 wikitesto]

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

[modifica | modifica wikitesto]

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 wikitesto]

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 wikitesto]

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 wikitesto]

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

((PD-Utente))

Categoria