-
Notifications
You must be signed in to change notification settings - Fork 4
Themes
Highlight v3.49
An introduction to Highlight color themes.
Table of Contents
Color themes are just Lua files with the .theme file extension.
Highlight ships with more than 190 themes, grouped in two subfolders:
-
themes/— The default themes. -
themes/base16/— The Base16 themes (enable with--base16option).
This subdivision was done to make themes usage more practical, and both Highlight GUI and command line tool allow to chose between the two sets.
Since Highlight v3.49, each theme can be associated with one or more categories, providing quick way to filter themes by kewywords when querying Highlight for the list of available themes. For example, to list all the available dark themes:
D:\>highlight --list-scripts=themes --list-cat=dark
Installed language definitions matching "dark" (located in C:\Program Files\Highlight\themes\):
aiseered : vim aiseered
andes : Andes
anotherdark : vim anotherdark
base16\3024 : Base16 3024
base16\apathy : Base16 Apathy
base16\ashes : Base16 Ashes
base16\atelier-cave : Base16 Atelier Cave
...
Currently, the following category keywords are being used with themes: dark/light, vim, base16.
You can always query Highlight via the command line option --help=theme to get summary help information:
THEME HELP:
A colour theme defines the formatting of recognized syntax elements.
These descriptions are saved as Lua scripts in HL_DATA_DIR/themes.
Apply custom themes with --config-file.
Use plug-in scripts (--plug-in) to modify the formatting output.
Print all installed themes with --list-scripts=themes.
Use --base16 to read a theme of the Base16 set.
Exemplary config files:
darkspectrum.theme: dark canvas (vim)
edit-eclipse: light canvas (IDE)
bespin.lang: dark canvas (Base16)
Refer to README files for configuration syntax and examples.
See the CLI-Help page for an always up to date output of the --help=theme option.