Primi passi — installare InventTasks e configurare un workspace

Installazione e primo avvio#

Installazione e attivazione#

1. Scarica inventtasks.zip da https://inventtasks.solidinvent.pl e decomprimilo in <vault>/.obsidian/plugins/ (l'archivio contiene già la cartella inventtasks/), oppure copia una build della release (main.js, manifest.json, styles.css) in .obsidian/plugins/inventtasks/.
2. Riavvia Obsidian o ricarica i plugin.
3. Attiva InventTasks in Impostazioni → Plugin della community.

Il file INSTALL.md incluso nel download contiene le istruzioni per la gestione dei file su desktop e dispositivi mobili. Per aggiornare un'installazione manuale, disattiva InventTasks, sostituisci i file installati del plugin con quelli della nuova versione, ricarica Obsidian e riattiva InventTasks. I dati delle attività restano nella cartella del Workspace all'interno del vault.

Aprire InventTasks#

• Clicca l'icona della barra laterale di InventTasks (una per ogni Workspace/vault configurato).
• Oppure esegui il comando Apri InventTasks dalla palette comandi.

Si apre la vista principale con il navigatore nella barra laterale e la posizione corrente.

Workspace dimostrativo#

Al primo avvio InventTasks crea la configurazione del Workspace e le List di sistema nascoste, ma non genera silenziosamente attività di esempio. Un Workspace vuoto offre:

• Crea il tuo primo Space, oppure
• Carica contenuto demo — uno Space, una List e alcuni Item introduttivi

Puoi anche usare Impostazioni → InventTasks → Aggiungi contenuto iniziale. Per un esempio più ampio con uno Space, un Folder, tre List, 25 Item attivi, campi personalizzati, relazioni, Docs, date e tracciamento del tempo, scegli Aggiungi contenuto completo per i tester. Entrambe le azioni aggiungono dati a quelli esistenti e rispettano i limiti del piano gratuito.

Cartella radice predefinita del Workspace: Tasks/ (modificabile per ogni voce vault nelle impostazioni del plugin).

Workspace, gerarchia e archiviazione#

Terminologia#

• Un vault Obsidian è la cartella aperta da Obsidian.
• Un Workspace InventTasks è la cartella radice del task manager all'interno di quel vault. Nelle impostazioni del plugin queste voci sono chiamate anche Vault, perché ciascuna si comporta come un'istanza InventTasks separata.
• Un server self-hosted contiene oggetti remoti di tipo Task manager o Vault. Un oggetto Task manager contiene un Workspace InventTasks; un oggetto Vault sincronizza il resto di un vault Obsidian tramite Vault sync.

Workspace (Vault)#

Puoi eseguire più Workspace InventTasks all'interno di un singolo vault Obsidian. Ogni Workspace ha:

• La propria cartella radice con _workspace.md e gli Space
• La propria icona nella barra laterale e il nome visualizzato
• Le proprie impostazioni per Workspace (fuso orario, stato notifiche, backup, scorciatoie da tastiera, …)

Passa da un Workspace all'altro cliccando un'icona della barra laterale o scegliendo Imposta come attivo nelle impostazioni. Gli account del calendario, l'account SMTP e l'account ntfy si configurano una volta per l'intero plugin; i dati degli Item e la configurazione Markdown restano separati per Workspace. Puoi anche rimuovere tutti i Workspace InventTasks e utilizzare soltanto il modulo Vault sync indipendente.

Gerarchia#

Workspace → Space → (Folder opzionale) → List → Item → Subitem

I Docs si trovano in _docs/ e compaiono nell'albero della barra laterale. Le attività possono comparire anche in List aggiuntive tramite il frontmatter, ma stato e campi personalizzati provengono sempre dalla List di appartenenza. L'appartenenza di un Folder o di uno Space è determinata anche dalla List di appartenenza: un elemento che aggiungi a una List altrove appare quando apri quella List — contrassegnato con un badge ↪ che ne indica la provenienza — ma non viene conteggiato nella Folder o nello Space sopra quella List.

Percorsi importanti#

• _workspace.md, _space.md, _folder.md, _list.md — configurazione
• _views/view-*.md — definizioni delle viste salvate, a livello di Workspace o posizione
• _templates/ — modelli riutilizzabili
• _trash/ — elementi eliminati in modo reversibile
• _attachments/<item_id>/ — file allegati agli Item
• _workspace-state.md — stato condiviso di notifiche/sincronizzazione (da sincronizzare tra i dispositivi)
• _tasks-calendar.ics — feed ICS opzionale alla radice del workspace InventTasks

Note sulla sincronizzazione#

• Tutti i dati delle attività InventTasks sono semplice Markdown. Obsidian Sync (o iCloud/Dropbox/Git) può mantenere allineati Item e configurazione senza il server InventTasks.
• Se modifichi un'attività nell'editor di Obsidian mentre InventTasks è aperto, il plugin rilegge al salvataggio. Evita di modificare a mano le chiavi strutturali (id, list, ID delle relazioni) se non conosci lo schema.
• Sincronizza _workspace-state.md così lo stato letto/posticipato della inbox e la deduplicazione degli invii esterni restano coerenti tra i dispositivi.
• Per le notifiche esterne, usa preferibilmente un solo computer desktop incaricato dell'invio per vault. Due computer che eseguono i controlli contemporaneamente possono duplicare i messaggi e-mail o ntfy prima che lo stato condiviso venga sincronizzato.
• Non sincronizzare lo stesso Workspace InventTasks con due sistemi indipendenti contemporaneamente, a meno che tu non ne conosca le regole di conflitto. Evita, per esempio, di usare sia Obsidian Sync sia la sincronizzazione del Workspace InventTasks sugli stessi file.