Kiwi wiki | Cookbook / Chord Pro

Version 2010-07-17

Summary: Display ChordPro-formatted song sheets in a wiki page

Version: 2009-10-01

Prerequisites: Requires at least PmWiki version: 2.0; last tested on PmWiki version: pmwiki-2.2

Status: Beta

Maintainer: skiwi

Categories: Editing, Layout, Markup

Discussion: ChordPro-Talk

File: chordpro-2009-10-01.zip

Description

Use ChordPro formatted lyrics and tablature in a PmWiki page to embed and display ChordPro-formatted song sheets into a wiki page.

Markup

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.

This recipe adds custom markup - ||: text :|| - for embedding ChordPro text within a wiki page. Within the custom markup ChordPro directives consist of keywords encapsulated in braces (curly brackets), viz "{keyword}", and text representing lyrics, within which chords, signified by square brackets, viz "[C#m7]", are embedded.

See ChordPro markup for details.

Formatting

All formatting is controlled by CSS. By default the chords and lyrics text is monospaced and the same size, however this is not necessary.

The spacing between the chording and the lyrics is controlled by the line-height CSS property. The spacing between each line of the song is controlled by padding above the chords and padding below the lyrics.

Modify chordpro.css to change colours, font-size, font-family, spacing etc. It is quite easy to do so and the CSS file is commented.

Installation

Download and unzip the archive chordpro-2009-10-01.zip.

move the chordpro.php file to the /cookbook/ directory
move the chordpro.css file to the /pub/css/ directory unless you have customised it previously

Add the following line to config.php

@include_once("$FarmD/cookbook/chordpro.php");

Notes

Releases

2009-10-01

Change handling of Title, Subtitle, and Album. Better cope with two directives on one line. Add CSS for page breaks and page directives. Adjust CSS for line-height and song line spacing.

2009-08-20

A significant release providing css controlled formatting for wiki pages and printing, with correct handling of blank lines

Contributors

skiwi - CSS, subsequent versions
Sproaticus ? - original version

References

http://webchord.sourceforge.net/(approve sites)
Web Chord(approve sites), an online program which takes ChordPro files and makes them look pretty, and Chordpro format(approve sites)
Chordie(approve sites) -- http://www.chordie.com/(approve sites) Search Engine specializing in Chopro-files
Songbird Chords, part of Andy Gryc's Songbird Suite - http://www.gryc.ws/songbirdsuite.htm(approve sites)
Daniel Polansky's now disappeared Chordpack(approve sites)

http://linkesoft.com/songbook/manual.html#chordproformat(approve sites)
http://mujweb.cz/www/danielpolansky/chordpack/chordpack-documentation.html#quick(approve sites)

http://webchord.sourceforge.net/tech.html(approve sites)
http://tenbyten.com/software/songsgen/help/HtmlHelp/files_reference.htm(approve sites)
http://www.vromans.org/johan/projects/Chordii/chordpro/index.html(approve sites)
http://linkesoft.com/songbook/manual.html#chordproformat(approve sites)

Cookbook

Topics

Changed

Chord Pro