kakoune/doc/manpages/faces.asciidoc

115 lines
2.4 KiB
Plaintext
Raw Normal View History

KAKOUNE(1)
==========
NAME
----
faces - a
Declaration
-----------
2016-02-10 22:03:49 +01:00
A 'face' refers how the specified text is displayed, it has a foreground
color, a background color, and some attributes. The value of a face has the
following format:
--------------------------------
fg_color[,bg_color][+attributes]
--------------------------------
'fg_color', 'bg_color'::
a color whose value can be expressed in the following formats:
*black*, *red*, *green*, *yellow*, *blue*, *magenta*, *cyan*, *white*:::
a named color
*default*:::
keep the existing color
*rgb:RRGGBB*:::
hexadecimal value
'attributes'::
string whose individual letters set an attribute:
*u*:::
underline
*r*:::
reverse
*b*:::
bold
*B*:::
blink
*d*:::
dim
*i*:::
italic
*e*:::
2016-02-10 22:03:49 +01:00
exclusive, override previous faces instead of merging
with them
Builtin faces
-------------
2016-04-08 18:00:24 +02:00
The following default faces are used by color schemes to highlight certain
2016-02-10 22:03:49 +01:00
areas of the user interface:
*Default*::
default colors
*PrimarySelection*::
main selection face for every selected character except the cursor
*SecondarySelection*::
secondary selection face for every selected character except the cursor
*PrimaryCursor*::
cursor of the primary selection
*SecondaryCursor*::
cursor of the secondary selection
*LineNumbers*::
face used by the number_lines highlighter
*LineNumberCursor*::
face used to highlight the line number of the main selection
2017-05-11 19:38:27 +02:00
*LineNumbersWrapped*::
2017-05-01 22:26:50 +02:00
face used to highlight the line number of wrapped lines
*MenuForeground*::
face for the selected element in menus
*MenuBackground*::
face for the not selected elements in menus
*MenuInfo*::
face for additional information for elements in menus
*Information*::
face for the informations windows and information messages
*Error*::
face of error messages
*StatusLine*::
face used for the status line
*StatusLineMode*::
face used for the current mode except the normal mode
*StatusLineInfo*::
face used for special information
*StatusLineValue*::
face used for special values (numeric prefixes, registers, etc.)
*StatusCursor*::
face used for the status line cursor
*Prompt*::
face used prompt displayed on the status line
*MatchingChar*::
face used by the show_matching highlighter
2016-02-17 14:55:19 +01:00
*BufferPadding*::
face applied on the characters that follow the last line of a buffer
*Whitespace*::
face used by the show_whitespaces highlighter