Perché le immagini incollate passano attraverso una scheda di conferma

Nei documenti Markdown non ci sono immagini. C’è scritto soltanto il percorso in cui si trovano. I file veri e propri si trovano in una cartella esterna al documento.

Per questo, nel momento in cui incolli un’immagine, l’editor deve prendere decisioni importanti. Deve decidere se creare un file, dove salvarlo e quale nome assegnargli. mote non prende queste decisioni all’insaputa dell’utente.

Il file viene creato solo quando premi Salva

Quando incolli un’immagine dagli appunti, compare una scheda di conferma. La scheda mostra innanzitutto il percorso relativo del file che verrà creato.

assets/plain-20260907-181756.png

Il nome del file contiene il nome del documento e l’ora in cui è stato incollato. In questo modo è facile capire da quale documento proviene l’immagine e, anche incollandone diverse, non si sovrascrivono a vicenda. La cartella predefinita è assets e può essere modificata nelle impostazioni.

Quando premi Salva, il file PNG viene scritto atomicamente in quella posizione e il link viene inserito nel punto in cui si trova il cursore. Se annulli, non viene creato alcun file.

Se il documento non è ancora stato salvato, ti viene prima chiesto di salvarlo. Questo perché il percorso relativo dell’immagine può essere determinato soltanto dopo aver stabilito la posizione del documento.

Quando trascini un file immagine nella finestra, il file non viene copiato. Se si trova all’interno della cartella del documento, viene inserito un percorso relativo; se si trova all’esterno, viene inserito un percorso assoluto. L’editor non sposta arbitrariamente un file che l’utente ha già collocato in una determinata posizione.

Quando modifichi le dimensioni, la modifica viene registrata nel documento

Quando selezioni un’immagine in modalità live, compaiono un bordo e otto maniglie. Trascinando un angolo vengono mantenute le proporzioni, mentre trascinando un lato le dimensioni cambiano soltanto in una direzione. Durante il trascinamento vengono mostrate in pixel le dimensioni previste.

Quando rilasci la maniglia, le dimensioni vengono registrate alla fine del testo alt.

• Se hai modificato soltanto la larghezza, |300
• Se hai modificato separatamente larghezza e altezza, |300x200

È lo stesso metodo usato da Obsidian, quindi anche lì l’immagine viene mostrata con le stesse dimensioni. Il ridimensionamento rimane nella cronologia delle modifiche e può essere annullato con un’unica operazione di annullamento.

Questa sintassi non fa parte dello standard CommonMark. Nei visualizzatori che non la supportano, |300 potrebbe apparire come parte del testo alt. Abbiamo comunque scelto di non nascondere le informazioni sulle dimensioni in un file separato. Questo perché riteniamo che lo stato del documento debba rimanere in un unico file .md.

Le immagini inutilizzate non vengono eliminate immediatamente

Se elimini il link di un’immagine incollata o annulli l’operazione, potrebbe rimanere soltanto il file PNG. In questo caso mote chiede una volta se vuoi spostare il file nel cestino. Non lo elimina senza autorizzazione e non pone nuovamente la stessa domanda per lo stesso file.

Sono interessati soltanto i file creati da mote durante la sessione di modifica corrente. Le immagini già presenti nella cartella o i file aggiunti direttamente dall’utente non vengono toccati. Inoltre, mote non esamina le cartelle alla ricerca di immagini inutilizzate.

Ripuliamo soltanto i file creati da noi e solo con il consenso dell’utente.

L’originale non viene modificato

mote non carica le immagini su servizi esterni. Non offre nemmeno funzioni di ritaglio, rotazione o correzione.

Soltanto durante la visualizzazione sullo schermo, l’immagine viene decodificata riducendola in modo che nessun lato superi i 2048 px. I pixel decodificati vengono conservati fino a un massimo di 64 MB, dopodiché vengono eliminati a partire dai meno recenti. Questo serve a evitare che l’utilizzo della memoria continui ad aumentare anche nei documenti contenenti molte fotografie.

Anche durante questo processo, il file originale non viene modificato.

C’è un solo momento in cui mote crea un nuovo file nella cartella del documento. È quando incolli un’immagine e premi Salva. Anche i contenuti scritti nel documento si limitano al testo inserito direttamente, ai link delle immagini e alle dimensioni delle immagini. A ogni versione pubblichiamo questo elenco nel registro delle modifiche.

Le immagini sono file esterni al documento. Deve essere l’utente, non l’editor, a decidere se crearle, conservarle o rimuoverle.