Groups #

Syncing only one group is boring. We can also add more groups.

Assuming your configuration files for VSCode lies at ~/dt/VSCode/User/settings.json, the group for syncing this file can be:

[[local]]
name = "VSCode"
base = "~/dt/VSCode"
sources = ["User/settings.json"]
target = "~/.config/Code - OSS/"

Appending this VSCode group to our previous config file, we obtain:

[global]
allow_overwrite = true


[[local]]
name = "Neovim"
base = "~/dt/nvim"
sources = ["*init.vim"]
target = "~/.config/nvim"
[[local]]
name = "VSCode"
base = "~/dt/VSCode"
sources = ["User/settings.json"]
target = "~/.config/Code - OSS/"

After syncing with this config, the target item ~/.config/Code - OSS/User/settins.json will be a symlink of the staged item~/.local/share/dt/staging/VSCode/User/settings.json, where the staged item mirrors the content of the source item~/dt/VSCode/User/settings.json.

Overriding Default Behaviours #

But what if we exceptionally want the VSCode group to not overwrite the target file if it already exists? No worries, here is the recipe of overriding a default behaviour for the VSCode group:

[[local]]
name = "VSCode"
base = "~/dt/VSCode"
sources = ["User/settings.json"]
target = "~/.config/Code - OSS/"

allow_overwrite = false

A group's behaviour will precedent the default behaviour if explicitly specified. Listing all overridable configs and their default values here:

• allow_overwrite: false
• hostname_sep: "@@"
• method: "Symlink"

References to those keys can be found at Key References.