Hogyan importálj Markdown-jegyzeteket a JW Library-be
Alakítsd az Obsidianból, Notionból vagy bármelyik Markdown-szerkesztőből származó .md fájlokat valódi JW Library-jegyzetekké, a megfelelő vershez rendelve — ingyen, magánjelleggel, a böngésződben.
A JW Library semmilyen módon nem tud szöveget behozni. Az alkalmazáson belül írhatsz jegyzetet, de a máshol írt jegyzetnek — Obsidianban, Notionban, egy sima szövegfájlban a gépeden — egyáltalán nincs útja a könyvtáradba. Van, aki újragépeli őket, más feladja, és két külön jegyzetgyűjteményt tart, amelyek soha nem találkoznak.
A JW Sync betölti ezt a hiányt. Tölts be egy biztonsági mentést a Tanulmányozási böngészőbe, nyomd meg a „Markdown importálása” gombot, és a .md fájljaidból valódi jegyzetek lesznek benne: a cím, a dátum és a címkék épségben maradnak, és ha a fájl megmondja, melyik íráshelyhez tartozik, a jegyzet pontosan arra a versre kerül — mintha olvasás közben az alkalmazásban írtad volna.
Mindkét irányban működik. Az innen exportált jegyzetek magukkal viszik a könyvet, a fejezetet és a verset, ezért pontosan oda térnek vissza, ahonnan jöttek. A máshol írt jegyzetekben rendszerint nincs ilyesmi, ezért ez az oldal elmagyarázza azt az egy-két sort, amely a helyükre teszi őket — és azt is, mi történik, ha egy fájlban nincsenek meg.
Lépésről lépésre
Készíts biztonsági mentést a JW Library-ben
Nyisd meg a JW Library-t, menj a Személyes tanulmányozáshoz, koppints a hárompontos menüre, válaszd a Biztonsági mentés és visszaállítás, majd a Biztonsági mentés készítése lehetőséget. Kapsz egy .jwlibrary fájlt — ez az a könyvtár, amelyhez a jegyzeteid hozzáadódnak.
Nyisd meg a Tanulmányozási böngészőt
Menj a jwsync.org címre, nyisd meg a Tanulmányozási böngészőt, és töltsd be azt a .jwlibrary fájlt. Minden a böngésződben történik; a fájl soha nem kerül feltöltésre.
Nyomd meg a „Markdown importálása” gombot
A gomb a „Markdown exportálása” mellett van. Válassz ki annyi .md fájlt, amennyit szeretnél, vagy egy .zip fájlt, amely tartalmazza őket — beleértve azt a .zip fájlt is, amelyet ez az oldal exportáláskor készít.
Olvasd el az összegzést, mielőtt bármi rögzülne
Megtudod, hány jegyzet kerül majd egy versre, hányat adunk hozzá önálló jegyzetként, és hány van már meg a mentésedben, ezért kimarad. Amit az oldalnak értelmeznie kellett, azt soronként, jelölőnégyzettel listázzuk, hogy te dönts, ne pedig utólag szembesülj vele.
Exportálj és állítsd vissza
Nyomd meg a „.jwlibrary exportálása” gombot, majd állítsd vissza a fájlt a JW Library-ben a Biztonsági mentés és visszaállítás → Visszaállítás úton. Az importált jegyzetek innentől a könyvtárad részei azon az eszközön.
A legrövidebb fájl, ami működik
Egy Markdown-fájlnak semmire sincs szüksége ahhoz, hogy importálható legyen: a csak szöveget tartalmazó fájlból is jegyzet lesz, a címét az első címsorból, annak híján a fájlnévből kapja. Minden más arra való, hogy megmondja, hová tartozik a jegyzet. Egy teljes fájl így néz ki: --- title: A pohár, amelyért imádkozott tags: [tanulmányozás, gecsemáné] publication: Matthew 26:39 --- Az imája alávetettséget mutat, nem vonakodást. A két kötőjeles sor közötti részt front matternek hívják. Az alatta lévő sorok maga a jegyzet.
A beolvasott mezők
Mindössze öt dolgot olvasunk be, és mindegyik többféle írásmódot elfogad, hogy ne kelljen pontos nevet megjegyezned. A **title** (vagy name, heading) lesz a jegyzet címe. A **tags** (vagy tag, keywords, categories, labels, topics) valódi JW Library-címkékké válnak, és létrejönnek, ha még nincsenek meg. A **date** (vagy created, modified) állítja be a jegyzet dátumát; bármi érthető, ami tartalmaz ÉÉÉÉ-HH-NN alakot. A **publication** (vagy pub, reference, ref, scripture, citation, source, passage) az a hely, ahová az íráshelyet írod. A **book**, **chapter** és **verse** (vagy ch, v, vs, verses) ugyanezt teszi külön mezőkben. Bármely más mezőt, amit magadnak tartasz meg — szerző, állapot, amit a szerkesztőd hozzátesz —, figyelmen kívül hagyunk, nem tekintjük hibának.
Három mód, hogy egy jegyzetet vershez köss
Írd egy sorba: `publication: Matthew 26:39`. Vagy bontsd szét: `book: Matthew`, `chapter: 26`, `verse: 39`. Vagy használd mindkettőt — ezt teszi az oldal exportja is, hogy a fájl embernek is jól olvasható, gépnek is pontos legyen. Mindhárom ugyanazt eredményezi, tehát azt használd, ami a szerkesztődhöz illik.
Mennyire lehet pontatlan az íráshely
A könyvneveket nagyvonalúan illesztjük. A teljes nevek működnek, és azok a rövidítések is, amelyeket az emberek tényleg begépelnek: Matt, Matt., Mt, 1 Cor, 1Cor, I Corinthians, Second Timothy, Psalm éppúgy, mint Psalms, Song of Songs éppúgy, mint Song of Solomon. A fejezet és a vers között lehet kettőspont, pont vagy v betű — a `John 3:16`, a `John 3.16` és az `1 Cor 13 v4` ugyanúgy olvasódik. A szóközök mindenütt elhagyhatók, tehát az `1Cor13:4` is jó. Maga a front matter ugyanilyen elnéző. A mezőnevek lehetnek nagybetűsek. A kettőspont utáni szóköz hiányozhat. A fölös szóközöket és tabulátorokat figyelmen kívül hagyjuk, ahogy az értékek körüli idézőjeleket és a sor végi # megjegyzést is. A windowsos sorvégek nem okoznak gondot. Akár a --- sorokat is elhagyhatod, és rögtön a mezőkkel kezdheted a fájlt, feltéve hogy a legelső sor a felismert nevek egyike — ez a szabály azért van, hogy egy kettőspontot tartalmazó, hétköznapi mondattal induló jegyzet ne veszítse el az első bekezdését.
Címkék, bárhogyan írod őket
Ezek mind ugyanazt a két címkét adják: `tags: [tanulmányozás, görög]`, `tags: tanulmányozás, görög`, `tags: tanulmányozás; görög`, `tags: #tanulmányozás #görög`, vagy egy lista a `tags:` alatt saját sorokban, ahol minden tétel kötőjellel kezdődik. A könyvtáradban már meglévő címkéket újra felhasználjuk, nem duplikáljuk, így az importált jegyzet ugyanahhoz a címkéhez csatlakozik, amelyre amúgy is szűrsz.
Mi történik, ha valami nem egyértelmű
Semmi bizonytalant nem döntünk el helyetted. Ha egy könyvnév közel áll egy valódihoz, de nem pontos — `Mathew`, `Ecclesiates` —, a jegyzetet nem helyezzük el automatikusan. Megjelenik az összegzésben, saját sorban, azzal, hogy az oldal minek olvasta: „így értelmeztük: Matthew 26:39”, jelölőnégyzettel. Ha kiveszed a pipát, kimarad; ha benne hagyod, oda kerül, amit a sor mond. Ha a könyv egyáltalán nem ismerhető fel, a sor ezt közli, és a jegyzet önálló jegyzetként kerül be — soha nem erőltetjük rá egy találgatásra. A számozott könyv megtartja a számát, tehát az `1 Jonh` csak 1 Jánosra javítható, 2 Jánosra soha.
Amit szándékosan nem tesz
A versszakasz a jegyzetet az első vershez horgonyozza: a `Matthew 26:39-41` a 39. vershez teszi, mert a JW Library-jegyzet a szöveg egy pontjához kapcsolódik, nem egy szakaszhoz. A fejezetet megadó, de verset nem tartalmazó hivatkozás — `Matthew 26` — a jegyzetet ahhoz a fejezethez köti. Az a fájl, amely íráshely helyett kiadványt nevez meg — `The Watchtower—2023 No. 4` —, mindenféle kérdés nélkül közönséges önálló jegyzetként kerül be, hiszen pontosan ezt írja az oldal exportja a cikkben készült jegyzetekhez.
Formázás, amely túléli az utat
A bekezdések, a sortörések, a **félkövér**, a *dőlt* és a felsorolások valódi formázásként érkeznek meg a JW Library-be. A fájl elején álló címsor a jegyzet címe lesz, nem ismétlődik meg belül. Amit a Markdown ki tud fejezni, a JW Library-jegyzetek pedig nem — táblázatok, képek, hivatkozások, kódblokkok —, azt a szövegére egyszerűsítjük, így egyetlen szó sem vész el akkor sem, ha az elrendezés nem hozható át.
Hová kerülnek valójában a jegyzetek, és miért biztonságos ez
Ahhoz, hogy egy jegyzetet vershez kössön, a JW Library-nek olyan belső azonosítókra van szüksége az adott fejezethez, amelyek a te könyvtáradra jellemzők. A JW Sync ezeket soha nem találja ki. Vagy azt a helyet használja újra, amely a saját mentésedben már megvan ahhoz a fejezethez, vagy ugyanabból a fájlból, egy másik bibliai helyről másolja át ezeket az azonosítókat. Ha egy mentésben egyáltalán nincs bibliai jegyzet vagy kiemelés, nincs honnan másolni — ilyenkor a jegyzetek önálló jegyzetként kerülnek be, ahelyett hogy olyasmihez kötnénk őket, amit az alkalmazás talán nem ismer fel. Ez szándékos döntés: a csendben rossz helyre került jegyzet rosszabb annál, mint amelyik láthatóan kötetlenül érkezik.
Ugyanazok a fájlok kétszer importálva
Egy jegyzetet akkor tekintünk meglévőnek, ha a címe, a szövege és a helye is egyezik valamivel a mentésben, így ugyanannak az exportnak az újbóli importálása semmit sem duplikál. Az összegzés a megerősítés előtt megmondja, hányat hagyunk ki emiatt. Amit egy import hozzáad, az egyetlen Visszavonás lépés, az importált jegyzetek pedig Imported címkét kapnak, hogy utólag csoportosan megtaláld, szűrd vagy törölhesd őket.
Gyakori kérdések
- Muszáj használnom a --- sorokat?
- Nem. Egyértelművé teszik a fájlt, és minden Markdown-szerkesztő érti őket, de kezdheted a fájlt közvetlenül a mezőkkel is — `title: …` az első sorban —, vagy elhagyhatod a front mattert, és hagyhatod, hogy a jegyzet az első címsorból kapja a címét.
- Mi van, ha elgépelem egy könyv nevét?
- Az oldal általában kitalálja, mire gondoltál, de pusztán ez alapján nem cselekszik. A jegyzet megjelenik az összegzésben azzal, hogyan olvastuk, és egy jelölőnégyzettel, hogy te erősítsd meg, mielőtt bármi rögzülne.
- Importálhatok egy egész mappát az Obsidianból?
- Jelölj ki egyszerre annyi .md fájlt, amennyit szeretnél, vagy tömörítsd a mappát, és válaszd a .zip fájlt. A tömörítvényben lévő fájlokat ugyanúgy olvassuk, mint a különállókat.
- Felülírja az importálás a meglévő jegyzeteimet?
- Nem. Az importálás csak hozzáad. A meglévő jegyzeteid, kiemeléseid, könyvjelzőid és címkéid érintetlenek maradnak, a betöltött fájl pedig soha nem módosul — a végén egy új .jwlibrary fájlt töltesz le.
- Feltöltődnek valahová a jegyzeteim?
- Nem. Minden a böngésződben fut, ahogy az oldal többi része is. Sem a mentésed, sem a Markdown-fájljaid nem hagyják el az eszközödet.
- Milyen nyelven írhatom az íráshelyet?
- A könyvneveket jelenleg angolul ismerjük fel, és az export is így írja őket. Ha más nyelven jegyzetelsz, használd a `book`, `chapter` és `verse` mezőket az angol könyvnévvel, vagy importáld a jegyzeteket kötetlenül, és helyezd el őket később kézzel.
- Ki tudom megint vinni a jegyzeteimet?
- Igen — ugyanezen a képernyőn a „Markdown exportálása” minden jegyzetet ugyanazokkal a mezőkkel ír ki egy .md fájlba, így a jegyzetek elhagyhatják a JW Library-t, és vissza is térhetnek anélkül, hogy elveszítenék a helyüket.