Cookbook /
ChordPro-Markup
Within the custom markup -
- added by ChordPro,
ChordPro directives, lyrics, and chords, are specified.
||:
text :||
Lyrics and chords
Text represents lyrics, within which chords, signified by square brackets, viz "[C#m7]", are embedded. Unlike a wiki white space and end of lines are recognised and honoured.
ChordPro directives
ChordPro directives consist of keywords encapsulated in braces (curly brackets), viz "{keyword}". Directives are not case sensitive, must be one per line, other content on a directive line is ignored.
Markup | Description | Note | |
---|---|---|---|
Preamble markup | |||
{title:..} | {t:..} | Song title | Formatted as <h2> |
{subtitle:..} | {st:..} | Subtitle | Usually composer or artist, formatted as <h3> |
{album:..} | {a:..} | Album | Usually composer or artist |
{capo:..} | Capo | Capo position | |
# | Comment line | These lines will not be displayed, must be in column 1. | |
Formatting markup | |||
{comment:..} | {c:..} | Comment | e.g. 'Chorus' |
{comment_italic:..} | {ci:..} | italic comment | |
{comment_box:..} | {cb:..} | Comment Box | |
{start_of_chorus} | {soc} | Start of chorus | For compatibility also recognises {start_of_choir) |
{end_of_chorus} | {eoc} | End of a chorus | For compatibility also recognises {end_of_choir) |
{start_of_tab} | {sot} | Start of tab | For preformatted tab etc |
{end_of_tab} | {eot} | End of a tab | |
Output markup | This recipe recogises these, but ignores them | ||
{artist:..} | Ignored | ||
{chordfont:..} | Ignored | ||
{chordsize:..} | Ignored | ||
{composer:..} | Ignored | ||
{define:..} | Defines a special chord | <chord name> <position> <String6>..<String1> e.g.: G 1 3 2 0 0 0 3 graphical representation of chords | |
{duration:..} | Ignored | ||
{grid} | {g} | Ignored | |
{key:..} | Ignored | ||
{lyricist:..} | Ignored | ||
{rowname} | Ignored | ||
{textfont:..} | Ignored | ||
{textsize:..} | Ignored | ||
{new_page} | {np} | Uses style "clear: both; page-break-after: always; " | May work with some browsers |
{new_physical_page} | {npp} | Uses style "clear: both; page-break-after: always; " | May work with some browsers |
{new_song} | {ns} | Ignored | |
{no_grid} | {ng} | Ignored | |
{tempo:..} | Ignored | ||
{tuning:..} | Ignored | ||
{year:..} | Ignored | ||
['|] | Vertical bar | Use [|] |
References
- http://webchord.sourceforge.net/tech.html
- http://tenbyten.com/software/songsgen/help/HtmlHelp/files_reference.htm
- http://www.vromans.org/johan/projects/Chordii/chordpro/index.html
- http://linkesoft.com/songbook/manual.html#chordproformat
See also
- Cookbook /
- ChordPro-ChordSheets ChordPro chord sheet documentation and examples
- ChordPro-Format ChordPro Basics and text format
- ChordPro-Markup ChordPro markup supported by this recipe
- ChordPro-Sandbox Test and try out ChordPro
- ChordPro-Talk Discussion of ChordPro (Stable)
- ChordPro-Users User notes for the Chord Pro recipe.