---

1 Установка

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

2 Начало работы

Перед вами официальное руководство по изучению и освоению Notebook Navigator:

Видео снабжено субтитрами на 21 языке.

3 Безопасность и качество

Notebook Navigator проверяется с помощью TypeScript, ESLint с официальным плагином Obsidian ESLint, Prettier, Vitest и производственной сборки перед слиянием изменений. Сборка должна завершиться с нулевыми ошибками и нулевыми предупреждениями.

Проверки безопасности выполняются через CodeQL, а история сканирования хранится в рабочих процессах CodeQL и OpenSSF Scorecard. Текущий статус отображается в значках в верхней части этой страницы.

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

Оглавление

• 4 Клавиатурные сокращения
• 5 Синхронизированные и локальные настройки
• 6 Поиск
• 7 Пользовательские горячие клавиши
• 8 Команды
• 9 Особенности
• 10 Раскрытие информации о сети и диагностике
• 11 Звездная история
• 12 Контакт
• 13 Вопросы или проблемы?
• 14 Лицензия

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 Синхронизированные и локальные настройки

Во многих настройках Notebook Navigator отображается тумблер синхронизации - значок облака, который переключает между "Включить синхронизацию" и "Отключить синхронизацию". Это позволяет определить, где хранится каждая настройка и будет ли она передаваться на разные устройства.

5.1 Как работает синхронизация

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

Если для параметра включена синхронизация (по умолчанию), значение сохраняется на data.json и синхронизируется со всеми устройствами через службу синхронизации.

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

Если вы не используете службу синхронизации, переключатель синхронизации не имеет практического значения, поскольку data.json хранится только локально.

6 Поиск

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

6.1 Поиск по фильтру

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

Имена файлов

• word - Сопоставьте заметки с "словом" в имени файла
• word1 word2 - Требуйте, чтобы каждое слово соответствовало имени файла
• -word - Исключить заметки с "словом" в имени файла

Теги

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

Свойства

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

Фильтры

• 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, чтобы настроить горячие клавиши Notebook Navigator. Откройте файл и найдите раздел 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 Команды

Установите пользовательские горячие клавиши для этих команд в настройках Hotkeys в Obsidian:

Вид и навигация

• Notebook Navigator: Open Открывает Навигатор блокнота в левой боковой панели. Если он уже открыт, фокус клавиатуры перемещается на панель списка. Предложение: Привязать к клавише быстрого доступа, например Cmd/Ctrl+Shift+E, чтобы переместить фокус клавиатуры на панель со списком - это необходимо для полноценной навигации по клавиатуре
• Notebook Navigator: Toggle left sidebar Переключает левую боковую панель. При открытии устанавливает вид левой боковой панели на Навигатор блокнота (в отличие от встроенной команды Obsidian "Toggle left sidebar", которая восстанавливает предыдущий вид левой боковой панели)
• 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 по умолчанию они создаются в корневой папке, в той же папке, что и текущий файл, или в определенной папке. При работе с Notebook Navigator вы всегда хотите создавать новые заметки в текущей выбранной папке или теге, поэтому первое, что вы должны сделать, это привязать Cmd/Ctrl+N к Notebook Navigator: Create new note, чтобы новые заметки всегда создавались в текущей выбранной папке или теге. То же самое относится к перемещению и удалению файлов. Именно поэтому при работе с Notebook Navigator следует использовать эти команды вместо встроенных команд 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 Создайте одну заметку из выбранных заметок Markdown в текущем порядке списка
• 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-navigator:select-profile-1	Навигатор по блокнотам: Выбрать профиль хранилища 1
notebook-navigator:select-profile-2	Навигатор по блокнотам: выбрать профиль хранилища 2
notebook-navigator:select-profile-3	Навигатор по блокнотам: выбрать профиль хранилища 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	Notebook Navigator: Открыть ярлык 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: Добавить тег к выбранным файлам
notebook-navigator:set-property	Notebook Navigator: Установить свойство для выбранных файлов
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 Организация

• Заметки с булавками - сохраняйте важные заметки в верхней части папок и тегов
• Заметки о папках - установка/удаление заметок о папках, закрепление заметок о папках, опция открытия в новой вкладке
• Операции с тегами - добавление/удаление/очистка тегов, переименование/удаление тегов, создание заметки в теге, перетаскивание иерархии тегов
• Пользовательская сортировка и группировка - переопределение настроек сортировки/группировки для каждой папки или тега
• Отображение каждой папки/тега - строки заголовка, строки предварительного просмотра, компактный режим, переключение потомков
• Скрытое содержимое - скрытые папки/теги/заметки/файлы с шаблонами, свойствами переднего плана и фильтрацией на основе тегов для профиля хранилища
• Исключение папок из вложенных — при сборе заметок из вложенных папок, в соответствии с профилем хранилища, эти папки не учитываются; исключенные папки остаются видимыми, и при их выборе отображаются содержащиеся в них заметки
• Система цветов и иконок - цвета папок/тегов/свойств/файлов, пакеты иконок, иконки emoji/Lucide, чтение/запись frontmatter, сопоставление иконок по имени файла и категории типа файла
• Предупреждения об именах - предупреждение о запрещенных символах файловой системы и символах, нарушающих связи Obsidian, при именовании файлов и папок

9.4 Отображение файлов

• Предварительный просмотр заметок - 1-5 строк предварительного просмотра с возможностью отсечения HTML
• Миниатюры — избранные изображения, а также автоматически сгенерированные миниатюры для файлов PDF, SVG и чертежей, хранящихся в кэше метаданных
• Внешние изображения - Дополнительные загрузки для внешних изображений и миниатюр YouTube
• Группировка по дате - группировка заметок по "Сегодня", "Вчера", "Предыдущие 7 дней", "Предыдущие 30 дней", "Месяцы" и "Годы" при сортировке по дате
• Поддержка Frontmatter - считывание имен заметок и временных меток из полей Frontmatter
• Метаданные заметки - отображение даты модификации и тегов в списке файлов
• Пользовательские свойства - отображение свойств frontmatter или количества слов в списке файлов с переопределением для каждой папки/тега и настраиваемыми цветами
• Отображение родительской папки - дополнительное имя и значок родительской папки в списке файлов
• Компактный режим - компактный дисплей, когда предварительный просмотр, дата и изображения отключены
• Кликабельные теги - теги в списке файлов ведут непосредственно к этому тегу

9.5 Производительность

• Поиск - фильтрация по имени файла, тегам, свойствам, датам, папкам, расширениям и задачам с помощью AND/OR/exclusions
• Интеграция с Omnisearch - полнотекстовый поиск через Omnisearch
• Перетаскивание - перемещение файлов, пометка, назначение ярлыков, перенаправление дерева тегов, папки с пружиной
• Контекстные меню - создание заметок/папок/холстов/основы/рисунков и выполнение действий с файлами/тегами
• Чертежи - создание чертежей Excalidraw и Tldraw из меню панели навигации и списка
• Шаблоны - Новая заметка о командах шаблонов с плагином Templater
• Операции с файлами - создание, переименование, дублирование, перемещение, удаление файлов и папок
• Фильтрация - исключение папок/тегов/заметок/файлов с помощью шаблонов и свойств frontmatter

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

11 Звездная история

12 Контакт

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

Не стесняйтесь общаться со мной на LinkedIn.

13 Вопросы или проблемы?

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

Пулл-реквесты не принимаются. В связи с появлением агентного программирования невозможно обеспечить контроль качества кода, присланного извне, в соответствии со стандартами проекта, поэтому любой пулл-реквест автоматически закрывается. Вместо этого предлагайте свои идеи в виде запросов на добавление новых функций — создайте иссу. Подробности см. в файле CONTRIBUTING.md.

14 Лицензия

Этот проект распространяется под лицензией GNU General Public License v3.0 - подробности смотрите в файле LICENSE.