Tutto ciò che fa mote, in una sola pagina.

mote è abbastanza piccolo da far stare qui tutto il manuale. Bastano dieci minuti.

Installazione

Il pacchetto Linux .deb non è ancora disponibile; sarà pubblicato su GitHub Releases con SHA256SUMS e firmato secondo le regole di ogni piattaforma. Ricevi un avviso quando sarà pronto.

Il tuo primo file

mote apre file, non una libreria. Usa ⌘O per aprire un file oppure trascina un file .md sulla finestra. Per impostazione predefinita, i file si aprono nella vista Live; la barra laterale (⌘⇧E) mostra la cartella che li contiene.

Il salvataggio è ⌘S. Il salvataggio automatico è attivo per impostazione predefinita e scrive un secondo dopo che smetti di digitare; la barra di stato indica esattamente quanti byte sono cambiati. Puoi disattivarlo in Impostazioni → Generali.

Live, Sorgente, Lettura

Il selettore nell'intestazione, oppure ⌘1 ⌘2 ⌘3, cambia il modo in cui viene mostrato lo stesso file. Il file non cambia.

• La vista Live mostra la formattazione direttamente nel testo. Il Markdown dietro una parola appare solo quando il cursore si trova su di essa; il marcatore di un titolo o di una citazione appare quando il cursore è sulla relativa riga, mentre quello di un elenco solo quando il cursore è sul marcatore stesso. Allontana il cursore e tornano a essere formattati. Seleziona più righe per vedere tutti i relativi marcatori. Enter inizia un nuovo paragrafo, continua un elenco e incrementa gli elenchi numerati.
• La vista Sorgente mostra il file così com'è sul disco, in un editor a spaziatura fissa. È la vista da consultare quando conta la precisione.
• La vista Lettura mostra il documento finito. Non è possibile modificarlo; i collegamenti si aprono.

La posizione del cursore e quella di scorrimento restano invariate passando da una vista all'altra.

Supporto Markdown

mote segue CommonMark 0.31 e GitHub Flavored Markdown. Tutto ciò che le specifiche rendono viene reso anche da mote. Ciò che non riconosce resta esattamente com'è scritto.

Scorciatoie da tastiera

Le scorciatoie sono indicate con ⌘; su Linux e Windows quel tasto è Ctrl.

Concentrazione e struttura

La modalità concentrazione (F8) nasconde tutti i controlli e lascia solo la pagina. Porta il puntatore sul bordo superiore per mostrare l'intestazione; Esc esce dalla modalità. La scheda Struttura nella barra laterale elenca i titoli; fai clic su uno per raggiungerlo. Il conteggio delle parole e il tempo di lettura stimato si trovano nella barra di stato.

Esportazione

L'esportazione, dal menu o dalla tavolozza dei comandi, produce PDF impaginati con la tipografia della vista Lettura e HTML autonomo senza script. Non modifica mai il file sorgente.

Integrità dei file

mote modifica direttamente il testo sorgente. Non esiste un modello intermedio da serializzare di nuovo al salvataggio. In pratica significa che:

• Le terminazioni di riga (LF o CRLF) e il ritorno a capo finale vengono conservati così come sono.
• Rientri, allineamento delle tabelle e marcatori degli elenchi spaziati a mano restano intatti, salvo che tu modifichi quella riga.
• Frontmatter, commenti HTML e sintassi sconosciuta restano identici byte per byte.
• I file vengono letti e scritti come sequenze di byte — UTF-8 con o senza BOM — e non vengono mai ricodificati.

Se un file aperto cambia sul disco, mote lo ricarica quando non ci sono modifiche non salvate; altrimenti chiede cosa fare.

Cartelle e sincronizzazione

Apri un file e la scheda File nella barra laterale (⌘⇧E) mostra la cartella che lo contiene. mote legge la cartella; non la indicizza, non la memorizza nella cache e non vi scrive nulla. Non esiste una directory .mote/. Per questo iCloud Drive, Dropbox, OneDrive, Syncthing e Git funzionano senza accorgimenti particolari.

Prova

Durante la beta la prova non ha scadenza. Il primo avvio dà inizio a una prova di 14 giorni con tutte le funzioni attive. I giorni rimanenti compaiono con discrezione nell'intestazione. Due giorni prima della fine appare un avviso che può essere chiuso. Dopo la prova, mote passa alla sola lettura: i file si aprono, ricerca e struttura funzionano, così come l'esportazione. Modifica, nuovi file e sostituzione restano bloccati finché non inserisci una chiave.

Attivare una chiave

La chiave ha questo aspetto: MOTE-XXXX-XXXX-XXXX. Arriva via e-mail dopo l'acquisto. Fai clic sull'indicatore della prova nell'intestazione (oppure mote → Licenza…), incolla la chiave e premi Attiva. L'attivazione effettua una richiesta al server delle licenze e conserva il risultato in locale; non vengono effettuate altre chiamate di rete. Per i computer isolati dalla rete, l'attivazione offline è disponibile su richiesta.

Gestire i dispositivi

Una licenza personale può essere attiva su tre dispositivi alla volta. Per passare a un nuovo computer, su quello vecchio scegli mote → Licenza → Disattiva questo dispositivo. Se il vecchio computer non è più disponibile, l<t0>assistenza</t0> può liberare il posto usando il tuo numero dordine.