Indeks dokumentacji
Główna dokumentacja
- README (ten dokument)
Dokumentacja deweloperska
- Dokumentacja API - Publiczna dokumentacja API. Obejmuje zarządzanie metadanymi, kontrolę nawigacji i subskrypcje zdarzeń dla programistów JavaScript/TypeScript.
- Przewodnik po motywach - Przewodnik dla twórców motywów. Zawiera odniesienia do klas CSS, niestandardowe właściwości i przykłady motywów dla jasnych i ciemnych trybów.
- Proces uruchamiania - Sekwencja inicjalizacji wtyczki. Przepływy zimnego i ciepłego rozruchu, rozdzielczość pamięci podręcznej metadanych, odroczone czyszczenie i potok generowania treści. Zawiera diagramy Mermaid.
- Potok metadanych - Sekwencja przebudowy pamięci podręcznej, etapy potoku dostawcy i sygnały zakończenia. Zawiera diagramy Mermaid.
- Architektura pamięci masowej - Przewodnik po kontenerach pamięci masowej (IndexedDB, Local Storage, Memory Cache, Settings). Wzorce przepływu danych i wytyczne dotyczące użytkowania.
- Architektura renderowania - Hierarchia komponentów React, wirtualne przewijanie z TanStack Virtual, optymalizacje wydajności i przepływ danych.
- Orkiestracja przewijania - W jaki sposób wtyczka zapewnia dokładne przewijanie, gdy zmienia się struktura drzewa (widoczność tagów, ustawienia itp.)?
- Architektura usług - Warstwa logiki biznesowej: MetadataService, FileSystemOperations, ContentProviderRegistry. Wzorce wstrzykiwania zależności i przepływ danych usługi.
1 Instalacja
- Zainstaluj Obsidian - Pobierz i zainstaluj z obsidian.md
- Włącz wtyczki społecznościowe - Przejdź do Ustawienia → Wtyczki społecznościowe → Włącz wtyczki społecznościowe
- Zainstaluj Notebook Navigator - Kliknij "Przeglądaj" → Wyszukaj "Notebook Navigator" → Zainstaluj
- Zainstaluj Style Settings (opcjonalnie) - aby dostosować kolory i wygląd, zainstaluj wtyczkę Style Settings, wyszukując "Style Settings" we wtyczkach Community
2 Pierwsze kroki
Oto oficjalny samouczek do nauki i opanowania programu Notebook Navigator:
Wideo zawiera napisy w 21 językach.
3 Bezpieczeństwo i jakość
Notebook Navigator jest sprawdzany za pomocą TypeScript, ESLint z oficjalną wtyczką Obsidian ESLint, Prettier, Vitest i kompilacji produkcyjnej przed scaleniem zmian. Kompilacja musi zakończyć się zerową liczbą błędów i ostrzeżeń.
Kontrole bezpieczeństwa przeprowadzane są przez CodeQL, z historią skanowania w przepływach pracy CodeQL i OpenSSF Scorecard. Bieżący status jest wyświetlany na plakietkach w górnej części tej strony.
Aplikacja Notebook Navigator działa lokalnie, ale niektóre jej funkcje wysyłają udokumentowane żądania HTTP dotyczące aktualizacji, pobierania i zdalnej zawartości. Pełna lista znajduje się w sekcji 10 - Ujawnianie informacji o sieci i diagnostyce.
Spis treści
- 4 Skróty klawiaturowe
- 5 Ustawienia zsynchronizowane i lokalne
- 6 Wyszukiwanie
- 7 Niestandardowe skróty klawiszowe
- 8 Polecenia
- 9 Funkcje
- 10 Ujawnienie informacji o sieci i diagnostyce
- 11 Star History
- 12 Kontakt
- 13 Pytania lub problemy?
- 14 Licencja
4 Skróty klawiaturowe
| Klucz | Działanie |
|---|---|
| ↑/↓ | Przejdź w górę/w dół w bieżącym panelu |
| ← | W panelu nawigacyjnym: zwinąć lub przejść do nadrzędnego W panelu listy: przełączyć się do panelu nawigacyjnego |
| → | W panelu nawigacyjnym: rozwiń lub przejdź do panelu listy W panelu listy: przejdź do edytora |
| Tab | W panelu nawigacyjnym: przełącz do panelu listy W panelu listy: przełącz do edytora W polu wyszukiwania: przełącz do panelu listy |
| Shift+Tab | W panelu listy: przełącz się do panelu nawigacyjnego W polu wyszukiwania: przełącz się do panelu nawigacyjnego |
| Enter (macOS) F2 (Windows/Linux) | Zmień nazwę elementu bezpośrednio w panelu nawigacyjnym lub panelu listy |
| Enter | W panelu nawigacyjnym: domyślne otwarcie notatki o folderze w systemach Windows/Linux (jeśli funkcja jest włączona) W panelu listy: otwarcie wybranego pliku we wszystkich systemach (jeśli funkcja jest włączona) W polu wyszukiwania: przełączanie do panelu listy |
| Esc | W polu wyszukiwania: zamknij wyszukiwanie i ustaw fokus na panelu listy |
| PageUp/PageDown | Przewijanie w górę/w dół w panelu nawigacyjnym i panelu listy |
| Home/End | Przejdź do pierwszej/ostatniej pozycji w bieżącym panelu |
| Usuń Backspace | Usuń zaznaczoną pozycję |
| Cmd/Ctrl+A | Zaznacz wszystkie notatki w bieżącym folderze |
| Cmd/Ctrl+kliknięcie | Przełącz zaznaczenie notatek |
| Shift+kliknięcie | Zaznacz zakres notatek |
| Shift+Home/End | Zaznacz od bieżącej pozycji do pierwszego/ostatniego elementu |
| Shift+↑/↓ | Rozszerz zaznaczenie w górę/w dół |
| Cmd/Ctrl+↑/↓ | Zmiana kolejności zaznaczonych plików w górę/w dół w trybie ręcznego sortowania |
Uwaga: Wszystkie skróty klawiaturowe można dostosować. Szczegółowe informacje na temat dodawania nawigacji w stylu VIM (h,j,k,l), klawiszy alternatywnych i kombinacji modyfikatorów można znaleźć w sekcji 7 - Niestandardowe klawisze skrótów.
5 Ustawienia zsynchronizowane i lokalne
Wiele ustawień w aplikacji Notebook Navigator wyświetla przełącznik synchronizacji - ikonę chmury, która przełącza między opcjami "Włącz synchronizację" i "Wyłącz synchronizację". Pozwala to kontrolować, gdzie przechowywane są poszczególne ustawienia i czy są one udostępniane na różnych urządzeniach.
5.1 Jak działa synchronizacja
Wtyczki Obsidian przechowują swoją konfigurację w pliku data.json, znajdującym się pod adresem .obsidian/plugins/notebook-navigator/data.json w folderze vault. Podczas korzystania z usługi synchronizacji - takiej jak Obsidian Sync, iCloud, GitHub, Dropbox lub Dysk Google - plik ten jest synchronizowany na wszystkich urządzeniach wraz z resztą skarbca. Wszelkie ustawienia zapisane na stronie data.json będą propagowane do każdego urządzenia, które synchronizuje skarbiec.
Gdy synchronizacja jest włączona (domyślnie) dla ustawienia, wartość jest zapisywana na stronie data.json i synchronizowana ze wszystkimi urządzeniami za pośrednictwem usługi synchronizacji.
Gdy synchronizacja jest wyłączona dla ustawienia, wartość jest zapisywana w lokalnej pamięci Obsidian. Pamięć lokalna jest specyficzna dla urządzenia i nie jest uwzględniana w synchronizacji skarbca. Ustawienie będzie miało własną niezależną wartość na każdym urządzeniu. Po wyłączeniu synchronizacji dla ustawienia, bieżąca wartość jest kopiowana do pamięci lokalnej na bieżącym urządzeniu, a wartość jest usuwana z data.json, aby zapobiec nadpisaniu lokalnych wartości na innych urządzeniach.
Jeśli nie korzystasz z usługi synchronizacji, przełącznik synchronizacji nie ma praktycznego zastosowania, ponieważ strona data.json jest przechowywana tylko lokalnie.
6 Wyszukiwanie
Aplikacja Notebook Navigator oferuje dwa tryby wyszukiwania: wyszukiwanie według filtrów i Omnisearch. Można przełączać się między nimi za pomocą klawiszy strzałek w górę/w dół lub klikając ikonę wyszukiwania. Łączenie nazw plików, właściwości, znaczników, dat i filtrów w jednym zapytaniu (np. meeting .status=active #work @thisweek).
6.1 Filtr wyszukiwania
Filtruje pliki według nazw, znaczników, właściwości, dat, folderów, rozszerzeń i zadań w bieżącym folderze i podfolderach. Domyślny tryb wyszukiwania.
Nazwy plików
word- Dopasuj notatki ze słowem "word" w nazwie plikuword1 word2- Wymóg zgodności każdego słowa z nazwą pliku-word- Wyklucz notatki z "word" w nazwie pliku
Tagi
#tag- Dołącz notatki do tagu (pasuje również do tagów zagnieżdżonych, takich jak#tag/subtag)#- Uwzględniaj tylko oznaczone notatki-#tag- Wyklucz notatki z tagiem-#- Uwzględniaj tylko nieoznaczone notatki#tag1 #tag2- Dopasowanie obu tagów (niejawne AND)#tag1 AND #tag2- Dopasowanie obu tagów (jawne AND)#tag1 OR #tag2- Dopasuj dowolny znacznik#a OR #b AND #c- AND ma wyższy priorytet: dopasowuje#alub zarówno#bjak i#c- Cmd/Ctrl+kliknij tag, aby dodać go za pomocą AND. Cmd/Ctrl+Shift+kliknięcie, aby dodać z OR
Właściwości
.key- Dołącz uwagi do klucza właściwości.key=value- Uwzględnij uwagi, jeśli wartość właściwości zawieravalue."Reading Status"- Klucz właściwości z białymi znakami (w cudzysłowie)."Reading Status"="In Progress"- Klucze i wartości z białymi znakami muszą być umieszczane w podwójnych cudzysłowach-.key- Wyklucz notatki z kluczem właściwości-.key=value- Wyklucz notatki, w których wartość właściwości zawieravalue- Cmd/Ctrl+kliknięcie właściwości, aby dodać za pomocą AND. Cmd/Ctrl+Shift+kliknięcie, aby dodać z OR
Filtry
has:task- Dołącz notatki z niedokończonymi zadaniami-has:task- Wyklucz notatki z niedokończonymi zadaniamifolder:meetings- Dołącz notatki, jeśli nazwa folderu zawierameetingsfolder:/work/meetings- Uwzględniaj notatki tylko na stroniework/meetings(nie w podfolderach)folder:/- Uwzględniaj notatki tylko w katalogu głównym skarbca-folder:archive- Wyklucz notatki, których nazwa folderu zawieraarchive-folder:/archive- Wyklucz notatki tylko warchive(nie w podfolderach)ext:md- Dołącz notatki z rozszerzeniemmd(ext:.mdjest również obsługiwane)-ext:pdf- Wyklucz notatki z rozszerzeniempdf- Połącz z tagami, nazwami i datami (np.
folder:/work/meetings ext:md @thisweek)
Daty
@today- Dopasowanie notatek z dnia dzisiejszego przy użyciu domyślnego pola daty@yesterday,@last7d,@last30d,@thisweek,@thismonth- Względne zakresy dat@2026-02-07- Dopasuj pojedynczy dzień (obsługuje również@20260207)@2026- Dopasuj rok kalendarzowy@2026-02lub@202602- dopasowanie do miesiąca kalendarzowego@2026-W05lub@2026W05- Dopasuj tydzień ISO@2026-Q2lub@2026Q2- dopasowanie do kwartału kalendarzowego@13/02/2026- Formaty liczbowe z separatorami (@07022026podąża za ustawieniami regionalnymi, jeśli są niejednoznaczne)@2026-02-01..2026-02-07- Dopasuj zakres dni (obsługiwane są otwarte końce)@c:...lub@m:...- data utworzenia lub modyfikacji celu-@...- Wyklucz dopasowanie daty
Domyślne pole daty jest zgodne z bieżącą kolejnością sortowania. Podczas sortowania według nazwy pole daty jest konfigurowane w Ustawienia → Notatki → Data → Podczas sortowania według nazwy.
Zachowanie AND/OR
AND i OR działają w zapytaniach zawierających tylko znaczniki/właściwości (zapytania zawierające tylko filtry #tag, -#tag, #, -#, .key, -.key, .key=value lub -.key=value ). Jeśli zapytanie zawiera również nazwy, daty, filtry zadań, filtry folderów lub filtry rozszerzeń, AND i OR są dopasowywane jako słowa nazw plików.
- Zapytanie operatora:
#work OR .status=started - Zapytanie mieszane:
#work OR ext:md(ORjest dopasowane w nazwach plików)
6.2 Omnisearch
Wyszukiwanie pełnotekstowe w całym skarbcu, filtrowane do bieżącego folderu, podfolderów lub wybranych tagów. Wymaga wtyczki Omnisearch. Jeśli Omnisearch nie jest zainstalowany, wyszukiwanie powraca do filtrowania.
Podglądy notatek wyświetlają fragmenty wyników Omnisearch zamiast domyślnego tekstu podglądu.
Znane ograniczenia
- Wydajność - Może działać wolno podczas wyszukiwania mniej niż 3 znaków w dużych skarbcach
- Filtry ścieżek — zakres folderów jest przekazywany do Omnisearch wyłącznie w przypadku prostych ścieżek ASCII. Pozostałe ścieżki są filtrowane po tym, jak Omnisearch zwróci wyniki
- Ograniczone wyniki - Omnisearch przeszukuje cały skarbiec i zwraca ograniczoną liczbę wyników przed filtrowaniem, więc odpowiednie pliki z bieżącego folderu mogą się nie pojawić, jeśli wiele dopasowań istnieje gdzie indziej
- Tekst podglądu - podglądy notatek są zastępowane fragmentami wyników Omnisearch, które mogą nie pokazywać rzeczywistego podświetlenia dopasowania wyszukiwania, jeśli pojawia się ono w innym miejscu w pliku
7 Niestandardowe skróty klawiszowe
Edytuj .obsidian/plugins/notebook-navigator/data.json, aby dostosować klawisze skrótów programu Notebook Navigator. Otwórz plik i znajdź sekcję keyboardShortcuts. Każdy wpis mapuje akcję na jedno lub więcej powiązań klawiszy:
"pane:move-up": [ { "key": "ArrowUp", "modifiers": [] }, { "key": "K", "modifiers": [] } ]
Dodaj wiele powiązań na akcję, aby obsługiwać alternatywne klucze, jak w powyższym przykładzie ArrowUp i K. Połącz modyfikatory w jednym wpisie, wymieniając każdą wartość, na przykład "modifiers": ["Mod", "Shift"]. Sekwencje klawiaturowe takie jak gg lub dd nie są obsługiwane. Przeładuj Obsidian po edycji pliku.
7.1 Modyfikatory
| Modyfikator | Klawisz |
|---|---|
Mod |
Cmd (macOS) / Ctrl (Win/Linux) |
Alt |
Alt / Option |
Shift |
Shift |
Ctrl |
Control (preferowany Mod dla różnych platform) |
7.2 Dostępne działania
| Akcja | Domyślne klawisze |
|---|---|
pane:move-up |
Strzałka w górę |
pane:move-down |
Strzałka w dół |
pane:page-up |
PageUp |
pane:page-down |
Page Down |
pane:home |
Strona główna |
pane:end |
Koniec |
pane:rename |
Enter (macOS), F2 (Windows/Linux) |
pane:delete-selected |
Delete, Backspace |
navigation:collapse-or-parent |
Strzałka w lewo |
navigation:expand-or-focus-list |
Strzałka w prawo |
navigation:focus-list |
Tab |
list:focus-navigation |
Strzałka w lewo, Shift+Tab |
list:focus-editor |
Strzałka w prawo, Tab |
list:select-all |
Mod+A |
list:extend-selection-up |
Shift + strzałka w górę |
list:extend-selection-down |
Shift+strzałka w dół |
list:manual-sort-up |
Mod+strzałka w górę |
list:manual-sort-down |
Mod+Strzałka w dół |
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 Polecenia
Ustaw niestandardowe skróty klawiszowe dla tych poleceń w ustawieniach skrótów klawiszowych Obsidian:
Widok i nawigacja
Notebook Navigator: OpenOtwiera Notebook Navigator na lewym pasku bocznym. Jeśli jest już otwarty, przenosi fokus klawiatury do panelu listy. Sugestia: Powiązanie ze skrótem klawiszowym, takim jakCmd/Ctrl+Shift+E, aby przenieść fokus klawiatury do panelu listy - jest to niezbędne do pełnej nawigacji za pomocą klawiaturyNotebook Navigator: Toggle left sidebarPrzełącza lewy pasek boczny. Po otwarciu ustawia widok lewego paska bocznego na Notebook Navigator (w przeciwieństwie do wbudowanego w Obsidian polecenia "Toggle left sidebar", które przywraca poprzedni widok lewego paska bocznego)Notebook Navigator: Open homepageOtwiera widok Notebook Navigator i ładuje skonfigurowany w ustawieniach cel strony głównejNotebook Navigator: Select vault profileOtwiera okno dialogowe do przełączania między profilami skarbcaNotebook Navigator: Reveal fileWyświetla bieżący plik w nawigatorze. Rozwija foldery nadrzędne i przewija do pliku. To polecenie jest przydatne, jeśli ustawienieAuto-reveal active notejest wyłączone i chcesz ręcznie ujawnić notatki. Sugestia: Powiązanie ze skrótem klawiszowym, takim jakCmd/Ctrl+Shift+R, aby szybko zmienić wybrany folder lub tag na bieżący plikNotebook Navigator: Open all filesOtwiera wszystkie notatki w aktualnie wybranym folderze lub tagu. Podczas otwierania 15 lub więcej plików wyświetlane jest okno dialogowe potwierdzeniaNotebook Navigator: Navigate to folderOkno dialogowe wyszukiwania umożliwiające przejście do dowolnego folderuNotebook Navigator: Navigate to tagOkno dialogowe wyszukiwania umożliwiające przejście do dowolnego taguNotebook Navigator: Navigate to propertyOkno dialogowe wyszukiwania umożliwiające przejście do dowolnego klucza lub wartości właściwościNotebook Navigator: Navigate backPrzenosi do poprzedniego folderu, tagu lub wyboru właściwości w historii nawigatoraNotebook Navigator: Navigate forwardPrzejście do następnego folderu, tagu lub właściwości w historii nawigatoraNotebook Navigator: Add to shortcutsDodaje lub usuwa bieżący plik, folder, tag lub właściwość ze skrótówNotebook Navigator: Open shortcut 1-9Otwiera skrót według jego pozycji na liście skrótówNotebook Navigator: SearchOtwiera pole szybkiego wyszukiwania lub skupia je, jeśli jest już otwarte. Wyszukiwanie jest zachowywane między sesjami. Sugestia: Powiązanie ze skrótem klawiszowym, takim jakCmd/Ctrl+Shift+S, w celu szybkiego filtrowania plikówNotebook Navigator: Search whole vaultWybiera folder główny skarbca i uruchamia wyszukiwanie z uwzględnieniem podfolderów (wymaga włączenia funkcji „Show root folder”)
Wybór
Notebook Navigator: Select next filePrzenosi zaznaczenie do następnego pliku w bieżącym widoku folderów lub tagów. Respektuje niestandardową kolejność sortowania. Sugestia: Powiązanie ze skrótem klawiszowym, takim jakOption+Cmd+Right, aby szybko przejść do następnego pliku na liścieNotebook Navigator: Select previous filePrzenosi zaznaczenie do poprzedniego pliku w bieżącym widoku folderów lub tagów. Respektuje niestandardową kolejność sortowania. Sugestia: Powiązanie ze skrótem klawiszowym, takim jakOption+Cmd+Left, aby szybko przejść do poprzedniego pliku na liście
Układ i wyświetlanie
Notebook Navigator: Toggle dual pane layoutPrzełączanie układu jedno-/dwupanelowego (pulpit). Sugestia: Powiązanie ze skrótem klawiszowym, takim jakCmd/Ctrl+Shift+A, aby szybko przełączać między układem jedno- i dwupanelowymNotebook Navigator: Toggle dual pane orientationPrzełączanie orientacji podwójnego panelu między poziomą i pionowąNotebook Navigator: Toggle descendantsPrzełączanie wyświetlania podfolderów / notatek potomnych dla folderów i tagów. Sugestia: Powiązanie ze skrótem klawiszowym, takim jakCmd/Ctrl+Shift+D, aby szybko przełączać wyświetlanie notatek z podfolderów / elementów potomnychNotebook Navigator: Toggle hidden folders, tags, and notesPokaż lub ukryj ukryte foldery, tagi i notatkiNotebook Navigator: Toggle tag sort orderPrzełączaj między sortowaniem tagów według alfabetu a sortowaniem według częstotliwościNotebook Navigator: Toggle tags by selectionPrzełączanie ograniczania tagów do tych znalezionych w notatkach w wybranym folderze lub właściwościNotebook Navigator: Toggle properties by selectionPrzełączanie ograniczania właściwości do tych znalezionych w notatkach w wybranym folderze lub taguNotebook Navigator: Toggle compact modePrzełączanie trybu listy między standardowym i kompaktowymNotebook Navigator: Toggle pinned sectionWyświetlanie lub ukrywanie przypiętych notatek w panelu listyNotebook Navigator: Collapse / expand all itemsZwija lub rozwija wszystkie elementy na podstawie bieżącego stanu. Gdy włączona jest opcjaKeep selected item expanded(domyślnie włączona), wszystkie foldery z wyjątkiem bieżącego zostaną zwinięte. Jest to przydatne, aby utrzymać porządek w drzewie nawigacji podczas wyszukiwania dokumentówNotebook Navigator: Collapse / expand selected itemZwiń lub rozwiń wybrany element nawigacji
Kalendarz
Notebook Navigator: Toggle calendarWłącza lub wyłącza kalendarz. Sugestia: Powiązanie ze skrótem klawiszowym, takim jakCmd/Ctrl+Shift+C, aby szybko wyświetlić kalendarzNotebook Navigator: Open daily noteOtwiera dzisiejszą notatkę dzienną na podstawie ustawień kalendarza. Tworzy notatkę, jeśli nie istniejeNotebook Navigator: Open weekly noteOtwiera bieżącą notatkę tygodniową. Tworzy notatkę, jeśli nie istniejeNotebook Navigator: Open monthly noteOtwiera bieżącą notę miesięczną. Tworzy notatkę, jeśli nie istniejeNotebook Navigator: Open quarterly noteOtwiera bieżącą notę kwartalną. Tworzy notatkę, jeśli nie istniejeNotebook Navigator: Open yearly noteOtwiera bieżącą notatkę roczną. Tworzy notatkę, jeśli nie istnieje
Operacje na plikach
Ważne: Obsidian nie ma kontekstu "bieżącego folderu lub tagu", więc podczas tworzenia notatek w Obsidian domyślnie są one tworzone w folderze głównym, tym samym folderze co bieżący plik lub w określonym folderze. Podczas pracy z Notebook Navigator zawsze chcesz tworzyć nowe notatki w aktualnie wybranym folderze lub tagu, więc pierwszą rzeczą, którą powinieneś zrobić, jest powiązanie Cmd/Ctrl+N z Notebook Navigator: Create new note, aby nowe notatki były zawsze tworzone w aktualnie wybranym folderze lub tagu. To samo dotyczy przenoszenia i usuwania plików. Dlatego podczas korzystania z aplikacji Notebook Navigator należy używać tych poleceń zamiast wbudowanych poleceń Obsidian.
Notebook Navigator: Create new noteUtwórz notatkę w aktualnie wybranym folderze. Sugestia: PowiążCmd/Ctrl+Nz tym poleceniem (najpierw usuń powiązanie z domyślnym "Utwórz nową notatkę" Obsidian)Notebook Navigator: Create new note from templateUtwórz notatkę z szablonu w aktualnie wybranym folderze (wymaga aplikacji Templater)Notebook Navigator: Move filesPrzenosi wybrane pliki do innego folderu. Wybiera następny plik w bieżącym folderzeNotebook Navigator: Merge notesUtworzenie jednej notatki z wybranych notatek Markdown w bieżącej kolejności na liścieNotebook Navigator: Convert to folder noteUtwórz folder odpowiadający nazwie pliku i przenieś plik do niego jako notatkę folderuNotebook Navigator: Set as folder noteZmiana nazwy aktywnego pliku na nazwę notatki folderuNotebook Navigator: Detach folder noteOdłącz notatkę folderu w wybranym folderze i zmień jej nazwęNotebook Navigator: Pin all folder notesPrzypnij wszystkie notatki do wszystkich folderów. Polecenie jest widoczne tylko wtedy, gdy notatki do folderów są włączoneNotebook Navigator: Delete filesUsuń wybrane pliki. Wybiera następny plik w bieżącym folderze
Operacje związane z tagami
Notebook Navigator: Add tag to selected filesOkno dialogowe do dodawania tagów do wybranych plików. Obsługuje tworzenie nowych tagówNotebook Navigator: Set property on selected filesOkno dialogowe do ustawiania właściwości na wybranych plikachNotebook Navigator: Remove tag from selected filesOkno dialogowe do usunięcia określonego tagu. Usuwa natychmiast, jeśli tylko jeden tagNotebook Navigator: Remove all tags from selected filesWyczyść wszystkie tagi z wybranych plików z potwierdzeniem
Konserwacja
Notebook Navigator: Rebuild cacheOdbudowuje lokalną pamięć podręczną aplikacji Notebook Navigator. Użyj tej opcji, jeśli występują brakujące znaczniki, nieprawidłowe podglądy lub brakujące obrazy funkcji
8.1 Identyfikatory poleceń
| Identyfikator polecenia | Nazwa polecenia |
|---|---|
notebook-navigator:open |
Notebook Navigator: Otwórz |
notebook-navigator:toggle-left-sidebar |
Notebook Navigator: Przełącz pasek boczny po lewej stronie |
notebook-navigator:open-homepage |
Notebook Navigator: Otwórz stronę główną |
notebook-navigator:select-profile |
Notebook Navigator: Wybierz profil skarbca |
notebook-navigator:select-profile-1 |
Notebook Navigator: Wybierz profil magazynu 1 |
notebook-navigator:select-profile-2 |
Notebook Navigator: Wybierz profil magazynu 2 |
notebook-navigator:select-profile-3 |
Notebook Navigator: Wybierz profil magazynu 3 |
notebook-navigator:reveal-file |
Notebook Navigator: Pokaż plik |
notebook-navigator:open-all-files |
Notebook Navigator: Otwórz wszystkie pliki |
notebook-navigator:navigate-to-folder |
Notebook Navigator: Przejdź do folderu |
notebook-navigator:navigate-to-tag |
Notebook Navigator: Przejdź do tagu |
notebook-navigator:navigate-to-property |
Notebook Navigator: Przejdź do właściwości |
notebook-navigator:navigate-back |
Notebook Navigator: Przejdź wstecz |
notebook-navigator:navigate-forward |
Notebook Navigator: Przejdź do przodu |
notebook-navigator:add-shortcut |
Notebook Navigator: Dodaj do skrótów |
notebook-navigator:open-shortcut-1 |
Notebook Navigator: Otwórz skrót 1 |
notebook-navigator:open-shortcut-2 |
Notebook Navigator: Otwórz skrót 2 |
notebook-navigator:open-shortcut-3 |
Notebook Navigator: Otwórz skrót 3 |
notebook-navigator:open-shortcut-4 |
Notebook Navigator: Otwórz skrót 4 |
notebook-navigator:open-shortcut-5 |
Notebook Navigator: Otwórz skrót 5 |
notebook-navigator:open-shortcut-6 |
Notebook Navigator: Otwórz skrót 6 |
notebook-navigator:open-shortcut-7 |
Notebook Navigator: Otwórz skrót 7 |
notebook-navigator:open-shortcut-8 |
Notebook Navigator: Otwórz skrót 8 |
notebook-navigator:open-shortcut-9 |
Notebook Navigator: Otwórz skrót 9 |
notebook-navigator:search |
Notebook Navigator: Szukaj |
notebook-navigator:search-vault |
Notebook Navigator: Wyszukaj w całym magazynie |
notebook-navigator:toggle-dual-pane |
Notebook Navigator: Przełącz układ z dwoma okienkami |
notebook-navigator:toggle-dual-pane-orientation |
Notebook Navigator: Przełącz orientację układu dwupanelowego |
notebook-navigator:toggle-calendar |
Notebook Navigator: Włącz/wyłącz kalendarz |
notebook-navigator:open-daily-note |
Notebook Navigator: Otwórz notatkę dzienną |
notebook-navigator:open-weekly-note |
Notebook Navigator: Otwórz notatkę tygodniową |
notebook-navigator:open-monthly-note |
Notebook Navigator: Otwórz notatkę miesięczną |
notebook-navigator:open-quarterly-note |
Notebook Navigator: Otwórz notatkę kwartalną |
notebook-navigator:open-yearly-note |
Notebook Navigator: Otwórz notatkę roczną |
notebook-navigator:toggle-descendants |
Notebook Navigator: Przełącz elementy podrzędne |
notebook-navigator:toggle-hidden |
Notebook Navigator: Przełącz ukryte foldery, tagi i notatki |
notebook-navigator:toggle-tag-sort |
Nawigator notatników: Przełącz kolejność sortowania tagów |
notebook-navigator:toggle-tags-by-selection |
Nawigator notatników: Przełącz tagi według zaznaczenia |
notebook-navigator:toggle-properties-by-selection |
Notebook Navigator: Przełączanie właściwości według zaznaczenia |
notebook-navigator:toggle-compact-mode |
Nawigator notatników: Włącz/wyłącz tryb kompaktowy |
notebook-navigator:toggle-pinned-section |
Notebook Navigator: Przełącz sekcję przypiętą |
notebook-navigator:collapse-expand |
Nawigator notatników: Zwiń / rozwiń wszystkie elementy |
notebook-navigator:collapse-expand-selected-item |
Nawigator notatników: Zwiń / rozwiń zaznaczony element |
notebook-navigator:new-note |
Nawigator notatników: Utwórz nową notatkę |
notebook-navigator:new-note-from-template |
Notebook Navigator: Utwórz nową notatkę na podstawie szablonu |
notebook-navigator:move-files |
Notebook Navigator: Przenieś pliki |
notebook-navigator:merge-notes |
Nawigator notatnika: Scal notatki |
notebook-navigator:select-next-file |
Notebook Navigator: Wybierz następny plik |
notebook-navigator:select-previous-file |
Notebook Navigator: Wybierz poprzedni plik |
notebook-navigator:convert-to-folder-note |
Notebook Navigator: Konwersja do notatki folderowej |
notebook-navigator:set-as-folder-note |
Notebook Navigator: Ustaw jako notatkę folderową |
notebook-navigator:detach-folder-note |
Notebook Navigator: Odłącz notatkę folderową |
notebook-navigator:pin-all-folder-notes |
Nawigator notatnika: Przypnij wszystkie notatki folderowe |
notebook-navigator:delete-files |
Nawigator notatników: Usuń pliki |
notebook-navigator:add-tag |
Notebook Navigator: Dodaj tag do wybranych plików |
notebook-navigator:set-property |
Notebook Navigator: Ustaw właściwości wybranych plików |
notebook-navigator:remove-tag |
Notebook Navigator: Usuń tag z wybranych plików |
notebook-navigator:remove-all-tags |
Notebook Navigator: Usuń wszystkie tagi z wybranych plików |
notebook-navigator:rebuild-cache |
Notebook Navigator: Odbuduj pamięć podręczną |
9 Funkcje
9.1 Interfejs
- Dwupanelowy układ - panel nawigacji (foldery/tagi/właściwości) i panel listy (pliki)
- Tryb jednookienkowy - widoki nawigacji i listy z animowanymi przejściami
- Zmienne okienka - orientacja podziału pozioma lub pionowa
- Niezależny zoom interfejsu użytkownika - skalowanie Nawigatora Notatnika bez zmiany zoomu Obsidian
- Widok startowy - najpierw nawigacja lub najpierw lista
- Obsługa wielu języków - 21 języków z obsługą układu RTL
- Zestaw ikon interfejsu - konfigurowalne ikony interfejsu użytkownika w całej wtyczce
9.2 Nawigacja
- Profile Vault - wiele filtrowanych widoków z ukrytymi folderami/tagami/notatkami dla każdego profilu, widocznością plików, banerami i skrótami
- Skróty — notatki, foldery, tagi, właściwości i zapisane wyszukiwania z możliwością przypinania i zmiany kolejności
- Ostatnie notatki/pliki - sekcja ostatnich elementów przechowywana w profilu skarbca, opcjonalnie przypięta za pomocą skrótów
- Kalendarz - dzienny kalendarz notatek z wyborem dnia, podglądem obrazów funkcji i obsługą podziału pionowego
- Drzewo folderów - Rozwiń/zwiń nawigację z ręcznym porządkowaniem folderów głównych
- Drzewo tagów - Hierarchiczne tagi z konfigurowalną kolejnością tagów głównych
- Przeglądarka właściwości - Przeglądaj właściwości plików uporządkowane według klucza i wartości z liczbą plików, niestandardowymi kolorami, ikonami oraz przeciąganiem i upuszczaniem
- Automatyczne wyświetlanie aktywnego pliku - Rozszerzanie folderu i przewijanie do wyboru
- Klawiatura i polecenia - konfigurowalne klawisze skrótów, polecenia historii wyboru wstecz/do przodu, polecenia następnego/poprzedniego pliku, polecenia skrótów otwarcia 1-9
9.3 Organizacja
- Przypinanie notatek - Przechowuj ważne notatki na górze folderów i tagów
- Notatki do folderów - ustawianie/usuwanie notatek do folderów, przypinanie notatek do folderów, opcja otwierania w nowej karcie
- Operacje na tagach - dodawanie/usuwanie/wyczyszczanie tagów, zmiana nazwy/usuwanie tagów, tworzenie notatek w tagach, przeciąganie i upuszczanie hierarchii tagów
- Niestandardowe sortowanie i grupowanie - zastępowanie ustawień sortowania/grupowania dla folderu lub tagu
- Wygląd poszczególnych folderów/tagów - wiersze tytułu, wiersze podglądu, tryb kompaktowy, przełączanie potomków
- Ukryta zawartość - Ukryte foldery/tagi/notatki/pliki z wzorcami, właściwościami frontmatter i filtrowaniem opartym na tagach według profilu skarbca
- Wykluczanie folderów z podkatalogów – pomijanie folderów podczas zbierania notatek z podfolderów zgodnie z profilem sejfu; wykluczone foldery pozostają widoczne, a po ich zaznaczeniu wyświetlane są zawarte w nich notatki
- System kolorów i ikon - kolory folderów/tagów/właściwości/plików, pakiety ikon, ikony emoji/Lucide, odczyt/zapis frontmatter, mapowanie ikon według nazwy pliku i kategorii typu pliku
- Ostrzeżenia dotyczące nazw - ostrzega przed niedozwolonymi znakami systemu plików i znakami, które przerywają łącza Obsidian podczas nazywania plików i folderów
9.4 Wyświetlanie plików
- Podgląd notatek - 1-5 linii podglądu z opcjonalnym usuwaniem kodu HTML
- Miniatury – obrazy wyróżnione oraz automatycznie generowane miniatury plików PDF, SVG i rysunków przechowywanych w pamięci podręcznej metadanych
- Obrazy zewnętrzne - opcjonalne pobieranie obrazów zewnętrznych i miniatur YouTube
- Grupowanie według daty - grupowanie notatek według daty Dzisiaj, Wczoraj, Poprzednie 7 dni, Poprzednie 30 dni, Miesiące i Lata w przypadku sortowania według daty
- Obsługa Front matter - odczytywanie nazw notatek i znaczników czasu z pól Frontmatter
- Metadane notatek - wyświetlanie daty modyfikacji i tagów na liście plików
- Właściwości niestandardowe - wyświetlanie właściwości frontonu lub liczby słów na liście plików z nadpisaniami dla poszczególnych folderów/etykiet i niestandardowymi kolorami
- Wyświetlanie folderu nadrzędnego - Opcjonalna nazwa folderu nadrzędnego i ikona na liście plików
- Tryb kompaktowy - Kompaktowe wyświetlanie, gdy podgląd, data i zdjęcia są wyłączone
- Klikalne znaczniki - znaczniki na liście plików prowadzą bezpośrednio do danego znacznika
9.5 Wydajność
- Wyszukiwanie - filtrowanie według nazw plików, tagów, właściwości, dat, folderów, rozszerzeń i zadań za pomocą AND/OR/wykluczeń
- Integracja z Omnisearch - wyszukiwanie pełnotekstowe za pośrednictwem Omnisearch
- Przeciągnij i upuść - przenoszenie plików, tagowanie, przypisywanie skrótów, zmiana drzewa tagów, foldery sprężynowe
- Menu kontekstowe - tworzenie notatek/folderów/szkiców/podstaw/rysunków i uruchamianie akcji na plikach/etykietach
- Rysunki - Tworzenie rysunków Excalidraw i Tldraw z poziomu menu panelu nawigacji i listy
- Szablony - Nowa notatka z poleceń szablonów z wtyczką Templater
- Operacje na plikach - tworzenie, zmiana nazwy, duplikowanie, przenoszenie, usuwanie plików i folderów
- Filtrowanie - Wykluczenia folderów/tagów/notatek/plików za pomocą wzorców i właściwości frontmatter
10 Ujawnienie informacji o sieci i diagnostyce
Notebook Navigator działa lokalnie, ale niektóre funkcje wysyłają żądania HTTP z Obsidian. Uruchamianie dziennika debugowania może również zapisywać lokalny plik diagnostyczny w skarbcu.
10.1 Kontrola aktualizacji wydania (opcjonalnie)
- Ustawienie: "Sprawdź nową wersję przy starcie"
- Prośba:
https://api.github.com/repos/johansan/notebook-navigator/releases/latest - Częstotliwość: Maksymalnie raz na 24 godziny, podczas uruchamiania
- Dane: Wysyła standardowe metadane HTTP; nie zawiera zawartości skarbca
10.2 Pakiety ikon do pobrania (opcjonalnie)
- Ustawienie: Włącz pakiet ikon na karcie Pakiety ikon
- Żądania:
https://raw.githubusercontent.com/johansan/notebook-navigator/main/icon-assets/...(manifest, czcionka, metadane) - Przechowywanie: Przechowywane lokalnie w IndexedDB
10.3 Obrazy zewnętrzne, filmy i miniatury z serwisu YouTube
- Obrazy funkcji (opcjonalnie): Kontrolowane przez ustawienie "Pobierz obrazy zewnętrzne". Pobiera zdalne obrazy i miniatury YouTube dla obrazów funkcji i przechowuje je lokalnie w IndexedDB.
- Modal powitalny (pierwsze uruchomienie): Ładuje statyczną miniaturę z
https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/youtube-thumbnail.jpg. - Nowy modal (przy aktualizacji / po otwarciu): Ładuje obrazy banerów wydania z
https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/version-banners/<id>.jpgdla informacji o wydaniu, które zawierają baner. - Okienko „Co nowego” (po aktualizacji / po otwarciu): Wyświetla filmy dotyczące nowych wersji ze strony
https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/version-banners/<id>.mp4w przypadku informacji o nowych wersjach, które zawierają materiał wideo. - Okienko „Co nowego” (przy otwieraniu filmu z zapowiedzią): Otwiera filmy z zapowiedziami z serwisu
https://cdn.jsdelivr.net/gh/johansan/notebook-navigator@main/images/version-banners/<id>.mp4, dzięki czemu przeglądarki mogą odtwarzać je bezpośrednio. - Okno dialogowe Co nowego (przy aktualizacji / po otwarciu): Ładuje miniatury YouTube z
https://img.youtube.com/vi/<id>/...dla informacji o wydaniu, które zawierają łącze YouTube.
10.4 Uruchamianie plików debugowania (opcjonalnie)
- Ustawienie: "Startup debug logging"
- Przechowywanie: Zapisuje plik
nn-debug-...mdze znacznikiem czasu w katalogu głównym skarbca, a następnie zatrzymuje się po zakończeniu uruchamiania. Plik może zostać zsynchronizowany, jeśli główny skarbiec jest zsynchronizowany. - Dane: Obejmuje czas uruchamiania, wersję wtyczki, minimalną obsługiwaną wersję Obsidian, platformę, liczbę pamięci podręcznych, liczbę kolejek, stan IndexedDB i błędy diagnostyczne. Nie zawiera zawartości notatek, nazw tagów, wartości frontmatter ani listy plików vault.
- Ścieżki i identyfikatory: Inicjalizacja uruchamiania, diagnostyka PDF i przypadki błędów mogą zawierać identyfikator aplikacji Obsidian/vault, ścieżki PDF odnoszące się do vault lub szczegóły stosu błędów. Przed publicznym udostępnieniem pliku należy go przejrzeć i zredagować.
- Przesyłanie: Notebook Navigator nie przesyła plików debugowania. Są one udostępniane tylko wtedy, gdy zostaną przesłane, dołączone lub zsynchronizowane poza wtyczką.
10.5 Prywatność i przetwarzanie danych
- Notebook Navigator nie wysyła treści notatek, nazw plików, znaczników ani plików debugowania na serwer Notebook Navigator.
- Żądania do GitHub, YouTube i dowolnego zewnętrznego hosta obrazów są wykonywane bezpośrednio z urządzenia użytkownika i zawierają standardowe metadane HTTP (adres IP, agent użytkownika itp.).
- Pobrane pakiety ikon i obrazy są przechowywane lokalnie (IndexedDB). Ostatnie notatki/pliki i stan interfejsu użytkownika są przechowywane lokalnie (Obsidian local storage).
11 Star History
12 Kontakt
Notebook Navigator jest tworzony i utrzymywany przez Johana Sanneblada. Johan ma tytuł doktora w dziedzinie rozwoju oprogramowania i pracował nad rozwojem innowacji dla takich firm jak Apple, Electronic Arts, Google, Microsoft, Lego, SKF, Volvo Cars, Volvo Group i Yamaha.
Zapraszam do kontaktu ze mną na LinkedIn.
13 Pytania lub problemy?
Dołącz do naszego Discorda w celu uzyskania wsparcia i dyskusji lub otwórz zgłoszenie wrepozytorium GitHub.
Nie przyjmujemy pull requestów. W związku z pojawieniem się programowania agentycznego nie jesteśmy w stanie zapewnić kontroli jakości zewnętrznych zgłoszeń kodu zgodnie ze standardami obowiązującymi w projekcie, dlatego każdy pull request jest automatycznie zamykany. Zamiast tego dziel się pomysłami w formie zgłoszeń dotyczących nowych funkcji — otwórz zgłoszenie. Szczegółowe informacje znajdziesz w pliku CONTRIBUTING.md.
14 Licencja
Ten projekt jest objęty licencją GNU General Public License v3.0 - szczegóły można znaleźć w pliku LICENSE.