From 91ca97bcd4027fc5a0e26cb36c63cc3b959fee6e Mon Sep 17 00:00:00 2001 From: lucaronin Date: Tue, 12 May 2026 10:01:30 +0200 Subject: [PATCH] docs: document multi-vault usage --- docs/GETTING-STARTED.md | 8 ++ site/concepts/vaults.md | 10 +++ site/start/getting-started-vault.md | 8 +- site/start/open-or-create-vault.md | 6 ++ src-tauri/resources/agent-docs/all.md | 82 ++++++------------- src-tauri/resources/agent-docs/concepts.md | 10 +++ src-tauri/resources/agent-docs/download.md | 24 ------ src-tauri/resources/agent-docs/index.md | 8 -- .../agent-docs/pages/concepts/vaults.md | 10 +++ .../agent-docs/pages/download/index.md | 24 ------ .../agent-docs/pages/releases/index.md | 22 ----- .../pages/start/getting-started-vault.md | 8 +- .../agent-docs/pages/start/install.md | 4 +- .../pages/start/open-or-create-vault.md | 6 ++ src-tauri/resources/agent-docs/releases.md | 22 ----- .../resources/agent-docs/search-index.json | 24 +----- src-tauri/resources/agent-docs/start.md | 18 +++- 17 files changed, 110 insertions(+), 184 deletions(-) delete mode 100644 src-tauri/resources/agent-docs/download.md delete mode 100644 src-tauri/resources/agent-docs/pages/download/index.md delete mode 100644 src-tauri/resources/agent-docs/pages/releases/index.md delete mode 100644 src-tauri/resources/agent-docs/releases.md diff --git a/docs/GETTING-STARTED.md b/docs/GETTING-STARTED.md index a5af1ccd..48a38074 100644 --- a/docs/GETTING-STARTED.md +++ b/docs/GETTING-STARTED.md @@ -71,6 +71,14 @@ pnpm playwright:regression # Full Playwright regression suite Linux AppImage builds still use the user's system `git`. Before Tolaria spawns that `git` process, it removes AppImage loader overrides such as `LD_LIBRARY_PATH`, `LD_PRELOAD`, and `GIT_EXEC_PATH` so HTTPS clone helpers use the host git libraries instead of bundled AppImage libraries. +## Multiple Vaults At The Same Time + +The `settings.multi_workspace_enabled` flag turns the registered vault list into a unified graph. When enabled, `useVaultLoader` loads every available mounted vault, annotates entries with workspace provenance, and lets note lists, quick open, keyword search, backlinks, and wikilink navigation span those vaults. + +The selected/default vault remains the write and repository focus. New notes and Type documents use `defaultWorkspacePath` when it points at an available mounted vault, while Git status, commits, sync, folder tree, saved views, repair, and watcher behavior stay scoped to explicit repository roots. + +The bottom-left `VaultMenu` exposes quick include/exclude controls and a `Manage vaults` entry. The Vaults settings section owns the full identity controls: display name, short label, read-only alias, accent color, removal, and default destination for new notes. + ## Directory Structure ``` diff --git a/site/concepts/vaults.md b/site/concepts/vaults.md index cc264dc4..ddc47617 100644 --- a/site/concepts/vaults.md +++ b/site/concepts/vaults.md @@ -22,6 +22,16 @@ A plain folder of Markdown files can open as a vault. Git-backed vaults unlock h If a folder is not a Git repository, Tolaria can initialize Git when you explicitly ask it to. It avoids initializing broad personal folders such as Desktop, Documents, or Downloads unless they are clearly dedicated vault folders. +## Multiple Vaults At The Same Time + +Tolaria can load multiple registered vaults into one unified graph. Enable this from `Settings` -> `Vaults` -> `Use multiple vaults at the same time`. + +After the option is enabled, open the bottom-left vault menu to include or exclude vaults from the graph. Included vaults appear together in note lists, search, quick open, backlinks, and wikilink navigation. Each note keeps a compact vault badge when Tolaria needs to disambiguate where it lives. + +The selected vault still matters. Git status, commits, sync, folder navigation, saved views, and vault repair actions stay scoped to the current repository. Use `Manage vaults` from the vault menu or the Vaults settings section to rename vaults, choose colors, and set the default destination for new notes. + +Cross-vault wikilinks use the target vault's stable alias when needed, for example `[[team/projects/alpha]]`. Links inside the same vault stay normal vault-relative links. + ## App State Versus Vault State Vault-level information should travel with the vault. Machine-specific preferences stay with the app installation. diff --git a/site/start/getting-started-vault.md b/site/start/getting-started-vault.md index 970faa9d..8946c72a 100644 --- a/site/start/getting-started-vault.md +++ b/site/start/getting-started-vault.md @@ -21,6 +21,12 @@ To connect a vault to your own remote, use the bottom status bar remote chip or Tolaria also repairs starter-vault guidance files when needed. `AGENTS.md` is the canonical guidance file, `CLAUDE.md` is kept as a compatibility shim, and `GEMINI.md` is only created when you explicitly restore Gemini guidance. +## Use It Alongside Your Own Vaults + +You can keep the Getting Started vault open while working in your own notes. Enable `Settings` -> `Vaults` -> `Use multiple vaults at the same time`, then use the bottom-left vault menu to include both the sample vault and your real vault in the unified graph. + +This lets search, quick open, note lists, backlinks, and wikilink navigation span both vaults. Git actions still stay scoped to each vault's own repository, and new notes go to the default vault you choose in `Manage vaults`. + ## When To Move On -After you understand the sample, open your own vault. Tolaria does not require a special folder structure: a folder of Markdown files is enough to start. +After you understand the sample, open your own vault. Tolaria does not require a special folder structure: a folder of Markdown files is enough to start. You can remove the sample from Tolaria's vault list later without deleting its files from disk. diff --git a/site/start/open-or-create-vault.md b/site/start/open-or-create-vault.md index ab9d8bad..10c6c8d5 100644 --- a/site/start/open-or-create-vault.md +++ b/site/start/open-or-create-vault.md @@ -17,6 +17,12 @@ Good starting points: Choose a new empty folder if you want Tolaria conventions from the start. New notes and optional type definitions are created as Markdown files. +## Use More Than One Vault + +You do not have to merge everything into one folder. Register each local folder as its own vault, then turn on `Use multiple vaults at the same time` in `Settings` -> `Vaults`. + +Once enabled, the bottom-left vault menu lets you include vaults in the unified graph. Search, quick open, wikilinks, and note lists can span the included vaults, while Git sync and commits remain tied to each vault's own repository. + ## Git Is Recommended, Not Required Tolaria works well with a plain folder of Markdown files. You can open, edit, organize, and search notes without making the vault a Git repository. diff --git a/src-tauri/resources/agent-docs/all.md b/src-tauri/resources/agent-docs/all.md index 1489d737..10de4825 100644 --- a/src-tauri/resources/agent-docs/all.md +++ b/src-tauri/resources/agent-docs/all.md @@ -78,9 +78,15 @@ To connect a vault to your own remote, use the bottom status bar remote chip or Tolaria also repairs starter-vault guidance files when needed. `AGENTS.md` is the canonical guidance file, `CLAUDE.md` is kept as a compatibility shim, and `GEMINI.md` is only created when you explicitly restore Gemini guidance. +## Use It Alongside Your Own Vaults + +You can keep the Getting Started vault open while working in your own notes. Enable `Settings` -> `Vaults` -> `Use multiple vaults at the same time`, then use the bottom-left vault menu to include both the sample vault and your real vault in the unified graph. + +This lets search, quick open, note lists, backlinks, and wikilink navigation span both vaults. Git actions still stay scoped to each vault's own repository, and new notes go to the default vault you choose in `Manage vaults`. + ## When To Move On -After you understand the sample, open your own vault. Tolaria does not require a special folder structure: a folder of Markdown files is enough to start. +After you understand the sample, open your own vault. Tolaria does not require a special folder structure: a folder of Markdown files is enough to start. You can remove the sample from Tolaria's vault list later without deleting its files from disk. --- @@ -97,9 +103,9 @@ Tolaria publishes desktop builds for macOS, Windows, and Linux. macOS is the pri Use the latest stable release unless you are intentionally testing pre-release builds: -- [Download the latest stable build](https://refactoringhq.github.io/tolaria/download/) +- Download the latest stable build - [Browse all GitHub releases](https://github.com/refactoringhq/tolaria/releases) -- [Read the release notes](/releases/) +- Read the release notes ## Homebrew @@ -152,6 +158,12 @@ Good starting points: Choose a new empty folder if you want Tolaria conventions from the start. New notes and optional type definitions are created as Markdown files. +## Use More Than One Vault + +You do not have to merge everything into one folder. Register each local folder as its own vault, then turn on `Use multiple vaults at the same time` in `Settings` -> `Vaults`. + +Once enabled, the bottom-left vault menu lets you include vaults in the unified graph. Search, quick open, wikilinks, and note lists can span the included vaults, while Git sync and commits remain tied to each vault's own repository. + ## Git Is Recommended, Not Required Tolaria works well with a plain folder of Markdown files. You can open, edit, organize, and search notes without making the vault a Git repository. @@ -543,6 +555,16 @@ A plain folder of Markdown files can open as a vault. Git-backed vaults unlock h If a folder is not a Git repository, Tolaria can initialize Git when you explicitly ask it to. It avoids initializing broad personal folders such as Desktop, Documents, or Downloads unless they are clearly dedicated vault folders. +## Multiple Vaults At The Same Time + +Tolaria can load multiple registered vaults into one unified graph. Enable this from `Settings` -> `Vaults` -> `Use multiple vaults at the same time`. + +After the option is enabled, open the bottom-left vault menu to include or exclude vaults from the graph. Included vaults appear together in note lists, search, quick open, backlinks, and wikilink navigation. Each note keeps a compact vault badge when Tolaria needs to disambiguate where it lives. + +The selected vault still matters. Git status, commits, sync, folder navigation, saved views, and vault repair actions stay scoped to the current repository. Use `Manage vaults` from the vault menu or the Vaults settings section to rename vaults, choose colors, and set the default destination for new notes. + +Cross-vault wikilinks use the target vault's stable alias when needed, for example `[[team/projects/alpha]]`. Links inside the same vault stay normal vault-relative links. + ## App State Versus Vault State Vault-level information should travel with the vault. Machine-specific preferences stay with the app installation. @@ -1460,56 +1482,4 @@ Resolve interrupted merges or corrupted repository state before retrying. ## Reload -Run `Reload Vault` from the command palette. This clears derived cache and rescans the filesystem. - ---- - -# Download - -Source: download/index.md -URL: /download/ - -# Download - -Download Tolaria from the latest stable release. - -## Latest Stable - -[Open the installer download page](https://refactoringhq.github.io/tolaria/download/) - -The download page reads the latest stable release metadata and points you to the current macOS, Windows, or Linux artifact. - -## Other Builds - -- [Browse all GitHub releases](https://github.com/refactoringhq/tolaria/releases) -- [Read release history](/releases/) -- [Learn release channels](/reference/release-channels) - -## Verify The Version - -After launching the app, check the version shown in Tolaria's status bar or release surface. - ---- - -# Releases - -Source: releases/index.md -URL: /releases/ - -# Releases - -Tolaria releases are published on GitHub. - -- [Latest release](https://github.com/refactoringhq/tolaria/releases/latest) -- [All releases](https://github.com/refactoringhq/tolaria/releases) -- [Download page](/download/) - -## Release Channels - -Stable builds are intended for normal use. Pre-release builds may contain newer features and rougher edges. - -Tolaria also has an Alpha channel for builds generated from pushes to `main`. See [Release Channels](/reference/release-channels) before switching from Stable. - -## Before Updating - -Commit or push important vault changes before updating the app. Your notes are local files, but having a clean Git state makes recovery easier. \ No newline at end of file +Run `Reload Vault` from the command palette. This clears derived cache and rescans the filesystem. \ No newline at end of file diff --git a/src-tauri/resources/agent-docs/concepts.md b/src-tauri/resources/agent-docs/concepts.md index 0ebccf44..4d194da8 100644 --- a/src-tauri/resources/agent-docs/concepts.md +++ b/src-tauri/resources/agent-docs/concepts.md @@ -381,6 +381,16 @@ A plain folder of Markdown files can open as a vault. Git-backed vaults unlock h If a folder is not a Git repository, Tolaria can initialize Git when you explicitly ask it to. It avoids initializing broad personal folders such as Desktop, Documents, or Downloads unless they are clearly dedicated vault folders. +## Multiple Vaults At The Same Time + +Tolaria can load multiple registered vaults into one unified graph. Enable this from `Settings` -> `Vaults` -> `Use multiple vaults at the same time`. + +After the option is enabled, open the bottom-left vault menu to include or exclude vaults from the graph. Included vaults appear together in note lists, search, quick open, backlinks, and wikilink navigation. Each note keeps a compact vault badge when Tolaria needs to disambiguate where it lives. + +The selected vault still matters. Git status, commits, sync, folder navigation, saved views, and vault repair actions stay scoped to the current repository. Use `Manage vaults` from the vault menu or the Vaults settings section to rename vaults, choose colors, and set the default destination for new notes. + +Cross-vault wikilinks use the target vault's stable alias when needed, for example `[[team/projects/alpha]]`. Links inside the same vault stay normal vault-relative links. + ## App State Versus Vault State Vault-level information should travel with the vault. Machine-specific preferences stay with the app installation. diff --git a/src-tauri/resources/agent-docs/download.md b/src-tauri/resources/agent-docs/download.md deleted file mode 100644 index 640833c6..00000000 --- a/src-tauri/resources/agent-docs/download.md +++ /dev/null @@ -1,24 +0,0 @@ -# Download - -Source: download/index.md -URL: /download/ - -# Download - -Download Tolaria from the latest stable release. - -## Latest Stable - -[Open the installer download page](https://refactoringhq.github.io/tolaria/download/) - -The download page reads the latest stable release metadata and points you to the current macOS, Windows, or Linux artifact. - -## Other Builds - -- [Browse all GitHub releases](https://github.com/refactoringhq/tolaria/releases) -- [Read release history](/releases/) -- [Learn release channels](/reference/release-channels) - -## Verify The Version - -After launching the app, check the version shown in Tolaria's status bar or release surface. \ No newline at end of file diff --git a/src-tauri/resources/agent-docs/index.md b/src-tauri/resources/agent-docs/index.md index b9868aac..e48916ed 100644 --- a/src-tauri/resources/agent-docs/index.md +++ b/src-tauri/resources/agent-docs/index.md @@ -63,14 +63,6 @@ Start here, then use `rg` over this folder for specific Tolaria concepts and wor - [Sync Conflicts](pages/troubleshooting/sync-conflicts.md) - [Vault Not Loading](pages/troubleshooting/vault-not-loading.md) -## Download - -- [Download](pages/download/index.md) - -## Releases - -- [Releases](pages/releases/index.md) - ## Generated Files - `all.md`: all public docs concatenated for fast full-context reads. diff --git a/src-tauri/resources/agent-docs/pages/concepts/vaults.md b/src-tauri/resources/agent-docs/pages/concepts/vaults.md index c46095af..fb28941f 100644 --- a/src-tauri/resources/agent-docs/pages/concepts/vaults.md +++ b/src-tauri/resources/agent-docs/pages/concepts/vaults.md @@ -27,6 +27,16 @@ A plain folder of Markdown files can open as a vault. Git-backed vaults unlock h If a folder is not a Git repository, Tolaria can initialize Git when you explicitly ask it to. It avoids initializing broad personal folders such as Desktop, Documents, or Downloads unless they are clearly dedicated vault folders. +## Multiple Vaults At The Same Time + +Tolaria can load multiple registered vaults into one unified graph. Enable this from `Settings` -> `Vaults` -> `Use multiple vaults at the same time`. + +After the option is enabled, open the bottom-left vault menu to include or exclude vaults from the graph. Included vaults appear together in note lists, search, quick open, backlinks, and wikilink navigation. Each note keeps a compact vault badge when Tolaria needs to disambiguate where it lives. + +The selected vault still matters. Git status, commits, sync, folder navigation, saved views, and vault repair actions stay scoped to the current repository. Use `Manage vaults` from the vault menu or the Vaults settings section to rename vaults, choose colors, and set the default destination for new notes. + +Cross-vault wikilinks use the target vault's stable alias when needed, for example `[[team/projects/alpha]]`. Links inside the same vault stay normal vault-relative links. + ## App State Versus Vault State Vault-level information should travel with the vault. Machine-specific preferences stay with the app installation. diff --git a/src-tauri/resources/agent-docs/pages/download/index.md b/src-tauri/resources/agent-docs/pages/download/index.md deleted file mode 100644 index 640833c6..00000000 --- a/src-tauri/resources/agent-docs/pages/download/index.md +++ /dev/null @@ -1,24 +0,0 @@ -# Download - -Source: download/index.md -URL: /download/ - -# Download - -Download Tolaria from the latest stable release. - -## Latest Stable - -[Open the installer download page](https://refactoringhq.github.io/tolaria/download/) - -The download page reads the latest stable release metadata and points you to the current macOS, Windows, or Linux artifact. - -## Other Builds - -- [Browse all GitHub releases](https://github.com/refactoringhq/tolaria/releases) -- [Read release history](/releases/) -- [Learn release channels](/reference/release-channels) - -## Verify The Version - -After launching the app, check the version shown in Tolaria's status bar or release surface. \ No newline at end of file diff --git a/src-tauri/resources/agent-docs/pages/releases/index.md b/src-tauri/resources/agent-docs/pages/releases/index.md deleted file mode 100644 index 091e4d4a..00000000 --- a/src-tauri/resources/agent-docs/pages/releases/index.md +++ /dev/null @@ -1,22 +0,0 @@ -# Releases - -Source: releases/index.md -URL: /releases/ - -# Releases - -Tolaria releases are published on GitHub. - -- [Latest release](https://github.com/refactoringhq/tolaria/releases/latest) -- [All releases](https://github.com/refactoringhq/tolaria/releases) -- [Download page](/download/) - -## Release Channels - -Stable builds are intended for normal use. Pre-release builds may contain newer features and rougher edges. - -Tolaria also has an Alpha channel for builds generated from pushes to `main`. See [Release Channels](/reference/release-channels) before switching from Stable. - -## Before Updating - -Commit or push important vault changes before updating the app. Your notes are local files, but having a clean Git state makes recovery easier. \ No newline at end of file diff --git a/src-tauri/resources/agent-docs/pages/start/getting-started-vault.md b/src-tauri/resources/agent-docs/pages/start/getting-started-vault.md index 86650f7a..8b4c6d61 100644 --- a/src-tauri/resources/agent-docs/pages/start/getting-started-vault.md +++ b/src-tauri/resources/agent-docs/pages/start/getting-started-vault.md @@ -26,6 +26,12 @@ To connect a vault to your own remote, use the bottom status bar remote chip or Tolaria also repairs starter-vault guidance files when needed. `AGENTS.md` is the canonical guidance file, `CLAUDE.md` is kept as a compatibility shim, and `GEMINI.md` is only created when you explicitly restore Gemini guidance. +## Use It Alongside Your Own Vaults + +You can keep the Getting Started vault open while working in your own notes. Enable `Settings` -> `Vaults` -> `Use multiple vaults at the same time`, then use the bottom-left vault menu to include both the sample vault and your real vault in the unified graph. + +This lets search, quick open, note lists, backlinks, and wikilink navigation span both vaults. Git actions still stay scoped to each vault's own repository, and new notes go to the default vault you choose in `Manage vaults`. + ## When To Move On -After you understand the sample, open your own vault. Tolaria does not require a special folder structure: a folder of Markdown files is enough to start. \ No newline at end of file +After you understand the sample, open your own vault. Tolaria does not require a special folder structure: a folder of Markdown files is enough to start. You can remove the sample from Tolaria's vault list later without deleting its files from disk. \ No newline at end of file diff --git a/src-tauri/resources/agent-docs/pages/start/install.md b/src-tauri/resources/agent-docs/pages/start/install.md index b8c32edf..54ef8945 100644 --- a/src-tauri/resources/agent-docs/pages/start/install.md +++ b/src-tauri/resources/agent-docs/pages/start/install.md @@ -11,9 +11,9 @@ Tolaria publishes desktop builds for macOS, Windows, and Linux. macOS is the pri Use the latest stable release unless you are intentionally testing pre-release builds: -- [Download the latest stable build](https://refactoringhq.github.io/tolaria/download/) +- Download the latest stable build - [Browse all GitHub releases](https://github.com/refactoringhq/tolaria/releases) -- [Read the release notes](/releases/) +- Read the release notes ## Homebrew diff --git a/src-tauri/resources/agent-docs/pages/start/open-or-create-vault.md b/src-tauri/resources/agent-docs/pages/start/open-or-create-vault.md index e97cad81..3c51751c 100644 --- a/src-tauri/resources/agent-docs/pages/start/open-or-create-vault.md +++ b/src-tauri/resources/agent-docs/pages/start/open-or-create-vault.md @@ -22,6 +22,12 @@ Good starting points: Choose a new empty folder if you want Tolaria conventions from the start. New notes and optional type definitions are created as Markdown files. +## Use More Than One Vault + +You do not have to merge everything into one folder. Register each local folder as its own vault, then turn on `Use multiple vaults at the same time` in `Settings` -> `Vaults`. + +Once enabled, the bottom-left vault menu lets you include vaults in the unified graph. Search, quick open, wikilinks, and note lists can span the included vaults, while Git sync and commits remain tied to each vault's own repository. + ## Git Is Recommended, Not Required Tolaria works well with a plain folder of Markdown files. You can open, edit, organize, and search notes without making the vault a Git repository. diff --git a/src-tauri/resources/agent-docs/releases.md b/src-tauri/resources/agent-docs/releases.md deleted file mode 100644 index 091e4d4a..00000000 --- a/src-tauri/resources/agent-docs/releases.md +++ /dev/null @@ -1,22 +0,0 @@ -# Releases - -Source: releases/index.md -URL: /releases/ - -# Releases - -Tolaria releases are published on GitHub. - -- [Latest release](https://github.com/refactoringhq/tolaria/releases/latest) -- [All releases](https://github.com/refactoringhq/tolaria/releases) -- [Download page](/download/) - -## Release Channels - -Stable builds are intended for normal use. Pre-release builds may contain newer features and rougher edges. - -Tolaria also has an Alpha channel for builds generated from pushes to `main`. See [Release Channels](/reference/release-channels) before switching from Stable. - -## Before Updating - -Commit or push important vault changes before updating the app. Your notes are local files, but having a clean Git state makes recovery easier. \ No newline at end of file diff --git a/src-tauri/resources/agent-docs/search-index.json b/src-tauri/resources/agent-docs/search-index.json index 116c2e35..a6ccf1a4 100644 --- a/src-tauri/resources/agent-docs/search-index.json +++ b/src-tauri/resources/agent-docs/search-index.json @@ -26,6 +26,7 @@ "headings": [ "What It Demonstrates", "Local-Only By Default", + "Use It Alongside Your Own Vaults", "When To Move On" ] }, @@ -49,6 +50,7 @@ "headings": [ "Open An Existing Folder", "Create A New Vault", + "Use More Than One Vault", "Git Is Recommended, Not Required" ] }, @@ -168,6 +170,7 @@ "Core Rules", "Why Local Files Matter", "Git Is A Capability", + "Multiple Vaults At The Same Time", "App State Versus Vault State" ] }, @@ -459,26 +462,5 @@ "Check Git", "Reload" ] - }, - { - "title": "Download", - "path": "pages/download/index.md", - "url": "/download/", - "section": "download", - "headings": [ - "Latest Stable", - "Other Builds", - "Verify The Version" - ] - }, - { - "title": "Releases", - "path": "pages/releases/index.md", - "url": "/releases/", - "section": "releases", - "headings": [ - "Release Channels", - "Before Updating" - ] } ] diff --git a/src-tauri/resources/agent-docs/start.md b/src-tauri/resources/agent-docs/start.md index 2971df97..60333f1e 100644 --- a/src-tauri/resources/agent-docs/start.md +++ b/src-tauri/resources/agent-docs/start.md @@ -69,9 +69,15 @@ To connect a vault to your own remote, use the bottom status bar remote chip or Tolaria also repairs starter-vault guidance files when needed. `AGENTS.md` is the canonical guidance file, `CLAUDE.md` is kept as a compatibility shim, and `GEMINI.md` is only created when you explicitly restore Gemini guidance. +## Use It Alongside Your Own Vaults + +You can keep the Getting Started vault open while working in your own notes. Enable `Settings` -> `Vaults` -> `Use multiple vaults at the same time`, then use the bottom-left vault menu to include both the sample vault and your real vault in the unified graph. + +This lets search, quick open, note lists, backlinks, and wikilink navigation span both vaults. Git actions still stay scoped to each vault's own repository, and new notes go to the default vault you choose in `Manage vaults`. + ## When To Move On -After you understand the sample, open your own vault. Tolaria does not require a special folder structure: a folder of Markdown files is enough to start. +After you understand the sample, open your own vault. Tolaria does not require a special folder structure: a folder of Markdown files is enough to start. You can remove the sample from Tolaria's vault list later without deleting its files from disk. --- @@ -88,9 +94,9 @@ Tolaria publishes desktop builds for macOS, Windows, and Linux. macOS is the pri Use the latest stable release unless you are intentionally testing pre-release builds: -- [Download the latest stable build](https://refactoringhq.github.io/tolaria/download/) +- Download the latest stable build - [Browse all GitHub releases](https://github.com/refactoringhq/tolaria/releases) -- [Read the release notes](/releases/) +- Read the release notes ## Homebrew @@ -143,6 +149,12 @@ Good starting points: Choose a new empty folder if you want Tolaria conventions from the start. New notes and optional type definitions are created as Markdown files. +## Use More Than One Vault + +You do not have to merge everything into one folder. Register each local folder as its own vault, then turn on `Use multiple vaults at the same time` in `Settings` -> `Vaults`. + +Once enabled, the bottom-left vault menu lets you include vaults in the unified graph. Search, quick open, wikilinks, and note lists can span the included vaults, while Git sync and commits remain tied to each vault's own repository. + ## Git Is Recommended, Not Required Tolaria works well with a plain folder of Markdown files. You can open, edit, organize, and search notes without making the vault a Git repository.