Покажчик документації

Основна документація

  • README (цей документ)

Документація для розробників

  • Довідка по API - Публічна документація API. Охоплює управління метаданими, навігацією та підписками на події для розробників JavaScript/TypeScript.
  • Посібник з розробки тем - Посібник для розробників тем. Містить посилання на класи CSS, користувацькі властивості та приклади тем для світлих і темних режимів.
  • Процес запуску - Послідовність ініціалізації плагіна. Потоки холодного та теплого завантаження, роздільна здатність кешу метаданих, відкладене очищення та конвеєр генерації вмісту. Включає діаграми Mermaid.
  • Конвеєр метаданих - Послідовність відновлення кешу, етапи конвеєра провайдера та сигнали завершення. Включає діаграми Mermaid.
  • Архітектура сховища - Посібник по контейнерах для зберігання даних (IndexedDB, Локальне сховище, Кеш пам'яті, Налаштування). Шаблони потоків даних та рекомендації щодо використання.
  • Архітектура рендерингу - Ієрархія компонентів React, віртуальний скролінг за допомогою TanStack Virtual, оптимізація продуктивності та потоку даних.
  • Оркестрування прокрутки - Як плагін забезпечує точну прокрутку при зміні структури дерева (видимості тегів, налаштувань тощо)
  • Архітектура сервісів - Рівень бізнес-логіки: MetadataService, FileSystemOperations, ContentProviderRegistry. Патерни ін'єкції залежностей та потік даних сервісів.

1 Встановлення

  1. Встановіть Obsidian - завантажте та встановіть з obsidian.md
  2. Увімкніть плагіни спільноти - перейдіть до Налаштування → Плагіни спільноти → Увімкнути плагіни спільноти
  3. Встановіть Notebook Navigator - Натисніть "Огляд" → Пошук "Notebook Navigator" → Встановити
  4. Встановлення налаштувань стилю (необов'язково) - щоб налаштувати кольори та зовнішній вигляд, встановіть плагін "Налаштування стилю ", знайшовши "Налаштування стилю" у розділі "Плагіни спільноти"

2 Початок роботи

Ось офіційний посібник з вивчення та освоєння Notebook Navigator:

Mastering Notebook Navigator

Відео має субтитри 21 мовою.


3 Безпека та якість

Notebook Navigator перевіряється за допомогою TypeScript, ESLint з офіційним плагіном Obsidian ESLint, Prettier, Vitest та виробничої збірки перед злиттям змін. Збірка повинна завершитися без помилок і попереджень.

Перевірки безпеки виконуються через CodeQL, з історією сканування в робочому процесі CodeQL, що виконується, і картою оцінювання OpenSSF. Поточний статус відображається у значках у верхній частині цієї сторінки.

Notebook Navigator працює локально, але деякі функції роблять задокументовані HTTP-запити на оновлення, завантаження та віддалений вміст. Повний список див. у розділі 10 - Відомості про мережу та діагностику.


Зміст


4 Комбінації клавіш

Ключ Дія
↑/↓ Перехід вгору/вниз у поточній панелі
У панелі навігації: згорнути або перейти до батьківського елемента У панелі списку: перейти до панелі навігації
У панелі навігації: розгорнути або перейти до панелі списку У панелі списку: перейти до редактора
Вкладка У панелі навігації: перейти до панелі списку У панелі списку: перейти до редактора У полі пошуку: перейти до панелі списку
Shift+Tab У панелі списку: перейти до панелі навігації У полі пошуку: перейти до панелі навігації
Enter (macOS) F2 (Windows/Linux) Перейменувати елемент безпосередньо у панелі навігації або панелі списку
Enter У панелі навігації: відкрити примітку до папки у Windows/Linux за замовчуванням (якщо функція увімкнена) У панелі списку: відкрити вибраний файл на всіх системах (якщо функція увімкнена) У полі пошуку: перейти до панелі списку
Esc У полі пошуку: закрити пошук і перевести фокус на панель списку
PageUp/PageDown Прокрутка вгору/вниз у панелі навігації та панелі списку
Home/End Перейти до першого/останнього елемента в поточній панелі
Видалити « » (Видалити « ») Backspace Видалити вибраний елемент
Cmd/Ctrl+A Виділити всі нотатки в поточній папці
Cmd/Ctrl+клацнути Перемикання вибору нотаток
Shift+клацнути Виділити діапазон нотаток
Shift+Home/End Виділити від поточної позиції до першого/останнього елемента
Shift+↑/↓ Розширити виділення вгору/вниз
Cmd/Ctrl+↑/↓ Перегрупувати вибрані файли вгору/вниз у режимі ручного сортування

Примітка: Усі комбінації клавіш можна налаштувати. Докладні відомості про додавання навігації у стилі VIM (h,j,k,l), альтернативних клавіш і комбінацій модифікаторів див. у розділі 7 - Користувацькі гарячі клавіші.


5 Синхронізовані та локальні налаштування

Багато налаштувань у Навігаторі ноутбука відображають перемикач синхронізації - значок хмари, який перемикається між "Увімкнути синхронізацію" та "Вимкнути синхронізацію". Це дозволяє контролювати, де зберігається кожен параметр і чи буде він доступний на різних пристроях.

5.1 Як працює синхронізація

Плагіни Obsidian зберігають свою конфігурацію у файлі data.json, розташованому за адресою .obsidian/plugins/notebook-navigator/data.json у папці вашого сховища. Коли ви використовуєте службу синхронізації - наприклад, Obsidian Sync, iCloud, GitHub, Dropbox або Google Drive - цей файл синхронізується на всіх ваших пристроях разом з рештою вашого сховища. Будь-які налаштування, збережені на data.json, будуть поширюватися на всі пристрої, які синхронізують сховище.

Screenshot 2026-02-18 at 22 58 05

Якщо синхронізація ввімкнена (за замовчуванням) для параметра, значення зберігається на data.json і синхронізується з усіма пристроями за допомогою служби синхронізації.

Screenshot 2026-02-18 at 22 58 14

Якщо синхронізацію для параметра вимкнено, значення зберігається у локальному сховищі Obsidian. Локальне сховище залежить від пристрою і не включається до синхронізації сховища. Параметр матиме власне незалежне значення на кожному пристрої. Коли ви вимикаєте синхронізацію для параметра, поточне значення копіюється до локального сховища на поточному пристрої, а значення видаляється з data.json, щоб запобігти перевизначенню локальних значень на інших пристроях.

Якщо ви не використовуєте службу синхронізації, перемикач синхронізації не має практичного ефекту, оскільки data.json зберігається лише локально.


6 Пошук

Notebook Navigator має два режими пошуку: пошук за фільтрами та всеохоплюючий пошук. Перемикайтеся між ними за допомогою клавіш зі стрілками вгору/вниз або клацнувши піктограму пошуку. Об'єднуйте імена файлів, властивості, теги, дати і фільтри в одному запиті (наприклад, meeting .status=active #work @thisweek).

6.1 Фільтр пошуку

Фільтрує файли за іменами, тегами, властивостями, датами, теками, розширеннями та завданнями у поточній теці та підтеках. Режим пошуку за замовчуванням.

Імена файлів

  • word - Зіставте нотатки зі словом "word" у назві файлу
  • word1 word2 - Вимагати, щоб кожне слово збігалося з назвою файлу
  • -word - Виключити нотатки зі словом "word" у назві файлу

Теги

  • #tag - Включати нотатки з тегом (також відповідає вкладеним тегам, таким як #tag/subtag)
  • # - Включати тільки позначені нотатки
  • -#tag - Виключити нотатки з тегом
  • -# - Додавайте лише немарковані нотатки
  • #tag1 #tag2 - Збіг обох тегів (неявне І)
  • #tag1 AND #tag2 - Збіг обох тегів (явне AND)
  • #tag1 OR #tag2 - Збігається з будь-яким тегом
  • #a OR #b AND #c - AND має вищий пріоритет: збігається з #a, або з обома #b та #c
  • Cmd/Ctrl+Клікніть тег, щоб додати AND. Cmd/Ctrl+Shift+Клікніть, щоб додати OR

Властивості

  • .key - Включити нотатки з ключем властивостей
  • .key=value - Включіть примітки, де вартість нерухомості містить value
  • ."Reading Status" - Ключ властивості з пробілами (у подвійних лапках)
  • ."Reading Status"="In Progress" - Ключі та значення з пробілами повинні бути взяті в подвійні лапки
  • -.key - Виключити нотатки з ключем властивості
  • -.key=value - Виключити нотатки, де вартість майна містить value
  • Cmd/Ctrl+Клікніть на властивості, щоб додати за допомогою AND. Cmd/Ctrl+Shift+Клікніть, щоб додати АБО

Фільтри

  • has:task - Включіть нотатки з незавершеними завданнями
  • -has:task - Виключити нотатки з незавершеними завданнями
  • folder:meetings - Включайте примітки, в яких назва папки містить meetings
  • folder:/work/meetings - Додавайте нотатки лише до work/meetings (не до підпапок)
  • folder:/ - Включайте нотатки лише до кореня сховища
  • -folder:archive - Виключити нотатки, в яких назва теки містить archive
  • -folder:/archive - Виключити нотатки тільки в archive (не в підкаталогах)
  • ext:md - Додавайте нотатки з розширенням md (ext:.md також підтримується)
  • -ext:pdf - Виключити нотатки з розширенням pdf
  • Поєднуйте з тегами, іменами та датами (наприклад, folder:/work/meetings ext:md @thisweek)

Дати

  • @today - Зіставити нотатки з сьогоднішнім днем, використовуючи поле дати за замовчуванням
  • @yesterday, @last7d, @last30d, @thisweek, @thismonth - Відносні діапазони дат
  • @2026-02-07 - Матч одного дня (також підтримує @20260207)
  • @2026 - Зіставте календарний рік
  • @2026-02 або @202602 - Підібрати календарний місяць
  • @2026-W05 або @2026W05 - Підберіть тиждень ISO
  • @2026-Q2 або @2026Q2 - зіставте з календарним кварталом
  • @13/02/2026 - Числові формати з роздільниками (@07022026 слідує вашій локалі, якщо це неоднозначно)
  • @2026-02-01..2026-02-07 - Відповідність діапазону включно з днем (підтримуються відкриті кінці)
  • @c:... або @m:... - дата створення або зміни цілі
  • -@... - Виключити збіг дат

Поле дати за замовчуванням відповідає поточному порядку сортування. При сортуванні за назвою поле дати налаштовується в Налаштуваннях → Примітки → Дата → При сортуванні за назвою.

І/або поведінка

AND та OR працюють у запитах лише за тегами/властивостями (запитах, що містять лише фільтри #tag, -#tag, #, -#, .key, -.key, .key=value або -.key=value ). Якщо запит також містить імена, дати, фільтри завдань, папок або розширень, AND і OR будуть використані як слова імені файлу.

  • Запит оператора: #work OR .status=started
  • Змішаний запит: #work OR ext:md (OR збігається з іменами файлів)

6.2 Omnisearch

Повнотекстовий пошук по всьому сховищу з фільтрацією за поточною папкою, підпапками або вибраними тегами. Потрібен плагін Omnisearch. Якщо Omnisearch не встановлено, пошук повернеться до пошуку за фільтрами.

Попередній перегляд нотаток показує уривки результатів Omnisearch замість тексту попереднього перегляду за замовчуванням.

Відомі обмеження

  • Продуктивність - може бути повільною під час пошуку менш ніж 3 символів у великих сховищах
  • Фільтри шляхів — інформація про область дії папки передається до Omnisearch лише для простих ASCII-шляхів. Інші шляхи фільтруються після того, як Omnisearch поверне результати
  • Обмежені результати - Omnisearch шукає по всьому сховищу і повертає обмежену кількість результатів перед фільтрацією, тому відповідні файли з поточної папки можуть не з'явитися, якщо багато збігів є в інших місцях
  • Попередній перегляд тексту - попередній перегляд нотаток замінюється фрагментами результатів пошуку Omnisearch, які можуть не відображати фактичне виділення збігу пошуку, якщо воно з'являється в іншому місці файлу

7 користувацьких гарячих клавіш

Відредагуйте .obsidian/plugins/notebook-navigator/data.json, щоб налаштувати гарячі клавіші Навігатора ноутбука. Відкрийте файл і знайдіть розділ keyboardShortcuts. Кожен запис пов'язує дію з одним або кількома сполученнями клавіш:

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

Додайте кілька прив'язок для кожної дії, щоб підтримувати альтернативні ключі, як у прикладі ArrowUp та K вище. Об'єднайте модифікатори в одному записі, перерахувавши кожне значення, наприклад "modifiers": ["Mod", "Shift"]. Послідовності клавіш, такі як gg або dd, не підтримуються. Перезавантажте Obsidian після редагування файлу.

7.1 Модифікатори

Модифікатор Клавіша
Mod Cmd (macOS) / Ctrl (Win/Linux)
Alt Alt / Option
Shift Shift
Ctrl Control (краще Mod для крос-платформних версій)

7.2 Доступні дії

Дія Клавіші за замовчуванням
pane:move-up Стрілка вгору
pane:move-down Стрілка вниз
pane:page-up PageUp
pane:page-down PageDown
pane:home Головна
pane:end Кінець
pane:rename Enter (macOS), F2 (Windows/Linux)
pane:delete-selected Delete, Backspace
navigation:collapse-or-parent Стрілка вліво
navigation:expand-or-focus-list Стрілка вправо
navigation:focus-list Tab
list:focus-navigation Стрілка вліво, Shift+Tab
list:focus-editor Стрілка вправо, Tab
list:select-all Mod+A
list:extend-selection-up Shift+Стрілка вгору
list:extend-selection-down Shift+стрілка вниз
list:manual-sort-up Mod+стрілка вгору
list:manual-sort-down Mod+Стрілка вниз
list:range-to-start Shift+Home
list:range-to-end Shift+End
search:focus-list Tab, Enter
search:focus-navigation Shift+Tab
search:close Esc

8 команд

Встановіть власні гарячі клавіші для цих команд у налаштуваннях гарячих клавіш Obsidian:

Перегляд та навігація

  • Notebook Navigator: Open Відкриває навігатор блокнота на лівій бічній панелі. Якщо його вже відкрито, переносить фокус клавіатури на панель списку. Рекомендація: Прив'яжіть до клавіші швидкого доступу, наприклад Cmd/Ctrl+Shift+E, щоб перемістити фокус клавіатури на панель списку - це важливо для повноцінної клавіатурної навігації
  • Notebook Navigator: Toggle left sidebar Перемикає ліву бічну панель. Під час відкриття встановлює вигляд лівої бічної панелі на Навігатор ноутбука (на відміну від вбудованої команди Obsidian "Перемкнути ліву бічну панель", яка відновлює попередній вигляд лівої бічної панелі)
  • Notebook Navigator: Open homepage Відкриває вікно Навігатора ноутбука та завантажує цільову домашню сторінку, налаштовану в налаштуваннях
  • Notebook Navigator: Select vault profile Відкриває модальне вікно для перемикання між профілями сховища
  • Notebook Navigator: Reveal file Показує поточний файл у навігаторі. Розгортає батьківські теки і прокручує до файлу. Ця команда корисна, якщо у вас вимкнено налаштування Auto-reveal active note і ви хочете показати нотатки вручну. Пропозиція: Прив'язати до клавіші швидкого доступу, наприклад, Cmd/Ctrl+Shift+R, щоб швидко змінити вибрану теку або тег на поточний файл
  • Notebook Navigator: Open all files Відкриває всі нотатки у вибраній теці або тезі. При відкритті 15 або більше файлів показує діалогове вікно підтвердження
  • Notebook Navigator: Navigate to folder Діалогове вікно пошуку для переходу до будь-якої папки
  • Notebook Navigator: Navigate to tag Діалогове вікно пошуку для переходу до будь-якого тегу
  • Notebook Navigator: Navigate to property Діалогове вікно пошуку для переходу до будь-якого ключа або значення властивості
  • Notebook Navigator: Navigate back Перехід до попередньої папки, тегу або вибору властивості в історії навігатора
  • Notebook Navigator: Navigate forward Перехід до наступної папки, тегу або вибору властивості в історії навігатора
  • Notebook Navigator: Add to shortcuts Додає або видаляє поточний файл, папку, тег або властивість з ярликів
  • Notebook Navigator: Open shortcut 1-9 Відкриває ярлик за його позицією у списку ярликів
  • Notebook Navigator: Search Відкриває поле швидкого пошуку або фокусує його, якщо воно вже відкрите. Пошук зберігається між сеансами. Пропозиція: Прив'язати до клавіші швидкого доступу, наприклад Cmd/Ctrl+Shift+S, для швидкого фільтрування файлів
  • Notebook Navigator: Search whole vault Вибирає кореневу папку сховища та відкриває пошук із врахуванням підпапок (необхідно увімкнути функцію « Show root folder »)

Вибір

  • Notebook Navigator: Select next file Переміщує виділення до наступного файлу у поточній теці або поданні тегів. Поважає користувацький порядок сортування. Пропозиція: Прив'язати до клавіші швидкого доступу, наприклад Option+Cmd+Right, для швидкого переходу до наступного файлу у списку
  • Notebook Navigator: Select previous file Переміщує виділення до попереднього файлу у поточній теці або поданні тегів. Поважає користувацький порядок сортування. Пропозиція: Прив'язати до клавіші швидкого доступу, наприклад Option+Cmd+Left, для швидкого переходу до попереднього файлу у списку

Макет та відображення

  • Notebook Navigator: Toggle dual pane layout Перемикання одно-/двопанельної розкладки (робочий стіл). Пропозиція: Прив'язати до клавіші швидкого доступу, наприклад, Cmd/Ctrl+Shift+A, для швидкого перемикання між одно- та двопанельним макетом
  • Notebook Navigator: Toggle dual pane orientation Перемикання орієнтації подвійної панелі між горизонтальною та вертикальною
  • Notebook Navigator: Toggle descendants Увімкнути відображення підтеки / нащадків нотаток для папок і тегів. Пропозиція: Прив'язати до клавіші швидкого доступу на кшталт Cmd/Ctrl+Shift+D для швидкого перемикання відображення нотаток з підтеки / нащадків
  • Notebook Navigator: Toggle hidden folders, tags, and notes Показати або приховати приховані папки, теги та нотатки
  • Notebook Navigator: Toggle tag sort order Перемикання між сортуванням тегів за алфавітом та за частотою використання
  • Notebook Navigator: Toggle tags by selection Увімкнути обмеження тегів до тих, що містяться у нотатках у вибраній теці або властивості
  • Notebook Navigator: Toggle properties by selection Увімкнути обмеження властивостей до тих, що містяться в нотатках у вибраній теці або тезі
  • Notebook Navigator: Toggle compact mode Перемикання режиму списку між стандартним і компактним
  • Notebook Navigator: Toggle pinned section Показати або приховати закріплені нотатки на панелі списку
  • Notebook Navigator: Collapse / expand all items Згорнути або розгорнути всі елементи на основі поточного стану. Якщо увімкнено Keep selected item expanded (за замовчуванням), усі теки, окрім поточної, буде згорнуто. Це зручно, щоб зберегти дерево навігації охайним під час пошуку документів
  • Notebook Navigator: Collapse / expand selected item Згорнути або розгорнути вибраний елемент навігації

Календар

  • Notebook Navigator: Toggle calendar Вмикає або вимикає календар. Пропозиція: Прив'язати до клавіші швидкого доступу на кшталт Cmd/Ctrl+Shift+C, щоб швидко показувати календар
  • Notebook Navigator: Open daily note Відкриває сьогоднішню щоденну нотатку на основі налаштувань календаря. Створює нотатку, якщо її не існує
  • Notebook Navigator: Open weekly note Відкриває поточну щотижневу замітку. Створює замітку, якщо її не існує
  • Notebook Navigator: Open monthly note Відкриває поточну щомісячну замітку. Створює замітку, якщо її не існує
  • Notebook Navigator: Open quarterly note Відкриває поточну квартальну нотатку. Створює записку, якщо її не існує
  • Notebook Navigator: Open yearly note Відкриває поточну річну нотатку. Створює нотатку, якщо її не існує

Файлові операції

Важливо: Obsidian не має контексту "поточна тека або тег", тому при створенні нотаток в Obsidian за замовчуванням вони створюються в кореневій теці, в тій же теці, що і поточний файл, або в певній теці. Під час роботи з Навігатором блокнота ви завжди хочете створювати нові нотатки у поточній папці або тезі, тому перше, що вам слід зробити, це прив'язати Cmd/Ctrl+N до Notebook Navigator: Create new note, щоб нові нотатки завжди створювалися у поточній папці або тезі. Те саме стосується переміщення та видалення файлів. Ось чому вам слід використовувати ці команди замість вбудованих команд Obsidian під час використання Навігатора блокнота.

  • Notebook Navigator: Create new note Створити нотатку у вибраній папці. Пропозиція: Прив'яжіть Cmd/Ctrl+N до цієї команди (спочатку відв'яжіть її від стандартної команди Obsidian "Створити нову нотатку")
  • Notebook Navigator: Create new note from template Створити нотатку з шаблону у вибраній папці (потрібен Templater)
  • Notebook Navigator: Move files Перемістити вибрані файли до іншої теки. Вибирає наступний файл у поточній теці
  • Notebook Navigator: Merge notes Створіть одну примітку з вибраних приміток уцінки в поточному порядку списку
  • Notebook Navigator: Convert to folder note Створіть папку, що відповідає імені файлу, і перемістіть файл всередину як примітку до папки
  • Notebook Navigator: Set as folder note Перейменуйте активний файл на ім'я нотатки в його папці
  • Notebook Navigator: Detach folder note Відокремте примітку до папки у вибраній папці та перейменуйте її
  • Notebook Navigator: Pin all folder notes Закріпити всі примітки до папок у всіх папках. Ця команда відображається лише тоді, коли увімкнено примітки до папок
  • Notebook Navigator: Delete files Видалити вибрані файли. Вибирає наступний файл у поточній теці

Операції з тегами

  • Notebook Navigator: Add tag to selected files Діалогове вікно для додавання тегів до вибраних файлів. Підтримує створення нових тегів
  • Notebook Navigator: Set property on selected files Діалогове вікно для встановлення властивостей для вибраних файлів
  • Notebook Navigator: Remove tag from selected files Діалогове вікно для видалення певної мітки. Видаляє негайно, якщо тільки один тег
  • Notebook Navigator: Remove all tags from selected files Видалити всі теги з вибраних файлів з підтвердженням

Обслуговування

  • Notebook Navigator: Rebuild cache Перебудовує локальний кеш Notebook Navigator. Використовуйте цю команду, якщо ви помітили відсутність тегів, неправильний попередній перегляд або відсутність зображень об'єктів

8.1 Командні ідентифікатори

Ідентифікатор команди Назва команди
notebook-navigator:open Навігатор ноутбука: Відкрити
notebook-navigator:toggle-left-sidebar Навігатор по блокнотах: Перемикання лівої бічної панелі
notebook-navigator:open-homepage Навігатор зошитів: Відкрити головну сторінку
notebook-navigator:select-profile Навігатор Notebook: Вибрати профіль сховища
notebook-navigator:select-profile-1 Навігатор Notebook: Вибрати профіль сховища 1
notebook-navigator:select-profile-2 Навігатор ноутбука: Вибрати профіль сховища 2
notebook-navigator:select-profile-3 Навігатор Notebook: Вибрати профіль сховища 3
notebook-navigator:reveal-file Навігатор ноутбука: Відкрити файл
notebook-navigator:open-all-files Навігатор ноутбука: Відкрити всі файли
notebook-navigator:navigate-to-folder Навігатор ноутбука: перейти до папки
notebook-navigator:navigate-to-tag Навігатор ноутбука: перейти до тегу
notebook-navigator:navigate-to-property Навігатор ноутбука: перейти до властивості
notebook-navigator:navigate-back Навігатор ноутбука: Перейти назад
notebook-navigator:navigate-forward Навігатор за нотатками: Перейти вперед
notebook-navigator:add-shortcut Навігатор за нотатками: Додати до ярликів
notebook-navigator:open-shortcut-1 Навігатор по блокнотах: Відкрити ярлик 1
notebook-navigator:open-shortcut-2 Навігатор по блокнотах: Відкрити ярлик 2
notebook-navigator:open-shortcut-3 Навігатор по блокнотах: Відкрити ярлик 3
notebook-navigator:open-shortcut-4 Навігатор по блокнотах: Відкрити ярлик 4
notebook-navigator:open-shortcut-5 Навігатор по блокнотах: Відкрити ярлик 5
notebook-navigator:open-shortcut-6 Навігатор по зошитах: Відкрити ярлик 6
notebook-navigator:open-shortcut-7 Навігатор по зошитах: Відкрити ярлик 7
notebook-navigator:open-shortcut-8 Навігатор по зошитах: Відкрити ярлик 8
notebook-navigator:open-shortcut-9 Навігатор по зошитах: Відкрити ярлик 9
notebook-navigator:search Навігатор по зошитах: Пошук
notebook-navigator:search-vault Навігатор по зошитах: Пошук у всьому сховищі
notebook-navigator:toggle-dual-pane Навігатор по зошитах: Перемикання між двопанельним макетом
notebook-navigator:toggle-dual-pane-orientation Навігатор по зошитах: Перемикання орієнтації подвійної панелі
notebook-navigator:toggle-calendar Навігатор за нотатками: Увімкнути/вимкнути календар
notebook-navigator:open-daily-note Навігатор за нотатками: Відкрити щоденну нотатку
notebook-navigator:open-weekly-note Навігатор за нотатками: відкрити тижневу нотатку
notebook-navigator:open-monthly-note Навігатор за нотатками: відкрити місячну нотатку
notebook-navigator:open-quarterly-note Навігатор за нотатками: відкрити квартальну нотатку
notebook-navigator:open-yearly-note Навігатор за нотатками: Відкрити річну нотатку
notebook-navigator:toggle-descendants Навігатор по блокнотах: Перемикання нащадків
notebook-navigator:toggle-hidden Навігатор за нотатками: Увімкнути/вимкнути приховані папки, теги та нотатки
notebook-navigator:toggle-tag-sort Навігатор по зошитах: Увімкнути/вимкнути сортування за тегами
notebook-navigator:toggle-tags-by-selection Навігатор зошитів: Увімкнути/вимкнути теги за вибором
notebook-navigator:toggle-properties-by-selection Навігатор зошитів: увімкнути/вимкнути властивості за вибором
notebook-navigator:toggle-compact-mode Навігатор зошитів: увімкнути/вимкнути компактний режим
notebook-navigator:toggle-pinned-section Навігатор по зошитах: увімкнути/вимкнути закріплений розділ
notebook-navigator:collapse-expand Навігатор за нотатками: Згорнути / розгорнути всі елементи
notebook-navigator:collapse-expand-selected-item Навігатор за нотатками: Згорнути / розгорнути вибраний елемент
notebook-navigator:new-note Навігатор за нотатками: Створити нову нотатку
notebook-navigator:new-note-from-template Навігатор за нотатками: Створити нову нотатку за шаблоном
notebook-navigator:move-files Навігатор блокнота: Перемістити файли
notebook-navigator:merge-notes Навігатор ноутбука: Об'єднати нотатки
notebook-navigator:select-next-file Навігатор за нотатками: Вибрати наступний файл
notebook-navigator:select-previous-file Навігатор за нотатками: Вибрати попередній файл
notebook-navigator:convert-to-folder-note Навігатор зошитів: Перетворити на нотатку-папку
notebook-navigator:set-as-folder-note Навігатор по блокнотах: Встановити як нотатку-папку
notebook-navigator:detach-folder-note Навігатор за нотатками: Від'єднати нотатку-папку
notebook-navigator:pin-all-folder-notes Навігатор по блокноту: Закріпити всі нотатки-папки
notebook-navigator:delete-files Навігатор по блокнотах: Видалити файли
notebook-navigator:add-tag Навігатор по блокнотах: Додати тег до вибраних файлів
notebook-navigator:set-property Навігатор по блокнотах: Встановити властивість для вибраних файлів
notebook-navigator:remove-tag Навігатор по блокнотах: Видалити тег з вибраних файлів
notebook-navigator:remove-all-tags Навігатор по блокнотах: Видалити всі теги з вибраних файлів
notebook-navigator:rebuild-cache Навігатор за нотатками: Перебудувати кеш

9 особливостей

9.1 Інтерфейс

  • Двопанельний макет - панель навігації (папки/теги/властивості) та панель списку (файли)
  • Однопанельний режим - навігація та списки з анімованими переходами
  • Змінні розміри панелей - Горизонтальна або вертикальна орієнтація розділення
  • Незалежне масшта буванняінтерфейсу - масштабування навігатора блокнота без зміни масштабу Obsidian
  • Початковий вигляд - спочатку навігація або спочатку список
  • Багатомовна підтримка - 21 мова з підтримкою RTL-макетів
  • Набір іконок інтерфейсу - Налаштовувані іконки інтерфейсу у всьому плагіні

9.2 Навігація

  • Профілі сх овища - Кілька відфільтрованих переглядів з прихованими папками/тегами/нотатками, видимістю файлів, банерами та ярликами для кожного профілю
  • Швидкі посилання — нотатки, папки, теги, властивості та збережені пошукові запити з можливістю закріплення та зміни порядку
  • Нещодавнінотатки/файли - розділ нещодавніх елементів, що зберігаються в кожному профілі сховища, за бажанням можна закріпити за допомогою ярликів
  • Календар - календар щоденних нотаток з можливістю вибору дня, попереднім переглядом зображень та підтримкою вертикального розділення
  • Дерево папок - Розгортання/згортання навігації з ручним упорядкуванням кореневих папок
  • Дерево тегів - ієрархічні теги з можливістю налаштування порядку кореневих тегів
  • Браузер властивостей - перегляд властивостей файлів, упорядкованих за ключами та значеннями, з підрахунком кількості файлів, спеціальними кольорами, піктограмами та перетягуванням
  • Автоматичне виявлення активного файлу - Розширення папки та прокрутка для вибору
  • Клавіатура та команди - Налаштовувані гарячі клавіші, команди перемотування назад/вперед по історії вибору, команди наступного/попереднього файлу, команди для відкриття комбінацій клавіш 1-9

9.3 Організація

  • Закріплюйтенотатки - зберігайте важливі нотатки у верхній частині папок і тегів
  • Нотатки до папки - Встановити/від'єднати нотатки до папки, закріпити нотатки до папки, відкрити в новій вкладці
  • Операції з тегами - додавання/видалення/очищення тегів, перейменування/видалення тегів, створення примітки в тезі, перетягування ієрархії тегів
  • Користувацьке сортування та групування - перевизначення параметрів сортування/групування для теки або мітки
  • Подання для кожної теки/тегів - Рядки заголовків, рядки попереднього перегляду, компактний режим, перемикання нащадків
  • Прихований вміст - Приховані папки/теги/нотатки/файли з шаблонами, властивостями обкладинки та фільтрацією на основі тегів за профілем сховища
  • Виключити папки з підпапок — не враховувати папки під час збору нотаток із підпапок відповідно до профілю сховища; виключені папки залишаються видимими, і їхні нотатки відображаються при виборі
  • Система кольорів та іконок - кольори папок/тегів/властивостей/файлів, пакети іконок, іконки емодзі/Lucide, читання/запис титульного аркуша, відображення іконок за назвою файлу та категорією типу файлу
  • Попередження щодо імен - Попередження про заборонені символи файлової системи та символи, які порушують зв'язки Obsidian під час іменування файлів і папок

9.4 Відображення файлів

  • Попередній перегляд нотаток - 1-5 рядків попереднього перегляду з опціональним HTML-вилученням
  • Ескізи — обрані зображення та автоматично згенеровані ескізи для файлів PDF, SVG та креслень, що зберігаються в кеші метаданих
  • Зовнішні зображення - Додаткові завантаження для зовнішніх зображень та ескізів YouTube
  • Групування за датою - згрупуйте нотатки за сьогодні, вчора, попередні 7 днів, попередні 30 днів, місяці та роки при сортуванні за датою
  • Підтримка титульного аркуша - зчитування назв нот і міток часу з полів титульного аркуша
  • Метадані примітки - Показувати дату модифікації та теги у списку файлів
  • Користувацькі властивості - Відображати властивості титульного аркуша або кількість слів у списку файлів з перевизначеннями для кожної теки/тегів та користувацькими кольорами
  • Відображення батьківської па пки - необов'язкове відображення імені та піктограми батьківської папки у списку файлів
  • Компактний режим - компактне відображення, коли попередній перегляд, дата та зображення вимкнені
  • Теги, на якіможна натиснути - Теги у списку файлів переходять безпосередньо до цього тегу

9.5 Продуктивність

  • Пошук - Фільтруйте за іменами файлів, тегами, властивостями, датами, папками, розширеннями та завданнями за допомогою AND/OR/виключень
  • Інтеграція з Omnisearch - повнотекстовий пошук через Omnisearch
  • Перетягування - переміщення файлів, позначення тегів, призначення ярликів, повторне створення дерева тегів, підпружинені папки
  • Контекстні меню - створення нотаток/папок/полотен/баз/креслень та виконання дій з файлами/тегами
  • Креслення - створення креслень Excalidraw та Tldraw за допомогою меню навігації та панелі списків
  • Шаблони - Нова нотатка з команд шаблону за допомогою плагіна Templater
  • Файлові операції - Створення, перейменування, копіювання, переміщення, видалення файлів і папок
  • Фільтрація - виключення папок/тегів/нотаток/файлів з шаблонами та властивостями титульного аркуша

10 Розкриття інформації про мережу та діагностику

Notebook Navigator працює локально, але деякі функції роблять HTTP-запити до Obsidian. Журнал налагодження під час запуску може також записувати локальний діагностичний файл до вашого сховища.

10.1 Перевірка оновлення релізу (необов'язково)

  • Налаштування: "Перевіряти наявність нової версії при запуску"
  • Прохання: https://api.github.com/repos/johansan/notebook-navigator/releases/latest
  • Частота: Не частіше одного разу на 24 години, під час запуску
  • Дані: Надсилає стандартні метадані HTTP; не включає вміст сховища

10.2 Завантаження пакета іконок (необов'язково)

  • Налаштування: Увімкніть пакет іконок на вкладці Пакети іконок
  • Запити: https://raw.githubusercontent.com/johansan/notebook-navigator/main/icon-assets/... (маніфест, шрифт, метадані)
  • Сховище: Зберігається локально в IndexedDB

10.3 Зовнішні зображення, відео та мініатюри YouTube

  • Зображення особливостей (необов'язково): Керується параметром "Завантажувати зовнішні зображення". Завантажує віддалені зображення та ескізи з YouTube для зображень об'єктів і зберігає їх локально в IndexedDB.
  • Вітальне вікно (Перший запуск): Завантажує статичну мініатюру з https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/youtube-thumbnail.jpg.
  • Що нового модального (При оновленні / при відкритті): Завантажує зображення банера випуску з https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/version-banners/<id>.jpg для нотаток про випуск, які містять банер.
  • Модальне вікно «Що нового» (при оновленні / при відкритті): завантажує відео з сайту https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/version-banners/<id>.mp4, що супроводжують нотатки до випуску, які містять відео.
  • Модальне вікно «Що нового» (під час відкриття відео про випуск): відкриває відео про випуск з сайту https://cdn.jsdelivr.net/gh/johansan/notebook-navigator@main/images/version-banners/<id>.mp4, щоб браузери могли відтворювати відео безпосередньо.
  • Що нового модального (При оновленні / при відкритті): Завантажує мініатюри YouTube з https://img.youtube.com/vi/<id>/... для приміток до випуску, які містять посилання на YouTube.

10.4 Файли налагодження під час запуску (необов'язково)

  • Налаштування: "Ведення журналу налагодження при запуску"
  • Сховище: Записує файл nn-debug-...md з позначкою часу у корені сховища, а потім зупиняється після завершення запуску. Файл може синхронізуватися, якщо корінь сховища синхронізовано.
  • Дані: Включає час запуску, версію плагіна, мінімальну підтримувану версію Obsidian, платформу, кількість кешу, кількість черг, стан IndexedDB та діагностичні помилки. Не включає вміст приміток, назви тегів, значення frontmatter або список файлів сховища.
  • Шляхи та ідентифікатори: Ініціалізація запуску, діагностика PDF-файлів та випадки помилок можуть містити ідентифікатор програми/сховища Obsidian, шляхи до PDF-файлів, пов'язаних зі сховищем, або деталі стеку помилок. Перегляньте і відредагуйте файл, перш ніж публікувати його.
  • Завантажити: Notebook Navigator не завантажує файли налагодження. Вони стають доступними лише тоді, коли ви завантажуєте, прикріплюєте або синхронізуєте їх за межами плагіна.

10.5 Конфіденційність та обробка даних

  • Notebook Navigator не надсилає вміст нотаток, імена файлів, теги або налагоджувальні файли на сервер Notebook Navigator.
  • Запити до GitHub, YouTube і будь-якого зовнішнього хостингу зображень здійснюються безпосередньо з вашого пристрою і містять стандартні метадані HTTP (IP-адреса, користувач-агент тощо).
  • Завантажені пакети іконок та зображення зберігаються локально (IndexedDB). Останні нотатки/файли та стан інтерфейсу зберігаються локально (локальне сховище Obsidian).

історія 12 зірок

Star History Chart


12 Контакт

Notebook Navigator створений і підтримується Йоханом Саннебладом. Йохан має ступінь доктора філософії з розробки програмного забезпечення і працював над інноваційними розробками для таких компаній, як Apple, Electronic Arts, Google, Microsoft, Lego, SKF, Volvo Cars, Volvo Group та Yamaha.

Не соромтеся зв'язуватися зі мною на LinkedIn.


13 Питання чи проблеми?

Приєднуйтесь до нашого Discord для підтримки та обговорення, або створіть проблему врепозиторії GitHub.

Запити на злиття (pull requests) не приймаються. З появою агентного програмування неможливо забезпечити контроль якості зовнішнього коду відповідно до стандартів, яких дотримується проєкт, тому будь-який запит на злиття автоматично закривається. Натомість пропонуйте свої ідеї у вигляді запитів на додавання нових функцій — створіть запит (issue). Детальніше див. у файлі CONTRIBUTING.md.


14 Ліцензія

Цей проект поширюється за ліцензією GNU General Public License v3.0 - див. файл ЛІЦЕНЗІЯ для отримання детальної інформації.