1
0
mirror of https://github.com/Llewellynvdm/conky.git synced 2024-09-29 21:49:07 +00:00
conky/extras/gedit
Matt Sturgeon 4d205ab9a3
gedit: Make better use of gtksourceview syntax
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>
2016-06-23 16:28:19 +01:00
..
conky.lang gedit: Make better use of gtksourceview syntax 2016-06-23 16:28:19 +01:00
README.md gedit: Make better use of gtksourceview syntax 2016-06-23 16:28:19 +01:00

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