Indeks Dokumentasi

Dokumentasi Utama

Dokumentasi Pengembang

  • Referensi API - Dokumentasi API publik. Meliputi manajemen metadata, kontrol navigasi, dan langganan acara untuk pengembang JavaScript/TypeScript.
  • Panduan Tema - Panduan untuk pengembang tema. Termasuk referensi kelas CSS, properti khusus, dan contoh tema untuk mode terang dan gelap.
  • Proses Startup - Urutan inisialisasi plugin. Aliran boot dingin vs boot hangat, resolusi cache metadata, pembersihan yang ditangguhkan, dan jalur pembuatan konten. Termasuk diagram Putri Duyung.
  • Pipeline Metadata - Urutan pembangunan ulang cache, tahapan pipeline penyedia, dan sinyal penyelesaian. Termasuk diagram putri duyung.
  • Arsitektur Penyimpanan - Panduan untuk wadah penyimpanan (IndexedDB, Penyimpanan Lokal, Cache Memori, Pengaturan). Pola aliran data dan panduan penggunaan.
  • Arsitektur Rendering - Hirarki komponen React, pengguliran virtual dengan TanStack Virtual, pengoptimalan performa, dan aliran data.
  • Orkestrasi Gulir - Bagaimana plugin memastikan pengguliran yang akurat ketika struktur pohon berubah (visibilitas tag, pengaturan, dll.)
  • Arsitektur Layanan - Lapisan logika bisnis: MetadataService, FileSystemOperations, ContentProviderRegistry. Pola injeksi ketergantungan dan aliran data layanan.

1 Instalasi

  1. Instal Obsidian - Unduh dan instal dari obsidian.md
  2. Aktifkan plugin komunitas - Buka Pengaturan → Plugin komunitas → Aktifkan plugin komunitas
  3. Instal Notebook Navigator - Klik "Jelajahi" → Cari "Notebook Navigator" → Instal
  4. Instal Pengaturan Gaya (opsional) - Untuk menyesuaikan warna dan tampilan, instal plugin Pengaturan Gaya dengan mencari "Pengaturan Gaya" di plugin Komunitas

2 Memulai

Berikut ini adalah tutorial resmi untuk mempelajari dan menguasai Notebook Navigator:

Mastering Notebook Navigator

Video ini memiliki subtitle dalam 21 bahasa.


3 Keamanan dan kualitas

Notebook Navigator diperiksa dengan TypeScript, ESLint dengan plugin resmi Obsidian ESLint, Prettier, Vitest, dan build produksi sebelum perubahan digabungkan. Proses pembuatan harus selesai tanpa kesalahan dan tanpa peringatan.

Pemeriksaan keamanan dijalankan melalui CodeQL, dengan riwayat pemindaian dalam alur kerja CodeQL yang berjalan, dan OpenSSF Scorecard. Status saat ini ditampilkan pada lencana di bagian atas halaman ini.

Notebook Navigator berjalan secara lokal, namun beberapa fitur membuat permintaan HTTP terdokumentasi untuk pembaruan, download, dan konten jarak jauh. Lihat bagian 10 - Pengungkapan Jaringan dan Diagnostik untuk daftar lengkapnya.


Daftar isi


4 Pintasan papan ketik

Kunci Tindakan
↑/↓ Menavigasi ke atas/bawah di panel saat ini
Di panel navigasi: menyembunyikan atau beralih ke panel induk Di panel daftar: beralih ke panel navigasi
Di panel navigasi: memperluas atau beralih ke panel daftar Di panel daftar: beralih ke editor
Tab Di panel navigasi: beralih ke panel daftar Di panel daftar: beralih ke editor Di bidang pencarian: beralih ke panel daftar
Shift+Tab Di panel daftar: beralih ke panel navigasi Di bidang pencarian: beralih ke panel navigasi
Enter (macOS) F2 (Windows/Linux) Ubah nama item secara langsung di panel navigasi atau panel daftar
Enter Di panel navigasi: buka catatan folder pada Windows/Linux secara default (jika diaktifkan) Di panel daftar: buka file yang dipilih di semua sistem (jika diaktifkan) Di bidang pencarian: beralih ke panel daftar
Esc Di bidang pencarian: tutup pencarian dan fokus ke panel daftar
PageUp/PageDown Gulir ke atas/bawah di panel navigasi dan panel daftar
Home/End Lompat ke item pertama/terakhir di panel saat ini
Hapus Backspace Hapus item yang dipilih
Cmd/Ctrl+A Pilih semua catatan di folder saat ini
Cmd/Ctrl+Klik Beralih antara memilih dan tidak memilih catatan
Shift+Klik Memilih rentang catatan
Shift+Home/End Pilih dari posisi saat ini hingga item pertama/terakhir
Shift+↑/↓ Perluas pemilihan ke atas/bawah
Cmd/Ctrl+↑/↓ Mengatur ulang urutan file yang dipilih ke atas/bawah dalam mode penyortiran manual

Catatan: Semua pintasan keyboard dapat dikustomisasi. Lihat bagian 7 - Tombol pintas khusus untuk rincian tentang cara menambahkan navigasi gaya VIM (h, j, k, l), tombol alternatif, dan kombinasi pengubah.


5 Pengaturan yang disinkronkan dan lokal

Banyak pengaturan di Notebook Navigator yang menampilkan tombol alih sinkronisasi - ikon cloud yang beralih antara "Aktifkan sinkronisasi" dan "Nonaktifkan sinkronisasi". Ini mengontrol di mana setiap pengaturan disimpan dan apakah pengaturan tersebut akan dibagikan ke seluruh perangkat.

5.1 Cara kerja sinkronisasi

Plugin Obsidian menyimpan konfigurasinya di data.json, yang terletak di .obsidian/plugins/notebook-navigator/data.json di dalam folder vault Anda. Ketika Anda menggunakan layanan sinkronisasi - seperti Obsidian Sync, iCloud, GitHub, Dropbox, atau Google Drive - file ini disinkronkan di semua perangkat Anda bersama dengan vault lainnya. Pengaturan apa pun yang disimpan ke data.json akan disebarkan ke setiap perangkat yang menyinkronkan vault.

Screenshot 2026-02-18 at 22 58 05

Ketika sinkronisasi diaktifkan (default) untuk pengaturan, nilainya disimpan ke data.json dan disinkronkan ke semua perangkat melalui layanan sinkronisasi Anda.

Screenshot 2026-02-18 at 22 58 14

Ketika sinkronisasi dinonaktifkan untuk suatu pengaturan, nilainya akan disimpan ke penyimpanan lokal Obsidian. Penyimpanan lokal bersifat khusus untuk perangkat dan tidak termasuk dalam sinkronisasi vault. Pengaturan akan memiliki nilai tersendiri pada setiap perangkat. Bila Anda menonaktifkan sinkronisasi untuk pengaturan, nilai saat ini akan disalin ke penyimpanan lokal pada perangkat saat ini, dan nilai tersebut akan dihapus dari data.json agar tidak menimpa nilai lokal pada perangkat lain.

Jika Anda tidak menggunakan layanan sinkronisasi, sakelar sinkronisasi tidak memiliki efek praktis karena data.json hanya disimpan secara lokal.


6 Pencarian

Notebook Navigator memiliki dua mode pencarian: pencarian filter dan Omnisearch. Beralihlah di antara keduanya menggunakan tombol panah atas/bawah atau dengan mengeklik ikon pencarian. Gabungkan nama file, properti, tag, tanggal, dan filter dalam satu kueri (misalnya, meeting .status=active #work @thisweek).

6.1 Pencarian filter

Menyaring berkas berdasarkan nama tampilan, alias, tag, properti, tanggal, folder, ekstensi, dan tugas di dalam folder saat ini serta subfoldernya. Mode pencarian default.

Nama file dan alias

  • word - Cocokkan catatan yang memiliki kata "word" dalam nama tampilan atau aliasnya
  • word1 word2 - Memastikan setiap kata harus sama antara nama tampilan dan alias-aliasnya
  • -word - Kecualikan catatan yang memiliki kata "word" dalam nama tampilan atau aliasnya
  • ".F" - Mencocokkan teks secara harfiah; istilah yang diawali dengan tanda kutip ganda tidak akan pernah diartikan sebagai tag, properti, tanggal, atau filter (misalnya, ` ".F" ` akan mencocokkan nama-nama yang mengandung ` .F `, alih-alih menyaring berdasarkan properti)
  • -".F" - Kecualikan catatan yang memiliki teks persis sama dalam nama tampilan atau aliasnya

Tags

  • #tag - Sertakan catatan dengan tag (juga cocok dengan tag bersarang seperti #tag/subtag)
  • # - Hanya menyertakan catatan yang ditandai
  • -#tag - Mengecualikan catatan dengan tag
  • -# - Hanya menyertakan catatan yang tidak diberi tag
  • #tag1 #tag2 - Mencocokkan kedua tag (implisit AND)
  • #tag1 AND #tag2 - Mencocokkan kedua tag (eksplisit AND)
  • #tag1 OR #tag2 - Cocokkan salah satu tag
  • #a OR #b AND #c - DAN memiliki prioritas yang lebih tinggi: cocok dengan #a, atau keduanya #b dan #c
  • Cmd/Ctrl+Klik tag yang akan ditambahkan dengan AND. Cmd/Ctrl+Shift+Klik untuk menambahkan dengan OR

Properti

  • .key - Sertakan catatan dengan kunci properti yang diawali dengan key
  • .key=value - Sertakan catatan di mana nilai properti berisi value
  • ."Reading Status" - Kunci properti dengan spasi (tanda kutip ganda)
  • ."Reading Status"="In Progress" - Tombol dan nilai dengan spasi harus diberi tanda kutip ganda
  • -.key - Kecualikan catatan yang memiliki kunci properti yang diawali dengan key
  • -.key=value - Kecualikan catatan di mana nilai properti berisi value
  • Cmd/Ctrl+Klik properti yang akan ditambahkan dengan AND. Cmd/Ctrl+Shift+Klik untuk menambahkan dengan OR

Filter

  • has:task - Menyertakan catatan dengan tugas yang belum selesai
  • -has:task - Mengecualikan catatan dengan tugas yang belum selesai
  • folder:meetings - Menyertakan catatan yang berisi nama folder meetings
  • folder:/work/meetings - Sertakan catatan hanya di work/meetings (bukan subfolder)
  • folder:/ - Sertakan catatan hanya di root vault
  • -folder:archive - Kecualikan catatan yang berisi nama folder archive
  • -folder:/archive - Kecualikan catatan hanya di archive (bukan subfolder)
  • ext:md - Sertakan catatan dengan ekstensi md (ext:.md juga didukung)
  • -ext:pdf - Mengecualikan catatan dengan ekstensi pdf
  • Kombinasikan dengan tag, nama, dan tanggal (misalnya, folder:/work/meetings ext:md @thisweek)

Kurma

  • @today - Mencocokkan catatan dari hari ini menggunakan bidang tanggal default
  • @yesterday, @last7d, @last30d, @thisweek, @thismonth - Rentang tanggal relatif
  • @2026-02-07 - Pertandingan satu hari (juga mendukung @20260207)
  • @2026 - Mencocokkan tahun kalender
  • @2026-02 atau @202602 - Cocokkan dengan bulan kalender
  • @2026-W05 atau @2026W05 - Mencocokkan minggu ISO
  • @2026-Q2 atau @2026Q2 - Mencocokkan kuartal kalender
  • @13/02/2026 - Format numerik dengan pemisah (@07022026 mengikuti wilayah Anda jika tidak jelas)
  • @2026-02-01..2026-02-07 - Cocokkan rentang hari yang inklusif (didukung ujung terbuka)
  • @c:... atau @m:... - Tanggal target dibuat atau diubah
  • -@... - Mengecualikan kecocokan tanggal

Bidang tanggal default mengikuti urutan pengurutan saat ini. Saat mengurutkan berdasarkan nama, bidang tanggal dikonfigurasikan di Pengaturan → Catatan → Tanggal → Saat mengurutkan berdasarkan nama.

Dan/atau perilaku

AND dan operator OR bekerja di kueri khusus tag/properti (kueri yang hanya berisi filter #tag, -#tag, #, -#, .key, -.key, .key=value, atau -.key=value ). Jika kueri juga menyertakan nama, tanggal, filter tugas, filter folder, atau filter ekstensi, AND dan OR akan dicocokkan sebagai kata nama file.

  • Permintaan operator: #work OR .status=started
  • Kueri campuran: #work OR ext:md (OR dicocokkan dengan nama file)

6.2 Omnisearch

Pencarian teks lengkap di seluruh lemari besi, difilter ke folder saat ini, subfolder, atau tag yang dipilih. Memerlukan plugin Omnisearch. Jika Omnisearch tidak diinstal, pencarian akan kembali ke pencarian filter.

Pratinjau catatan menampilkan kutipan hasil Omnisearch, bukan teks pratinjau default.

Keterbatasan yang diketahui

  • Performa - Bisa lambat saat mencari kurang dari 3 karakter dalam brankas besar
  • Filter jalur — Batasan folder dikirim ke Omnisearch untuk semua jalur folder, kecuali nama yang mengandung " atau ,. Nama folder yang mengandung karakter non-ASCII memerlukan Omnisearch versi 1.30.0 atau yang lebih baru. Hasil selalu disaring sesuai tampilan saat ini setelah Omnisearch mengembalikan hasilnya
  • Hasil terbatas - Omnisearch menampilkan maksimal 50 hasil. Saat melakukan pencarian di dalam sebuah folder, batasan ini mencakup folder tersebut beserta subfoldernya, sehingga hasil pencocokan di subfolder juga dihitung dalam batasan tersebut, bahkan jika opsi " Show notes from subfolders " dinonaktifkan
  • Teks pratinjau - Pratinjau catatan diganti dengan kutipan hasil Omnisearch, yang mungkin tidak menampilkan sorotan kecocokan pencarian yang sebenarnya jika muncul di tempat lain dalam file

7 Tombol pintas khusus

Edit .obsidian/plugins/notebook-navigator/data.json untuk menyesuaikan tombol pintas Notebook Navigator. Buka file dan cari bagian keyboardShortcuts. Setiap entri memetakan tindakan ke satu atau beberapa pengikatan tombol:

"pane:move-up": [ { "key": "ArrowUp", "modifiers": [] }, { "key": "K", "modifiers": [] } ]

Tambahkan beberapa binding per tindakan untuk mendukung kunci alternatif, seperti contoh ArrowUp dan K di atas. Menggabungkan pengubah dalam satu entri dengan mencantumkan setiap nilai, misalnya "modifiers": ["Mod", "Shift"]. Urutan keyboard seperti gg atau dd tidak didukung. Muat ulang Obsidian setelah mengedit file.

7.1 Pengubah

Pengubah Kunci
Mod Cmd (macOS) / Ctrl (Win/Linux)
Alt Alt / Opsi
Shift Shift
Ctrl Kontrol (lebih suka Mod untuk lintas platform)

7.2 Tindakan yang tersedia

Tindakan Tombol default
pane:move-up Panah Atas
pane:move-down Panah Bawah
pane:page-up PageUp
pane:page-down PageDown
pane:home Beranda
pane:end End
pane:rename Enter (macOS), F2 (Windows/Linux)
pane:delete-selected Hapus, Backspace
navigation:collapse-or-parent Panah Kiri
navigation:expand-or-focus-list Panah Kanan
navigation:focus-list Tab
list:focus-navigation Panah Kiri, Shift+Tab
list:focus-editor Panah Kanan, Tab
list:select-all Mod+A
list:extend-selection-up Shift+Panah Atas
list:extend-selection-down Shift+Panah Bawah
list:manual-sort-up Mod+Panah Atas
list:manual-sort-down Mod+Panah Bawah
list:range-to-start Shift+Home
list:range-to-end Shift+End
search:focus-list Tab, Enter
search:focus-navigation Shift+Tab
search:close Escape

8 Perintah

Tetapkan tombol pintas khusus untuk perintah-perintah ini dalam pengaturan Tombol Pintas Obsidian:

Tampilan & navigasi

  • Notebook Navigator: Open Membuka Notebook Navigator di bilah sisi kiri. Jika sudah terbuka, memindahkan fokus keyboard ke panel daftar. Saran: Ikat tombol pintasan seperti Cmd/Ctrl+Shift+E untuk memindahkan fokus papan ketik ke panel daftar - ini penting untuk navigasi papan ketik secara penuh
  • Notebook Navigator: Toggle left sidebar Mengalihkan bilah sisi kiri. Saat membuka, atur tampilan bilah sisi kiri ke Notebook Navigator (tidak seperti perintah "Alihkan bilah sisi kiri" bawaan Obsidian yang mengembalikan tampilan bilah sisi kiri sebelumnya)
  • Notebook Navigator: Open homepage Membuka tampilan Notebook Navigator dan memuat target beranda yang dikonfigurasi dalam pengaturan
  • Notebook Navigator: Select vault profile Membuka modal untuk beralih di antara profil vault
  • Notebook Navigator: Select vault profile 1-3 Mengaktifkan profil brankas berdasarkan posisinya. Membuka jendela pop-up pemilihan profil jika tidak ada profil di posisi tersebut
  • Notebook Navigator: Reveal file Menampilkan file saat ini di navigator. Memperluas folder induk dan menggulir ke file. Perintah ini berguna jika pengaturan Auto-reveal active note dimatikan dan Anda ingin menampilkan catatan secara manual. Saran: Ikat ke tombol pintasan seperti Cmd/Ctrl+Shift+R untuk mengubah folder atau tag yang dipilih dengan cepat ke file saat ini
  • Notebook Navigator: Open all files Membuka semua catatan dalam folder atau tag yang sedang dipilih. Saat membuka 15 file atau lebih, menampilkan dialog konfirmasi
  • Notebook Navigator: Navigate to folder Dialog pencarian untuk melompat ke folder mana pun
  • Notebook Navigator: Navigate to tag Dialog pencarian untuk melompat ke tag apa pun
  • Notebook Navigator: Navigate to property Dialog pencarian untuk melompat ke kunci atau nilai properti apa pun
  • Notebook Navigator: Navigate back Memindahkan ke folder, tag, atau pilihan properti sebelumnya dalam riwayat navigator
  • Notebook Navigator: Navigate forward Memindahkan ke folder, tag, atau pilihan properti berikutnya dalam riwayat navigator
  • Notebook Navigator: Add to shortcuts Menambahkan atau menghapus file, folder, tag, atau properti saat ini dari pintasan
  • Notebook Navigator: Open shortcut 1-9 Membuka pintasan berdasarkan posisinya dalam daftar pintasan
  • Notebook Navigator: Search Membuka bidang pencarian cepat atau memfokuskannya jika sudah terbuka. Pencarian berlanjut di antara sesi. Saran: Ikat ke tombol pintasan seperti Cmd/Ctrl+Shift+S untuk pemfilteran file cepat
  • Notebook Navigator: Search whole vault Memilih folder induk vault dan membuka fitur pencarian yang mencakup subfolder (tersedia jika opsi “ Show root folder ” atau “ Show hidden items ” diaktifkan)

Seleksi

  • Notebook Navigator: Select next file Memindahkan pilihan ke file berikutnya dalam folder atau tampilan tag saat ini. Menghormati urutan pengurutan khusus. Saran: Ikat ke tombol pintasan seperti Option+Cmd+Right untuk membuka file berikutnya dengan cepat dalam daftar
  • Notebook Navigator: Select previous file Memindahkan pilihan ke file sebelumnya dalam folder atau tampilan tag saat ini. Menghormati urutan pengurutan khusus. Saran: Ikat ke tombol pintasan seperti Option+Cmd+Left untuk membuka file sebelumnya dengan cepat dalam daftar

Tata letak & tampilan

  • Notebook Navigator: Toggle dual pane layout Beralih antara tata letak satu panel dan dua panel (desktop dan tablet). Saran: Tetapkan pintasan keyboard seperti Cmd/Ctrl+Shift+A untuk beralih dengan cepat antara tata letak satu panel dan dua panel
  • Notebook Navigator: Toggle dual pane orientation Beralih orientasi panel ganda antara horizontal dan vertikal
  • Notebook Navigator: Toggle descendants Mengalihkan tampilan catatan subfolder/turunan untuk folder dan tag. Saran: Ikat ke tombol pintasan seperti Cmd/Ctrl+Shift+D untuk beralih tampilan catatan dari subfolder / turunan dengan cepat
  • Notebook Navigator: Toggle hidden folders, tags, and notes Menampilkan atau menyembunyikan folder tersembunyi, tag, dan catatan
  • Notebook Navigator: Toggle tag sort order Beralih antara pengurutan tag berdasarkan abjad dan frekuensi
  • Notebook Navigator: Toggle tags by selection Beralih membatasi tag yang ditemukan di catatan dalam folder atau properti yang dipilih
  • Notebook Navigator: Toggle properties by selection Beralihlah ke properti pembatas yang ditemukan di catatan dalam folder atau tag yang dipilih
  • Notebook Navigator: Toggle compact mode Beralih mode daftar antara standar dan ringkas
  • Notebook Navigator: Toggle pinned section Menampilkan atau menyembunyikan catatan yang disematkan di panel daftar
  • Notebook Navigator: Collapse / expand all navigation items Menyembunyikan atau menampilkan semua item navigasi sesuai dengan status saat ini. Jika opsi " Keep selected item expanded " diaktifkan (secara default aktif), semua folder kecuali folder yang sedang dipilih akan disembunyikan. Fitur ini berguna untuk menjaga pohon navigasi tetap rapi saat mencari dokumen
  • Notebook Navigator: Collapse / expand selected item Menciutkan atau memperluas item navigasi yang dipilih

Kalender

  • Notebook Navigator: Toggle calendar Mengaktifkan atau menonaktifkan kalender. Saran: Mengikat ke tombol pintasan seperti Cmd/Ctrl+Shift+C untuk menampilkan kalender dengan cepat
  • Notebook Navigator: Open daily note Membuka catatan harian hari ini berdasarkan pengaturan kalender. Membuat catatan jika tidak ada
  • Notebook Navigator: Open weekly note Membuka catatan mingguan saat ini. Membuat catatan jika tidak ada
  • Notebook Navigator: Open monthly note Membuka catatan bulanan saat ini. Membuat catatan jika catatan tersebut tidak ada
  • Notebook Navigator: Open quarterly note Membuka catatan triwulanan saat ini. Membuat catatan jika catatan tersebut tidak ada
  • Notebook Navigator: Open yearly note Membuka catatan tahunan saat ini. Membuat catatan jika catatan tersebut tidak ada

Operasi file

Penting: Obsidian tidak memiliki konteks "folder atau tag saat ini", sehingga saat membuat catatan di Obsidian secara default, catatan akan dibuat di folder root, folder yang sama dengan file saat ini, atau folder tertentu. Saat bekerja dengan Notebook Navigator, Anda selalu ingin membuat catatan baru di folder atau tag yang sedang dipilih, sehingga hal pertama yang harus Anda lakukan adalah mengikat Cmd/Ctrl+N ke Notebook Navigator: Create new note sehingga catatan baru selalu dibuat di folder atau tag yang sedang dipilih. Hal yang sama juga berlaku untuk memindahkan dan menghapus file. Inilah alasan mengapa Anda harus menggunakan perintah ini, bukan perintah bawaan Obsidian saat menggunakan Notebook Navigator.

  • Notebook Navigator: Create new note Membuat catatan di folder yang sedang dipilih. Saran: Ikat Cmd/Ctrl+N ke perintah ini (lepaskan ikatan dari "Buat catatan baru" default Obsidian terlebih dahulu)
  • Notebook Navigator: Create new note from template Membuat catatan dari templat di folder yang saat ini dipilih (memerlukan Templater)
  • Notebook Navigator: Move files Memindahkan file yang dipilih ke folder lain. Memilih file berikutnya dalam folder saat ini
  • Notebook Navigator: Merge notes Membuat satu catatan dari catatan Penurunan Harga yang dipilih dalam urutan daftar saat ini
  • Notebook Navigator: Convert to folder note Buat folder yang cocok dengan nama file dan pindahkan file ke dalam sebagai catatan folder
  • Notebook Navigator: Set as folder note Ubah nama file aktif menjadi nama catatan foldernya
  • Notebook Navigator: Detach folder note Lepaskan catatan folder di folder yang dipilih dan ganti namanya
  • Notebook Navigator: Pin all folder notes Sematkan semua catatan folder di semua folder. Perintah ini hanya terlihat jika catatan folder diaktifkan
  • Notebook Navigator: Delete files Menghapus file yang dipilih. Memilih file berikutnya dalam folder saat ini

Operasi tag

  • Notebook Navigator: Add tag to selected files Dialog untuk menambahkan tag ke file yang dipilih. Mendukung pembuatan tag baru
  • Notebook Navigator: Set property on selected files Dialog untuk mengatur properti pada file yang dipilih
  • Notebook Navigator: Remove tag from selected files Dialog untuk menghapus tag tertentu. Menghapus segera jika hanya satu tag
  • Notebook Navigator: Remove all tags from selected files Menghapus semua tag dari file yang dipilih dengan konfirmasi

Pemeliharaan

  • Notebook Navigator: Rebuild cache Membangun ulang cache Notebook Navigator lokal. Gunakan ini jika Anda mengalami tag yang hilang, pratinjau yang salah, atau gambar fitur yang hilang
  • Notebook Navigator: Restore default settings Mengganti berkas pengaturan dengan nilai default yang telah diverifikasi setelah menyimpan cadangan yang dilengkapi cap waktu. Perintah ini hanya tersedia jika Notebook Navigator tidak dapat membaca pengaturannya dan terhenti saat proses startup

8.1 ID Perintah

ID Perintah Nama perintah
notebook-navigator:open Navigator Notebook: Buka
notebook-navigator:toggle-left-sidebar Navigator Notebook: Aktifkan/Nonaktifkan bilah samping kiri
notebook-navigator:open-homepage Navigator Notebook: Buka halaman beranda
notebook-navigator:select-profile Navigator Notebook: Pilih profil vault
notebook-navigator:select-profile-1 Navigator Notebook: Pilih profil vault 1
notebook-navigator:select-profile-2 Navigator Notebook: Pilih profil vault 2
notebook-navigator:select-profile-3 Navigator Notebook: Pilih profil vault 3
notebook-navigator:reveal-file Notebook Navigator: Tampilkan file
notebook-navigator:open-all-files Navigator Notebook: Buka semua file
notebook-navigator:navigate-to-folder Navigator Notebook: Arahkan ke folder
notebook-navigator:navigate-to-tag Navigator Notebook: Arahkan ke tag
notebook-navigator:navigate-to-property Navigator Notebook: Arahkan ke properti
notebook-navigator:navigate-back Navigator Notebook: Kembali
notebook-navigator:navigate-forward Navigator Notebook: Buka ke depan
notebook-navigator:add-shortcut Navigator Notebook: Tambahkan ke pintasan
notebook-navigator:open-shortcut-1 Navigator Notebook: Buka pintasan 1
notebook-navigator:open-shortcut-2 Navigator Notebook: Buka pintasan 2
notebook-navigator:open-shortcut-3 Navigator Notebook: Buka pintasan 3
notebook-navigator:open-shortcut-4 Navigator Notebook: Buka pintasan 4
notebook-navigator:open-shortcut-5 Navigator Notebook: Buka pintasan 5
notebook-navigator:open-shortcut-6 Navigator Notebook: Buka pintasan 6
notebook-navigator:open-shortcut-7 Navigator Notebook: Buka pintasan 7
notebook-navigator:open-shortcut-8 Navigator Notebook: Buka pintasan 8
notebook-navigator:open-shortcut-9 Navigator Notebook: Buka pintasan 9
notebook-navigator:search Navigator Notebook: Cari
notebook-navigator:search-vault Navigator Notebook: Cari di seluruh vault
notebook-navigator:toggle-dual-pane Navigator Notebook: Beralih ke tata letak dua panel
notebook-navigator:toggle-dual-pane-orientation Notebook Navigator: Aktifkan/nonaktifkan orientasi panel ganda
notebook-navigator:toggle-calendar Navigator Notebook: Aktifkan/nonaktifkan kalender
notebook-navigator:open-daily-note Navigator Buku Catatan: Buka catatan harian
notebook-navigator:open-weekly-note Navigator Buku Catatan: Buka catatan mingguan
notebook-navigator:open-monthly-note Navigator Buku Catatan: Buka catatan bulanan
notebook-navigator:open-quarterly-note Navigator Buku Catatan: Buka catatan triwulanan
notebook-navigator:open-yearly-note Navigator Buku Catatan: Buka catatan tahunan
notebook-navigator:toggle-descendants Navigator Buku Catatan: Aktifkan/nonaktifkan catatan turunan
notebook-navigator:toggle-hidden Navigator Buku Catatan: Aktifkan/nonaktifkan folder tersembunyi, tag, dan catatan
notebook-navigator:toggle-tag-sort Navigator Buku Catatan: Aktifkan/nonaktifkan urutan penyortiran tag
notebook-navigator:toggle-tags-by-selection Navigator Buku Catatan: Aktifkan/nonaktifkan tag berdasarkan pilihan
notebook-navigator:toggle-properties-by-selection Navigator Buku Catatan: Aktifkan/nonaktifkan properti berdasarkan pilihan
notebook-navigator:toggle-compact-mode Navigator Buku Catatan: Aktifkan/nonaktifkan mode ringkas
notebook-navigator:toggle-pinned-section Navigator Buku Catatan: Aktifkan/nonaktifkan bagian yang disematkan
notebook-navigator:collapse-expand-list-groups Navigator Buku Catatan: Lipat / Perluas semua grup daftar
notebook-navigator:collapse-expand Navigator Buku Catatan: Lipat / Perluas semua item navigasi
notebook-navigator:collapse-expand-selected-item Navigator Notebook: Lipat / Perluas item yang dipilih
notebook-navigator:new-note Navigator Notebook: Buat catatan baru
notebook-navigator:new-note-from-template Navigator Buku Catatan: Buat catatan baru dari templat
notebook-navigator:move-files Navigator Buku Catatan: Pindahkan berkas
notebook-navigator:merge-notes Navigator Buku Catatan: Gabungkan catatan
notebook-navigator:select-next-file Navigator Buku Catatan: Pilih file berikutnya
notebook-navigator:select-previous-file Navigator Buku Catatan: Pilih file sebelumnya
notebook-navigator:convert-to-folder-note Navigator Buku Catatan: Konversi menjadi catatan folder
notebook-navigator:set-as-folder-note Navigator Buku Catatan: Tetapkan sebagai catatan folder
notebook-navigator:detach-folder-note Navigator Buku Catatan: Lepaskan catatan folder
notebook-navigator:pin-all-folder-notes Navigator Buku Catatan: Sematkan semua catatan folder
notebook-navigator:delete-files Navigator Buku Catatan: Hapus file
notebook-navigator:add-tag Notebook Navigator: Tambahkan tag ke file yang dipilih
notebook-navigator:set-property Notebook Navigator: Atur properti pada file yang dipilih
notebook-navigator:remove-tag Navigator Notebook: Hapus tag dari file yang dipilih
notebook-navigator:remove-all-tags Notebook Navigator: Hapus semua tag dari file yang dipilih
notebook-navigator:rebuild-cache Notebook Navigator: Membangun ulang cache
notebook-navigator:restore-default-settings Notebook Navigator: Kembalikan pengaturan default

9 Fitur

9.1 Antarmuka

  • Tata letak panel ganda - Panel navigasi (folder/tag/properti) dan panel daftar (file)
  • Mode panel tunggal - Tampilan navigasi dan daftar dengan transisi animasi
  • Panel yang dapat diubah ukurannya - Orientasi pemisahan horizontal atau vertikal
  • Zoom UI independen - Scale Notebook Navigator tanpa mengubah zoom Obsidian
  • Tampilan awal panel tunggal - Panel navigasi atau panel daftar
  • Dukungan multi-bahasa - 21 bahasa dengan dukungan tata letak RTL
  • Set ikon antarmuka - Ikon UI yang dapat disesuaikan di seluruh plugin

9.2 Navigasi

  • Profil Vault - Beberapa tampilan yang difilter dengan folder/tag/catatan tersembunyi per profil, visibilitas file, spanduk, dan pintasan
  • Pintasan - Catatan, folder, tag, properti, dan pencarian yang disimpan, lengkap dengan fitur penandaan dan pengurutan ulang
  • Catatan/file terbaru - Bagian item terbaru yang disimpan per profil vault, secara opsional disematkan dengan pintasan
  • Kalender - Kalender catatan harian dengan pilihan hari, pratinjau gambar fitur, dan dukungan pemisahan vertikal
  • Pohon folder - Perluas/ciutkan navigasi dengan urutan folder root manual
  • Pohon tag - Tag hierarkis dengan urutan tag akar yang dapat dikonfigurasi
  • Browser properti - Jelajahi properti file yang diatur berdasarkan kunci dan nilai dengan jumlah file, warna khusus, ikon, dan seret dan lepas
  • Menampilkan file aktif secara otomatis - Perluasan folder dan gulir ke pilihan
  • Papan ketik dan perintah - Tombol pintas yang dapat dikonfigurasi, riwayat pilihan perintah mundur/maju, perintah file berikutnya/sebelumnya, perintah pintasan terbuka 1-9

9.3 Organisasi

  • Sematkancatatan - Menyimpan catatan penting di bagian atas folder dan tag
  • Catatan folder - Mengatur/melepaskan catatan folder, menyematkan catatan folder, membuka di tab baru pilihan
  • Operasi tag - Menambah/menghapus/menghapus tag, mengganti nama/menghapus tag, membuat catatan di dalam tag, hirarki tag seret dan lepas
  • Pengurutandan pengelompokan kustom - Mengesampingkan pengaturan pengurutan/pengelompokan per folder atau tag
  • Tampilan per-folder/tag - Baris judul, baris pratinjau, mode ringkas, sakelar keturunan
  • Konten tersembunyi - Folder/tag/catatan/file tersembunyi dengan pola, properti frontmatter, dan pemfilteran berbasis tag per profil vault
  • Kecualikan folder dari folder-folder di bawahnya - Abaikan folder saat mengumpulkan catatan dari subfolder, sesuai profil vault; folder yang dikecualikan tetap terlihat dan menampilkan catatannya saat dipilih
  • Sistem warna dan ikon - Warna folder/tag/properti/file, paket ikon, ikon emoji/Lucide, baca/tulis di bagian depan, pemetaan ikon berdasarkan nama file dan kategori jenis file
  • Peringatan nama - Memperingatkan tentang karakter sistem berkas yang dilarang dan karakter yang memutus tautan Obsidian saat memberi nama file dan folder

9.4 Tampilan file

  • Pratinjau catatan - 1-5 baris pratinjau dengan pengupasan HTML opsional
  • Gambar mini - Gambar unggulan serta gambar mini yang dibuat secara otomatis untuk berkas PDF, SVG, dan gambar yang disimpan dalam cache metadata
  • Gambar eksternal - Unduhan opsional untuk gambar eksternal dan gambar mini YouTube
  • Pengelompokan tanggal - Kelompokkan catatan berdasarkan Hari Ini, Kemarin, 7 hari sebelumnya, 30 hari sebelumnya, bulan, dan tahun ketika diurutkan berdasarkan tanggal
  • Pengelompokan berdasarkan properti - Mengelompokkan catatan berdasarkan nilai properti pada bagian awal, sesuai dengan fitur "group by" di Obsidian Bases: catatan yang memiliki nilai yang sama akan dikumpulkan di bawah satu judul, catatan yang tidak memiliki properti tersebut akan dimasukkan ke dalam kelompok "None" di bagian akhir, dan kelompok-kelompok tersebut diurutkan berdasarkan nilai dengan urutan alami
  • Dukungan frontmatter - Membaca nama catatan dan stempel waktu dari bidang frontmatter
  • Catatan metadata - Menampilkan tanggal modifikasi dan tag dalam daftar file
  • Status tugas - Tampilkan kemajuan tugas dalam baris standar dan, jika diinginkan, ganti ikon file untuk tugas yang belum selesai dalam mode tampilan ringkas atau semua
  • Properti khusus - Menampilkan properti frontmatter atau jumlah kata dalam daftar file dengan penggantian per-folder/tag dan warna khusus
  • Tampilan folder induk - Nama dan ikon folder induk (opsional) dalam daftar file
  • Mode Ringkas - Tampilan ringkas ketika pratinjau, tanggal, dan gambar dinonaktifkan
  • Tag yang dapat diklik - Tag dalam daftar file menavigasi langsung ke tag tersebut

9.5 Produktivitas

  • Pencarian - Saring berdasarkan nama file, alias, tag, properti, tanggal, folder, ekstensi, dan tugas dengan operator AND/OR/pengecualian
  • Integrasi Omnisearch - Pencarian teks lengkap melalui Omnisearch
  • Seret dan lepas - Pemindahan file, penandaan, penetapan pintasan, perbaikan pohon tag, folder pegas
  • Menu konteks - Membuat catatan/folder/kotak/dasar/gambar dan menjalankan tindakan file/tag
  • Gambar - Membuat gambar Excalidraw dan Tldraw dari menu navigasi dan panel daftar
  • Templat - Catatan baru dari perintah templat dengan plugin Templater
  • Operasi file - Membuat, mengganti nama, menduplikasi, memindahkan, membuang file dan folder
  • Pemfilteran - Pengecualian folder/tag/catatan/file dengan pola dan properti frontmatter

10 Pengungkapan Jaringan dan Diagnostik

Notebook Navigator berjalan secara lokal, namun beberapa fitur membuat permintaan HTTP dari Obsidian. Pencatatan debug startup juga dapat menulis file diagnostik lokal di brankas Anda.

10.1 Pemeriksaan pembaruan rilis (Opsional)

  • Pengaturan: "Periksa versi baru saat memulai"
  • Permintaan: https://api.github.com/repos/johansan/notebook-navigator/releases/latest
  • Frekuensi: Paling banyak sekali per 24 jam, saat pengaktifan
  • Data: Mengirimkan metadata HTTP standar; tidak termasuk konten vault

10.2 Unduhan paket ikon (Opsional)

  • Pengaturan: Mengaktifkan paket ikon di tab Paket Ikon
  • Permintaan: https://raw.githubusercontent.com/johansan/notebook-navigator/main/icon-assets/... (manifes, font, metadata)
  • Penyimpanan: Disimpan secara lokal di IndexedDB

10.3 Gambar, video, dan gambar mini YouTube dari sumber eksternal

  • Menampilkan gambar (Opsional): Dikendalikan oleh pengaturan "Unduh gambar eksternal". Mengunduh gambar jarak jauh dan gambar mini YouTube untuk gambar fitur dan menyimpannya secara lokal di IndexedDB.
  • Jendela pop-up selamat datang (Saat pertama kali dibuka): Memuat gambar mini YouTube dari https://img.youtube.com/vi/<id>/....
  • Modal "Apa yang Baru" (Saat diperbarui / saat dibuka): Memuat gambar spanduk rilis dari https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/version-banners/<filename> menggunakan nama file dan ekstensi yang disebutkan dalam catatan rilis.
  • Modal "Apa yang Baru" (Saat diperbarui / saat dibuka): Memuat video rilis dari https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/version-banners/<id>.mp4 untuk catatan rilis yang menyertakan video.
  • Modal "Apa yang Baru" (Saat membuka video pengumuman): Membuka video pengumuman dari https://cdn.jsdelivr.net/gh/johansan/notebook-navigator@main/images/version-banners/<id>.mp4 sehingga peramban dapat memutar video tersebut secara langsung.
  • Modal What's New (Pada pembaruan / saat dibuka): Memuat gambar mini YouTube dari https://img.youtube.com/vi/<id>/... untuk catatan rilis yang menyertakan tautan YouTube.

10.4 File debug startup (Opsional)

  • Pengaturan: "Pencatatan debug startup"
  • Penyimpanan: Menulis file nn-debug-...md dengan cap waktu di root vault, lalu berhenti setelah pengaktifan selesai. File ini dapat disinkronkan jika root vault disinkronkan.
  • Data: Termasuk waktu startup, versi plugin, versi minimum Obsidian yang didukung, platform, jumlah cache, jumlah antrean, status IndexedDB, dan kesalahan diagnostik. Tidak termasuk konten catatan, nama tag, nilai frontmatter, atau daftar file vault.
  • Jalur dan pengidentifikasi: Inisialisasi awal, diagnostik PDF, dan kasus kesalahan dapat menyertakan pengidentifikasi aplikasi/vault Obsidian, jalur PDF relatif vault, atau detail tumpukan kesalahan. Tinjau dan edit file sebelum membagikannya secara publik.
  • Unggah: Notebook Navigator tidak mengupload file debug. File tersebut hanya dibagikan jika Anda mengunggah, melampirkan, atau menyinkronkannya di luar plugin.

10.5 Privasi dan penanganan data

  • Notebook Navigator tidak mengirim konten catatan, nama file, tag, atau file debug ke server Notebook Navigator.
  • Permintaan ke GitHub, YouTube, dan host gambar eksternal lainnya dibuat langsung dari perangkat Anda dan menyertakan metadata HTTP standar (alamat IP, agen-pengguna, dan sejenisnya).
  • Paket ikon dan gambar yang diunduh disimpan secara lokal (IndexedDB). Catatan/file terbaru dan status UI disimpan secara lokal (penyimpanan lokal Obsidian).

11 Kontak

Notebook Navigator dibuat dan dikelola oleh Johan Sanneblad. Johan memiliki gelar PhD dalam bidang Pengembangan Perangkat Lunak dan telah bekerja dalam pengembangan inovasi untuk perusahaan seperti Apple, Electronic Arts, Google, Microsoft, Lego, SKF, Volvo Cars, Volvo Group, dan Yamaha.

Jangan ragu untuk terhubung dengan saya di LinkedIn.


12 Pertanyaan atau masalah?

Baca bagian Pertanyaan yang Sering Diajukan (FAQ) untuk mengetahui jawaban atas pertanyaan-pertanyaan umum.

Bergabunglah dengan Discord kami untuk mendapatkan dukungan dan diskusi, atau buka masalah direpositori GitHub.

Pull request tidak diterima. Seiring munculnya pendekatan pemrograman berbasis agen, pengiriman kode dari pihak luar tidak dapat dikontrol kualitasnya sesuai standar yang diterapkan proyek ini, sehingga setiap pull request akan ditutup secara otomatis. Silakan sampaikan ide Anda sebagai permintaan fitur — buka sebuah issue. Lihat berkas CONTRIBUTING.md untuk detailnya.


13 Lisensi

Proyek ini dilisensikan di bawah Lisensi Publik Umum GNU v3.0 - lihat berkas LICENSE untuk detailnya.