Questa pagina descrive Calíope 1.7, la versione che sto costruendo adesso. La 1.6 è sull'App Store per Mac, iPad, iPhone, Apple Watch, Apple TV e Apple Vision Pro. Il changelog dice in quale versione è arrivata ogni funzione.
Aggiunge a ogni argomento un pulsante «Apri in Calíope». Funziona solo con l'app installata.
Leggi file .md, .sql, .json, .csv, .rtf e di testo senza aprire un editor.
Dove si trova: Workspace › Strumenti › Anteprima file
L'Anteprima file mostra il contenuto di un file locale interpretato in base alla sua estensione: il Markdown (.md) viene reso come documento, l'SQL (.sql) con evidenziazione della sintassi e numeri di riga, il JSON (.json) reindentato e colorato, il CSV (.csv, .tsv) come tabella, il testo formattato (.rtf) come documento, e il testo semplice (.txt, .log) così com'è.
È uno strumento in sola lettura: non modifica, non salva e non esegue nulla. Per scrivere ed eseguire query c'è l'Editor SQL; per i database SQLite locali, l'Editor SQLite.
Funziona senza connessione a un server e mostra un file alla volta, con un elenco dei recenti.
Parole chiave: anteprima, file, markdown, md, sql, json, csv, log, leggere, visualizzatore, sola lettura
Scegli un file dal disco o riaprilo dall'elenco dei recenti.
Tocca Apri… e scegli qualsiasi file supportato: .md, .sql, .json, .csv, .tsv, .rtf, .txt o .log. Il file viene aggiunto ai Recenti, che compaiono nella schermata iniziale dello strumento e conservano gli ultimi otto.
Calíope conserva un permesso persistente per ogni recente, così puoi riaprirlo dopo aver chiuso l'app senza cercarlo di nuovo. Se il file viene spostato o eliminato, il recente non lo apre più e basta sceglierlo un'altra volta con Apri….
Chiudi rilascia il file e interrompe la sorveglianza delle modifiche.
Sul Mac, Vista rapida — il pulsante con l'occhio, o la barra spaziatrice — mostra il file nel visore del sistema, che apre anche ciò che l'anteprima non interpreta: PDF, immagini, documenti d'ufficio.
Puoi aprirlo anche dall'esterno di Calíope. Sul Mac, dal Finder con Apri con › Calíope, oppure con un doppio clic se Calíope è l'app predefinita per quel tipo di file. Su iPad e iPhone, condividendolo dall'app File e scegliendo Calíope. Un .sql aperto così va nell'Editor SQL, non qui. Se la sessione che hai davanti non offre questo strumento, il file si apre in Apri senza connessione.
Parole chiave: aprire, recenti, file, chiudere, permessi, sandbox
Titoli, elenchi, tabelle, citazioni e blocchi di codice.
La resa copre i titoli da # a ######; i paragrafi con grassetto, corsivo, codice in linea, barrato e collegamenti; elenchi numerati e non, con annidamento; checklist - [ ] e - [x]; citazioni >; righe orizzontali; tabelle con barre verticali; e blocchi di codice recintati. Se il blocco è etichettato sql, viene evidenziato come un file .sql.
Escluso di proposito: le immagini non vengono mai scaricate — al loro posto compare il testo alternativo —, l'HTML incorporato non viene interpretato e il front matter iniziale viene saltato.
I titoli vengono annunciati a VoiceOver come titoli e tutto il testo segue la dimensione dinamica del carattere.
Parole chiave: markdown, md, titoli, elenchi, tabelle, immagini, codice
I file di testo formattato si leggono come documento, con la loro struttura.
Un file .rtf — quello che scrivono TextEdit, Word o Pages quando esportano — viene mostrato come documento e non come marcatura. Si conservano i titoli, gli elenchi con la loro annidatura e numerazione, il grassetto, il corsivo, il sottolineato, il barrato, i collegamenti, l'allineamento dei paragrafi e i tratti in carattere a spaziatura fissa.
Quello che non si applica è la tipografia del documento: né il carattere, né i corpi in punti, né i colori. Li mette Calíope, come già fa con il Markdown, così il testo scala con la dimensione dinamica del testo e si legge bene sia in tema chiaro sia in scuro. Te lo ricorda in fondo finché il file resta aperto.
I livelli dei titoli si deducono dal corpo del carattere relativo al documento stesso: il più grande è il livello 1, il successivo il 2, e così via. Un RTF non dichiara alcuna gerarchia, quindi è l'unica cosa che si può sapere.
Fuori ambito: i pacchetti .rtfd non si aprono — sono una cartella, non un file — e le immagini e gli oggetti incorporati non vengono mostrati; se il documento ne contiene, ti si dice quanti in fondo.
Parole chiave: rtf, testo formattato, richtext, documento, textedit, word, pages, formattazione, grassetto, corsivo
Evidenziazione della sintassi e numeri di riga, senza esecuzione.
I file .sql vengono mostrati a spaziatura fissa, con numeri di riga ed evidenziazione della sintassi: query, definizione dello schema, controllo, funzioni, tipi, finestra e procedurale, oltre a letterali di testo, numeri, commenti --, # e /* … */ e identificatori tra accenti gravi.
Non c'è un pulsante per eseguire, ed è voluto: l'anteprima non apre mai una connessione. Se vuoi eseguire il contenuto, aprilo nell'Editor SQL.
Oltre i 500 KB l'evidenziazione si disattiva e il file viene mostrato come testo semplice; una nota in fondo lo segnala.
Parole chiave: sql, evidenziazione, sintassi, righe, eseguire, editor
JSON reindentato, CSV come tabella, log così come sono.
Il JSON (.json) viene reindentato con due spazi per livello e colorato: chiavi, testo, numeri e true/false/null. L'ordine delle chiavi è quello del file — non viene riordinato nulla — e se il contenuto non è JSON valido l'anteprima lo segnala in fondo e mostra comunque ciò che è stato possibile leggere. Oltre i 2 MB la formattazione si disattiva e il file viene mostrato così com'è sul disco.
Il CSV (.csv, .tsv) viene mostrato come tabella, con numeri di riga e intestazione fissa. Il separatore viene rilevato — virgola, punto e virgola, tabulazione o barra verticale — e indicato in fondo; i campi tra virgolette, le virgolette raddoppiate e i ritorni a capo dentro un campo vengono rispettati. Vengono disegnate fino a 10 000 righe e 64 colonne, e ogni taglio viene dichiarato. Non ordina e non filtra: è un visualizzatore, non una griglia di dati.
Il testo semplice (.txt, .log e qualsiasi estensione non riconosciuta) viene mostrato così com'è, a spaziatura fissa e con numeri di riga. Le righe più lunghe di 2 000 caratteri vengono spezzate per poterle disegnare, e il segno ↳ indica la continuazione della riga precedente.
Gli oggetti e gli array si comprimono: il triangolo nel margine nasconde il contenitore e lascia un riepilogo —[…] o {…}— con il numero di membri; i due pulsanti dell’intestazione comprimono ed espandono tutto il file. I contenitori vuoti stanno già su una sola riga.
Risultati evidenziati, conteggio e salto tra di essi.
⌘F apre la barra di ricerca, come il pulsante con la lente nell’intestazione. Si cerca testo semplice, senza espressioni regolari, e solo su ciò che è stato letto: se il file è stato tagliato a 5 MB, l’avviso in alto lo dice e il resto non è stato guardato.
I risultati vengono dipinti sopra il contenuto senza coprire l’evidenziazione della sintassi, e quello selezionato usa un tono più forte. Invio e ⌘G portano al successivo, ⇧⌘G al precedente, e il conteggio della barra dice a quale sei. Il pulsante Aa distingue maiuscole e minuscole. Esc chiude la barra.
Funziona con tutti i tipi: nel CSV la cella si illumina e la sua riga viene segnalata; nel Markdown e nel testo formattato, il testo dentro il blocco —nei blocchi di codice il risultato viene contato e raggiunto, ma non illuminato, perché conservano la propria evidenziazione—; e nel JSON, un risultato nascosto in un contenitore compresso lo espande quando ci si salta. Si contano fino a 5 000 risultati; oltre, la barra mostra un +.
Parole chiave: cercare, trovare, risultati, evidenziare, cmd-f
La vista si aggiorna da sola quando il file cambia sul disco.
Finché il file è aperto, Calíope ne sorveglia il percorso. Se lo salvi da un altro programma, la vista si aggiorna da sola — con un indicatore Aggiornato per qualche secondo — e mantiene la posizione di lettura. Puoi anche forzarlo con Ricarica.
La sorveglianza sopravvive al salvataggio atomico, quello che fanno TextEdit, Xcode o vim sostituendo il file invece di riscriverlo: continua ad aggiornare anche dopo il secondo e il terzo salvataggio.
Se il file sparisce, lo strumento lo dice senza trattarlo come un errore: eliminare un file non è un guasto.
Limiti: di un file grande si leggono i primi 5 MB — in alto è indicato quanto viene mostrato —, l'evidenziazione SQL si disattiva oltre i 500 KB, la formattazione JSON oltre i 2 MB, e di un CSV vengono disegnate fino a 10 000 righe e 64 colonne. Ogni taglio viene dichiarato in fondo alla vista.
Parole chiave: aggiornare, ricaricare, modifiche, dimensione, limite, 5 mb
Come rileva la codifica di un file di testo, dove la mostra e che cosa dice quando non riesce a leggerlo.
Dove si trova: Workspace › Strumenti › Anteprima file
Per leggere un file di testo, l’Anteprima file cerca prima un indicatore dell’ordine dei byte (UTF-8, o UTF-16 nei due ordini). Senza, considera il file binario se trova un byte NUL vicino all’inizio; altrimenti prova UTF-8, poi il rilevamento del sistema, poi Windows-1252 e ISO-8859-1, in quest’ordine. La codifica trovata compare nell’intestazione accanto al tipo di file.
Un file binario, o uno che non riesce a decodificare, mostra «File binario o codifica di testo non supportata.». Quando un file grande viene troncato, il taglio cade su un confine di carattere pulito.
Parole chiave: codifica, UTF-8, UTF-16, Windows-1252, ISO-8859-1, binario