Publikowanie migawki

Migawka to folder stron statycznych utworzonych z notatek w ich bieżącym stanie. Każdy, kto go otworzy, może przeczytać te notatki i nic więcej. Pozwala to przekazać zestaw notatek osobie bez Varlig lub samodzielnie czytać je na komputerze PC albo w przeglądarce telefonu.

Okno przed publikacją wyjaśnia to wprost: „Migawka to folder stron statycznych. Każdy, kto go otworzy, może czytać notatki i nic więcej: stron nie można edytować, nie potrzebują sieci i nadal pokazują dzisiejszy tekst po zmianie oryginałów”.

Czym jest migawka, a czym nie jest

Migawka to zestaw plików utrwalający stan z chwili zapisu. Późniejsza edycja oryginalnych notatek nie zmienia ani jednego bajtu w już zapisanym folderze, a Varlig nie aktualizuje go w tle.

To nie jest witryna internetowa, konto ani usługa synchronizacji:

• Bez kont i zaproszeń. Każdy, kto może otworzyć folder, może go przeczytać. Nie ma logowania, dostępu przyznawanego poszczególnym osobom ani rejestru czytelników.
• Bez możliwości cofnięcia dostępu do pobranych kopii. Usunięcie folderu uniemożliwia nowym czytelnikom otwarcie go z tej lokalizacji. Nie wpływa na kopie, które ktoś już pobrał, przesłał pocztą lub umieścił w kopii zapasowej.
• Bez edycji i komentarzy. Strony są dokumentami. Ich czytanie niczego nie zmienia w Varlig, a działania w Varlig nie zmieniają tych stron.
• Bez hostingu i zabezpieczenia transmisji. Varlig zapisuje folder. To sposób przekazania — dysk współdzielony, serwer WWW czy załącznik wiadomości — określa, kto może uzyskać do niego dostęp.

Opublikuj migawkę

Trzy polecenia otwierają to samo okno:

Żadne z nich nie ma skrótu klawiszowego.

Okno ma tytuł Publish snapshot. Wpisz nazwę w polu Snapshot name, sprawdź podgląd, a następnie wybierz Choose Folder… i wskaż miejsce zapisu. Cancel pozostawia wszystko bez zmian.

Po zakończeniu pojawia się Published 12 notes, ścieżka oraz objaśnienie: „Otwórz index.html w dowolnej przeglądarce, tutaj lub na telefonie. Strony są migawką: nie zmienią się po edycji notatek, a czytelnicy nie mogą ich edytować. Późniejsze usunięcie folderu uniemożliwi nowe pobrania, ale nie wycofa kopii, którą ktoś już ma”. Show in Finder otwiera folder, a Done zamyka okno.

Najpierw sprawdź podgląd

Nic nie zostaje zapisane, dopóki nie wybierzesz folderu. Podgląd pokazuje dokładnie, co znajdzie się w folderze:

• Każdą notatkę przeznaczoną do publikacji, wraz z liczbą jej załączników i ich łącznym rozmiarem.
• Not published — pominięte notatki, każda z podanym powodem: Locked note, Protected note lub Protected tag — must stay in Varlig.
• Missing attachments (not published) — pliki, których nie znaleziono w bibliotece. Wynik końcowy podaje liczbę pominiętych plików, także dla pojedynczego załącznika: „1 attachment was missing and was not published”.
• Każdy wychodzący odsyłacz do notatki, wraz z informacją, jak będzie działał na opublikowanej stronie.

Poniżej znajduje się bieżące podsumowanie liczby notatek, załączników i bajtów oraz liczby odsyłaczy, które zostaną opublikowane jako aktywne odsyłacze lub zwykły tekst. Jeśli niczego z zaznaczenia nie można opublikować, okno informuje o tym, a przycisk pozostaje nieaktywny.

Każdy odsyłacz należy do jednej z trzech kategorii:

Podgląd ponownie odczytuje notatki, gdy okno jest otwarte. Notatka edytowana w innym oknie jest więc pokazywana — i publikowana — w aktualnym stanie.

Czego nigdy nie publikuje się w migawce

Chronione notatki, notatki z chronionym tagiem i zablokowane notatki nigdy nie są odczytywane ani publikowane. W przeciwieństwie do zwykłego eksportu nie ma tu opcji Include unlocked protected notes: publikowanie nie pozwala w żaden sposób ich uwzględnić.

Odsyłacz, którego Varlig nie może dostosować do migawki, traci zarówno adres, jak i wygląd odsyłacza. Opublikowana strona nie może więc ujawnić nazwy ani wskazać nieopublikowanej notatki. Dotyczy to odsyłaczy [[Title|alias]], adresów varlig:// i notatek Bear, których adresy mogłyby zawierać tytuł nieopublikowanej notatki, oraz odsyłaczy do tagów. Zwykłe adresy internetowe pozostają bez zmian.

Zawartość folderu

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

Strony są renderowane tak samo jak eksport HTML: wyniki obliczeń jak w eksporcie sformatowanym, obrazy z assets/, kod i diagramy jako obrazy. Dodatkowo mają widok dostosowany do szerokości telefonu, odsyłacz do index.html i stopkę z datą migawki: „Opublikowano 16 września 2026. To jest migawka: pokazuje notatki w stanie z tego dnia i nie zmienia się wraz z nimi. Nie można jej tutaj edytować”.

Nie ma skryptów, żądań sieciowych ani kontrolek edycji, więc folder można czytać offline, po przeniesieniu lub skopiowaniu, także na ekranie telefonu.

publication.json zapisuje informacje o publikacji: wersję formatu varligPublication, jej id, name, daty created i updated, a dla każdej notatki id, title, file i contentHash, oraz wykaz opublikowanych plików. Nowsza wersja formatu jest odrzucana, aby uniknąć błędnej interpretacji.

Zaktualizuj lub usuń migawkę

Settings › Import & Export › Published snapshots pokazuje wszystkie migawki zapisane przez tę bibliotekę. Zanim zapiszesz pierwszą, widnieje tam informacja: „Nie ma jeszcze migawek. Zaznacz notatki i użyj File ▸ Publish Snapshot…, aby zapisać folder stron tylko do odczytu”.

Każdy wiersz informuje o zmianach od czasu publikacji — 3 notes changed, a osobno 1 note no longer in the library — i udostępnia trzy przyciski:

Aktualizacja powstaje obok folderu docelowego, a następnie jest przenoszona na jego miejsce, więc błąd pozostawia poprzednią migawkę nienaruszoną. Varlig usuwa folder tylko wtedy, gdy nadal zawiera on własny plik publication.json tej publikacji. Folder przeniesiony lub zastąpiony samodzielnie pozostaje bez zmian.

Komunikat Remove "Trip notes"? jasno określa granice usuwania: „To usunie opublikowany folder na tym Macu i uniemożliwi otwieranie go z tego miejsca. Kopie już pobrane przez inne osoby pozostaną u nich: opublikowanej migawki nie można wycofać”. Dostępne przyciski to Cancel i Delete Folder.

Przypis w panelu wyjaśnia to samo: „Migawka to folder stron tylko do odczytu, który można kopiować, wysyłać pocztą lub przechowywać w folderze współdzielonym; działa też w przeglądarce telefonu. To nie jest konto: każdy, kto ma folder, może go czytać, a pobranej już kopii nie da się odebrać”.

Inne sposoby przenoszenia notatek poza Varlig opisuje strona Import, eksport i kopie zapasowe.