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

Memfilter file berdasarkan nama, tag, properti, tanggal, folder, ekstensi, dan tugas di dalam folder dan subfolder saat ini. Mode pencarian default.

Nama file

  • word - Mencocokkan catatan dengan "kata" dalam nama file
  • word1 word2 - Mewajibkan setiap kata agar sesuai dengan nama file
  • -word - Kecualikan catatan dengan "kata" dalam nama file

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 - Menyertakan catatan dengan kunci properti
  • .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 - Mengecualikan catatan dengan kunci properti
  • -.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 hanya dikirim ke Omnisearch untuk jalur ASCII sederhana. Jalur lainnya disaring setelah Omnisearch menampilkan hasilnya
  • Hasil terbatas - Omnisearch mencari seluruh brankas dan mengembalikan sejumlah hasil sebelum memfilter, sehingga file yang relevan dari folder saat ini mungkin tidak muncul jika banyak kecocokan di tempat lain
  • 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: 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 akar vault dan membuka fitur pencarian dengan menyertakan subfolder (harus mengaktifkan opsi " Show root folder ")

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 tata letak panel tunggal/ganda (desktop). Saran: Ikat ke tombol pintasan seperti Cmd/Ctrl+Shift+A untuk beralih dengan cepat antara tata letak panel tunggal dan panel ganda
  • 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 items Menciutkan atau memperluas semua item berdasarkan status saat ini. Ketika Keep selected item expanded diaktifkan (default), semua folder kecuali folder saat ini akan diciutkan. Hal ini berguna untuk menjaga agar 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

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 Notebook Navigator: Buka pintasan 9
notebook-navigator:search Navigator Notebook: Cari
notebook-navigator:search-vault Notebook Navigator: Cari di seluruh vault
notebook-navigator:toggle-dual-pane Notebook Navigator: Aktifkan/nonaktifkan 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 Notebook Navigator: Buka catatan triwulanan
notebook-navigator:open-yearly-note Navigator Buku Catatan: Buka catatan tahunan
notebook-navigator:toggle-descendants Notebook Navigator: Aktifkan/nonaktifkan 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 Navigator Buku Catatan: Lipat / Perluas semua item
notebook-navigator:collapse-expand-selected-item Navigator Buku Catatan: 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 Notebook Navigator: 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

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 permulaan - Navigasi-dahulu atau daftar-dahulu
  • 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
  • Dukungan frontmatter - Membaca nama catatan dan stempel waktu dari bidang frontmatter
  • Catatan metadata - Menampilkan tanggal modifikasi dan tag dalam daftar file
  • 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 - Filter berdasarkan nama file, tag, properti, tanggal, folder, ekstensi, dan tugas dengan pengecualian DAN/atau
  • 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.
  • Modal selamat datang (Peluncuran pertama): Memuat gambar mini statis dari https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/youtube-thumbnail.jpg.
  • Modal apa yang baru (Pada pembaruan / saat dibuka): Memuat gambar spanduk rilis dari https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/version-banners/<id>.jpg untuk catatan rilis yang menyertakan spanduk.
  • 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 Sejarah Bintang

Star History Chart


12 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.


13 Pertanyaan atau masalah?

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.


14 Lisensi

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