FooBarWidget-mizuho 0.9.0

data/asciidoc/doc/main.aap

@@ -0,0 +1,293 @@
+#####################################################################
+#
+# A-A-P file for making AsciiDoc distribution documents.
+# (you can obtain A-A-P from http://www.a-a-p.org)
+#
+# Stuart Rackham <srackham@gmail.com>
+#####################################################################
+
+:execute ../common.aap
+
+# Uncomment next line to use dblatex instead of FOP, or alternatively
+# include PDF_PROCESSOR=dblatex on the command-line.
+#PDF_PROCESSOR = dblatex
+
+#####################################################################
+# Programs used by this script.
+#####################################################################
+
+# If python is not in your executable search path you may have to
+# tweak these locations. Note also that this script is in the distribution
+# ./doc directory and a number of paths are relative.
+
+## Older or alternative rules and actions have been commented out but not
+#  deleted.
+
+@if OSTYPE == 'mswin':
+    ASCIIDOC = python ..\asciidoc.py -a revision=$(VERS)@ -a date="$(DATE)@" 
+    HHC = "C:\Program Files\HTML Help Workshop\hhc.exe"
+    FOP = fop.bat
+@else:
+    ASCIIDOC = python ../asciidoc.py -a revision=$(VERS)@ -a date="$(DATE)@" 
+    @if os.uname()[0][:6] == 'CYGWIN':
+        HHC = "c:/Program\ Files/HTML\ Help\ Workshop/hhc.exe"
+        :syseval which fop.bat | :assign FOP
+    @else:
+        HHC =
+        :syseval which fop.sh | :assign FOP
+
+:syseval which jw | :assign JW              # Converts DocBook SGML to PDF.
+:syseval which lynx | :assign LYNX          # Converts HTML to text.
+:syseval which xmllint | :assign XMLLINT    # Validates XML.
+:syseval which dblatex | :assign DBLATEX    # Converts DocBook XML to PDF.
+
+## xsltproc(1) is used instead of xmlto(1).
+#XMLTO = xmlto
+ASPELL = aspell
+XSLTPROC = xsltproc
+
+ROOT = asciidoc asciidoc.1
+INFILES = $*(ROOT).txt
+CHUNK_DIR = ./asciidoc.chunked
+HTMLHELP_DIR = ./asciidoc.htmlhelp
+HTMLHELP_FILE = asciidoc
+
+OUTFILES = $*(ROOT).html $*(ROOT).css.html $*(ROOT).css-embedded.html \
+        asciidoc.pdf asciidoc.1.man a2x.1.man \
+        article.html book.html book-multi.html asciidoc.xml asciidoc.1.xml \
+        ../BUGS ../CHANGELOG ../README ../INSTALL \
+        latex-backend.html \
+        ${HTMLHELP_FILE}.chm \
+        $CHUNK_DIR/index.html \
+        article.pdf \
+        source-highlight-filter.pdf \
+        music-filter.pdf
+
+TEST_FILES = $*(ROOT).css-embedded.html 
+        article.css-embedded.html book.css-embedded.html \
+        article.xml book.xml book-multi.xml asciidoc.xml asciidoc.1.xml \
+        asciidoc.1.html a2x.1.xml music-filter.xml
+
+
+#####################################################################
+# Filetype build rules.
+#####################################################################
+
+:rule %.text : %.txt
+    # Convert AsciiDoc to HTML then use lynx(1) to convert HTML to text.
+    @if _no.OSTYPE != 'posix':
+        :print WARNING: non-POSIX environment: skipping $target file generation
+    @elif not _no.LYNX:
+        :print WARNING: lynx(1) unavailable: skipping $target file generation
+    @else:
+        opt = -f ../text.conf
+        @if source_list[0] == 'asciidoc.1.txt':
+            opt += -d manpage
+        @else:
+            opt += -n
+        :sys $ASCIIDOC $opt -b html4 -o - $source | \
+            lynx -dump -stdin > $target
+
+## The preceding rule makes a better job of producing plain text.
+#:rule %.text : %.xml 
+#   :sys $XMLTO txt $source
+
+:rule %.css.html : %.txt
+    opt =
+    @if source_list[0] == 'asciidoc.1.txt':
+        opt += -d manpage
+    @else:
+        opt += -n
+        opt += -a toc -a toclevels=2 -a scriptsdir=../javascripts
+    :sys $ASCIIDOC $opt -b xhtml11 -a linkcss -a icons -a stylesdir=../stylesheets -o $target $(source[0])
+    @if _no.XMLLINT:
+        :sys $XMLLINT --nonet --noout --valid $target
+    @else:
+        :print WARNING: xmllint(1) unavailable: skipping validation
+
+:rule %.css-embedded.html : %.txt
+    opt =
+    @if source_list[0] == 'asciidoc.1.txt':
+        opt += -d manpage
+    @else:
+        opt += -n
+        opt += -a toc -a toclevels=2
+    :sys $ASCIIDOC -b xhtml11 $opt -o $target $(source[0])
+    @if _no.XMLLINT:
+        :sys $XMLLINT --nonet --noout --valid $target
+    @else:
+        :print WARNING: xmllint(1) unavailable: skipping validation
+
+:rule %.xml : %.txt
+    opt =
+    @if source_list[0] in ('asciidoc.1.txt','a2x.1.txt'):
+        opt += -d manpage
+    @else:
+        opt += -n
+##
+#    @if source_list[0] == 'asciidoc.txt':
+#        # User Guide is a book.
+#        opt += -d book
+    :sys $ASCIIDOC $opt -b docbook $(source[0])
+    @if _no.XMLLINT:
+        # Don't validate against DTD (using --valid option) because of
+        # non-standard dblatex <programlisting> 'linenumbering' attribute.
+        #:sys $XMLLINT --nonet --noout --valid $target
+        :sys $XMLLINT --nonet --noout $target
+    @else:
+        :print WARNING: xmllint(1) unavailable: skipping validation
+
+:rule %.sgml : %.txt
+    opt =
+    @if source_list[0] in ('asciidoc.1.txt','a2x.1.txt'):
+        opt += -d manpage
+    :sys $ASCIIDOC $opt -b docbook-sgml $(source[0])
+
+:rule %.html: %.xml
+#   :sys $XMLTO xhtml-nochunks $source
+    :sys $XSLTPROC --nonet --stringparam admon.textlabel 0 --stringparam html.stylesheet ./docbook-xsl.css ../docbook-xsl/xhtml.xsl $source >$target
+
+## Generate plain HTML from DocBook XML using the preceeding rule.
+#:rule %.html : %.txt
+#   opt =
+#   @if source_list[0] == 'asciidoc.1.txt':
+#       opt += -d manpage
+#   @else:
+#       opt += -n
+#   :sys $ASCIIDOC $opt -b xhtml $(source[0])
+
+:rule %.man : %.xml
+    :sys $XSLTPROC --nonet ../docbook-xsl/manpage.xsl $source
+    :sys touch $target  # Dummy target.
+
+## Generate manpage from XML using preceeding rule.
+#:rule %.man : %.sgml
+#   :sys $JW -b man $(match).sgml
+#   :sys touch $target  # Dummy target.
+
+:rule %.fo: %.xml
+    :sys $XSLTPROC --nonet --stringparam admon.textlabel 0 ../docbook-xsl/fo.xsl $source >$target
+
+# This kludge forces the User Guide PDF to be generated using dblatex
+# so we include a dblatex example in the distribution.
+@if _no.DBLATEX:
+    asciidoc.pdf: asciidoc.xml
+        :sys $DBLATEX -p ../dblatex/asciidoc-dblatex.xsl -s ../dblatex/asciidoc-dblatex.sty -o $target $source
+
+# Force the Source Highlighter PDF to be generated using dblatex
+# because dblatex has builtin source code highlighting.
+@if _no.DBLATEX:
+    source-highlight-filter.pdf: source-highlight-filter.xml
+        :sys $DBLATEX -p ../dblatex/asciidoc-dblatex.xsl -s ../dblatex/asciidoc-dblatex.sty -o $target $source
+
+# Try PDF generators in order of preference.
+@if _no.DBLATEX and _no.get('PDF_PROCESSOR') and _no.PDF_PROCESSOR == 'dblatex':
+    :rule %.pdf: %.xml
+        :sys $DBLATEX -p ../dblatex/asciidoc-dblatex.xsl -s ../dblatex/asciidoc-dblatex.sty -o $target $source
+@elif _no.FOP:
+    :rule %.pdf: %.fo
+        :sys $FOP $source $target
+@elif _no.JW:
+    :rule %.pdf: %.sgml
+        :sys $JW -b pdf $source
+@else:
+    :rule %.pdf:
+        :print WARNING: PDF processor  unavailable: skipping $target file generation
+
+## jw(1) renders better PDF than xmlto(1) (see preceeding rule).
+#:rule %.pdf : %.xml 
+#   :sys $XMLTO pdf $source
+
+
+#####################################################################
+# Explicit file generation (cases that don't fit the rules).
+#####################################################################
+
+asciidoc.1.html: asciidoc.1.txt
+    :sys $ASCIIDOC -d manpage -b html4 $source
+    @if _no.XMLLINT:
+        :sys $XMLLINT --nonet --noout --valid --html $target
+    @else:
+        :print WARNING: xmllint(1) unavailable: skipping validation
+
+# User Guide 'chunked' into linked HTML pages.
+$CHUNK_DIR/index.html: asciidoc.xml
+    :mkdir {f} $CHUNK_DIR
+    :del {f} {q} $CHUNK_DIR/*.html
+    :sys $XSLTPROC --nonet --stringparam base.dir $CHUNK_DIR/ --stringparam html.stylesheet ../docbook-xsl.css ../docbook-xsl/chunked.xsl $source
+
+# HTML Help formatted User Guide.
+$HTMLHELP_DIR/index.html: asciidoc.xml
+    :mkdir {f} $HTMLHELP_DIR
+    :del {f} {q} $HTMLHELP_DIR/*.html
+    :sys $XSLTPROC --nonet --stringparam admon.textlabel 0 --stringparam base.dir $HTMLHELP_DIR/ --stringparam html.stylesheet ../docbook-xsl.css --stringparam htmlhelp.hhp ${HTMLHELP_FILE}.hhp --stringparam htmlhelp.chm ${HTMLHELP_FILE}.chm ../docbook-xsl/htmlhelp.xsl $source
+
+${HTMLHELP_FILE}.chm: $HTMLHELP_DIR/index.html
+    @if _no.HHC:
+        :sys {f} "$HHC" ${HTMLHELP_FILE}.hhp
+    @else:
+        :print WARNING: HTMLHelp compiler unavailable: skipping asciidoc.chm file generation
+
+# Book template.
+book.xml: book.txt
+    :sys $ASCIIDOC -d book -b docbook $source
+    @if _no.XMLLINT:
+        :sys $XMLLINT --nonet --noout --valid $target
+    @else:
+        :print WARNING: xmllint(1) unavailable: skipping validation
+
+# Multi-part book template.
+book-multi.xml: book-multi.txt
+    :sys $ASCIIDOC -d book -b docbook $source
+    @if _no.XMLLINT:
+        :sys $XMLLINT --nonet --noout --valid $target
+    @else:
+        :print WARNING: xmllint(1) unavailable: skipping validation
+
+../BUGS: ../BUGS.text
+    # Make BUGS.text and copy to BUGS.
+    :copy ../BUGS.text ../BUGS
+
+../CHANGELOG: ../CHANGELOG.text
+    # Make CHANGELOG.text and copy to CHANGELOG.
+    :copy ../CHANGELOG.text ../CHANGELOG
+
+../README: ../README.text
+    # Make README.text and copy to README.
+    :copy ../README.text ../README
+
+../INSTALL: ../INSTALL.text
+    # Make INSTALL.text and copy to INSTALL.
+    :copy ../INSTALL.text ../INSTALL
+
+asciimath.html: asciimath.txt
+    :sys $ASCIIDOC -a asciimath $source
+    # No xmllint(1) checking -- fails on embedded JavaScript.
+
+latexmath.html: latexmath.txt
+    :sys $ASCIIDOC -a latexmath $source
+    # No xmllint(1) checking -- fails on embedded JavaScript.
+
+
+#####################################################################
+# Build commands.
+#####################################################################
+
+all: $OUTFILES
+
+clean:
+    :del {f} $OUTFILES $TEST_FILES
+    :del {f} *.bak          # Remove aspell backups.
+
+spell: $INFILES ../CHANGELOG.txt ../README.txt ../BUGS.txt ../INSTALL.txt \
+        a2x.1.txt
+    # Interactively spell check all files.
+    @for s in source_list:
+        :sys {i} $ASPELL check -p ./asciidoc.dict $s
+
+clean_testfiles:
+    :del {f} $TEST_FILES
+    :del {f} music*.png     # Force Lilypond to run.
+
+test: clean_testfiles $TEST_FILES
+    # Force generation and validation of .html and Docbook (.xml) files.

data/asciidoc/doc/music-filter.html

@@ -0,0 +1,513 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
+    "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+<meta name="generator" content="AsciiDoc 8.2.7" />
+<style type="text/css">
+/* Debug borders */
+p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
+/*
+  border: 1px solid red;
+*/
+}
+
+body {
+  margin: 1em 5% 1em 5%;
+}
+
+a {
+  color: blue;
+  text-decoration: underline;
+}
+a:visited {
+  color: fuchsia;
+}
+
+em {
+  font-style: italic;
+  color: navy;
+}
+
+strong {
+  font-weight: bold;
+  color: #083194;
+}
+
+tt {
+  color: navy;
+}
+
+h1, h2, h3, h4, h5, h6 {
+  color: #527bbd;
+  font-family: sans-serif;
+  margin-top: 1.2em;
+  margin-bottom: 0.5em;
+  line-height: 1.3;
+}
+
+h1, h2, h3 {
+  border-bottom: 2px solid silver;
+}
+h2 {
+  padding-top: 0.5em;
+}
+h3 {
+  float: left;
+}
+h3 + * {
+  clear: left;
+}
+
+div.sectionbody {
+  font-family: serif;
+  margin-left: 0;
+}
+
+hr {
+  border: 1px solid silver;
+}
+
+p {
+  margin-top: 0.5em;
+  margin-bottom: 0.5em;
+}
+
+ul, ol, li > p {
+  margin-top: 0;
+}
+
+pre {
+  padding: 0;
+  margin: 0;
+}
+
+span#author {
+  color: #527bbd;
+  font-family: sans-serif;
+  font-weight: bold;
+  font-size: 1.1em;
+}
+span#email {
+}
+span#revision {
+  font-family: sans-serif;
+}
+
+div#footer {
+  font-family: sans-serif;
+  font-size: small;
+  border-top: 2px solid silver;
+  padding-top: 0.5em;
+  margin-top: 4.0em;
+}
+div#footer-text {
+  float: left;
+  padding-bottom: 0.5em;
+}
+div#footer-badges {
+  float: right;
+  padding-bottom: 0.5em;
+}
+
+div#preamble,
+div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
+div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
+div.admonitionblock {
+  margin-right: 10%;
+  margin-top: 1.5em;
+  margin-bottom: 1.5em;
+}
+div.admonitionblock {
+  margin-top: 2.5em;
+  margin-bottom: 2.5em;
+}
+
+div.content { /* Block element content. */
+  padding: 0;
+}
+
+/* Block element titles. */
+div.title, caption.title {
+  color: #527bbd;
+  font-family: sans-serif;
+  font-weight: bold;
+  text-align: left;
+  margin-top: 1.0em;
+  margin-bottom: 0.5em;
+}
+div.title + * {
+  margin-top: 0;
+}
+
+td div.title:first-child {
+  margin-top: 0.0em;
+}
+div.content div.title:first-child {
+  margin-top: 0.0em;
+}
+div.content + div.title {
+  margin-top: 0.0em;
+}
+
+div.sidebarblock > div.content {
+  background: #ffffee;
+  border: 1px solid silver;
+  padding: 0.5em;
+}
+
+div.listingblock {
+  margin-right: 0%;
+}
+div.listingblock > div.content {
+  border: 1px solid silver;
+  background: #f4f4f4;
+  padding: 0.5em;
+}
+
+div.quoteblock > div.content {
+  padding-left: 2.0em;
+}
+
+div.attribution {
+  text-align: right;
+}
+div.verseblock + div.attribution {
+  text-align: left;
+}
+
+div.admonitionblock .icon {
+  vertical-align: top;
+  font-size: 1.1em;
+  font-weight: bold;
+  text-decoration: underline;
+  color: #527bbd;
+  padding-right: 0.5em;
+}
+div.admonitionblock td.content {
+  padding-left: 0.5em;
+  border-left: 2px solid silver;
+}
+
+div.exampleblock > div.content {
+  border-left: 2px solid silver;
+  padding: 0.5em;
+}
+
+div.verseblock div.content {
+  white-space: pre;
+}
+
+div.imageblock div.content { padding-left: 0; }
+div.imageblock img { border: 1px solid silver; }
+span.image img { border-style: none; }
+
+dl {
+  margin-top: 0.8em;
+  margin-bottom: 0.8em;
+}
+dt {
+  margin-top: 0.5em;
+  margin-bottom: 0;
+  font-style: normal;
+}
+dd > *:first-child {
+  margin-top: 0.1em;
+}
+
+ul, ol {
+    list-style-position: outside;
+}
+div.olist > ol {
+  list-style-type: decimal;
+}
+div.olist2 > ol {
+  list-style-type: lower-alpha;
+}
+
+div.tableblock > table {
+  border: 3px solid #527bbd;
+}
+thead {
+  font-family: sans-serif;
+  font-weight: bold;
+}
+tfoot {
+  font-weight: bold;
+}
+
+div.hlist {
+  margin-top: 0.8em;
+  margin-bottom: 0.8em;
+}
+div.hlist td {
+  padding-bottom: 15px;
+}
+td.hlist1 {
+  vertical-align: top;
+  font-style: normal;
+  padding-right: 0.8em;
+}
+td.hlist2 {
+  vertical-align: top;
+}
+
+@media print {
+  div#footer-badges { display: none; }
+}
+
+div#toctitle {
+  color: #527bbd;
+  font-family: sans-serif;
+  font-size: 1.1em;
+  font-weight: bold;
+  margin-top: 1.0em;
+  margin-bottom: 0.1em;
+}
+
+div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
+  margin-top: 0;
+  margin-bottom: 0;
+}
+div.toclevel2 {
+  margin-left: 2em;
+  font-size: 0.9em;
+}
+div.toclevel3 {
+  margin-left: 4em;
+  font-size: 0.9em;
+}
+div.toclevel4 {
+  margin-left: 6em;
+  font-size: 0.9em;
+}
+/* Workarounds for IE6's broken and incomplete CSS2. */
+
+div.sidebar-content {
+  background: #ffffee;
+  border: 1px solid silver;
+  padding: 0.5em;
+}
+div.sidebar-title, div.image-title {
+  color: #527bbd;
+  font-family: sans-serif;
+  font-weight: bold;
+  margin-top: 0.0em;
+  margin-bottom: 0.5em;
+}
+
+div.listingblock div.content {
+  border: 1px solid silver;
+  background: #f4f4f4;
+  padding: 0.5em;
+}
+
+div.quoteblock-content {
+  padding-left: 2.0em;
+}
+
+div.exampleblock-content {
+  border-left: 2px solid silver;
+  padding-left: 0.5em;
+}
+
+/* IE6 sets dynamically generated links as visited. */
+div#toc a:visited { color: blue; }
+
+/* Because IE6 child selector is broken. */
+div.olist2 ol {
+  list-style-type: lower-alpha;
+}
+div.olist2 div.olist ol {
+  list-style-type: decimal;
+}
+</style>
+<title>Music Filter</title>
+</head>
+<body>
+<div id="header">
+<h1>Music Filter</h1>
+</div>
+<div id="preamble">
+<div class="sectionbody">
+<div class="para"><p>The <em>AsciiDoc</em> distribution includes a Music Block filter that
+translates music in <a href="http://lilypond.org/">LilyPond</a> or
+<a href="http://abcnotation.org.uk/">ABC</a> notation to standard classical
+notation in the form of a trimmed PNG image which is automatically
+inserted into the <em>AsciiDoc</em> output document (see the <a href="#X1">examples below</a>).</p></div>
+<div class="para"><p>Actually the filter (<tt>./filters/music2png.py</tt>) can be used outside
+<em>AsciiDoc</em> to convert LilyPond or ABC music files to PNG images.
+Execute the following command to see how to use it:</p></div>
+<div class="literalblock">
+<div class="content">
+<pre><tt>$ ./filters/music2png.py --help</tt></pre>
+</div></div>
+<div class="para"><p>The Music Filter can be used as a model for filters that convert a
+block of text into a file that is linked or embedded into the <em>AsciiDoc</em>
+output document.</p></div>
+<div class="exampleblock" id="X1">
+<div class="title">Example 1: Music Block containing ABC notation</div>
+<div class="exampleblock-content">
+<div class="para"><p>This Music Block:</p></div>
+<div class="listingblock">
+<div class="content">
+<pre><tt> [music,music1.png]
+ ---------------------------------------------------------------------
+ T:The Butterfly
+ R:slip jig
+ C:Tommy Potts
+ H:Fiddle player Tommy Potts made this tune from two older slip jigs,
+ H:one of which is called "Skin the Peelers" in Roche's collection.
+ H:This version by Peter Cooper.
+ D:Bothy Band: 1975.
+ M:9/8
+ K:Em
+ vB2(E G2)(E F3)|B2(E G2)(E F)ED|vB2(E G2)(E F3)|(B2d) d2(uB A)FD:|
+ |:(vB2c) (e2f) g3|(uB2d) (g2e) (dBA)|(B2c) (e2f) g2(ua|b2a) (g2e) (dBA):|
+ |:~B3 (B2A) G2A|~B3 BA(uB d)BA|~B3 (B2A) G2(A|B2d) (g2e) (dBA):|
+ ---------------------------------------------------------------------</tt></pre>
+</div></div>
+<div class="para"><p>Renders:</p></div>
+<div class="musicblock">
+<div class="content">
+<img style="border-width: 0;" src="music1.png" alt="music1.png" />
+</div></div>
+</div></div>
+<div class="exampleblock" id="X2">
+<div class="title">Example 2: Music Block containing LilyPond notation</div>
+<div class="exampleblock-content">
+<div class="para"><p>This example contains LilyPond musical markup, it uses the <em>link</em>
+attribute so you can click on the music image to display the source
+notation. The <tt>music2.ly</tt> source file is automatically created and
+retained by the <tt>music2png.py</tt> filter when the <tt>-m</tt> option is used.</p></div>
+<div class="listingblock">
+<div class="content">
+<pre><tt> ["music", "music2.png", "ly", link="music2.ly"]
+ ---------------------------------------------------------------------
+ \version "2.10.0"
+ \paper {
+   ragged-right = ##t
+ }
+ {
+   \time 3/4
+   \clef bass
+   c2 e4 g2. f4 e d c2 r4
+ }
+ ---------------------------------------------------------------------</tt></pre>
+</div></div>
+<div class="para"><p>Renders:</p></div>
+<div class="musicblock">
+<div class="content">
+<a href="music2.ly">
+<img style="border-width: 0;" src="music2.png" alt="music2.png" />
+</a>
+</div></div>
+</div></div>
+<div class="admonitionblock">
+<table><tr>
+<td class="icon">
+<div class="title">Note</div>
+</td>
+<td class="content">If you get an error processing the above example it may be that
+it is not compatible with your version of LilyPond. Use the LilyPond
+<tt>convert-ly(1)</tt> utility to update the source to the version that you
+are using.</td>
+</tr></table>
+</div>
+</div>
+</div>
+<h2 id="_using_the_filter">Using the Filter</h2>
+<div class="sectionbody">
+<div class="para"><p>Insert a delimited Music Block containing valid ABC notation into your
+<em>AsciiDoc</em> document:</p></div>
+<div class="ilist"><ul>
+<li>
+<p>
+The Music Block delimiter is the word <tt>music</tt> followed by four or
+  more tilde characters.
+</p>
+</li>
+<li>
+<p>
+The Music Block attribute list must contain a file name for the PNG
+  output image file followed by the input format (either <em>abc</em> for ABC
+  or <em>ly</em> for LilyPond). If the format is omitted ABC notation is
+  assumed.
+</p>
+</li>
+<li>
+<p>
+The filter invokes <tt>music2png</tt> with the <tt>-m</tt> option so that music
+  images will only be regenerated if the block content has changed.
+</p>
+</li>
+<li>
+<p>
+The optional named block attributes <em>link</em>, <em>width</em> and <em>height</em> are
+  also available (see <a href="userguide.html#X55">Image macro attributes</a>
+  in the <em>AsciiDoc</em> User Guide).
+</p>
+</li>
+</ul></div>
+</div>
+<h2 id="_limitations">Limitations</h2>
+<div class="sectionbody">
+<div class="ilist"><ul>
+<li>
+<p>
+The <tt><tt>asciidoc(1)</tt></tt> output file cannot be <tt>-</tt> (stdout), you must
+  output to a named file.
+</p>
+</li>
+<li>
+<p>
+If the music image file is linked to the output document then the
+  image file name in the Music Block attribute list should be a
+  relative path name relative to the <em>AsciiDoc</em> output file.
+</p>
+</li>
+</ul></div>
+</div>
+<h2 id="_installation">Installation</h2>
+<div class="sectionbody">
+<div class="para"><p>In addition to <em>AsciiDoc</em> you will need to have installed:</p></div>
+<div class="ilist"><ul>
+<li>
+<p>
+<a href="http://lilypond.org/web/">LilyPond</a> (most Linux distributions include
+  this package).
+</p>
+</li>
+<li>
+<p>
+<a href="http://www.imagemagick.org">ImageMagick</a> (most Linux distributions
+  include this package).
+</p>
+</li>
+</ul></div>
+<div class="para"><p>Test the music filter it by converting the test file to HTML with <em>AsciiDoc</em>:</p></div>
+<div class="literalblock">
+<div class="content">
+<pre><tt>$ asciidoc -v ./filters/music-filter-test.txt
+$ firefox ./filters/music-filter-test.html &amp;</tt></pre>
+</div></div>
+<div class="para"><p>The filter was developed and tested on Xubuntu Linux using LilyPond
+2.10.5 and ImageMagick 6.2.4.</p></div>
+<div class="admonitionblock">
+<table><tr>
+<td class="icon">
+<div class="title">Note</div>
+</td>
+<td class="content">The filter does not work with LilyPond 2.2.6 because it did not
+generate the requested output file name correctly (2.6.3 does not have
+a problem).</td>
+</tr></table>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Last updated 2008-07-02 21:36:40 NZDT
+</div>
+</div>
+</body>
+</html>