File: configuration.md

package info (click to toggle)
settle 0.40.1-9
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 1,024 kB
  • sloc: makefile: 42; sh: 1
file content (32 lines) | stat: -rw-r--r-- 1,047 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# Configuration

The configuration options are passed in YAML format. The location of the
configuration file may be influenced by environment variables:

1. if `$SETTLE_CONFIG` is set: `$SETTLE_CONFIG`
2. if `$XDG_CONFIG_HOME` is set: `$XDG_CONFIG_HOME/settle/settle.yaml`
3. default: `$HOME/.config/settle/settle.yaml`

A generic configuration file is automatically created when `settle` is ran with
any command (except `compl`), if it doesn't already exist.

### Configuration option

NOTE: the paths specified in configuration may contain environment variables, or
a leading tilde.

- `zettelkasten` - path to the directory in which the notes are stored at

    If you don't specify an absolute path, e.g. `notes`, it's assumed you want
    your Zettelkasten to be at `~/notes`.

- `template` - path to the [template file for new Zettel](./templates.md)

    If empty, or if the path is invalid, then templates won't be used.

### Example configuration file

```YAML
zettelkasten: ~/docs/zettelkasten
template: ~/.config/settle/template.md
```