Как импортировать заметки 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 и возвращаться, не теряя своего места.