@c -*- texinfo -*-

@chapter LS Colors

@float Figure,fig:screenshot_ls-colors
@center @image{screenshots/bashstyle-ng_ls-colors,,, BashStyle-NG LS Colors, png}
@caption{LS Colors}
@end float

@heading Basic

@defvr {Setting} use_lscolors Customize LS Colors
This master switch will make @b{BashStyle-NG} adjust the @code{LS_COLORS}
environment variable to make @code{ls}, and other commands utilizing it, use your
color settings.
@end defvr

@defvr {Setting} custom Custom
Define additional settings for @code{LS_COLORS}, if @code{use_vivid} is enabled,
this will still work, as your custom settings are the last to be enabled.

The syntax is @code{*filetype=colordefinition}, for example
@code{*README.md=0;38;2;239;241;245;48;2;223}, sets an orange background and
white text for @code{README.md} files, of course more simple color definitions
like @code{*.png=01;35} which will make @code{.png} files appear magneta, work
as well.
@end defvr

@defvr {Setting} use_vivid Use vivid
@code{vivid} (@url{https://github.com/sharkdp/vivid}) is a generator for
@code{LS_COLORS}, whichs uses YAML configuration. If @code{vivid} is installed,
you can use it instead of manual configuration from @b{BashStyle-NG}.
@end defvr

@defvr {Setting} vivid_cholorscheme Choose vivid color scheme
Choose which predefinied colorscheme to use for @code{vivid}, use
@code{vivid preview $theme} for a preview in your terminal.
@end defvr

If you don't want to use @code{vivid} the following settings allow to customize
the most commong file types manually, using @b{Bashstyle-NG}'s predefined colors,
note: the color style from the Style Settings apply here aswell.

Theese are disabled, when @code{vivid} is in use.