Substitute Plugin
*****************

The "substitute" plugin lets you easily substitute values in your
templates and path formats. Specifically, it is intended to let you
*canonicalize* names such as artists: For example, perhaps you want
albums from The Jimi Hendrix Experience to be sorted into the same
folder as solo Hendrix albums.

This plugin is intended as a replacement for the "rewrite" plugin.
While the "rewrite" plugin modifies the metadata, this plugin does
not.

Enable the "substitute" plugin (see Using Plugins), then make a
"substitute:" section in your config file to contain your rules. Each
rule consists of a case-insensitive regular expression pattern, and a
replacement value. For example, you might use:

   substitute:
      .*jimi hendrix.*: Jimi Hendrix

To apply the substitution, you have to call the function
"%substitute{}" in the paths section. For example:

   paths:
      default: %substitute{$albumartist}/$year -
      $album%aunique{}/$track - $title
