> For the complete documentation index, see [llms.txt](https://altaisoft.gitbook.io/ysv/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://altaisoft.gitbook.io/ysv/configuration-format.md).

# Configuration format

`ysv` uses standard YAML configuration file format. Here is [cheat sheet](https://kapeli.com/cheat_sheets/YAML.docset/Contents/Resources/Documents/index), just in case.

```yaml
version: 1

# The main section of config file starts. 
# It describes the columns of the OUTPUT CSV dataset
# you want ysv to generate.
columns:
  # first column of that file will be called `name`.
  name:
    # ysv will take the values for that column from 
    # PersonName column of the INPUT file.
    # (Column names are case sensitive!)
    - input: PersonName

    # Then, ysv will uppercase the value
    - uppercase

    # And, it will replace dashes with spaces.
    - replace:
      "-": " "

    # The result will go directly to the output dataset.
```

YAML is well standardized, human readable, supported by multiple text editors with lints and highlighting. It is also easy to generate by software means.

Via this format, `ysv` supports multiple **transformations** you can apply to your data.