1
0
mirror of https://github.com/deadc0de6/dotdrop.git synced 2026-02-05 17:53:52 +00:00
Files
dotdrop/docs/config-uservars.md
2022-05-27 12:37:57 +02:00

42 lines
1.1 KiB
Markdown

# Uservariables entry
The **uservariables** entry (optional) contains a collection of variables
whose values are queried from the user
(See [User variables](config-variables.md)).
```yaml
uservariables:
<variable-name>: <prompt>
```
If you want to manually enter variables' values, you can use the
`uservariables` entry. Each variable will be prompted to the user.
For example:
```yaml
uservariables:
emailvar: "email"
```
will prompt the user to enter a value for the variable `emailvar`:
```
Please provide the value for "email":
```
And store the entered text as the value for the variable `email`.
The variable can then be used as any other [variable](config-file.md#variables).
`uservariables` are eventually saved to `uservariables.yaml` (relatively to the
config file).
This allows to use the following construct to prompt once for some specific variables and
then store them in a file. You might also want to add `uservariables.yaml` to your `.gitignore`.
```yaml
uservariables:
emailvar: "email"
config:
import_variables:
- uservariables.yaml:optional
```
For an example, see [prompt user for variables](howto/prompt-user-for-variables.md).