A Description of the two editing modes in VHV, and Humdrum syntax coloring.

Text editing in Verovio Humdrum Viewer uses the ace editor. There are two modes in which the contents can be edited: (1) the initial simple-text editor (2) a vi editor useful to people who know vi/vim. Switch between these two modes by pressing alt-v.

Plain-text mode

The Plain-text editing mode is indicated by a light background, closely matching the background color of the notation area of the page:

light-themed colorizing
Light theme coloring for plain-text mode.

When editing Humdrum files, their contents will be colored by syntactic function:

example
meaning
**kern
exclusive interpretations
*^
spine manipulators
*M4/4
tandem interpretations
*>A     
section labels
!!!OTL:
reference records
!! comment
global comments
!bass
local comments
example
meaning
!LO:N:vis=0
layout commands
!!!filter: autobeam
filters
!!!Xfilter: autobeam
used filters
=2
barlines
.
null tokens
4E
data tokens
   
active cursor line

vi mode

dark-themed colorizing
Dark theme coloring for vi mode (alt-v).

Syntax coloring in vi mode:

example
meaning
**kern
exclusive interpretations
*^
spine manipulators
*M4/4
tandem interpretations
*>A     
section labels
!!!OTL:
reference records
!! comment
global comments
!bass
local comments
example
meaning
!LO:N:vis=0
layout commands
!!!filter: autobeam
filters
!!!Xfilter: autobeam
used filters
=2
barlines
.
null tokens
4E
data tokens
   
active cursor line

Basic syntax error highlighting

Tab syntax errors

Tabs cannot start a line, end a line, or occur more than once between tokens in the Humdrum syntax. Any of these invalid cases will be highlighted in red:

dark-themed colorizing
Tab errors in plain-text theme.
dark-themed colorizing
Tab errors in vi theme.

Space syntax warnings

Generally tokens do not start or end with space characters, and multiple sub-tokens are separated by a single space (in data formats such as **kern). When a token starts or ends with a space, or there is more than one space between subtokens, the space will be highlighted in blue. Usually this is a syntax error that should be fixed.

dark-themed colorizing
Space warnings in plain-text theme.
dark-themed colorizing
Space warnings in vi theme.

Syntax files

Here are the Humdrum syntax parsing/highlighting files for the ace editor: