Questa pagina descrive Calíope 1.5, la versione che stiamo costruendo adesso. La 1.4 è finita ed è in revisione sull'App Store, e il negozio serve oggi la 1.3 sul Mac e la 1.2 su iPad. 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.
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 e cinque i tipi: nel CSV la cella si illumina e la sua riga viene segnalata; nel Markdown, 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