Extension:Score

What can this extension do?
This extension can render musical scores as PNG images using LilyPond.

Acknowledgements

 * The original Extension:LilyPond was written by Johannes E. Schindelin.
 * This extension is based on a code review of Extension:LilyPond by Tim Starling.

Usage
You can embed simple LilyPond notation into your wikitext using the  tags. For example: yields:



The lilypond software is also capable of creating MIDI files. Use

and the rendered image will be embedded into a hyperlink to an appropriate MIDI file. For more complex scores, you may supply a complete LilyPond file with

You may also combine the raw and midi attributes, but remember that in this case, you need to provide the necessary  block yourself.

Prerequisites
This extension uses LilyPond to render score images, so you need a working LilyPond installation. If you want the extension to trim the score files for you, you will also need ImageMagick.

This extension was tested with MediaWiki 1.18.0 and LilyPond 2.12.3.

Download instructions
You can download a tarball from GitHub:, or as a zipped file:.

Installation

 * 1) Change to the   directory of your MediaWiki installation.
 * 2) Create a new subdirectory named.
 * 3) Copy the files ,   and   from the distribution into the new subdirectory. Make sure they are readable by your webserver. If you do not create this directory, the Score extension will attempt to create it for you with the rights available to it.
 * 4) Create a subdirectory named   in your $wgUploadDirectory (usually the directory named   in in your MediaWiki directory). Make sure the directory is writable by your webserver.
 * 5) Add the following to LocalSettings.php:

Configuration parameters
Currently, the extension has two global configuration parameters:  and.

Set  to the path to your LilyPond executable (typically   or  ).

The  is a boolean which defaults to the value of. If, the resulting score PNG images are trimmed with ImageMagick. If you don't want trimming, or don't want to install ImageMagick, set  to.

You may have to increase $wgMaxShellMemory if you get out of memory errors.