Pierwsze kroki — instalacja InventTasks i konfiguracja workspace'u

Instalacja i pierwsze uruchomienie#

Instalacja i włączenie#

Pobierz inventtasks.zip z https://inventtasks.solidinvent.pl i rozpakuj do <vault>/.obsidian/plugins/ (archiwum zawiera już folder inventtasks), albo skopiuj build z wydania (main.js, manifest.json, styles.css) do .obsidian/plugins/inventtasks/.
Uruchom ponownie Obsidian lub przeładuj wtyczki.
Włącz InventTasks w Settings → Community plugins.

Instrukcje instalacji na komputerach i urządzeniach mobilnych znajdują się w pliku INSTALL.md w pobranej paczce. Aby zaktualizować ręczną instalację, wyłącz InventTasks, zastąp zainstalowane pliki wtyczki nowym wydaniem, przeładuj Obsidian i ponownie włącz wtyczkę. Dane zadań pozostają w folderze workspace'u wewnątrz vaulta.

Otwieranie InventTasks#

Kliknij ikonę InventTasks na wstążce (jedna na skonfigurowany wpis workspace/vault).
Albo uruchom polecenie Open InventTasks z palety poleceń.

Otwiera się główny widok z nawigatorem w panelu bocznym i bieżącą lokalizacją.

Przykładowy workspace#

Przy pierwszym uruchomieniu InventTasks tworzy konfigurację workspace'u i ukryte systemowe Lists, ale nie tworzy po cichu przykładowych zadań. Pusty workspace oferuje:

Utwórz pierwszy Space
Wczytaj zawartość startową — jeden Space, jedna List i kilka przykładowych Items

Możesz też użyć Settings → InventTasks → Add starter content. Aby dodać szerszy przykład z jednym Space, jednym Folder, trzema Lists, 25 aktywnymi Items, polami własnymi, relacjami, Docs, datami i śledzeniem czasu, wybierz Add rich content for testers. Obie opcje dodają dane do istniejącej zawartości i mieszczą się w limitach darmowego planu.

Domyślnym folderem głównym workspace'u jest Tasks/ (możesz go zmienić osobno dla każdego wpisu vaulta w ustawieniach wtyczki).

Workspace'y, hierarchia i przechowywanie#

Terminologia#

Vault Obsidian to folder otwarty w Obsidianie.
Workspace InventTasks to główny katalog menedżera zadań wewnątrz tego vaulta. Ustawienia wtyczki nazywają takie wpisy również Vaults, ponieważ każdy zachowuje się jak osobna instancja InventTasks.
Serwer self-hosted posiada zdalne obiekty typu Task manager lub Vault. Obiekt Task manager zawiera jeden workspace InventTasks, natomiast Vault synchronizuje pozostałą część vaulta Obsidian przez Vault sync.

Workspace'y (Vaults)#

Możesz uruchomić wiele workspace'ów InventTasks w jednym vault Obsidian. Każdy workspace ma:

Własny folder główny z _workspace.md i Space'ami
Własną ikonę na wstążce i nazwę wyświetlaną
Osobne ustawienia każdego workspace'u (strefa czasowa, stan powiadomień, kopie zapasowe, skróty klawiszowe, …)

Przełączaj się, klikając ikonę na wstążce lub Set active w ustawieniach. Konta kalendarza, konto SMTP i konto ntfy konfigurujesz raz dla wtyczki; dane Items i konfiguracja Markdown pozostają oddzielne w każdym workspace. Możesz też usunąć wszystkie workspace'y InventTasks i używać wyłącznie niezależnego modułu Vault sync.

Hierarchia#

Workspace → Space → (opcjonalny Folder) → List → Element → Podelement

Poziom	Na dysku	Przeznaczenie
Workspace	`_workspace.md`	Globalne domyślne: statusy, priorytety, pola własne, funkcje
Space	Folder + `_space.md`	Główny obszar (np. Praca, Osobiste)
Folder	Opcjonalny podfolder + `_folder.md`	Grupuje listy w Space
List	Folder + `_list.md`	Kontener elementów; każdy element ma dokładnie jedną home list
Element	`*.md` w folderze List	Jedna jednostka pracy
Podelement	Osobny plik `*.md` z `parent_task` we frontmatter	Bezpośrednie podelementy albo trzy łączne poziomy drzewa przy włączonych zagnieżdżonych podelementach

Docs znajdują się w _docs/ i pojawiają się w drzewie panelu bocznego. Elementy mogą też występować w dodatkowych listach przez frontmatter, ale status i pola własne zawsze pochodzą z home list. O przynależności do Folderu i Space decyduje również lista domowa: element dodany do listy w innym miejscu pojawi się po otwarciu tej listy — ze znacznikiem ↪ wskazującym jego listę domową — ale nie jest liczony w Folderze ani Space powyżej.

Ważne ścieżki#

_workspace.md, _space.md, _folder.md, _list.md — konfiguracja
_views/view-*.md — definicje zapisanych widoków na poziomie workspace'u lub danej lokalizacji
_templates/ — wielokrotnego użytku szablony
_trash/ — elementy usunięte miękko
_attachments/<item_id>/ — pliki załączników elementów
_workspace-state.md — wspólny stan powiadomień/synchronizacji (powinien synchronizować się między urządzeniami)
_tasks-calendar.ics — opcjonalny plik ICS w głównym katalogu workspace'u InventTasks

Uwagi o synchronizacji#

Wszystkie dane zadań InventTasks to zwykły Markdown. Obsidian Sync (lub iCloud/Dropbox/Git) może utrzymywać Items i konfigurację w zgodności bez serwera InventTasks.
Jeśli edytujesz element w edytorze Obsidian, gdy InventTasks jest otwarty, wtyczka ponownie odczytuje plik po zapisie. Unikaj ręcznej edycji kluczy strukturalnych (id, list, ID relacji), chyba że rozumiesz schemat.
Synchronizuj _workspace-state.md, aby stan odczytania/snooze skrzynki i deduplikacja wysyłek zewnętrznych były spójne między urządzeniami.
Dla powiadomień zewnętrznych wyznacz jeden aktywny komputer wysyłający na vault — dwa komputery sprawdzające terminy jednocześnie mogą powielić wiadomości e-mail lub ntfy, zanim zsynchronizuje się wspólny stan.
Nie synchronizuj tego samego workspace'u InventTasks przez dwa niezależne systemy równocześnie, jeśli nie znasz ich zasad rozwiązywania konfliktów. Na przykład nie uruchamiaj Obsidian Sync i synchronizacji workspace'u InventTasks na tych samych plikach.