4d205ab9a3
Rewrite the gtksourceview highlighting file to make better use of available syntax options. This allows us to separate various contexts, and means we don't have to keep track of all conky keywords. Overview of changes: * Use separate contexts for config block and "lit string". * (lit string is the lua lit string [[ .. ]], we assume that this is used to contain text sections or template blocks) * Use "sub-string" highlighting to highlight parts of identifiers separately. * Added conky.text comments (from '#' to EOL). * Remove lists of keywords and instead rely on syntax implications. * Uses separate contexts for config 'key=val' and text '${var}'s. * Match escape sequences more precisely. * Lua and conky escape sequences matched separately; lua in normal strings and conky in literal strings. See escapes note. * Transition from camelCase to hyphen-separated names * Reword README to reflect changes Escapes note: We also match conky template escape sequences when in lua literal strings as it would be too messy to separate `conky.text` and `templateN = ` literal strings. We currently don't match time format escape sequences as this would require knowing which text variable we are in. This is only possible if we duplicate the `bracket-var` context (less painful than duplicating the `lua-literal-string` context). Signed-off-by: Matt Sturgeon <matt@sturgeon.me.uk> |
||
---|---|---|
.. | ||
conky.lang | ||
README.md |
Gedit syntax highlighting
Note: this highlights based on syntax and does NOT attempt to validate arguments or keywords. The syntax highlighting is unlikely to be 100% accurate and is open to improvement.
The syntax highlighting will automatically be applied to all files with conky
in their name. eg. my_config.conky
(unfortunately it also triggers for the conky.lang
file itself, you should set it to XML manually)
Developers: The main context (id="conkyrc"
) is where gedit begins. This main context then references other sub-contexts. Each context can apply styles to itself, sub-strings from its regexs, or its contents (in the case of <start><end>
"container" contexts). If you are ever confused by something, try searching for XML attributes in the gtksourceview
docs. If you find a particuarly complex regex, try using the Regex Tester linked above, and bear in mind that gtksourceview
adds some extra regex syntax (i.e. \%[ ... ]
and \%{ ... }
).
for medit v1.1.1:
/usr/share/medit/language-specs/conky.lang
for medit - older versions:
/usr/share/medit-1/language-specs/conky.lang
for gedit v2.x
/usr/share/gtksourceview-2.0/language-specs/conky.lang
or (for single user)
~/.local/share/gtksourceview-2.0/language-specs/conky.lang
for gedit v3.x
/usr/share/gtksourceview-3.0/language-specs/conky.lang
or (for single user)
~/.local/share/gtksourceview-3.0/language-specs/conky.lang