Wikibooks:Popup di navigazione

Un popup in azione

I Popup di navigazione offrono un accesso facile ed immediato a numerose funzioni di Wikipedia, attraverso un comodo popup che apparirà lasciando il mouse sopra ad un link.

Installazione rapida: aggiungi {{subst:navpop}} al tuo monobook.js (o ad un file equivalente se utilizzi una skin diversa). Vedi sotto per le istruzioni complete per l'installazione.

Se riscontri dei problemi, prova a consultare le FAQ.

Funzionalità

Anteprima piccola dell'immagine di un articolo

Facendo clic, l'anteprima viene ingrandita

Un rollback eseguito tramite un popup

• Anteprima della prima parte del testo di un articolo (grazie a en:User:Pilaf per il suo script "Live Preview" che ha reso possibile tutto questo)
• Anteprima delle immagini dai loro collegamenti
• Anteprima della prima immagine di ogni articolo
• Anteprima delle differenze negli osservati speciali, nella cronologia e nelle modifiche correlate.
• Anteprima dei wikilink selezionati durante la modifica di una pagina (usa il mouse per selezionare un wikilink)
• Rollback dei vandalismi con un click dalla cronologia (vedi immagine)
• Informazioni su redirect, stub e pagine di disambiguazione
• Informazioni sulla pagina come la dimensione, il numero di link, il numero di immagini, il numero di categorie e l'età della pagina
• Dovrebbe funzionare su tutti i wiki di Wikimedia
• Accesso immediato (con un click) a
  • modifica della pagina
  • contributi utente
  • tool di Interiot (contatore di edit)
  • scrivi all'utente
  • cronologia
  • segui/non seguire
  • mostra e permette di modificare le pagine di discussione
  • puntano qui
  • modifiche correlate
  • per gli amministratori, proteggi e sblocca, cancella e blocca utente
  • log utente e log dei blocchi
  • elenco delle sottopagine delle pagine utente
  • ricerca in Wikipedia, ricerca globale su Wikipedia e su Google
• Scorciatoie da tastiera (opzionali)
• Riparazione automatica dei link per evitare i redirect e le pagine di disambiguazione (opzionale)

Installazione

Devi avere un account utente per poter installare ed usare le funzionalità dei popup di navigazione. Se non ne hai uno, dovrai crearlo e connetterti.

Il prossimo passo è aggiungere {{subst:navpop}} al tuo monobook.js. Tale azione servirà per aggiungere il seguente codice al tuo fle .js:

// [[:en:User:Lupin/popups.js]]


document.write('<script type="text/javascript" src="' 
    + 'http://it.wikipedia.org/w/index.php?title=Utente:Emc2/strings-it.js' 
    + '&action=raw&ctype=text/javascript"></script>');

document.write('<script type="text/javascript" src="' 
    + 'http://en.wikipedia.org/w/index.php?title=User:Lupin/popups.js' 
    + '&action=raw&ctype=text/javascript&dontcountme=s"></script>');

Nota: Se stai usando una skin diversa dal MonoBook (quella predefinita), il file in cui dovrai aggiungere il codice sono elencate qua sotto.

• Classic: standard.js
• Cologne Blue: cologneblue.js
• Chick: chick.js
• Simple: simple.js
• Nostalgia: nostalgia.js
• MySkin: myskin.js

Dopo aver salvato la pagina, pulisci la cache del tuo browser (tieni premuto SHIFT mentre ricarichi la pagina). A meno che il javascript non sia disabilitato nel tuo browser, un popup dovrebbe apparire lasciando il mouse sopra ad un link interno in Wikipedia.

Per installare lo script su commons o sul wikizionario, ripeti la stessa procedura. Per disinstallare lo script, elimina le linee riportate sopra dalla stessa pagina e pulisci la cache del tuo browser.

Guida all'utilizzo

Questo strumento serve per generare dei "popup di suggerimento" quando lasci il puntatore del mouse sopra a link o immagini.

Molte delle funzionalità considerate più importanti possono essere comodamente usate dalla lista degli osservati speciali.

• lascia il mouse sopra al link ad una differenza per mostrare un riassunto delle modifiche effettuate
• lascia il mouse sopra al link alla revisione di un articolo per mostrare un breve estratto della revisione

Dovrebbero esserci anche alcuni "link di navigazione" che offrono l'accesso a diverse funzioni, compreso un rollback immediato, la modifica della pagina e così via. Potrebbero essere incluse direttamente nel template, o nascoste nel menu "azioni", a seconda del tuo browser e delle tue impostazioni.

Negli articoli normali:

• lascia il mouse sopra ad un link per far apparire un breve estratto dell'articolo collegato, poi passa con il mouse sopra al link "azioni" per vedere i comandi aggiuntivi
• tieni premuto il tasto shift per aggiustare la posizione del popup

Configurazione (opzionale)

Cambiare l'aspetto dei popup

Puoi cambiare l'aspetto dei popup tramite il tuo file CSS. Il tuo file CSS ha esattamente lo stesso nome del file javascript, con "css" invece di "js" alla fine. Quindi, per la maggior parte delle persone, il file da modificare è monobook.css.

Quello che segue è un esempio che presenta un popup arancione con un bordo e cambia il font in uso. Il popup avrà un aspetto abbastanza stupido, ma è una dimostrazione del tipo di cose che si possono fare con un po' di voglia.

.navpopup { 
  background-color: #FFBE20  !important;
  font-family:      serif    !important;
  color:            #404     !important;
  font-size:        medium   !important;
}

Opzioni

Ci sono alcune opzioni che puoi personalizzare. Per farlo, modifica il tuo file javascript (ad esempio monobook.js) e agigungi una linea del tipo

opzione = valore;

dove opzione e valore sono scelti dalla tabella seguente. Per esempio, per evitare ogni tipo di download e mostrare i link per amministratori, avrai bisogno di una cose del genere nel tuo file javascript:

// [[:en:User:Lupin/popups.js]] - si prega di aggiungere questa linea 


document.write('<script type="text/javascript" src="' 
    + 'http://it.wikipedia.org/w/index.php?title=Utente:Emc2/strings-it.js' 
    + '&action=raw&ctype=text/javascript"></script>');

document.write('<script type="text/javascript" src="' 
    + 'http://en.wikipedia.org/w/index.php?title=User:Lupin/popups.js' 
    + '&action=raw&ctype=text/javascript&dontcountme=s"></script>');

simplePopups=true;
popupAdminLinks=true;

Configuration options
Opzioni	Valori*	Descrizione

*I valori predefiniti sono elencati in grassetto

Potrebbero essere aggiunte altre opzioni, e le richieste di una maggiore flessibilità di configurazione sono più che benvenute.

Advanced customization

You can define custom filters for articles. These are javascript functions which are run after the page statistics are generated, and their output is appended (as HTML) to that part of the popup. (Note that if simplePopups is true or popupSummaryData is false, then nothing will be displayed).

The way to set this up is to write a filter function which accepts a string (the wikitext of the article) as input, and returns a fragment of HTML. Repeat for as many filters as you want, and then create an array extraPopupFilters which contains all of the functions, in the order in which you want them to be run.

For example, let's say you want to be told whenever the wikitext of an article contains a table written using HTML tags rather than wiki markup. One way to do this is to add the following to your user javascript file:

// initialize the array - only do this once
extraPopupFilters=[];

// define the function
function popupFilterHtmlTable (wikiText) {
  if (/<table/i.test(wikiText)) return '&lt;table&gt;';
  else return '';
};

// add the function to the array (you can repeat this for lots of functions)
extraPopupFilters.push(popupFilterHtmlTable);

Then when a popup is generated for a page containing an HTML table, you should see <table> in the popup. (It may also appear for other pages, such as this page. Correcting this defect is left as an exercise for the reader).

Crediti

La traduzione italiana è a cura di:

• Emc2, aiuto alla traduzione delle stringhe, debug del file di stringhe, traduzione della pagina corrente, smazzamenti vari
• Valepert, traduzione delle stringhe, creazione degli screenshot illustrativi, manutenzione del file di stringhe, smazzamenti vari

Per ogni tipo di lamentele, complimenti, segnalazioni di bug e quant'altro potete alternativamente contattare Emc2 o Valepert, o (in inglese) Lupin, lo sviluppatore che ha reso possibile tutto ciò.

Browser problems

Safari

Some people have found that Safari crashes a lot when running this script. Lupin would be interested to hear if this is still the case or not, and would greatly welcome assistance from someone who knows some javascript in getting to the bottom of these problems.

Current versions of Safari have bugs which prevent the menus from functioning correctly. Using a Webkit nightly build should give correctly functioning menus.

Opera

Older versions of Opera have bugs which prevent the menus from functioning correctly. Using a current version (9.0 or higher) should give correctly functioning menus, but you may still experience problems sometimes, with popups not loading, or not disappearing after the mouse is moved away.

Feedback

Bugs, problems, suggestions and enhancements to Lupin, please.

I have set up a page where you can list pages with incorrect previews.

Development version

This tool remains under development. The very latest version is available at User:Lupin/popupsdev.js and it sees new features before the stable version. Be warned that it does break every so often, though. If you do want to install it, you can type

 {{subst:js|User:Lupin/popupsdev.js}}

into your user javascript file and delete your current popups installation from that file.

See also

• Wikipedia:Easy navigation – Proposed guideline
• Help:User style – Customize Wikipedia page layout

Credits and external links

This tool depends on some other peoples' work:

• User:Pilaf/InstaView (née Live Preview) by Pilaf
• a Javascript MD5 hash function by Paul Johnston and others, available here
• domdrag by Aaron Boodman
• An implementation of a diff algorithm by John Resig

Older versions of the tool used overlib by Erik Bosrup.

Wikipedians who have helped

• Brian0918 - a little code and lots of inspiration
• Eddideigel - translation work
• IceKarma - aborting download code, making much better use of bandwidth
• Mike Dillon - the page age code
• Yurik - with his fantastic mediawiki BotQuery extension
• Zocky - the menus
• Zyxw - preview enhancements
• ....and many more with helpful suggestions, comments and bug reports