Chordpro Directives Implemented

This is a simplified explanation of the various Chordpro directives that I have implemented here as well as the extensions I have added:

{title: title string} ({t:string}) – Specifies the title of the song. The title appears at the top of the song and the directive should be first.

{artist: artist name} – Specifies name of artist but can be any string you wish – so acts like SubTitle.

{subtitle: subtitle string} ({st:string})  – specifies a subtitle for the song

{start_of_chorus} ({soc}) – Indicates the start of a chorus.  The chorus is indented and a line appears to the left to highlight.

{end_of_chorus} ({eoc}) – Shows the end of a chorus. the indent and left mark will end here

{comment: string} ({c:string}) – Prints the string following the colon as a comment.

{start_of_tab} ({sot}) – Indicates the start of a  tab section. The text will be formatted in a fixed-width font until the end_of_tab directive appears. This can be useful for creating a tab drawing with ASCII text. Guitar tab sections will not be printed on lyrics sheets.

{end_of_tab} ({eot}) – Marks the end of the  tab section.

{column_break} ({colb}) – This directive will force a column break in the song and split the song into multi columns.

{key: xyz} ({k:xyz}) – Key the chart is written in; xyz is a valid key; transposition will apply.

{define: } – Defines the chord positions and optionally fingering for chords in each instrument. Easiest way to use this is via the “A Chord Builder” in the edit box – it will create the defines for you

{new_page} ({np}) – This directive will cause a page break in any PDF’s Printed/Created from the song. It has no effect in the web display of the song.

Extensions Implemented

A number of formatting extensions have been added:

To highlight text in a song use the following around the text to be highlighted

{soh} – Yellow  {eoh}
{sohr} – Red (Tomato) {eoh}
{sohb} – Blue (Cyan) {eoh}
{sohg} – Green (Yellow/Green) {eoh}
{sohp} – Pink {eoh}
{sohy} – Grey (LightGrey) {eoh}
{soho} – Orange {eoh}

{sob} – Text to bolden up {eob}

{soi} – Text to italicise {eoi}

Directives in Chordpro but NOTt implemented here (NOT YET) :

{album: Album Name} – Accepted (but not displayed at this time)

{guitar_comment: string} ({gc:string}) – Prints the string following the colon as a comment. This comment will only be printed if chords are also printed; it should be used for comments to performers, or for other notes that are unneccessary for lyrics-only song sheets.

{new_song} ({ns}) – Marks the beginning of a new song. Although this directive will work with some programs, its use is not recommended, since only the first song in any song file will show up in the “Songs available” list.

{new_physical_page} ({npp}) – This directive will always force a physical page break. It has no effect in the Text and HTML File output destinations.

A number of other directives: Composer, Lyricist, Tempo, Capo, Duration, Time and some around text formatting that are handled by menu items on this site are also not implemented.

Share this:
FacebooktwitterpinterestmailFacebooktwitterpinterestmail

10 thoughts on “Chordpro Directives Implemented

  1. There is also a {np} or {new-page} directive that will skip to a new page when creating a PDF

  2. I have noticed a few {sos} {eos} sections, that show up highlighted and underscored in the song display… eg, Hippopotamus Song
    What are these?

  3. Admittedly a novice, but when I “update” the display moves the chords from where I placed them and puts them above the wrong portion of the lyric-what am I doing wrong and how can I fix this?

    1. I’m sorry for the slow answer on this. I am unclear on what you mean here – can you give me an example on this ?

      Jim

        1. With Chordpro you have to input the chords inline e.g. [D] lyrics [A] and more.
          You then decide in the song (using the Layout menu) whether chords appear on top or inline. But in Edit you MUST put chords inline

  4. Hi Jim, Our Ukulele Group out of Wabeno, Wisconsin (according to their sign, the only Wabeno in the world) uses a lot of your songs for our jam sessions.
    I have started converting some of the songs that are not in your format. Some are in my Favourites already
    Are there any other tips or listings for the Chordpro directives that are published anywhere to help streamline my processing? I have puzzled out some already from other songs but not a complete listing.
    Thanks
    Jim Bauer

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.