Publicar uma cópia estática

Um instantâneo é uma pasta de páginas estáticas escritas a partir de suas notas como estão naquele momento. Qualquer um que o abrir pode ler essas notas e nada mais. É a maneira de entregar um conjunto de notas para alguém que não tem Varlig, ou lê-las você mesmo em um PC ou navegador de telefone.

A folha diz claramente antes de você publicar: "Um instantâneo é uma pasta de páginas estáticas. Quem o abrir pode ler as notas e nada mais: as páginas não podem ser editadas, elas não precisam de rede e continuam mostrando o texto de hoje depois que você altera os originais."

O que é um instantâneo e quais são seus limites

Um instantâneo é um conjunto de arquivos. É fixado no momento em que você o escreveu: editar as notas originais depois não altera um único byte de uma pasta que já foi escrita, e nada no Varlig a reescreve em segundo plano.

Isso não é um site, uma conta nem um serviço de sincronização:

Sem contas e sem convites. Quem puder abrir a pasta pode lê-la. Não há login, nem acesso por pessoa e nem registro de quem o leu.
Sem revogação. Remover a pasta impede novas leituras a partir daquele local. Isso não apaga cópias que alguém já tenha baixado, encaminhado por e-mail ou guardado em um backup.
Sem edição e sem comentários. As páginas são documentos. Lê-los não muda nada em Varlig, e nada em Varlig os muda.
Sem hospedagem e sem segurança de transporte. Varlig escreve a pasta; o que quer que a carregue — uma unidade compartilhada, um servidor web, um anexo de e-mail — decide quem pode alcançá-la.

Publique um

Três comandos abrem a mesma janela:

Comando	O que publica
File › Publish Snapshot…	As notas que você selecionou
Publish Snapshot… no menu de contexto da lista de notas	A seleção que você clicou com o botão direito
Publish Tag Snapshot… no menu de contexto da barra lateral de uma tag	Cada nota com essa etiqueta

Não há atalho de teclado para nenhum deles.

A janela tem o título Publish snapshot. Digite um nome em Snapshot name, confira a prévia e clique em Choose Folder… para escolher onde salvar. Cancel deixa tudo como estava.

Ao terminar, o resultado mostra Published 12 notes, informa o caminho e explica: “Abra index.html em qualquer navegador, aqui ou no celular. As páginas são uma cópia estática: não mudam quando você edita as notas e não podem ser editadas por quem as lê. Remover a pasta impede novos downloads, mas não recupera cópias que outras pessoas já tenham.” Show in Finder abre a pasta e Done fecha a janela.

Leia a prévia primeiro

Nada é gravado até você escolher uma pasta. A prévia mostra exatamente o que ela conterá:

Cada nota que será publicada, com quantos anexos ela tem e seu tamanho total.
Not published — as notas deixadas de fora, cada uma com seu motivo: Locked note, Protected note ou Protected tag — must stay in Varlig.
Missing attachments (not published) — arquivos que a biblioteca não consegue encontrar. O resultado depois diz quantos foram deixados de fora, até "1 anexo estava faltando e não foi publicado".
Cada link que aponta para outra nota, indicando como será tratado na página publicada.

Abaixo, um total atualizado contabiliza notas, anexos e bytes, além de informar quantos links entre notas permanecerão como links e quantos virarão texto simples. Se nenhum item selecionado puder ser publicado, a janela avisa e o botão fica desativado.

Cada link se enquadra em uma das três classificações:

Classificação	O que a página faz
`included`	A nota vinculada está neste instantâneo, então a página se vincula ao seu arquivo
`kept as plain text (not published)`	A nota vinculada não está neste instantâneo, então apenas as palavras que você digitou permanecem
`blocked (protected, protected tag or locked)`	A nota vinculada não deve sair do Varlig, então apenas as palavras que você digitou permanecem

A prévia relê as notas enquanto a janela está aberta. Assim, uma nota editada em outra janela aparece na prévia — e é publicada — com o conteúdo atual.

O que nunca é publicado

Notas protegidas, notas com uma etiqueta protegida e notas bloqueadas nunca são lidas nem publicadas. Ao contrário de uma exportação comum, não existe aqui a opção Include unlocked protected notes: a publicação não permite incluí-las.

Um link que Varlig não pode reescrever dentro do instantâneo perde seu endereço, bem como seu estilo de link, portanto, uma página publicada nunca pode nomear ou apontar para uma nota que não foi publicada. Isso cobre links [[Title|alias]], varlig:// e endereços de nota Bear, cujo endereço, de outra forma, levaria o título da nota não publicada e os links de tags. Endereços comuns da web não são tocados.

O que a pasta contém

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

As páginas são a mesma renderização de uma exportação HTML — respostas de cálculo como em uma exportação rica, imagens de assets/, código e diagramas como imagens — além de uma janela de visualização de largura de telefone, um link de volta para index.html e um rodapé que data o instantâneo: "Publicado em 16 de setembro de 2026. Este é um instantâneo: ele mostra as notas como estavam naquela data e não muda quando o fazem. Não pode ser editado aqui."

Não há script, solicitação de rede e controle de edição de qualquer tipo, então a pasta é lida offline, depois de ter sido movida ou copiada e na tela de um telefone.

publication.json registra o que foi publicado: a versão do formato varligPublication, o id da publicação, seu name, datas de created e updated, id de cada nota, title, file e contentHash, e um manifesto dos arquivos publicados. Uma versão de formato mais recente é recusada em vez de ser mal lida.

Atualize ou remova um instantâneo

Settings › Import & Export › Published snapshots lista todas as cópias estáticas publicadas por esta biblioteca. Antes da primeira publicação, informa que ainda não há cópias e orienta você a selecionar notas e usar File ▸ Publish Snapshot… para criar uma pasta de páginas somente leitura.

Cada linha informa se as notas mudaram desde a publicação — 3 notes changed e, separadamente, 1 note no longer in the library — e oferece três botões:

Botão	O que faz
Show in Finder	Abre a pasta como foi escrita.
Update Snapshot…	Reabre a janela com o título Update snapshot, mostrando quais notas mudaram. Update Snapshot regrava a mesma pasta como uma nova revisão da publicação.
Remove…	Exclui a pasta deste Mac, após uma confirmação.

Uma atualização é construída ao lado de seu destino e movida para o lugar, portanto, uma falha deixa o instantâneo anterior intacto. Varlig remove uma pasta apenas quando ela ainda carrega o próprio publication.json dessa publicação, portanto, uma pasta que você mesmo moveu ou substituiu é deixada sozinha.

O alerta Remove "Trip notes"? deixa claro o limite da remoção: “Isso exclui a pasta publicada neste Mac e impede que ela seja aberta a partir daqui. As cópias já baixadas continuam com as outras pessoas: uma cópia estática publicada não pode ser revogada.” Os botões são Cancel e Delete Folder.

A própria nota de rodapé do painel diz a mesma coisa: "Um instantâneo é uma pasta de páginas somente leitura que você pode copiar, enviar ou manter em uma pasta compartilhada; ele também lê em um navegador de telefone. Não é uma conta: qualquer pessoa com a pasta pode lê-la, e uma cópia que alguém baixou não pode ser retirada."

Para outras maneiras de obter notas do Varlig, consulte Importação, exportação e backups.