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 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 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:
Tab errors in plain-text theme.
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.
Space warnings in plain-text theme.
Space warnings in vi theme.
Syntax files
Here are the Humdrum syntax parsing/highlighting files for the ace editor:
