• View
• Edit
• History
• Attach
• Print
• Backlinks

ChordPro

Goal

To embed ChordPro-formatted song sheets into a wiki page.

ChordPro is an early text format which was used to quickly generate song list with the chords mixed in with the lyrics. In many ways it is very wiki-like. Its goal is to make a machine-readable songsheet syntax, suitable for pretty-printing, which is also relatively easy on human eyes. Thousands of ChordPro files can be found on websites such as OLGA.

This recipe adds custom markup - ||: text :|| - for embedding ChordPro text within a wiki page. For more information, please refer to the accompanying documentation.

For more information on ChordPro, you'll unfortunately have to do some digging. I suggest starting with the following sites:

• http://linkesoft.com/songbook/manual.html#chordproformat
• Web Chord, an online program which takes ChordPro files and makes them look pretty, and Chordpro format
• http://www.tabs-lyrics.com/ Tabs And Lyrics(approve links)
• Chordie -- http://www.chordie.com/
• Songbird Chords, part of Andy Gryc's Songbird Suite - http://www.gryc.ws/songbirdsuite.htm
• Daniel Polansky's now disappeared Chordpack

Files

• chordpro-0.01.zipΔ
• chordpro.cssΔ (place this file in the directory /pmwiki/pub/chordpro/)

Notes

Releases

• 0.01: Initial beta release.

Known Bugs and Issues

• Printing is not yet supported (no stylesheet)
• Support for generation of chord graphs (little boxes showing chord fingerings) is disabled for now. I need to prevent PmWiki from applying wiki formatting to text generated by this plugin.
• A large percentage of the ChordPro-formatted files out there are badly formatted. This parser could allow a little looser syntax.
• The actual ChordPro manpage seems to have been lost to the mists of time. If anyone can grab me one in HTML, that would rock.
• There's a bug with two or more chordpro blocks on the same page - the markup regex is too greedy and see it all as one block
• There's not much by way of samples yet - hard to GPL an unauthorized interpretation of someone else's published work, especially when the original author is a member of the RIAA and/or ASCAP. I suspect I shall impose some of my own music onto y'all...
• Could you possibly provide some example of how does the recipe look in action? I'd like to see how does ChordPro notation look like + what are the results after the plugin parses it.
  Mateusz November 27, 2005, at 04:11 PM
• I'm officially announcing that this project is on my back burner - way in the farthest back, against the wall, tucked between the tea kettle and the decade-old scent candle that I never light which my mom gave me. Whoops, it has a bit of dust on it, doesn't it. - Sproaticus Profiles March 14, 2006, at 11:39 AM

Contributors

• Sproaticus - Primary author and maintainer
• Simon - CSS