Pubblicare un’istantanea

Una copia statica è una cartella di pagine generate dalle note così come sono al momento della pubblicazione. Chi la apre può leggere quelle note e nient'altro. Puoi usarla per condividere una raccolta di note con chi non ha Varlig, oppure per leggerle su un PC o nel browser di un telefono.

Il pannello lo chiarisce prima della pubblicazione: "Una copia statica è una cartella di pagine. Chi la apre può leggere le note e nient'altro: le pagine non sono modificabili, non richiedono una connessione e continuano a mostrare il testo attuale anche se in seguito modifichi gli originali."

Cosa è una copia statica e quali limiti ha

Una copia statica è un insieme di file che rispecchia le note al momento della creazione. Modificare in seguito le note originali non cambia neppure un byte della cartella già generata, e Varlig non la riscrive in background.

Non è un sito web, un account o un servizio di sincronizzazione:

• Nessun account e nessun invito. Chiunque possa aprire la cartella può leggerne il contenuto. Non ci sono accessi con credenziali, autorizzazioni per singole persone o registri dei lettori.
• Nessuna revoca dell'accesso. Eliminare la cartella impedisce a nuovi lettori di aprirla da quella posizione. Non elimina però le copie già scaricate, inoltrate per email o conservate in un backup.
• Nessuna modifica e nessun commento. Le pagine sono documenti: leggerle non cambia nulla in Varlig e le modifiche in Varlig non cambiano le pagine.
• Nessun hosting e nessuna protezione del trasferimento. Varlig crea la cartella. L'accesso dipende dal mezzo con cui la distribuisci, ad esempio un disco condiviso, un server web o un allegato email.

Pubblicare una copia statica

Tre comandi aprono lo stesso pannello:

Nessuno dei tre ha una scorciatoia da tastiera.

Il pannello si intitola Publish snapshot. Inserisci un nome nel campo Snapshot name, controlla l'anteprima, poi premi Choose Folder… e scegli dove salvare la cartella. Cancel lascia tutto invariato.

Al termine compare un messaggio come Published 12 notes, seguito dal percorso e da questa spiegazione: "Apri index.html in qualsiasi browser, qui o su un telefono. Le pagine sono una copia statica: non cambiano quando modifichi le note e chi le legge non può modificarle. Eliminare la cartella impedisce nuovi download, ma non revoca le copie già in possesso di altre persone." Show in Finder apre la cartella e Done chiude il pannello.

Controllare prima l'anteprima

Non viene scritto nulla finché non scegli una cartella e l'anteprima mostra esattamente cosa conterrà la cartella:

• Tutte le note che verranno pubblicate, con il numero di allegati e la loro dimensione complessiva.
• Not published - le note tralasciate, ognuna con il suo motivo: Locked note, Protected note o Protected tag — must stay in Varlig.
• Missing attachments (not published) elenca i file che la libreria non riesce a trovare. Il messaggio finale indica quanti sono stati esclusi, anche nel caso di un solo file: "1 allegato non è stato trovato e non è stato pubblicato".
• Ogni collegamento in uscita verso un'altra nota, con l'indicazione di come verrà gestito nella pagina pubblicata.

Sotto l'anteprima, un riepilogo aggiornato conteggia note, allegati e byte e indica quanti collegamenti alle note resteranno cliccabili e quanti diventeranno testo semplice. Se nessun elemento selezionato può essere pubblicato, il pannello lo segnala e il pulsante resta disabilitato.

Ogni collegamento rientra in una di queste tre categorie:

L'anteprima rilegge le note mentre il pannello è aperto. Se modifichi una nota in un'altra finestra, l'anteprima e la pubblicazione ne usano quindi la versione attuale.

Cosa non viene mai pubblicato

Le note protette, quelle con un tag protetto e quelle bloccate non vengono mai lette né pubblicate. A differenza di una normale esportazione, qui non esiste l’opzione Include unlocked protected notes: la pubblicazione non consente in alcun modo di includerle.

Se Varlig non può riscrivere un collegamento all'interno della copia statica, ne rimuove sia l'indirizzo sia l'aspetto cliccabile. Una pagina pubblicata non può così rivelare il nome di una nota non pubblicata o rimandare ad essa tramite il collegamento. Questo vale per i collegamenti [[Title|alias]], per gli indirizzi delle note varlig:// e Bear, che altrimenti conterrebbero il titolo della nota non pubblicata, e per i collegamenti ai tag. Gli indirizzi web ordinari restano invariati.

Cosa contiene la cartella

Trip notes/
  index.html            the listing every reader starts from
  Trip-<UUID>.html      one page per note
  Packing-<UUID>.html
  assets/               images and files, shared by every page
  publication.json

Le pagine hanno lo stesso aspetto di un'esportazione HTML: risultati dei calcoli come nelle esportazioni formattate, immagini dalla cartella assets/, codice e diagrammi resi come immagini. Si aggiungono una visualizzazione adatta alla larghezza del telefono, un collegamento a index.html e una nota a piè di pagina con la data: "Pubblicato il 16 settembre 2026. Questa è una copia statica: mostra le note com'erano in quella data e non cambia quando vengono modificate. Non è modificabile da qui."

Le pagine non contengono script, richieste di rete o controlli di modifica. Puoi quindi leggerle offline, anche dopo aver spostato o copiato la cartella, e sullo schermo di un telefono.

publication.json registra ciò che è stato pubblicato: la versione del formato varligPublication, i campi id e name della pubblicazione, le date created e updated, i campi id, title, file e contentHash di ogni nota e un elenco dei file pubblicati. Le versioni di formato più recenti vengono rifiutate, evitando di interpretarle in modo errato.

Aggiornare o rimuovere una copia statica

Settings › Import & Export › Published snapshots elenca tutte le copie statiche create da questa libreria. Se non ne hai ancora creata nessuna, compare il messaggio: "Non ci sono ancora copie statiche. Seleziona le note e usa File ▸ Publish Snapshot… per creare una cartella di pagine di sola lettura."

Ogni riga indica se le note sono cambiate dalla pubblicazione — 3 notes changed e, separatamente, 1 note no longer in the library — e offre tre pulsanti:

L'aggiornamento viene preparato accanto alla destinazione e poi spostato al suo posto: se l'operazione fallisce, la copia precedente resta intatta. Varlig elimina una cartella solo se contiene ancora il file publication.json della pubblicazione corrispondente. Una cartella che hai spostato o sostituito manualmente viene quindi lasciata invariata.

L'avviso Remove "Trip notes"? chiarisce i limiti dell'eliminazione: "Questa operazione elimina la cartella pubblicata su questo Mac e impedisce di aprirla da lì. Le copie già scaricate da altre persone restano in loro possesso: una copia statica pubblicata non può essere ritirata." I pulsanti sono Cancel e Delete Folder.

La nota in fondo al pannello ribadisce lo stesso concetto: "Una copia statica è una cartella di pagine di sola lettura che puoi copiare, inviare per email o conservare in una cartella condivisa. È leggibile anche nel browser di un telefono. Non è un account: chiunque abbia la cartella può leggerla e una copia già scaricata non può essere ritirata."

Per conoscere gli altri modi di esportare le note da Varlig, vedi Importazione, esportazione e backup.