Menerbitkan salinan statis

Snapshot adalah folder berisi halaman statis yang menyimpan catatan dalam keadaan saat diterbitkan. Siapa pun yang membukanya hanya dapat membaca catatan tersebut. Gunakan snapshot untuk memberikan sekumpulan catatan kepada orang yang tidak memiliki Varlig, atau membacanya sendiri di PC maupun browser ponsel.

Sebelum diterbitkan, dialog menjelaskan: "Snapshot adalah folder halaman statis. Orang yang membukanya hanya dapat membaca catatan. Halamannya tidak dapat diedit, tidak memerlukan jaringan, dan tetap menampilkan teks saat penerbitan meskipun catatan aslinya berubah."

Pengertian dan batasan snapshot

Snapshot adalah sekumpulan berkas yang menyimpan isi pada saat dibuat. Mengedit catatan asli sesudahnya tidak mengubah satu byte pun dalam folder yang sudah dibuat. Varlig juga tidak memperbaruinya diam-diam di latar belakang.

Ini bukan situs web, akun, atau layanan sinkronisasi:

• Tidak ada akun dan tidak ada undangan. Siapa pun yang dapat membuka folder dapat membacanya. Tidak ada login, tidak ada akses per orang dan tidak ada catatan siapa yang membacanya.
• Salinan yang sudah dibagikan tidak dapat ditarik kembali. Menghapus folder mencegah pembaca baru membukanya dari lokasi itu. Tindakan ini tidak memengaruhi salinan yang sudah diunduh, diteruskan lewat email, atau disimpan dalam cadangan.
• Tidak ada pengeditan dan tidak ada komentar. Halaman-halamannya adalah dokumen. Membaca mereka tidak mengubah apa pun di Varlig, dan tidak ada apa pun di Varlig yang mengubah mereka.
• Tidak menyediakan hosting atau keamanan pengiriman. Varlig hanya membuat folder. Media yang digunakan untuk membagikannya—drive bersama, server web, atau lampiran email—menentukan siapa yang dapat mengaksesnya.

Menerbitkan snapshot

Tiga perintah berikut membuka dialog yang sama:

Tidak ada pintasan keyboard untuk salah satu dari mereka.

Dialog berjudul Publish snapshot. Isi kolom Snapshot name, periksa pratinjau, lalu klik Choose Folder… untuk memilih lokasi penyimpanan. Cancel membatalkan tanpa mengubah apa pun.

Setelah selesai, hasilnya mengatakan Published 12 notes, memberikan jalur, dan menambahkan: "Buka index.html di browser apa pun, di sini atau di telepon. Halaman-halamannya adalah snapshot: mereka tidak akan berubah ketika Anda mengedit catatan, dan mereka tidak dapat diedit oleh siapa pun yang membacanya. Menghapus folder kemudian menghentikan unduhan baru; itu tidak dapat menarik kembali salinan yang sudah dimiliki seseorang." Show in Finder membuka folder, dan Done menutup lembar kerja.

Baca pratinjaunya terlebih dahulu

Tidak ada yang ditulis sampai Anda memilih folder, dan pratinjau menunjukkan dengan tepat apa yang akan terkandung dalam folder:

• Setiap catatan yang akan dipublikasikan, dengan berapa banyak lampiran yang dimilikinya dan ukuran totalnya.
• Not published — catatan yang ditinggalkan, masing-masing dengan alasannya: Locked note, Protected note atau Protected tag — must stay in Varlig.
• Missing attachments (not published) — berkas yang tidak dapat ditemukan dalam pustaka. Hasil akhirnya menyebutkan jumlah lampiran yang dilewati, bahkan jika hanya "1 lampiran tidak ditemukan dan tidak diterbitkan".
• Setiap tautan ke catatan lain, beserta perlakuannya dalam halaman hasil penerbitan.

Di bawahnya, jumlah catatan, lampiran, dan byte diperbarui terus. Ada juga jumlah tautan catatan yang akan tetap menjadi tautan dan yang berubah menjadi teks biasa. Jika tidak ada pilihan yang dapat diterbitkan, dialog menjelaskannya dan tombol tetap nonaktif.

Setiap tautan masuk ke dalam salah satu dari tiga klasifikasi:

Pratinjau membaca catatan lagi saat lembar terbuka, sehingga catatan yang Anda edit di jendela lain dipratinjau — dan dipublikasikan — seperti sekarang.

Apa yang tidak pernah dipublikasikan

Catatan yang dilindungi, catatan dengan tag terlindungi, dan catatan terkunci tidak pernah dibaca maupun diterbitkan. Berbeda dengan ekspor biasa, tidak ada pilihan Include unlocked protected notes di sini: penerbitan tidak menyediakan cara untuk menyertakannya.

Tautan yang tidak dapat disesuaikan menjadi tautan internal snapshot akan kehilangan alamat dan gaya tautannya. Jadi, halaman yang diterbitkan tidak dapat mengungkap nama atau merujuk ke catatan yang tidak diterbitkan. Ini berlaku untuk [[Title|alias]], alamat catatan varlig:// dan Bear yang mungkin memuat judul catatan, serta tautan tag. Alamat web biasa tetap utuh.

Apa yang ada di folder itu

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

Halaman tampil seperti ekspor HTML: jawaban perhitungan seperti dalam ekspor berformat, gambar dari assets/, serta kode dan diagram dalam bentuk gambar. Ada pula tampilan yang menyesuaikan lebar ponsel, tautan kembali ke index.html, dan keterangan tanggal di bawah: "Diterbitkan 16 September 2026. Snapshot ini menunjukkan catatan sebagaimana adanya pada tanggal tersebut dan tidak berubah saat catatan aslinya berubah. Snapshot tidak dapat diedit di sini."

Tidak ada skrip, tidak ada permintaan jaringan dan tidak ada kontrol pengeditan dalam bentuk apa pun, jadi folder dibaca offline, setelah dipindahkan atau disalin, dan di layar ponsel.

publication.json mencatat apa yang diterbitkan: versi format varligPublication, id publikasi, name, tanggal created dan updated, id setiap catatan, title, file dan contentHash, dan manifes dari file yang diterbitkan. Versi format yang lebih baru ditolak daripada salah dibaca.

Memperbarui atau menghapus snapshot

Settings › Import & Export › Published snapshots mencantumkan semua snapshot yang pernah dibuat dari pustaka ini. Jika belum ada, pesannya berbunyi: "Belum ada snapshot. Pilih catatan dan gunakan File ▸ Publish Snapshot… untuk membuat folder halaman hanya-baca."

Setiap baris menjelaskan perubahan sejak penerbitan, seperti 3 notes changed dan, secara terpisah, 1 note no longer in the library, lalu menyediakan tiga tombol:

Pembaruan dibangun di samping tujuannya dan dipindahkan ke tempatnya, sehingga kegagalan membuat snapshot sebelumnya tetap utuh. Varlig menghapus folder hanya ketika masih membawa publication.json publikasi itu sendiri, jadi folder yang telah Anda pindahkan atau ganti sendiri dibiarkan sendiri.

Peringatan Remove "Trip notes"? menjelaskan batas penghapusan: "Tindakan ini menghapus folder yang diterbitkan di Mac ini dan mencegah siapa pun membukanya dari lokasi tersebut. Salinan yang sudah diunduh orang lain tetap ada pada mereka: snapshot yang diterbitkan tidak dapat ditarik kembali." Tombolnya adalah Cancel dan Delete Folder.

Keterangan di bagian bawah panel juga menjelaskan hal yang sama: "Snapshot adalah folder halaman hanya-baca yang dapat disalin, dikirim lewat email, atau disimpan dalam folder bersama. Isinya juga dapat dibaca di browser ponsel. Ini bukan akun: siapa pun yang memiliki foldernya dapat membaca isinya, dan salinan yang sudah diunduh tidak dapat ditarik kembali."

Untuk cara lain untuk mengeluarkan catatan dari Varlig, lihat Impor, ekspor, dan cadangan.