Jak zaimportować notatki Markdown do JW Library
Zamień pliki .md z Obsidiana, Notion czy dowolnego edytora Markdown w prawdziwe notatki JW Library, umieszczone przy właściwym wersecie — za darmo, prywatnie, w przeglądarce.
JW Library nie ma żadnego sposobu na wczytanie tekstu z zewnątrz. W samej aplikacji notatki napiszesz, ale notatka napisana gdzie indziej — w Obsidianie, w Notion, w zwykłym pliku tekstowym na komputerze — nie ma w ogóle drogi do twojej biblioteki. Ludzie przepisują je ręcznie albo rezygnują i prowadzą dwa zbiory notatek do studium, które nigdy się nie spotykają.
JW Sync zasypuje tę lukę. Wczytaj kopię zapasową w Eksploratorze studium, naciśnij „Importuj Markdown”, a twoje pliki .md staną się w niej prawdziwymi notatkami: tytuł, data i etykiety zostaną nienaruszone, a gdy plik mówi, do którego wersetu należy, notatka trafi dokładnie tam — tak, jakbyś napisał ją w aplikacji podczas czytania.
Działa to w obie strony. Notatki wyeksportowane z tej strony niosą ze sobą księgę, rozdział i werset, więc wracają dokładnie tam, skąd wyszły. Notatki pisane gdzie indziej zwykle nie mają nic takiego — i właśnie dlatego ta strona wyjaśnia te jedną czy dwie linijki, które je umieszczają, oraz to, co się dzieje, gdy plik ich nie ma.
Krok po kroku
Utwórz kopię zapasową w JW Library
Otwórz JW Library, przejdź do Studium osobistego, dotknij menu z trzema kropkami, wybierz Kopia zapasowa i przywracanie, a potem Utwórz kopię zapasową. Dostaniesz plik .jwlibrary — bibliotekę, do której trafią twoje notatki.
Otwórz Eksplorator studium
Wejdź na jwsync.org, otwórz Eksplorator studium i wczytaj ten plik .jwlibrary. Wszystko dzieje się w twojej przeglądarce; plik nigdy nie jest wysyłany.
Naciśnij „Importuj Markdown”
Przycisk stoi obok „Eksportuj Markdown”. Wybierz dowolną liczbę plików .md albo archiwum .zip z nimi — także to .zip, które ta strona tworzy przy eksporcie.
Przeczytaj podsumowanie, zanim cokolwiek zostanie zapisane
Dowiesz się, ile notatek trafi na werset, ile zostanie dodanych jako notatki samodzielne i ile jest już w kopii, więc zostanie pominiętych. Wszystko, co strona musiała zinterpretować, jest wypisane linijka po linijce z polem wyboru — decydujesz ty, a nie odkrywasz to później.
Wyeksportuj i przywróć
Naciśnij „Eksportuj .jwlibrary”, a potem przywróć ten plik w JW Library przez Kopia zapasowa i przywracanie → Przywróć. Zaimportowane notatki są już częścią twojej biblioteki na tym urządzeniu.
Najkrótszy plik, który zadziała
Plik Markdown nie potrzebuje niczego, żeby dało się go zaimportować: plik z samym tekstem też stanie się notatką, a tytuł weźmie z pierwszego nagłówka albo, w jego braku, z nazwy pliku. Cała reszta służy temu, by powiedzieć, gdzie notatka przynależy. Kompletny plik wygląda tak: --- title: Kielich, o który się modlił tags: [studium, getsemani] publication: Matthew 26:39 --- Jego modlitwa pokazuje podporządkowanie, a nie niechęć. Blok między dwiema liniami myślników nazywa się front matter. Linie poniżej to sama notatka.
Pola, które są odczytywane
Odczytywanych jest tylko pięć rzeczy, a każda przyjmuje kilka zapisów, żebyś nie musiał pamiętać jednego dokładnego. **title** (albo name, heading) staje się tytułem notatki. **tags** (albo tag, keywords, categories, labels, topics) stają się prawdziwymi etykietami JW Library i są tworzone, jeśli jeszcze ich nie ma. **date** (albo created, modified) ustawia datę notatki; rozumiana jest każda wartość zawierająca RRRR-MM-DD. **publication** (albo pub, reference, ref, scripture, citation, source, passage) to miejsce na werset. **book**, **chapter** i **verse** (albo ch, v, vs, verses) robią to samo w osobnych polach. Każde inne pole, które trzymasz dla siebie — autor, status, cokolwiek dodaje twój edytor — jest pomijane, a nie traktowane jako błąd.
Trzy sposoby wskazania notatce wersetu
Napisz namiar w jednej linii: `publication: Matthew 26:39`. Albo rozbij go: `book: Matthew`, `chapter: 26`, `verse: 39`. Albo użyj obu — tak robi eksport tej strony, żeby plik dobrze się czytał człowiekowi i dokładnie parsował maszynie. Wszystkie trzy dają ten sam wynik, więc używaj tego, co pasuje do twojego edytora.
Jak swobodny może być zapis wersetu
Nazwy ksiąg dopasowywane są hojnie. Działają pełne nazwy, a także skróty, które ludzie naprawdę wpisują: Matt, Matt., Mt, 1 Cor, 1Cor, I Corinthians, Second Timothy, Psalm równie dobrze jak Psalms, Song of Songs równie dobrze jak Song of Solomon. Rozdział od wersetu może oddzielać dwukropek, kropka albo litera v — `John 3:16`, `John 3.16` i `1 Cor 13 v4` czytane są tak samo. Spacje wszędzie są opcjonalne, więc `1Cor13:4` też przejdzie. Sam front matter jest równie wyrozumiały. Nazwy pól mogą być z wielkiej litery. Spacji po dwukropku może zabraknąć. Nadmiarowe spacje i tabulatory są pomijane, podobnie jak cudzysłowy wokół wartości i końcowy komentarz z #. Windowsowe końce linii nie przeszkadzają. Możesz nawet całkiem pominąć linie --- i zacząć plik od razu od pól, o ile pierwsza linia jest jedną z rozpoznawanych nazw — ta zasada istnieje po to, żeby notatka zaczynająca się zwykłym zdaniem z dwukropkiem nie straciła pierwszego akapitu.
Etykiety, jakkolwiek je zapiszesz
Wszystkie te zapisy dają te same dwie etykiety: `tags: [studium, greka]`, `tags: studium, greka`, `tags: studium; greka`, `tags: #studium #greka`, albo lista we własnych liniach pod `tags:`, gdzie każdy wpis zaczyna się myślnikiem. Etykiety, które już masz w bibliotece, są używane ponownie, a nie dublowane, więc zaimportowana notatka dołącza do tej samej etykiety, po której i tak filtrujesz.
Co się dzieje, gdy coś jest niejasne
Nic niepewnego nie jest rozstrzygane za ciebie. Jeśli nazwa księgi jest bliska prawdziwej, ale niedokładna — `Mathew`, `Ecclesiates` — notatka nie zostaje umieszczona automatycznie. Pojawia się w podsumowaniu we własnej linii z tym, co strona z niej zrozumiała: „odczytano jako Matthew 26:39”, wraz z polem wyboru. Odznacz je, a notatka zostanie pominięta; zostaw zaznaczone, a trafi tam, gdzie mówi linia. Jeśli księgi w ogóle nie da się rozpoznać, linia to mówi, a notatka zostaje dodana jako samodzielna — nigdy nie jest wciskana na domysł. Księga z numerem zachowuje swój numer, więc `1 Jonh` może zostać poprawione tylko na 1 Jana, nigdy na 2 Jana.
Czego celowo nie robi
Zakres wersetów kotwiczy notatkę przy pierwszym z nich: `Matthew 26:39-41` umieszcza ją przy wersecie 39, bo notatka JW Library przypina się do jednego punktu tekstu, a nie do przedziału. Namiar z rozdziałem, ale bez wersetu — `Matthew 26` — przypina notatkę do tego rozdziału. Plik, który podaje publikację zamiast wersetu — `The Watchtower—2023 No. 4` — jest importowany jako zwykła notatka samodzielna, bez żadnego pytania, bo dokładnie to zapisuje eksport tej strony dla notatek robionych w artykule.
Formatowanie, które przeżywa podróż
Akapity, złamania wierszy, **pogrubienie**, *kursywa* i listy punktowane trafiają do JW Library jako prawdziwe formatowanie. Nagłówek na początku pliku służy za tytuł notatki, zamiast powtarzać się w jej wnętrzu. Wszystko, co Markdown potrafi wyrazić, a notatki JW Library nie — tabele, obrazy, odnośniki, bloki kodu — zostaje sprowadzone do tekstu, więc nie ginie ani jedno słowo, nawet gdy układu nie da się przenieść.
Gdzie notatki naprawdę lądują i dlaczego to bezpieczne
Żeby przypiąć notatkę do wersetu, JW Library potrzebuje wewnętrznych identyfikatorów tego rozdziału, właściwych dla twojej biblioteki. JW Sync nigdy ich nie wymyśla. Używa ponownie miejsca, które twoja własna kopia już ma dla tego rozdziału, albo kopiuje te identyfikatory z innego miejsca biblijnego w tym samym pliku. Jeśli kopia nie zawiera żadnych notatek ani zaznaczeń w Biblii, nie ma z czego kopiować — wtedy notatki są dodawane jako samodzielne, zamiast być przypinane do czegoś, czego aplikacja może nie rozpoznać. To świadomy wybór: notatka, która po cichu wylądowała w złym miejscu, jest gorsza niż taka, która przyszła wyraźnie nieprzypięta.
Import tych samych plików dwa razy
Notatkę uznaje się za już obecną, gdy jej tytuł, tekst i miejsce zgadzają się z czymś w kopii, więc ponowny import tego samego eksportu niczego nie podwaja. Podsumowanie mówi, ile zostanie z tego powodu pominiętych, zanim potwierdzisz. Wszystko, co dodaje jeden import, to jeden krok Cofnij, a zaimportowane notatki dostają etykietę Imported, żebyś mógł je potem znaleźć, przefiltrować albo usunąć grupowo.
Częste pytania
- Czy muszę używać linii ---?
- Nie. Czynią plik jednoznacznym i rozumie je każdy edytor Markdown, ale możesz też zacząć plik od razu od pól — `title: …` w pierwszej linii — albo zrezygnować z front matter i pozwolić notatce wziąć tytuł z pierwszego nagłówka.
- A jeśli przekręcę nazwę księgi?
- Strona zwykle domyśli się, o co ci chodziło, ale nie działa wyłącznie na tej podstawie. Notatka pojawia się w podsumowaniu z informacją, jak została odczytana, i z polem wyboru — potwierdzasz, zanim cokolwiek zostanie zapisane.
- Czy mogę zaimportować cały folder z Obsidiana?
- Zaznacz naraz dowolną liczbę plików .md albo spakuj folder i wybierz .zip. Pliki w archiwum czytane są tak samo jak luźne.
- Czy import nadpisze moje dotychczasowe notatki?
- Nie. Import tylko dodaje. Twoje notatki, zaznaczenia, zakładki i etykiety pozostają nietknięte, a wczytany plik nigdy nie jest zmieniany — na końcu pobierasz nowy .jwlibrary.
- Czy moje notatki są gdzieś wysyłane?
- Nie. Wszystko działa w twojej przeglądarce, jak reszta strony. Ani kopia zapasowa, ani pliki Markdown nie opuszczają twojego urządzenia.
- W jakim języku mogę zapisać werset?
- Na razie nazwy ksiąg rozpoznawane są po angielsku — tak też zapisuje je eksport. Jeśli prowadzisz notatki w innym języku, użyj pól `book`, `chapter` i `verse` z angielską nazwą księgi albo zaimportuj notatki nieprzypięte i rozmieść je później ręcznie.
- Czy mogę znowu wydobyć swoje notatki?
- Tak — „Eksportuj Markdown” na tym samym ekranie zapisuje każdą notatkę do pliku .md z tymi samymi polami, więc notatki mogą opuścić JW Library i wrócić, nie tracąc swojego miejsca.