Contatto
Email: ribbon@craftclay.com
Quando contatti il supporto, includi la versione di macOS e la versione dell’app mostrata in RibbonDiff → About (oppure nella “Version History” dell’App Store).
Accesso Pro (Limited / Pro Trial / Pro Lifetime)
RibbonDiff è gratuito da scaricare e funziona in modalità Limited per confrontare testo digitato o incollato. Apertura e salvataggio file, uso di Workspace e della ricerca file Workspace, e Version History sono disponibili in Pro.
Limited (gratis)
- Confronta e modifica testo in entrambi i pannelli (digitato / incollato).
- Aggiornamenti diff live, connettori Ribbon centrali, Find per pannello, a capo automatico e temi.
Pro (Trial o Lifetime)
- Apri file da disco (
⌘O), Finder, Terminale o drag & drop - Save / Save As… per pannello (
⌘S/⇧⌘S) - Cartelle o
.rd-workspacedocumenti nella barra laterale Workspace e salvare documenti Workspace (⇧⌥⌘S) - Cerca testo in un Workspace aperto con Find in Workspace… (
⇧⌘F), incluso Option-clic per aprire i risultati in un’altra scheda - Crea nuovi file o cartelle Workspace con rinomina inline, poi spostali, eliminali, mostrali o copia i percorsi dalla barra laterale
- Usa Version History per file in Workspace gestiti da Git, con anteprime storiche in sola lettura
- Optional per-pane Line Endings e Encoding opzionali (se abilitati in Settings)
Avviare Pro Trial (7 giorni)
Apri: RibbonDiff → Settings… → Pro, quindi fai clic su Start 7-Day Pro Trial. Il trial è one-time, dura 7 giorni e non si rinnova automaticamente.
Sbloccare Pro Lifetime
Apri: RibbonDiff → Settings… → Pro, quindi fai clic su Sbloccare Pro Lifetime. È un acquisto una tantum.
Restore Purchases
Se l’accesso Pro non appare (dopo una reinstallazione o un cambio Mac), vai a Settings → Pro → Restore Purchases.
Clienti della precedente versione a pagamento: se hai acquistato RibbonDiff quando era un download a pagamento sull’App Store, dovrebbe sbloccare automaticamente Pro Lifetime sullo stesso Apple ID. Se non succede, usa Restore Purchases.
Aiuto rapido
- Documentazione completa: see the Guida utente per workflow dettagliati e scorciatoie.
- Elenco scorciatoie: choose Help → RibbonDiff Help (⌘?) per aprire la finestra di riferimento scorciatoie integrata.
- Compare text: incolla o digita nei pannelli sinistro e destro. Il diff si aggiorna automaticamente.
- Open files (Pro): trascina un file su un pannello, oppure fai clic su un pannello e premi ⌘O.
- Nuovo confronto: choose File → New Window (⌘N) per una nuova finestra di confronto indipendente, File → New Window with Sidebar (⇧⌘N) per una finestra con la barra laterale Workspace aperta, oppure ⌘T per una nuova scheda nel gruppo finestra corrente.
- Workspace (Pro): use File → Open Workspace… (⇧⌘O) per aprire una cartella o
.rd-workspacein una nuova finestra indipendente. Oppure usa l’azione della barra laterale Open Folder or Workspace File per collegare il Workspace alla attuale window. - Ricerca file Workspace (Pro): scegli Find → Find in Workspace… (⇧⌘F) per cercare nei file di testo del Workspace aperto. Usa View → Show File Tree (⌘1) e View → Show File Search (⌘2) per cambiare modalità della barra laterale. La ricerca resta visibile mentre passi tra schede, mantiene query e risultati espansi, mostra indicatori M per i file modificati da Git e supporta Option-clic per aprire risultati in un’altra scheda.
- Gestione file Workspace (Pro): usa il menu azioni della barra laterale o il clic destro su cartelle/file per aggiungere file o cartelle, aprire file in nuove schede, mostrare elementi nel Finder, copiare percorsi relativi o completi, selezionare più elementi, trascinarli in cartelle o spostare nel Cestino le eliminazioni confermate.
- Version History (Pro): apri un file da un Workspace gestito da Git, poi usa i selettori di branch e versione per confrontare il file corrente con snapshot storici in sola lettura.
- Save (Pro): fai clic in un pannello per renderlo attivo, poi usa ⌘S / ⇧⌘S. Il salvataggio si applica sempre al active pane. Use Save Workspace / Save Workspace As… per salvare un documento Workspace.
- File cambiati su disco: se un file aperto cambia su disco, RibbonDiff lo ricarica automaticamente quando non ci sono modifiche non salvate, oppure chiede conferma prima di sostituire le modifiche nell’app.
- Find in ciascun pannello: usa il campo Find del pannello, oppure premi ⌘F, then ⌘G/⇧⌘G per passare da una corrispondenza all’altra.
- Word wrap: attiva l’a capo per evitare lo scorrimento orizzontale sulle righe lunghe.
- Filtri Whitespace: use the Whitespace toolbar toggle or View → Whitespace Filters (⌃⌘I) per attivare o disattivare insieme i filtri di confronto salvati per indentazione, spazi iniziali e spazi finali.
- Line Endings / Encoding (opzionale): abilita i badge in Settings → General. Queste impostazioni influiscono su come i file vengono scritti al salvataggio, ma sono normalizzate per il confronto (LF vs CRLF di solito non crea un diff da solo).
- Themes: personalizza colori/sfondi del diff e importa/esporta temi come JSON.
- Confronti multipli: usa nuove finestre o schede finestra macOS per tenere aperti più diff. Quando un Workspace è aperto, ogni scheda in quella finestra condivide la stessa barra laterale e lo stesso albero progetto.
Preferenze / Impostazioni
Open Settings
Dalla barra dei menu scegli: RibbonDiff → Settings… (shortcut: ⌘,).
Sezioni utili
- Pro: visualizza il livello di accesso, cosa è incluso, avvia la trial di 7 giorni, sblocca Pro Lifetime o ripristina gli acquisti. Se provi un workflow solo Pro come aprire o salvare file, usare Workspace o la ricerca file Workspace, o usare Version History in modalità Limited, RibbonDiff mostra il prompt Pro.
- General: numeri di riga (per pannello), a capo automatico predefinito, valori predefiniti salvati dei filtri Whitespace, badge opzionali Line Endings / Encoding e dimensione/altezza riga degli elementi Workspace.
- Appearance: regola i colori di evidenziazione del diff (Added/Removed/Modified) e il colore del connettore centrale (“ribbon”).
- Backgrounds: choose System sfondi (seguono Light/Dark Mode) oppure passa a Custom colors.
- Syntax: abilita colori sintattici personalizzati e modifica palette Light/Dark separate.
- Themes: passa tra temi integrati o temi personalizzati salvati.
Importare un tema (JSON)
Go to Settings → Theme, click Import Theme…, then select a
.json file.
Imported themes appear under User Themes.
Esportare un tema (JSON)
Go to Settings → Theme, click Export Theme…, assegnagli un nome, quindi scegli dove salvare il file .json file.
Suggerimento: se hai importato un tema ma non lo vedi nell’elenco, chiudi e riapri Settings e controlla di nuovo la sezione Theme.
Risoluzione dei problemi
Non riesco ad aprire / trascinare / salvare file, Workspace, ricerca file Workspace o Version History
Aprire o salvare file, usare Workspace e usare la ricerca file Workspace sono workflow Pro. Version History è anch’essa solo Pro e appare solo per file dentro un Workspace gestito da Git. Controlla RibbonDiff → Settings… → Pro per confermare di essere in Pro Trial o Pro Lifetime. Se hai già acquistato, usa Restore Purchases.
La mia Pro Trial è terminata — cosa succede?
Dopo 7 giorni, RibbonDiff torna in modalità Limited. I workflow di apertura/salvataggio file, Workspace, ricerca file Workspace e Version History vengono disattivati di nuovo, ma puoi continuare a confrontare testo digitato o incollato, oppure sbloccare Pro Lifetime.
Workspace resta chiuso o mostra un prompt di upgrade
Workspace is a Pro una funzione. Se RibbonDiff mostra il prompt di upgrade, avvia Pro Trial o sblocca Pro Lifetime da RibbonDiff → Settings… → Pro. Se Workspace è già aperto nella finestra corrente, usa quella barra laterale condivisa invece di aspettarti un Workspace separato per ogni scheda.
La gestione file Workspace non è stata completata
I nomi dei nuovi elementi Workspace non possono essere vuoti, contenere / o duplicare un altro elemento nella stessa cartella. Gli spostamenti drag & drop devono avere come destinazione una cartella dentro il Workspace; RibbonDiff blocca spostamenti senza effetto, spostamenti dentro l’elemento stesso o una sua sottocartella e conflitti da nomi duplicati. Delete sposta nel Cestino file e cartelle confermati.
La ricerca file Workspace non mostra risultati
La ricerca file Workspace richiede un Workspace aperto e cerca nei file di testo dentro quel Workspace. Verifica di essere in Pro Trial o Pro Lifetime, che il Workspace sia aperto e che il testo cercato esista in un file di testo leggibile. Se passi tra schede o torni dall’albero file, RibbonDiff mantiene query corrente, risultati, file espansi e posizione di scorrimento. File binari, non leggibili o molto grandi possono essere saltati.
Version History non è disponibile
Version History è una funzione Workspace solo Pro. Appare solo quando il file corrente si trova dentro un Workspace gestito da Git. Se il file è fuori dal Workspace, o il Workspace non è gestito da Git, i selettori branch e versione potrebbero non apparire.
Open Workspace… ha aperto una nuova finestra
È previsto. File → Open Workspace… apre sempre la cartella o il
.rd-workspace in una nuova finestra indipendente. Se invece vuoi sostituire il confronto della finestra corrente con un Workspace, usa il pulsante della barra laterale Open Folder or Workspace File oppure trascina una cartella / .rd-workspace
file sulla barra laterale.
Wrap / Whitespace / Swap / Clear sono scomparsi
La riga toolbar superiore potrebbe essere nascosta. Scegli View → Show Toolbar or press ⌥⌘T per ripristinarla, incluso il toggle Whitespace toggle. Il contenuto dell’editor, Workspace e diff restano invariati.
Un file è cambiato su disco mentre era aperto
RibbonDiff ora ricarica automaticamente i file cambiati quando ci sono nessuna modifica non salvata nell’app. Se hai modifiche non salvate, RibbonDiff chiede conferma prima di sostituire tali modifiche nell’app con il nuovo contenuto su disco.
Restore Purchases non ha sbloccato Pro
Conferma di aver effettuato l’accesso con lo same Apple ID su questo Mac usato per l’acquisto originale. Poi chiudi e riapri RibbonDiff e prova di nuovo Settings → Pro → Restore Purchases di nuovo. Se ancora non funziona, scrivi al supporto indicando versione dell’app e versione macOS (non servono dati sensibili).
Il testo appare illeggibile (mojibake) dopo l’apertura di un file
Il file potrebbe essere stato decodificato con la codifica sbagliata. Abilita il badge Encoding badge in Settings → General, seleziona un’altra codifica e riapri il file.
Ho cambiato Line Endings o Encoding e il file è stato riscritto, ma il testo sembra uguale
È previsto. RibbonDiff normalizza internamente terminazioni di riga e codifica, quindi modificare solo il badge può riscrivere dettagli di archiviazione del file senza cambiare il testo visibile.
Il testo sembra fuori sincronizzazione dopo un grande incolla
Prova a fare clic nel pannello e scorrere una volta, oppure disattiva/riattiva Word Wrap per aggiornare il layout.
Prestazioni con testi molto grandi
I confronti molto grandi possono richiedere qualche momento per essere calcolati. Se sembra lento, prova a confrontare sezioni più piccole o a dividere l’input.
Problemi di import/export dei temi
Assicurati che il file sia JSON valido e corrisponda al formato tema di RibbonDiff. Se hai importato un tema ma non lo vedi, riapri Settings e controlla il menu Theme.
Richieste di funzionalità e feedback
Invia suggerimenti a ribbon@craftclay.com. Se possibile, includi un breve input di esempio (non sensibile) e ciò che ti aspettavi di vedere.