====== Songlist plugin ======

---- plugin ----
description: Generate wiki code from lines of a master page, indexed by IDs
author     : Reinhold Kainhofer
email      : reinhold@kainhofer.com
type       : syntax
lastupdate : 2008-09-03
compatible : Release 2008-05-05
depends    :
conflicts  :
similar    :
tags       : list, pages
----



This [[plugin]] implements generating wiki code from lines of a master file. Each line in the master file that is indicated by an ID can be included in the current page. I use this for [[http://www.jung-wien.at/|our choir]], where we have a large repertoire of songs, which we can perform. The program for a given concert is simply generated by selecting some songs of that master repertoire list. Text that does not match any ID in the maste file is inserted as verbatim wiki code.

===== Syntax =====
Usage of the plugin inside a wiki page:
<code><songlist [src=]masterlist>
id1
id2
</songlist></code>

This takes all lines from the page named "masterlist", which are indexed by id1 and id2. The masterlist has the following syntax:
<code>some wiki text|id
lines without ID can be written but cannot be included by <songlist..>
some more wiki text|anotherid</code>
===== Notes =====
  * You can try it at [[http://wiki.kainhofer.com/playground/songlist/test|Reinhold's test wiki]]
  * Tested with [[http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2006-03-09b.tgz?id=projects%3Adokuwiki&cache=cache|2006-03-09b]]
  * Author: [[http://reinhold.kainhofer.com/|Reinhold Kainhofer]], Code is licensed under GPL 2.

===== Example =====
Generate a master page (let's say ":playground:songlistdata"), that contains lines of the form:
<code>==== Masses ====
  * **"Petite Messe Solennelle"** (G. Rossini): [[wp>Petite Messe Solennelle|Wikipedia]]|Rossini
  * **"Missa di gloria"** (G. Puccini): [[wp>Puccini|Wikipedia]]|Puccini

==== Others ====
  * **"Ave Verum"** (Wolfgang Amadeus MOZART): [[wp>Ave Verum|Wikipedia]]|Ave Verum
</code>

Each line can now be used by the ID after the last |.

In your page you can now use the plugin as
<code><songlist src=:playground:songlistdata>
==== Songlist for the concert ====
Ave Verum
Rossini
  * //BREAK//
Puccini
</songlist></code>

This will effectively have the same effect as simply writing 
<code>
==== Songlist for the concert ====
  * **"Ave Verum"** (Wolfgang Amadeus MOZART): [[wp>Ave Verum|Wikipedia]]
  * **"Petite Messe Solennelle"** (G. Rossini): [[wp>Petite Messe Solennelle|Wikipedia]]
  * //BREAK//
  * **"Missa di gloria"** (G. Puccini): [[wp>Puccini|Wikipedia]]
</code>
and thus generate an output:

==== Songlist for the concert ====
  * **"Ave Verum"** (Wolfgang Amadeus MOZART): [[wp>Ave Verum|Wikipedia]]
  * **"Petite Messe Solennelle"** (G. Rossini): [[wp>Petite Messe Solennelle|Wikipedia]]
  * //BREAK//
  * **"Missa di gloria"** (G. Puccini): [[wp>Puccini|Wikipedia]]


===== Configuration =====
No configuration is needed.

===== Installation =====
Download: [[http://reinhold.kainhofer.com/Download/songlist_latest.zip|songlist_latest.zip, Version 0.2, 3. Sept. 2008]] (use this link with the Plugin Manager)

===== Version history and Changelog =====
  * [[http://reinhold.kainhofer.com/Download/songlist-0.1_2006-11-12.zip|Version 0.1]] (12. November 2006): Initial Release
  * [[http://reinhold.kainhofer.com/Download/songlist-0.2_2008-09-03.zip|Version 0.2]] (3. September 2008): ID comparison is case-insensitive, punctuation marks (,.-'?! etc) are ignored for the comparioson, too.

===== Todo =====

===== Bugs =====

===== Discussion =====

===== Feature requests =====