Non un muro di + e −.Le modifiche, sulla pagina renderizzata.

Perché un diff per righe è difficile da leggere con la prosa

Un diff per righe confronta il testo riga per riga. Nel codice funziona, perché una riga è un’unità di significato. In un documento no: un paragrafo è spesso una sola riga lunga, quindi cambiare una parola fa apparire l’intero paragrafo rimosso in rosso e aggiunto in verde. Anche riandare a capo in un paragrafo fa lo stesso. Finisci a cercare la parola che è cambiata.

Una tabella è peggio. Una cella cambiata è una riga di barre verticali e trattini cambiata. Quello che vuoi è la tabella renderizzata con la riga cambiata evidenziata.

DotMD mostra la differenza sulla pagina che stai leggendo: titoli, paragrafi, voci di elenco, blocchi di codice e righe di tabella, quelli aggiunti in verde, quelli rimossi in rosso, barrati.

Apri la cronologia delle versioni

Premi il pulsante ⑂ nella barra degli strumenti, ⌥⌘Y, oppure scegli File → Show Version History. La finestra passa alla modalità cronologia, come in Google Docs. Le versioni sono elencate per giorno sulla destra, con Current version in cima. La versione selezionata appare renderizzata al posto della pagina, con evidenziato ciò che è cambiato rispetto alla versione precedente.

• Highlight changes disattiva i colori, per vedere la versione com’era.
• Restore rimette la versione selezionata. Il testo attuale viene prima salvato come versione, quindi un ripristino si può annullare.
• Done (⌘↩) esce dalla modalità cronologia.

Le versioni vengono salvate come istantanee: quando aggiungi una cartella, quando DotMD si avvia, ogni volta che un’altra app come un agente IA, git o un altro editor modifica il file, e quando lo apri, lo lasci o finisci di modificarlo. Quelle più vecchie vengono diradate come in Time Machine, fino a un massimo di 200 per file. La cronologia è una comodità, non un backup.

Annulla una modifica, tieni il resto

Ripristinare una versione rimette l’intero file. Spesso vuoi di meno: tenere il testo nuovo tranne un paragrafo. Con DotMD Reviewer, nella versione attuale ogni blocco modificato è mostrato con il suo testo vecchio in rosso proprio sopra il testo nuovo in verde.

1. Segna cosa annullare

   Passa sopra una modifica e fai clic su ↩ Revert sul suo testo rosso. Un paragrafo che è stato solo aggiunto ha invece ✕ Remove. La pagina mostra come apparirà.

2. Applica

   Fai clic su Apply Reverts. Il file viene scritto con solo quelle modifiche annullate, e il resto rimane. Cancel scarta i segni. Il testo precedente è salvato come versione, quindi anche questo si può annullare.

Dopo che un agente IA modifica il file

I file che un’altra app ha modificato dall’ultima volta che li hai aperti hanno un punto arancione nella barra laterale. Aprine uno e DotMD va direttamente alle sue modifiche, con tutto ciò che è successo dall’ultima volta evidenziato. Se il file aperto cambia, un banner dice quante righe sono state aggiunte e rimosse, e Show Changes apre il confronto.

Quando rivedi le correzioni di un agente ai tuoi commenti, le modifiche sono mostrate accanto a ogni commento, e le modifiche che nessun commento aveva chiesto vengono contate come other changes. È lì che si nascondono le sorprese di un agente. Vedi Rivedere le modifiche.

Git diff o DotMD?

Usa git per rivedere il codice in una pull request: è per questo che serve un diff per righe. Usa DotMD per leggere cosa è cambiato in un documento: una spec, un piano, un README, una tabella di confronto. Non sono in competizione. DotMD non ha bisogno di un repository e coglie anche le modifiche che non sono mai state committate.

Domande sui diff Markdown

Altre domande