Як імпортувати нотатки Markdown у JW Library
Перетворіть файли .md з Obsidian, Notion чи будь-якого редактора Markdown на справжні нотатки JW Library, прив'язані до потрібного вірша — безкоштовно, приватно, у вашому браузері.
JW Library не має жодного способу внести текст ззовні. Усередині застосунку нотатки писати можна, але нотатка, написана деінде — в Obsidian, у Notion, у звичайному текстовому файлі на комп'ютері, — не має взагалі ніякого шляху до вашої бібліотеки. Дехто передруковує їх вручну, а дехто махає рукою й тримає два набори навчальних нотаток, які ніколи не сходяться.
JW Sync закриває цю прогалину. Завантажте резервну копію в «Оглядач вивчення», натисніть «Імпорт Markdown» — і ваші файли .md стануть у ній справжніми нотатками: заголовок, дата й мітки лишаться незмінними, а якщо у файлі вказано, до якого місця Писання він належить, нотатка стане саме на той вірш, наче ви написали її в застосунку під час читання.
Це працює в обидва боки. Нотатки, вивантажені з цього сайту, несуть книгу, розділ і вірш, тому повертаються точно туди, звідки вийшли. У нотаток, написаних деінде, зазвичай нічого такого немає — тому ця сторінка й пояснює той один-два рядки, які їх розставляють, і те, що відбувається, коли таких рядків у файлі немає.
Крок за кроком
Створіть резервну копію в JW Library
Відкрийте JW Library, перейдіть до «Особисте вивчення», натисніть меню з трьох крапок, виберіть «Резервне копіювання та відновлення», далі «Створити резервну копію». Отримаєте файл .jwlibrary — бібліотеку, до якої додадуться ваші нотатки.
Відкрийте «Оглядач вивчення»
Зайдіть на jwsync.org, відкрийте «Оглядач вивчення» і завантажте той файл .jwlibrary. Усе відбувається у вашому браузері; файл нікуди не надсилається.
Натисніть «Імпорт Markdown»
Кнопка стоїть поруч із «Експорт Markdown». Виберіть скільки завгодно файлів .md або архів .zip із ними — зокрема той .zip, який створює цей сайт під час експорту.
Прочитайте підсумок, перш ніж щось буде записано
Вам покажуть, скільки нотаток стануть на вірш, скільки додадуться як окремі й скільки вже є в копії, тож будуть пропущені. Усе, що сайтові довелося витлумачити, перелічено по рядку з віконцем для позначки — вирішуєте ви, а не дізнаєтеся згодом.
Вивантажте й відновіть
Натисніть «Експорт .jwlibrary» і відновіть цей файл у JW Library через «Резервне копіювання та відновлення» → «Відновити». Імпортовані нотатки тепер частина вашої бібліотеки на цьому пристрої.
Найкоротший файл, який спрацює
Файлові Markdown не потрібно нічого, щоб його імпортували: файл із самим лише текстом теж стане нотаткою, а заголовок візьме з першого заголовка всередині або, якщо його немає, з назви файлу. Усе інше потрібне, щоб сказати, куди нотатка належить. Повний файл виглядає так: --- title: Чаша, про яку він молився tags: [вивчення, гефсиманія] publication: Matthew 26:39 --- Його молитва показує покору, а не небажання. Блок між двома рядками з дефісів називається front matter. Рядки нижче — сама нотатка.
Поля, які зчитуються
Зчитується лише п'ять речей, і кожна розуміє кілька написань, щоб не доводилося запам'ятовувати одне точне. **title** (або name, heading) стає заголовком нотатки. **tags** (або tag, keywords, categories, labels, topics) стають справжніми мітками JW Library і створюються, якщо їх ще немає. **date** (або created, modified) задає дату нотатки; зрозуміле будь-яке значення, що містить РРРР-ММ-ДД. **publication** (або pub, reference, ref, scripture, citation, source, passage) — місце для посилання на Писання. **book**, **chapter** і **verse** (або ch, v, vs, verses) роблять те саме окремими полями. Будь-яке інше поле, яке ви тримаєте для себе — автор, стан, те, що додає ваш редактор, — просто ігнорується, а не вважається помилкою.
Три способи вказати нотатці вірш
Напишіть посилання одним рядком: `publication: Matthew 26:39`. Або розкладіть його: `book: Matthew`, `chapter: 26`, `verse: 39`. Або скористайтеся обома — саме так робить експорт цього сайту, щоб файл добре читався людиною й точно розбирався машиною. Усі три дають однаковий результат, тож беріть те, що зручніше у вашому редакторі.
Наскільки вільним може бути посилання
Назви книг зіставляються щедро. Працюють повні назви й ті скорочення, які люди справді набирають: Matt, Matt., Mt, 1 Cor, 1Cor, I Corinthians, Second Timothy, Psalm нарівні з Psalms, Song of Songs нарівні з Song of Solomon. Розділювачем між розділом і віршем може бути двокрапка, крапка або літера v — `John 3:16`, `John 3.16` і `1 Cor 13 v4` читаються однаково. Пробіли всюди необов'язкові, тож `1Cor13:4` теж підійде. Сам front matter такий самий поблажливий. Назви полів можуть бути з великої літери. Пробіл після двокрапки може бути відсутнім. Зайві пробіли й табуляції ігноруються, як і лапки навколо значень і завершальний коментар із #. Переноси рядків Windows не заважають. Можна навіть зовсім не ставити рядки --- і почати файл прямо з полів — за умови, що найперший рядок є однією з розпізнаваних назв. Це правило існує заради того, щоб нотатка, яка починається звичайним реченням із двокрапкою, не втратила свій перший абзац.
Мітки — хоч би як ви їх записали
Усі ці способи дають ті самі дві мітки: `tags: [вивчення, грецька]`, `tags: вивчення, грецька`, `tags: вивчення; грецька`, `tags: #вивчення #грецька` або список окремими рядками під `tags:`, де кожен запис починається з дефіса. Мітки, які вже є у вашій бібліотеці, використовуються повторно, а не дублюються, тож імпортована нотатка потрапляє до тієї самої мітки, за якою ви й так фільтруєте.
Що відбувається, коли щось незрозуміло
Нічого сумнівного за вас не вирішують. Якщо назва книги схожа на справжню, але не збігається — `Mathew`, `Ecclesiates`, — нотатку не розставляють автоматично. Вона з'являється в підсумку окремим рядком із тим, як її зрозумів сайт: «прочитано як Matthew 26:39», і з віконцем для позначки. Знімете позначку — нотатка лишиться осторонь; залишите — вона піде туди, де сказано. Якщо книгу не розпізнано взагалі, рядок так і каже, а нотатка додається як окрема — її ніколи не нав'язують здогаду. Нумерована книга зберігає свій номер, тож `1 Jonh` може бути виправлене лише на 1 Івана, але ніколи на 2 Івана.
Чого він навмисно не робить
Діапазон віршів прив'язує нотатку до першого з них: `Matthew 26:39-41` ставить її на вірш 39, бо нотатка JW Library кріпиться до точки в тексті, а не до відрізка. Посилання з розділом, але без вірша — `Matthew 26` — прив'язує нотатку до цього розділу. Файл, що називає видання, а не вірш — `The Watchtower—2023 No. 4`, — імпортується як звичайна окрема нотатка без жодних запитань, адже саме це пише експорт сайту для нотаток, зроблених у статті.
Оформлення, яке переживає дорогу
Абзаци, переноси рядків, **жирний**, *курсив* і марковані списки приходять до JW Library справжнім оформленням. Заголовок на початку файлу використовується як назва нотатки, а не повторюється всередині неї. Усе, що Markdown уміє виразити, а нотатки JW Library — ні (таблиці, зображення, посилання, блоки коду), зводиться до тексту: слова не губляться, навіть коли верстку перенести не можна.
Куди нотатки потрапляють насправді й чому це безпечно
Щоб прив'язати нотатку до вірша, JW Library потрібні внутрішні ідентифікатори цього розділу, властиві саме вашій бібліотеці. JW Sync ніколи їх не вигадує. Він бере те місце, яке вже є у вашій копії для цього розділу, або копіює ці ідентифікатори з іншого біблійного місця в тому самому файлі. Якщо в копії немає жодної нотатки чи виділення в Біблії, копіювати нізвідки — тоді нотатки додаються як окремі, а не прив'язуються до чогось, чого застосунок може не впізнати. Це свідомий вибір: нотатка, що тихо опинилася не там, гірша за нотатку, яка чесно прийшла неприв'язаною.
Імпорт тих самих файлів двічі
Нотатка вважається наявною, коли збігаються її заголовок, текст і місце, тож повторний імпорт того самого експорту нічого не подвоює. Підсумок до підтвердження повідомляє, скільки буде пропущено з цієї причини. Усе, що додає імпорт, — це один крок скасування, а імпортовані нотатки отримують мітку Imported, щоб потім їх можна було знайти, відфільтрувати чи видалити групою.
Часті запитання
- Чи обов'язково використовувати рядки ---?
- Ні. Вони роблять файл однозначним, і їх розуміє будь-який редактор Markdown, але можна почати файл прямо з полів — `title: …` першим рядком — або взагалі обійтися без front matter і дозволити нотатці взяти назву з першого заголовка.
- А якщо я помилюся в назві книги?
- Зазвичай сайт розуміє, що малося на увазі, але не діє лише на цій підставі. Нотатка з'явиться в підсумку з тим, як її прочитали, і з віконцем для позначки — ви підтверджуєте, перш ніж щось буде записано.
- Чи можна імпортувати цілу теку з Obsidian?
- Виберіть за раз скільки завгодно файлів .md або запакуйте теку в .zip і виберіть його. Файли всередині архіву читаються так само, як окремі.
- Чи перезапише імпорт мої наявні нотатки?
- Ні. Імпорт лише додає. Ваші нотатки, виділення, закладки й мітки лишаються недоторканими, а завантажений файл ніколи не змінюється — наприкінці ви завантажуєте новий .jwlibrary.
- Чи надсилаються мої нотатки кудись?
- Ні. Усе працює у вашому браузері, як і решта сайту. Ані резервна копія, ані файли Markdown не залишають ваш пристрій.
- Якою мовою писати посилання?
- Наразі назви книг розпізнаються англійською — так їх пише й експорт. Якщо ви ведете нотатки іншою мовою, використовуйте поля `book`, `chapter` і `verse` з англійською назвою книги або імпортуйте нотатки без прив'язки й розставте їх вручну пізніше.
- Чи зможу я знову вивантажити свої нотатки?
- Так — «Експорт Markdown» на тому самому екрані записує кожну нотатку у файл .md з тими самими полями, тож нотатки можуть виходити з JW Library й повертатися, не втрачаючи свого місця.