L'editor è dove passi il tuo tempo in Caliu, quindi è ciò che riceve più cura. Ogni app ha il proprio editor, costruito sulla tecnologia di testo della sua piattaforma, e tutti condividono una promessa: ciò che viene salvato è semplice Markdown, e ciò che vedi è quel Markdown, formattato sul posto mentre scrivi.
Un ciclo, tre editor
Ogni editor di Caliu fa le stesse tre cose:
- Legge il Markdown della nota e ne ricava la struttura: titoli, elenchi, attività, citazioni, codice, tabelle.
- Mostra quella struttura come testo formattato, nascondendo la sintassi finché non ti serve.
- Scrive le tue modifiche come Markdown, lo stesso testo semplice che qualsiasi altra app Markdown sa leggere.
Aprire una nota non la modifica mai. Una nota cambia solo quando la modifichi tu, quindi leggerla su un altro dispositivo non la riscrive mai alle tue spalle.
Sul web: ProseMirror
L'editor web è costruito su Tiptap, che a sua volta poggia su ProseMirror, un toolkit per la scrittura di testo formattato nel browser usato da molti strumenti di scrittura noti. I blocchi di codice sono colorati da Shiki, lo stesso evidenziatore usato da molti editor di codice.
Su iPhone, iPad e Mac: il sistema di testo di Apple
L'editor Apple è costruito direttamente sulla vista di testo nativa di Apple (UITextView su iPhone e iPad, NSTextView su Mac) e su TextKit, il motore di testo delle app di Apple stessa. Il Markdown viene letto con la libreria swift-markdown di Apple, che segue la stessa specifica usata da GitHub, e riscritto rispettando le tue scelte originali: se hai scritto *italic* anziché _italic_, resta così.
L'intera nota è un'unica vista di testo continua. È questo che rende naturali la selezione, lo scorrimento e la modifica da un paragrafo all'altro. Ciò che non è testo semplice, come tabelle e blocchi di codice, viene disegnato in viste proprie appoggiate sopra il testo.
Su Android: il campo di testo della piattaforma
L'editor Android è costruito sul campo di testo di Android, formattato mentre scrivi. Il Markdown viene letto con commonmark-java e verificato rispetto allo stesso riferimento dell'app Apple. Centinaia di documenti di esempio devono uscire dall'editor Android esattamente come ci sono entrati, proprio come sui dispositivi Apple.
Perché il testo nativo conta
La modifica del testo è una delle cose più difficili da fare bene per un'app. Costruendo sul motore di testo di ogni piattaforma invece di reinventarne uno, Caliu ottiene tutto ciò che il tuo dispositivo sa già fare: correzione automatica e controllo ortografico, dettatura, metodi di inserimento per giapponese, cinese e coreano, lettori di schermo come VoiceOver e TalkBack, e le maniglie di selezione e le scorciatoie a cui sei abituato.
Vedere il Markdown
Quando vuoi vedere cosa viene salvato davvero, passa alla modalità sorgente. Mostra il Markdown grezzo, ogni # e ogni * compreso, e puoi modificarlo anche lì. Vedi l'articolo "Modalità sorgente".