A workspace is a collection of one or more vaults. This is a folder that contains all the files necessary to manage your information in Dendron.
The workspace is the top most folder you create when you run
Dendron: Initialize Workspace. It is at the same level where the
dendron.yml file is located.
A workspace contains one or more vaults, with a single vault being the most common (see when you might want multiple vaults for scenarios that might require additional vaults)
The folder that contains files like
dendron.code-workspace is the top-level directory of a workspace, known as the workspace root.
A workspace that is created using
A workspace that is created with a
dendron.yml file and lacking a
A bare workspace is a workspace where all vaults inside are remote vaults (separate git repos). You can have a bare code workspace or a bare native workspace.
Synchronize all notes across all vaults with git.
Any changes you made will be pushed back to remote, and any changes in the remote will be pulled.
Dendron recognizes two types of workspaces, Code and Native. When you initialize your workspace with
the Initialize Workspace command, you get a Code
workspace. Code workspaces include a
dendron.code-workspace file which sets up vaults and
recommends installing some useful extensions. Code workspaces are great when you are setting up a
Native workspaces on the other hand don't have a
They are useful when you are writing notes or documentation, and you want to
keep your notes as part of a project rather than a separate knowledge base.
See Native Workspace Setup to see how you can start using a native workspace!
Version control your workspace using Git
Inside your workspace, run the following
- Initialize a git repo
git init git add . git commit -m "initial commit"
- Add a remote
- go to GitHub, and create a new workspace
- follow instructions to add an existing git repo to the repository
Syncing your workspace with Git
Workspace Sync does not sync the workspace if all your vaults are separate git repos. In order to synchronize your workspace, you need to explicitly do a
git pull from the workspace folder.
If you are inside VS Code, you should be able to run
> Create Integrated Terminal..., choose the folder containing your workspace, and launch the terminal. After launching, run a
git pull inside of it.