Aiuto:Diff
Il termine diff, nel gergo di Wikizionario, indica un confronto tra due versioni di una stessa pagina evidenziato in una schermata. Qui, ad esempio, il diff a una versione del lemma zolfo (che risale al 23 giugno 2009) e la seconda (di 7 minuti dopo). Le versioni da mettere a confronto non devono per forza essere "contigue" tra loro[1]: è insomma possibile generare un diff tra due versioni qualsiasi di una stessa pagina.
Si può accedere ad un diff dalla cronologia di una pagina: per ogni versione ci sono due possibili pulsanti di scelta: nella colonna sinistra si seleziona la versione più vecchia tra le due da confrontare, mentre nella colonna di destra la versione più nuova. Premendo il tasto Confronta le versioni selezionate vengono mostrate le differenze tra le due versioni.
Ci sono poi dei casi speciali per i quali vengono forniti anche altri metodi per ottenere il confronto. Per mostrare le differenze tra una versione e la versione corrente si può premere sul collegamento corr ("corrente") sulla linea corrispondente alla versione prescelta. Per mostrare le differenze tra una versione e la versione immediatamente precedente si può premere sul collegamento prec ("precedente") sulla linea corrispondente alla versione prescelta; questi link sono disponibili nella pagina della cronologia.
Il diff è utile anche in alternativa o in aggiunta all'anteprima della modifica[2], anche per notare quelle piccole modifiche che potrebbero sfuggire, piuttosto che l'effetto generale.
Il confronto viene mostrato automaticamente nel caso di conflitto di edizione, per permettere di vedere esattamente cosa c'è bisogno di reintegrare.
Come appare
[modifica]
Riga 2: Riga 2: {{-sost-|ru}} {{-sost-|ru}} − + − [[Categoria:Colori]] + − [[Categoria:Colori RAL]]
Le due versioni sono mostrate fianco a fianco. La versione meno recente si trova sulla sinistra, quella più recente sulla destra. I riquadri corrispondono ad alcune porzioni che il software ritiene utili ai fini del confronto: quelli grigi si riferiscono a sezioni rimaste immutate, quelle colorate a parti che invece hanno subito modifiche.
I blocchi gialli sulla sinistra rappresentano parti che hanno subito delle modifiche. Se la modifica è stata parziale, il codice che è stato rimosso apparirà evidenziato di giallo e accanto al blocco, sulla destra, ne apparirà un altro azzurro; se invece il paragrafo è stato rimosso completamente, di fianco non comparirà alcun box colorato ma solo uno spazio vuoto. I blocchi azzurri sulla destra possono, come detto sopra, averne uno giallo sulla sinistra (in questo caso, il testo evidenziato di azzurro rappresenta il codice che è stato aggiunto) o non averne nessuno (a indicare che si tratta di nuove parti aggiunte alla pagina).
I blocchi vuoti si riferiscono invece a linee vuote: ogni singola riga vuota è rappresentata da un blocco, indipendentemente dalla sua dimensione. Quelli gialli rappresentano le linee vuote rimosse, mentre gli azzurri quelle inserite. Si ricorda che una riga vuota, in codice wiki, corrisponde di solito ad un ritorno a capo (nuovo capoverso).
Di seguito un esempio pratico schematizzato di come potrebbero apparire i diff:
Riga rimasta invariata
|
Riga rimasta invariata
| ||
| − | parte rimossa
|
+ | parte aggiunta
|
| − | Blocco rimosso | ||
| + | Blocco Aggiunto |
Nella pagina del confronto vengono mostrati vari link che riguardano le versioni della cronologia, gli autori delle modifiche, i relativi oggetti e, nella colonna più a destra, uno per l'annullamento della modifica (e eventualmente anche uno per la verifica delle modifiche).
Gli amministratori vedono anche un bottone per il rollback, che consente di ripristinare la versione più vecchia con un solo clic. Quest'ultimo collegamento viene mostrato solo quando si sta confrontando la pagina con una versione precedente il cui autore sia un utente diverso da quello dell'ultima versione. Con i link ← Differenza precedente e Differenza successiva → è infine possibile confrontare la versione meno/più recente con quella immediatamente meno/più recente.
Se si stanno confrontando modifiche non consecutive, comparirà un messaggio indicante il numero di versioni intermedie: ad esempio, il messaggio
- 2 revisioni intermedie non mostrate
significa che il diff riguarda due modifiche tra le quali ne sono presenti altre due. Per poter visualizzare la differenza tra due modifiche non consecutive si devono usare i radio button o il pulsante (corr) della cronologia, che consente di effettuare il diff tra la modifica cui si riferisce e la versione corrente della pagina.
Se si vuole spostare o copiare un pezzo di testo da una parte all'altra di una stessa pagina o da una pagina a un'altra e contemporaneamente fare anche delle altre modifiche, è utile farlo in due tempi. In questo modo la funzione di confronto tra le versioni può essere utilizzata più comodamente per controllare o evidenziare questi altri cambiamenti.
Struttura della pagina
[modifica]Dopo la tabella delle differenze viene mostrata per intero la seconda tra le due versioni (in genere la più nuova).
Nel caso si utilizzi lo skin Classic con la barra delle scorciatoie, la pagina del confronto non ha la barra delle scorciatoie per rendere disponibile più spazio. Pertanto la pagina del confronto è anche utile per vedere il contenuto della pagina a tutto schermo, senza dover cambiare le preferenze.
Se si utilizza la skin Monobook i pannelli a sinistra sono presenti anche nelle pagine dei confronti.
Linkare un diff
[modifica]Quando, all'interno di una pagina di discussione, si parla di una certa modifica, può essere molto utile fornire un collegamento al diff particolare che la riguarda, per far capire meglio la questione agli interlocutori. Per farlo, è sufficiente visualizzare quel diff all'interno di una finestra del browser[3], selezionare con il mouse l'URL all'interno della barra degli indirizzi, e copia-incollarne il contenuto all'interno della discussione, trattandolo come un qualunque collegamento esterno.
Struttura del link
[modifica]L'URL associato ad una differenza tra versioni contiene sempre il comando &oldid= seguito dall'id di una delle due versioni (v) che si stanno confrontando[4]; compare sempre anche il comando &diff= seguito dalla parola cur (se si sta facendo un confronto la versione v e quella corrente), o dalla parola next (se si sta facendo un confronto tra la versione v e quella immediatamente successiva), o dalla parola prev o previous (se si sta facendo un confronto tra la versione v e quella immediatamente precedente) oppure negli altri casi dall'id della versione più recente (in questo caso, &oldid= sarà seguito dall'id della versione meno recente).
Si prenda in esame l'URL https://it.wiktionary.org/w/index.php?title=Aiuto:Diff&diff=252413&oldid=252412 (vedi), composto nel seguente modo:
https://it.wiktionary.org/w/index.php?title=Aiuto:Diff |
URL del sito, compreso il nome della pagina con il relativo namespace |
&diff=252413 |
(versione più recente) |
&oldid=252412 |
(versione meno recente) |
Attenzione
[modifica]È talvolta possibile imbattersi in diff ingannevoli, da cui sembra potersi desumere che un certo testo sia stato inserito da una certa persona, quando invece non è così. Succede in caso di pulizia selettiva della cronologia, in caso cioè di rimozione di vecchie versioni di una pagina che contengano testi offensivi o in violazione di copyright[5]. Tali versioni "rimosse" non solo non sono accessibili dalla cronologia, ma non vi sono nemmeno elencate: il diff quindi potrebbe mostrare testi inseriti nell'arco di tempo in cui esisteva anche il testo rimosso, facendoli sembrare appartenenti alla prima modifica al di fuori della rimozione. Per identificare questi casi, controllare l'eventuale presenza nella pagina di discussione della voce di eventuali avvisi di pulizia selettiva effettuata (gli amministratori possono riportarvi l'elenco degli autori delle versioni intermedie) e la presenza di versioni cancellate e/o recuperate nel log di cancellazione della pagina.
Esempio: la versione 10 di una voce contiene il testo "Ciao". Nella versione 11 l'utente A modifica in "Ciao mondo". Nella versione 12 l'utente B modifica in "Ciao mondo. Salve a tutti!". Poniamo ad esempio che "mondo" sia un'offesa, quindi nella versione 13 l'utente C modifica il testo in "Salve a tutti! Anche a te!" (rimuovendo "Ciao mondo"). Poi un amministratore elimina dalla cronologia tutte le versioni che contenevano la parola "mondo", quindi la 11 e la 12. La cronologia della voce mostrerà solo la 10 e la 13, e di conseguenza il diff, mostrando la differenza fra queste due versioni apparentemente contigue, evidenzierà la rimozione di "Ciao" e l'inserimento di "Salve a tutti! Anche a te!", dando l'impressione che tale modifica appartenga interamente all'utente C. Invece la frase "Salve a tutti" non era stata inserita da C, bensì da B.
Note
[modifica]- ↑ Come in quest'altro esempio (il diff reca in questo caso la scritta 18 revisioni intermedie di 10 utenti non mostrate).
- ↑ L'anteprima viene generata dal pulsante Mostra cambiamenti (sulla skin Vector) o Modifiche (sulla skin Monobook).
- ↑ Vi si accede di solito attraverso il link (prec) situato nella cronologia alla sinistra della modifica che interessa; se invece si vuole riferire un blocco di modifiche consecutive è necessario far uso dei radio button
- ↑ Fa eccezione il diff tra la versione corrente e quella immediatamente precedente, che contiene solo il comando &diff=cur: ad esempio http://it.wiktionary.org/w/index.php?title=Aiuto:Diff&diff=cur
- ↑ Salvo casi particolari, a questa procedura viene preferita la funzionalità RevisionDelete.
Pagine correlate
[modifica]- Speciale:ComparaPagine (permette di effettuare un diff tra versioni di due pagine distinte)