mirror of
https://github.com/mickael-menu/zk
synced 2024-11-15 12:12:56 +00:00
56 lines
2.6 KiB
Markdown
56 lines
2.6 KiB
Markdown
# Note configuration
|
||
|
||
The `[note]` section from the [configuration file](config.md) is used to set the [note creation rules](note-creation.md). The following properties are customizable:
|
||
|
||
* `language` (string)
|
||
* Two-letters code of the language used when writing notes, e.g. `en`.
|
||
* This is used to generate slugs or with date formats. For now, only English is fully supported.
|
||
* `default-title` (string)
|
||
* The default title used for new notes when no `--title` option is provided.
|
||
* `filename` (string)
|
||
* [Template](template.md) used to generate the note filename, without its file extension.
|
||
* `extension` (string)
|
||
* File extension for the generated note. By default, `md` (Markdown) is used.
|
||
* `template` (string)
|
||
* Path to the [template](template.md) used to generate the note content.
|
||
* Either an absolute path, or relative to `.zk/templates/`.
|
||
* `id-charset` (string)
|
||
* Characters set used to [generate random IDs](note-id.md).
|
||
* You can use:
|
||
* `letters` for characters from `a` to `z`
|
||
* `numbers` for characters from `0` to `9`
|
||
* `alphanum` for `letters` + `numbers`
|
||
* `hex` for characters from `a` to `f` and `0` to `9`
|
||
* a free string for custom characters
|
||
* `id-length` (integer)
|
||
* Length of the generated random IDs.
|
||
* `id-case` (enum)
|
||
* Letter case for the generated random IDs.
|
||
* Possible values are `lower`, `upper` or `mixed`.
|
||
|
||
## Common filename templates
|
||
|
||
Here are some common filename patterns you may want to use:
|
||
|
||
* `{{id}}` – e.g. `i2hn8.md`
|
||
* Just a [random ID](note-id.md), simple and elegant.
|
||
* To use [Neuron](neuron.md)'s ID format, set:
|
||
```toml
|
||
[note]
|
||
id-charset = "hex"
|
||
id-length = 8
|
||
id-case = "lower"
|
||
```
|
||
* `{{slug title}}` – e.g. `an-interesting-concept.md`
|
||
* A [slugified](template.md) version of the title given with `--title`.
|
||
* Readable and practical for web servers, but fragile in case of renaming.
|
||
* `{{id}}-{{slug title}}` – e.g. `i2hn8-an-interesting-concept.md`
|
||
* The best of both worlds? Readable but if you link only with the prefix ID, you can rename without breaking links.
|
||
* `{{date now 'timestamp'}}` – e.g. `200911172034.md`
|
||
* Verbose, but sortable by creation date and stable.
|
||
* `{{date now 'timestamp'}} {{title}}` – e.g. `200911172034 An interesting concept.md`
|
||
* The format of [The Archive](https://zettelkasten.de/the-archive/) and [sirupsen's zk](https://github.com/sirupsen/zk).
|
||
* `{{date now '%Y-%m-%d'}}` – e.g. `2009-11-17.md`
|
||
* Sortable, human-friendly format for a daily journal.
|
||
* i.e. [Maintaining a daily journal](daily-journal.md).
|