Cara mengimpor catatan Markdown ke JW Library
Ubah berkas .md dari Obsidian, Notion, atau editor Markdown mana pun menjadi catatan JW Library yang sesungguhnya, tepat di ayatnya — gratis, privat, di dalam peramban Anda.
JW Library sama sekali tidak punya cara memasukkan teks dari luar. Anda bisa menulis catatan di dalam aplikasi, tetapi catatan yang ditulis di tempat lain — di Obsidian, di Notion, di berkas teks biasa pada komputer — tidak punya jalan sama sekali menuju perpustakaan Anda. Orang mengetiknya ulang, atau menyerah dan menyimpan dua kumpulan catatan pelajaran yang tak pernah bertemu.
JW Sync menutup celah itu. Muat sebuah cadangan di Penjelajah Pelajaran, tekan “Impor Markdown”, dan berkas .md Anda menjadi catatan sungguhan di dalamnya: judul, tanggal, dan tag tetap utuh — dan bila berkas menyebutkan ayat mana yang dimaksud, catatan itu menempel di ayat tersebut, persis seperti kalau Anda menulisnya di aplikasi sambil membaca.
Ini bekerja dua arah. Catatan yang diekspor dari situs ini membawa kitab, pasal, dan ayatnya, sehingga kembali tepat ke tempat asalnya. Catatan yang ditulis di tempat lain biasanya tidak membawa apa pun seperti itu, dan karena itulah halaman ini menjelaskan satu atau dua baris yang menempatkannya — serta apa yang terjadi bila sebuah berkas tidak memilikinya.
Langkah demi langkah
Buat cadangan di JW Library
Buka JW Library, masuk ke Pelajaran Pribadi, ketuk menu tiga titik, pilih Cadangkan dan Pulihkan, lalu Buat cadangan. Anda mendapat berkas .jwlibrary — perpustakaan yang akan ditambahi catatan Anda.
Buka Penjelajah Pelajaran
Kunjungi jwsync.org, buka Penjelajah Pelajaran, dan muat berkas .jwlibrary itu. Semuanya berlangsung di dalam peramban Anda; berkas tidak pernah diunggah.
Tekan “Impor Markdown”
Tombolnya ada di sebelah “Ekspor Markdown”. Pilih berapa pun berkas .md yang Anda mau, atau sebuah .zip yang berisi berkas-berkas itu — termasuk .zip yang dihasilkan situs ini saat Anda mengekspor.
Baca ringkasannya sebelum ada yang ditulis
Anda diberi tahu berapa catatan yang akan mendarat di sebuah ayat, berapa yang ditambahkan sebagai catatan lepas, dan berapa yang sudah ada di cadangan sehingga dilewati. Semua yang terpaksa ditafsirkan oleh situs ditampilkan baris demi baris dengan kotak centang, jadi Anda yang memutuskan, bukan menemukannya belakangan.
Ekspor dan pulihkan
Tekan “Ekspor .jwlibrary”, lalu pulihkan berkas itu di JW Library lewat Cadangkan dan Pulihkan → Pulihkan. Catatan yang diimpor kini menjadi bagian perpustakaan Anda di perangkat tersebut.
Berkas terpendek yang tetap berhasil
Sebuah berkas Markdown tidak perlu apa pun untuk bisa diimpor: berkas berisi teks saja juga menjadi catatan, dan judulnya diambil dari tajuk pertama atau, kalau tidak ada, dari nama berkas. Selebihnya hanyalah cara memberi tahu di mana catatan itu seharusnya berada. Berkas yang lengkap tampak seperti ini: --- title: Cawan yang ia doakan tags: [pelajaran, getsemani] publication: Matthew 26:39 --- Doanya menunjukkan ketundukan, bukan keengganan. Blok di antara dua baris tanda hubung itu disebut front matter. Baris-baris di bawahnya adalah isi catatannya.
Ruas-ruas yang dibaca
Hanya lima hal yang dibaca, dan masing-masing menerima beberapa penulisan sehingga Anda tak perlu menghafal satu nama yang persis. **title** (atau name, heading) menjadi judul catatan. **tags** (atau tag, keywords, categories, labels, topics) menjadi tag JW Library yang sesungguhnya, dibuat bila belum ada. **date** (atau created, modified) menetapkan tanggal catatan; apa pun yang memuat TTTT-BB-HH dipahami. **publication** (atau pub, reference, ref, scripture, citation, source, passage) adalah tempat Anda menulis ayatnya. **book**, **chapter**, dan **verse** (atau ch, v, vs, verses) melakukan hal yang sama dalam ruas terpisah. Ruas lain yang Anda simpan untuk keperluan sendiri — penulis, status, apa pun yang ditambahkan editor Anda — diabaikan, bukan dianggap kesalahan.
Tiga cara menautkan catatan ke sebuah ayat
Tulis rujukannya dalam satu baris: `publication: Matthew 26:39`. Atau pisahkan: `book: Matthew`, `chapter: 26`, `verse: 39`. Atau pakai keduanya — itulah yang dilakukan ekspor situs ini, agar berkasnya enak dibaca manusia dan tepat dibaca mesin. Ketiganya memberi hasil yang sama, jadi pakai yang cocok dengan editor Anda.
Seberapa longgar rujukannya boleh ditulis
Nama kitab dicocokkan dengan murah hati. Nama lengkap bisa, begitu pula singkatan yang memang diketik orang: Matt, Matt., Mt, 1 Cor, 1Cor, I Corinthians, Second Timothy, Psalm maupun Psalms, Song of Songs maupun Song of Solomon. Pemisah antara pasal dan ayat boleh titik dua, titik, atau huruf v — `John 3:16`, `John 3.16`, dan `1 Cor 13 v4` dibaca sama. Spasi boleh dihilangkan di mana saja, jadi `1Cor13:4` pun bisa. Front matter sendiri sama longgarnya. Nama ruas boleh berhuruf besar. Spasi setelah titik dua boleh tidak ada. Spasi dan tab berlebih diabaikan, begitu pula tanda kutip di sekitar nilai dan komentar # di akhir baris. Akhiran baris Windows tidak masalah. Anda bahkan boleh menghilangkan baris --- sama sekali dan memulai berkas langsung dengan ruas-ruasnya, asalkan baris paling pertama adalah salah satu nama yang dikenali — aturan itu ada supaya catatan yang dibuka dengan kalimat biasa bertitik dua tidak kehilangan paragraf pertamanya.
Tag, ditulis dengan cara apa pun
Semua bentuk ini menghasilkan dua tag yang sama: `tags: [pelajaran, yunani]`, `tags: pelajaran, yunani`, `tags: pelajaran; yunani`, `tags: #pelajaran #yunani`, atau daftar pada baris tersendiri di bawah `tags:` dengan tiap butir diawali tanda hubung. Tag yang sudah ada di perpustakaan Anda dipakai kembali, bukan digandakan, sehingga catatan yang diimpor bergabung ke tag yang memang sudah Anda pakai untuk menyaring.
Apa yang terjadi bila ada yang tidak jelas
Tidak ada hal meragukan yang diputuskan untuk Anda. Bila nama kitab mirip dengan yang asli tetapi tidak persis — `Mathew`, `Ecclesiates` — catatan itu tidak ditempatkan otomatis. Ia muncul di ringkasan pada barisnya sendiri, menyebutkan bagaimana situs membacanya: “dibaca sebagai Matthew 26:39”, dengan kotak centang. Hapus centangnya dan ia tidak ikut; biarkan tercentang dan ia masuk sesuai baris itu. Bila kitabnya sama sekali tidak dikenali, barisnya menyatakan hal itu dan catatan ditambahkan sebagai catatan lepas — tidak pernah dipaksakan pada tebakan. Kitab bernomor mempertahankan nomornya, jadi `1 Jonh` hanya bisa dibetulkan menjadi 1 Yohanes, tidak pernah menjadi 2 Yohanes.
Yang sengaja tidak dilakukan
Rentang ayat menambatkan catatan pada ayat pertamanya: `Matthew 26:39-41` menempatkannya di ayat 39, karena catatan JW Library melekat pada satu titik dalam teks, bukan pada satu rentang. Rujukan dengan pasal tetapi tanpa ayat — `Matthew 26` — melekatkan catatan pada pasal itu. Berkas yang menyebut sebuah publikasi alih-alih ayat — `The Watchtower—2023 No. 4` — diimpor sebagai catatan lepas biasa tanpa ditanyakan apa pun, sebab itulah yang ditulis ekspor situs ini untuk catatan yang dibuat di sebuah artikel.
Format yang selamat sampai tujuan
Paragraf, ganti baris, **tebal**, *miring*, dan daftar berbutir tiba sebagai format sungguhan di JW Library. Tajuk di bagian atas berkas dipakai sebagai judul catatan, bukan diulang di dalamnya. Apa pun yang bisa diungkapkan Markdown tetapi tidak oleh catatan JW Library — tabel, gambar, tautan, blok kode — disederhanakan menjadi teksnya, jadi tidak ada kata yang hilang meski tata letaknya tidak bisa ikut.
Ke mana catatan benar-benar mendarat, dan mengapa itu aman
Untuk melekatkan catatan pada sebuah ayat, JW Library memerlukan pengenal internal bagi pasal itu yang khas bagi perpustakaan Anda. JW Sync tidak pernah mengarangnya. Ia memakai kembali lokasi yang sudah dimiliki cadangan Anda untuk pasal tersebut, atau menyalin pengenal itu dari lokasi Alkitab lain di berkas yang sama. Bila sebuah cadangan tidak memuat catatan atau sorotan Alkitab sama sekali, tidak ada yang bisa disalin — maka catatan ditambahkan sebagai catatan lepas, bukan dilekatkan pada sesuatu yang mungkin tidak dikenali aplikasi. Ini pilihan yang disengaja: catatan yang diam-diam mendarat di tempat yang salah lebih buruk daripada catatan yang datang jelas-jelas tanpa tautan.
Mengimpor berkas yang sama dua kali
Sebuah catatan dianggap sudah ada bila judul, teks, dan tempatnya cocok dengan sesuatu di cadangan, sehingga mengimpor ulang ekspor yang sama tidak menggandakan apa pun. Ringkasan memberi tahu berapa yang dilewati karena alasan itu sebelum Anda menyetujui. Semua yang ditambahkan satu impor terhitung satu langkah Urungkan, dan catatan yang diimpor diberi tag Imported agar bisa Anda cari, saring, atau hapus sekaligus nanti.
Pertanyaan yang sering diajukan
- Apakah saya harus memakai baris ---?
- Tidak. Baris itu membuat berkas tidak ambigu dan dipahami setiap editor Markdown, tetapi Anda juga bisa memulai berkas langsung dengan ruas-ruasnya — `title: …` di baris pertama — atau melewatkan front matter dan membiarkan catatan mengambil judul dari tajuk pertama.
- Bagaimana kalau saya salah menulis nama kitab?
- Biasanya situs bisa menebak maksud Anda, tetapi tidak bertindak hanya atas dasar itu. Catatan itu muncul di ringkasan lengkap dengan cara ia dibaca dan kotak centang, jadi Anda mengonfirmasi sebelum ada yang ditulis.
- Bisakah saya mengimpor satu folder penuh dari Obsidian?
- Pilih sekaligus berapa pun berkas .md yang Anda mau, atau kompres foldernya dan pilih .zip itu. Berkas di dalam arsip dibaca sama seperti berkas lepas.
- Apakah mengimpor akan menimpa catatan yang sudah ada?
- Tidak. Mengimpor hanya menambah. Catatan, sorotan, penanda, dan tag Anda yang lama tidak disentuh, dan berkas yang Anda muat tidak pernah diubah — di akhir Anda mengunduh .jwlibrary yang baru.
- Apakah catatan saya diunggah ke suatu tempat?
- Tidak. Semuanya berjalan di peramban Anda, seperti seluruh bagian situs ini. Baik cadangan maupun berkas Markdown Anda tidak meninggalkan perangkat.
- Dalam bahasa apa rujukannya boleh ditulis?
- Untuk saat ini nama kitab dikenali dalam bahasa Inggris, dan itu pula yang ditulis oleh ekspor. Jika Anda menulis catatan dalam bahasa lain, gunakan ruas `book`, `chapter`, dan `verse` dengan nama kitab berbahasa Inggris, atau impor catatan tanpa tautan lalu tempatkan sendiri nanti.
- Bisakah saya mengeluarkan catatan saya lagi?
- Bisa — “Ekspor Markdown” di layar yang sama menulis setiap catatan ke berkas .md dengan ruas yang sama, jadi catatan bisa keluar dari JW Library dan kembali tanpa kehilangan tempatnya.