xenia/home
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Made changes suggested by krobelus

Browse Source
This commit is contained in:
Pound_Hash 2022-07-24 14:59:56 -07:00
parent 9364796033
commit 12c2b53105
1 changed files with 25 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

51
doc/pages/faces.asciidoc
View File

@ -17,53 +17,53 @@ fg_color, bg_color, underline_color::
*white* *bright-black*, *bright-red*, *bright-green*, *white* *bright-black*, *bright-red*, *bright-green*,
*bright-yellow* *bright-blue*, *bright-magenta*, *bright-cyan*, *bright-yellow* *bright-blue*, *bright-magenta*, *bright-cyan*,
*bright-white* *bright-white*
The existing color::: The color of the base face (see below):::
*default* *default*
A hexadecimal value::: A hexadecimal value:::
*rgb:RRGGBB*, *rgba:RRGGBBAA* *rgb:RRGGBB*, *rgba:RRGGBBAA*
If left unspecified, the value of *default* is used. If left unspecified, the value of *default* is used.
Alpha values are used to blend the face onto either its base (see below) or Alpha values are used to blend the face onto either its base or else onto
else onto whatever color happens to be used at the moment. For technical whatever color happens to be used at the moment. For technical reasons,
reasons, alpha values must be >16. alpha values must be >16.
attributes:: attributes::
A string whose individual letters each set an attribute: A string whose individual letters each set an attribute:
*u*::: *u*:::
Underline underline
*c*::: *c*:::
Curly underline curly underline
Note: This takes precedence over underline if both are specified. Note: This takes precedence over underline if both are specified.
*r*::: *r*:::
Reverse reverse
*b*::: *b*:::
Bold bold
*B*::: *B*:::
Blink blink
*d*::: *d*:::
Dim dim
*i*::: *i*:::
Italic italic
*s*::: *s*:::
Strikethrough strikethrough
*F*::: *F*:::
Final:::: final::::
Override the previous face instead of merging with Override the previous face instead of merging with it. Can
it. Can only be replaced if another face with the final only be replaced if another face with the final attribute
attribute is applied. is applied.
*f*::: *f*:::
Final foreground:::: final foreground::::
Same as final, but only applies to a face's foreground color. Same as final, but only applies to a face's foreground color.
*g*::: *g*:::
Final background:::: final background::::
Same as final, but only applies to a face's background color. Same as final, but only applies to a face's background color.
*a*::: *a*:::
Final attributes:::: final attributes::::
Same as final, but only applies to a face's attributes. Same as final, but only applies to a face's attributes.
base:: base::
The face onto which the rest of the face applies. Its value can be any The face onto which other faces apply. Its value can be any face name,
face name, as long as no cycle is introduced. A face can reference itself, as long as no cycle is introduced. A face can reference itself, in which
in which case it will apply on top of the parent scope. case it'll apply on top of the version of the parent scope.
== Built-in faces == Built-in faces
@ -71,7 +71,7 @@ The following faces are used by color schemes to highlight certain areas of
the user interface: the user interface:
*Default*:: *Default*::
Default colors::: default colors:::
The default foreground and background colors. If the value of *default* The default foreground and background colors. If the value of *default*
is used here, then the colors used will be your terminal's defaults. is used here, then the colors used will be your terminal's defaults.
@ -174,9 +174,8 @@ For example, the following command displays the text "default" in the
echo -markup 'default {Error}error{Default} default' echo -markup 'default {Error}error{Default} default'
---- ----
Inside a markup string, a literal `{` character is written `\{`, and a literal Inside a markup string, a literal `{` character is written as `\{`, and a
backslash `\` character that precedes a `{` character is escaped as well literal backslash (`\`) character is written as `\\`.
(`\\`).
The `{\}` string disables markup processing for the rest of the line. It The `{\}` string disables markup processing for the rest of the line. It
can be used to avoid having to escape text that might be mistaken for markup can be used to avoid having to escape text that might be mistaken for markup