RubyGems - mizuho - Versions diffs - 0.9.6 - Mend

mizuho 0.9.6

Files changed (295) hide show

data/LICENSE.txt +20 -0
data/README.markdown +61 -0
data/Rakefile +41 -0
data/asciidoc/BUGS +39 -0
data/asciidoc/BUGS.txt +32 -0
data/asciidoc/CHANGELOG +1796 -0
data/asciidoc/CHANGELOG.txt +1810 -0
data/asciidoc/COPYING +339 -0
data/asciidoc/COPYRIGHT +18 -0
data/asciidoc/INSTALL +76 -0
data/asciidoc/INSTALL.txt +71 -0
data/asciidoc/Makefile.in +161 -0
data/asciidoc/README +46 -0
data/asciidoc/README.txt +36 -0
data/asciidoc/a2x +674 -0
data/asciidoc/asciidoc.conf +455 -0
data/asciidoc/asciidoc.py +4998 -0
data/asciidoc/common.aap +9 -0
data/asciidoc/configure +2840 -0
data/asciidoc/configure.ac +11 -0
data/asciidoc/dblatex/asciidoc-dblatex.sty +20 -0
data/asciidoc/dblatex/asciidoc-dblatex.xsl +32 -0
data/asciidoc/dblatex/dblatex-readme.txt +39 -0
data/asciidoc/doc/a2x.1 +257 -0
data/asciidoc/doc/a2x.1.txt +204 -0
data/asciidoc/doc/article.css-embedded.html +602 -0
data/asciidoc/doc/article.html +46 -0
data/asciidoc/doc/article.pdf +0 -0
data/asciidoc/doc/article.txt +122 -0
data/asciidoc/doc/asciidoc-revhistory.xml +27 -0
data/asciidoc/doc/asciidoc.1 +155 -0
data/asciidoc/doc/asciidoc.1.css-embedded.html +598 -0
data/asciidoc/doc/asciidoc.1.css.html +212 -0
data/asciidoc/doc/asciidoc.1.html +190 -0
data/asciidoc/doc/asciidoc.1.txt +118 -0
data/asciidoc/doc/asciidoc.conf +8 -0
data/asciidoc/doc/asciidoc.css-embedded.html +7853 -0
data/asciidoc/doc/asciidoc.css.html +7416 -0
data/asciidoc/doc/asciidoc.dict +733 -0
data/asciidoc/doc/asciidoc.html +3339 -0
data/asciidoc/doc/asciidoc.txt +4979 -0
data/asciidoc/doc/asciimathml.txt +64 -0
data/asciidoc/doc/book-multi.css-embedded.html +575 -0
data/asciidoc/doc/book-multi.html +55 -0
data/asciidoc/doc/book-multi.txt +155 -0
data/asciidoc/doc/book.css-embedded.html +607 -0
data/asciidoc/doc/book.html +43 -0
data/asciidoc/doc/book.txt +131 -0
data/asciidoc/doc/customers.csv +18 -0
data/asciidoc/doc/docbook-xsl.css +272 -0
data/asciidoc/doc/faq.txt +547 -0
data/asciidoc/doc/latex-backend.html +117 -0
data/asciidoc/doc/latex-backend.txt +191 -0
data/asciidoc/doc/latexmath.txt +244 -0
data/asciidoc/doc/latexmathml.txt +41 -0
data/asciidoc/doc/main.aap +297 -0
data/asciidoc/doc/music-filter.html +566 -0
data/asciidoc/doc/music-filter.pdf +0 -0
data/asciidoc/doc/music-filter.txt +158 -0
data/asciidoc/doc/source-highlight-filter.html +214 -0
data/asciidoc/doc/source-highlight-filter.pdf +0 -0
data/asciidoc/doc/source-highlight-filter.txt +203 -0
data/asciidoc/docbook-xsl/asciidoc-docbook-xsl.txt +43 -0
data/asciidoc/docbook-xsl/chunked.xsl +19 -0
data/asciidoc/docbook-xsl/common.xsl +67 -0
data/asciidoc/docbook-xsl/fo.xsl +149 -0
data/asciidoc/docbook-xsl/htmlhelp.xsl +17 -0
data/asciidoc/docbook-xsl/manpage.xsl +31 -0
data/asciidoc/docbook-xsl/text.xsl +50 -0
data/asciidoc/docbook-xsl/xhtml.xsl +14 -0
data/asciidoc/docbook.conf +721 -0
data/asciidoc/examples/website/ASCIIMathML.js +938 -0
data/asciidoc/examples/website/CHANGELOG.html +4389 -0
data/asciidoc/examples/website/CHANGELOG.txt +1810 -0
data/asciidoc/examples/website/INSTALL.html +161 -0
data/asciidoc/examples/website/INSTALL.txt +71 -0
data/asciidoc/examples/website/LaTeXMathML.js +1223 -0
data/asciidoc/examples/website/README-website.html +118 -0
data/asciidoc/examples/website/README-website.txt +29 -0
data/asciidoc/examples/website/README.html +125 -0
data/asciidoc/examples/website/README.txt +36 -0
data/asciidoc/examples/website/a2x.1.html +419 -0
data/asciidoc/examples/website/a2x.1.txt +204 -0
data/asciidoc/examples/website/asciidoc-docbook-xsl.html +130 -0
data/asciidoc/examples/website/asciidoc-docbook-xsl.txt +43 -0
data/asciidoc/examples/website/asciidoc-graphviz-sample.txt +130 -0
data/asciidoc/examples/website/asciimathml.txt +64 -0
data/asciidoc/examples/website/build-website.sh +25 -0
data/asciidoc/examples/website/customers.csv +18 -0
data/asciidoc/examples/website/downloads.html +257 -0
data/asciidoc/examples/website/downloads.txt +121 -0
data/asciidoc/examples/website/faq.html +673 -0
data/asciidoc/examples/website/faq.txt +547 -0
data/asciidoc/examples/website/index.html +419 -0
data/asciidoc/examples/website/index.txt +245 -0
data/asciidoc/examples/website/latex-backend.html +535 -0
data/asciidoc/examples/website/latex-backend.txt +191 -0
data/asciidoc/examples/website/latexmathml.txt +41 -0
data/asciidoc/examples/website/layout1.conf +161 -0
data/asciidoc/examples/website/layout1.css +65 -0
data/asciidoc/examples/website/layout2.conf +158 -0
data/asciidoc/examples/website/layout2.css +93 -0
data/asciidoc/examples/website/manpage.html +266 -0
data/asciidoc/examples/website/manpage.txt +118 -0
data/asciidoc/examples/website/music-filter.html +242 -0
data/asciidoc/examples/website/music-filter.txt +158 -0
data/asciidoc/examples/website/music1.abc +12 -0
data/asciidoc/examples/website/music1.png +0 -0
data/asciidoc/examples/website/music2.ly +9 -0
data/asciidoc/examples/website/music2.png +0 -0
data/asciidoc/examples/website/newlists.txt +40 -0
data/asciidoc/examples/website/newtables.txt +397 -0
data/asciidoc/examples/website/sample1.png +0 -0
data/asciidoc/examples/website/sample3.png +0 -0
data/asciidoc/examples/website/sample4.png +0 -0
data/asciidoc/examples/website/source-highlight-filter.html +286 -0
data/asciidoc/examples/website/source-highlight-filter.txt +203 -0
data/asciidoc/examples/website/support.html +78 -0
data/asciidoc/examples/website/support.txt +5 -0
data/asciidoc/examples/website/toc.js +69 -0
data/asciidoc/examples/website/userguide.html +7460 -0
data/asciidoc/examples/website/userguide.txt +4979 -0
data/asciidoc/examples/website/version83.txt +37 -0
data/asciidoc/examples/website/version9.html +143 -0
data/asciidoc/examples/website/version9.txt +48 -0
data/asciidoc/examples/website/xhtml11-manpage.css +18 -0
data/asciidoc/examples/website/xhtml11-quirks.css +41 -0
data/asciidoc/examples/website/xhtml11.css +328 -0
data/asciidoc/filters/code/code-filter-readme.txt +37 -0
data/asciidoc/filters/code/code-filter-test.txt +15 -0
data/asciidoc/filters/code/code-filter.conf +8 -0
data/asciidoc/filters/code/code-filter.py +239 -0
data/asciidoc/filters/graphviz/asciidoc-graphviz-sample.txt +130 -0
data/asciidoc/filters/graphviz/graphviz-filter.conf +39 -0
data/asciidoc/filters/graphviz/graphviz2png.py +154 -0
data/asciidoc/filters/music/music-filter-test.txt +40 -0
data/asciidoc/filters/music/music-filter.conf +40 -0
data/asciidoc/filters/music/music2png.py +189 -0
data/asciidoc/filters/source/source-highlight-filter-test.txt +19 -0
data/asciidoc/filters/source/source-highlight-filter.conf +108 -0
data/asciidoc/help.conf +213 -0
data/asciidoc/html4.conf +460 -0
data/asciidoc/images/highlighter.png +0 -0
data/asciidoc/images/icons/README +5 -0
data/asciidoc/images/icons/callouts/1.png +0 -0
data/asciidoc/images/icons/callouts/10.png +0 -0
data/asciidoc/images/icons/callouts/11.png +0 -0
data/asciidoc/images/icons/callouts/12.png +0 -0
data/asciidoc/images/icons/callouts/13.png +0 -0
data/asciidoc/images/icons/callouts/14.png +0 -0
data/asciidoc/images/icons/callouts/15.png +0 -0
data/asciidoc/images/icons/callouts/2.png +0 -0
data/asciidoc/images/icons/callouts/3.png +0 -0
data/asciidoc/images/icons/callouts/4.png +0 -0
data/asciidoc/images/icons/callouts/5.png +0 -0
data/asciidoc/images/icons/callouts/6.png +0 -0
data/asciidoc/images/icons/callouts/7.png +0 -0
data/asciidoc/images/icons/callouts/8.png +0 -0
data/asciidoc/images/icons/callouts/9.png +0 -0
data/asciidoc/images/icons/caution.png +0 -0
data/asciidoc/images/icons/example.png +0 -0
data/asciidoc/images/icons/home.png +0 -0
data/asciidoc/images/icons/important.png +0 -0
data/asciidoc/images/icons/next.png +0 -0
data/asciidoc/images/icons/note.png +0 -0
data/asciidoc/images/icons/prev.png +0 -0
data/asciidoc/images/icons/tip.png +0 -0
data/asciidoc/images/icons/up.png +0 -0
data/asciidoc/images/icons/warning.png +0 -0
data/asciidoc/images/smallnew.png +0 -0
data/asciidoc/images/tiger.png +0 -0
data/asciidoc/install-sh +201 -0
data/asciidoc/javascripts/ASCIIMathML.js +938 -0
data/asciidoc/javascripts/LaTeXMathML.js +1223 -0
data/asciidoc/javascripts/toc.js +69 -0
data/asciidoc/lang-es.conf +15 -0
data/asciidoc/latex.conf +663 -0
data/asciidoc/stylesheets/docbook-xsl.css +272 -0
data/asciidoc/stylesheets/xhtml11-manpage.css +18 -0
data/asciidoc/stylesheets/xhtml11-quirks.css +41 -0
data/asciidoc/stylesheets/xhtml11.css +328 -0
data/asciidoc/text.conf +16 -0
data/asciidoc/vim/ftdetect/asciidoc_filetype.vim +53 -0
data/asciidoc/vim/syntax/asciidoc.vim +165 -0
data/asciidoc/wordpress.conf +48 -0
data/asciidoc/xhtml11-quirks.conf +57 -0
data/asciidoc/xhtml11.conf +645 -0
data/bin/mizuho +47 -0
data/bin/mizuho-asciidoc +4 -0
data/lib/mizuho.rb +10 -0
data/lib/mizuho/chapter.rb +54 -0
data/lib/mizuho/generator.rb +134 -0
data/lib/mizuho/heading.rb +46 -0
data/lib/mizuho/parser.rb +103 -0
data/lib/mizuho/source_highlight.rb +2 -0
data/lib/mizuho/template.rb +50 -0
data/source-highlight/ada.lang +38 -0
data/source-highlight/bib.lang +6 -0
data/source-highlight/bison.lang +3 -0
data/source-highlight/c.lang +41 -0
data/source-highlight/c_comment.lang +27 -0
data/source-highlight/c_string.lang +9 -0
data/source-highlight/caml.lang +16 -0
data/source-highlight/changelog.lang +8 -0
data/source-highlight/clike_vardeclaration.lang +4 -0
data/source-highlight/cpp.lang +15 -0
data/source-highlight/csharp.lang +36 -0
data/source-highlight/css.lang +14 -0
data/source-highlight/css_common.outlang +26 -0
data/source-highlight/darwin/source-highlight +0 -0
data/source-highlight/default.css +51 -0
data/source-highlight/default.lang +8 -0
data/source-highlight/default.style +57 -0
data/source-highlight/desktop.lang +7 -0
data/source-highlight/diff.lang +32 -0
data/source-highlight/docbook.outlang +36 -0
data/source-highlight/esc.outlang +46 -0
data/source-highlight/esc.style +35 -0
data/source-highlight/extreme_comment.lang +5 -0
data/source-highlight/extreme_comment2.lang +5 -0
data/source-highlight/extreme_comment3.lang +15 -0
data/source-highlight/fixed-fortran.lang +5 -0
data/source-highlight/flex.lang +37 -0
data/source-highlight/fortran.lang +57 -0
data/source-highlight/function.lang +2 -0
data/source-highlight/glsl.lang +86 -0
data/source-highlight/haxe.lang +7 -0
data/source-highlight/html.lang +7 -0
data/source-highlight/html.outlang +25 -0
data/source-highlight/html_common.outlang +35 -0
data/source-highlight/html_notfixed.outlang +22 -0
data/source-highlight/html_ref.outlang +6 -0
data/source-highlight/htmlcss.outlang +28 -0
data/source-highlight/htmltable.outlang +14 -0
data/source-highlight/htmltablelinenum.outlang +26 -0
data/source-highlight/java.lang +26 -0
data/source-highlight/javadoc.outlang +24 -0
data/source-highlight/javascript.lang +27 -0
data/source-highlight/key_string.lang +4 -0
data/source-highlight/lang.map +108 -0
data/source-highlight/langdef.lang +21 -0
data/source-highlight/latex.lang +52 -0
data/source-highlight/latex.outlang +59 -0
data/source-highlight/latexcolor.outlang +44 -0
data/source-highlight/ldap.lang +10 -0
data/source-highlight/log.lang +53 -0
data/source-highlight/logtalk.lang +85 -0
data/source-highlight/lsm.lang +7 -0
data/source-highlight/lua.lang +27 -0
data/source-highlight/m4.lang +27 -0
data/source-highlight/makefile.lang +42 -0
data/source-highlight/nohilite.lang +2 -0
data/source-highlight/number.lang +3 -0
data/source-highlight/outlang.lang +16 -0
data/source-highlight/outlang.map +12 -0
data/source-highlight/pascal.lang +20 -0
data/source-highlight/perl.lang +134 -0
data/source-highlight/php.lang +25 -0
data/source-highlight/postscript.lang +42 -0
data/source-highlight/prolog.lang +37 -0
data/source-highlight/properties.lang +7 -0
data/source-highlight/python.lang +26 -0
data/source-highlight/ruby.lang +32 -0
data/source-highlight/scala.lang +31 -0
data/source-highlight/script_comment.lang +3 -0
data/source-highlight/sh.lang +38 -0
data/source-highlight/slang.lang +25 -0
data/source-highlight/sml.lang +5 -0
data/source-highlight/source-highlight +24 -0
data/source-highlight/spec.lang +12 -0
data/source-highlight/sql.lang +46 -0
data/source-highlight/style.defaults +15 -0
data/source-highlight/style.lang +16 -0
data/source-highlight/style2.style +10 -0
data/source-highlight/style3.style +10 -0
data/source-highlight/symbols.lang +2 -0
data/source-highlight/tcl.lang +35 -0
data/source-highlight/texinfo.outlang +34 -0
data/source-highlight/texinfo.style +20 -0
data/source-highlight/url.lang +3 -0
data/source-highlight/xhtml.outlang +25 -0
data/source-highlight/xhtml_common.outlang +8 -0
data/source-highlight/xhtml_notfixed.outlang +16 -0
data/source-highlight/xhtmlcss.outlang +19 -0
data/source-highlight/xhtmltable.outlang +7 -0
data/source-highlight/xml.lang +17 -0
data/source-highlight/xorg.lang +10 -0
data/templates/asciidoc.css +358 -0
data/templates/asciidoc.html.erb +86 -0
data/templates/manualsonrails.css +165 -0
data/templates/manualsonrails.html.erb +97 -0
data/test/generator_spec.rb +60 -0
data/test/parser_spec.rb +239 -0
data/test/spec_helper.rb +51 -0
metadata +358 -0

data/asciidoc/examples/website/manpage.txt ADDED Viewed

@@ -0,0 +1,118 @@
+ASCIIDOC(1)
+===========
+Stuart Rackham <srackham@gmail.com>
+NAME
+----
+asciidoc - converts an AsciiDoc text file to DocBook, HTML or LinuxDoc
+SYNOPSIS
+--------
+*asciidoc* ['OPTIONS'] 'FILE'
+DESCRIPTION
+-----------
+The asciidoc(1) command translates the AsciiDoc text file 'FILE' to a
+DocBook, HTML or LinuxDoc file.  If 'FILE' is '-' then the standard
+input is used.
+OPTIONS
+-------
+*-a, --attribute*='ATTRIBUTE'::
+    Define or delete document attribute. 'ATTRIBUTE' is formatted like
+    'NAME=VALUE'. Command-line attributes take precedence over
+    document and configuration file attributes.  Alternate acceptable
+    forms are 'NAME' (the 'VALUE' defaults to an empty string);
+    'NAME!' (delete the 'NAME' attribute); 'NAME@' (do not override
+    document or configuration file attributes).  Values containing
+    spaces should be enclosed in double-quote characters. This option
+    may be specified more than once.
+*-b, --backend*='BACKEND'::
+    Backend output file format: 'docbook', 'xhtml11' or 'html4'.
+    Defaults to 'xhtml11'.
+*-f, --conf-file*='CONF_FILE'::
+    Use configuration file 'CONF_FILE'.Configuration files processed
+    in command-line order (after implicit configuration files).  This
+    option may be specified more than once.
+*-d, --doctype*='DOCTYPE'::
+    Document type: 'article', 'manpage' or 'book'. The 'book' document
+    type is only supported by the 'docbook' backend.  Default document
+    type is 'article'.
+*-c, --dump-conf*::
+    Dump configuration to stdout.
+*-h, --help*[='TOPIC']::
+    Print help TOPIC. *--help*='topics' will print a list of help
+    topics, *--help*='syntax' summarizes AsciiDoc syntax,
+    *--help*='manpage' prints the AsciiDoc manpage.
+*-e, --no-conf*::
+    Exclude implicitly loaded configuration files except for those
+    named like the input file ('infile.conf' and
+    'infile-backend.conf').
+*-s, --no-header-footer*::
+    Suppress document header and footer output.
+*-o, --out-file*='OUT_FILE'::
+    Write output to file 'OUT_FILE'. Defaults to the base name of
+    input file with 'backend' extension. If the input is stdin then
+    the outfile defaults to stdout. If 'OUT_FILE' is '-' then the
+    standard output is used.
+*-n, --section-numbers*::
+    Auto-number HTML article section titles.  Synonym for *-a
+    numbered*.
+*--unsafe*::
+    Disable safe mode. Safe mode is enabled by default, disabling
+    it is potentially dangerous.
+*-v, --verbose*::
+    Verbosely print processing information and configuration file
+    checks to stderr.
+*--version*::
+    Print program version number.
+EXIT STATUS
+-----------
+*0*::
+    Success
+*1*::
+    Failure (syntax or usage error; configuration error; document
+    processing failure; unexpected error).
+BUGS
+----
+See the AsciiDoc distribution BUGS file.
+AUTHOR
+------
+Written by Stuart Rackham, <srackham@gmail.com>
+RESOURCES
+---------
+SourceForge: <http://sourceforge.net/projects/asciidoc/>
+Main web site: <http://www.methods.co.nz/asciidoc/>
+COPYING
+-------
+Copyright \(C) 2002-2008 Stuart Rackham. Free use of this software is
+granted under the terms of the GNU General Public License (GPL).

data/asciidoc/examples/website/music-filter.html ADDED Viewed

@@ -0,0 +1,242 @@
+<!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.3.3" />
+<link rel="stylesheet" href="./xhtml11.css" type="text/css" />
+<link rel="stylesheet" href="./xhtml11-quirks.css" type="text/css" />
+<link rel="stylesheet" href="./layout1.css" type="text/css" />
+<title>Music Filter</title>
+</head>
+<body>
+<div id="layout-banner">
+  <div id="layout-title">AsciiDoc</div>
+  <div id="layout-description">Text based document generation</div>
+</div>
+<table>
+<tr valign="top">
+<td id="layout-menu">
+  <div>&#187;<a href="index.html">Home</a></div>
+  <div>&#187;<a href="manpage.html">Man&nbsp;Page</a></div>
+  <div>&#187;<a href="userguide.html">User&nbsp;Guide</a></div>
+  <div>&#187;<a href="http://powerman.name/doc/asciidoc">Cheatsheet</a></div>
+  <div>&#187;<a href="a2x.1.html">a2x</a></div>
+  <div>&#187;<a href="README.html">README</a></div>
+  <div>&#187;<a href="CHANGELOG.html">ChangeLog</a></div>
+  <div>&#187;<a href="INSTALL.html">Installation</a></div>
+  <div>&#187;<a href="downloads.html">Downloads</a></div>
+  <div>&#187;<a href="faq.html">FAQ</a></div>
+  <div>&#187;<a href="support.html">Support</a></div>
+  <div id="page-source">&#187;<a href="music-filter.txt">Page&nbsp;Source</a></div>
+</td>
+<td>
+<div id="layout-content">
+<div id="header">
+<h1>Music Filter</h1>
+</div>
+<div id="preamble">
+<div class="sectionbody">
+<div class="paragraph"><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="paragraph"><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="paragraph"><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="paragraph"><p>This Music Block:</p></div>
+<div class="listingblock">
+<div class="content">
+<pre><tt> ["music","music1.png",scaledwidth="100%"]
+ ---------------------------------------------------------------------
+ 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="paragraph"><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="paragraph"><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="paragraph"><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">
+<img src="./images/icons/note.png" alt="Note" />
+</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="paragraph"><p>Insert a delimited Music Block containing valid ABC notation into your
+<em>AsciiDoc</em> document:</p></div>
+<div class="ulist"><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="ulist"><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="paragraph"><p>In addition to <em>AsciiDoc</em> you will need to have installed:</p></div>
+<div class="ulist"><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="paragraph"><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="paragraph"><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">
+<img src="./images/icons/note.png" alt="Note" />
+</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">
+Version 8.3.3<br />
+Last updated 2009-01-02 11:18:53 NZDT
+</div>
+<div id="footer-badges">
+<a href="http://validator.w3.org/check?uri=referer">
+  <img style="border:none; width:88px; height:31px;"
+       src="http://www.w3.org/Icons/valid-xhtml11"
+       alt="Valid XHTML 1.1!" />
+</a>
+<a href="http://jigsaw.w3.org/css-validator/check/referer">
+  <img style="border:none; width:88px; height:31px;"
+       src="http://jigsaw.w3.org/css-validator/images/vcss"
+       alt="Valid CSS!" />
+</a>
+<a href="http://www.mozilla.org/products/firefox/">
+  <img style="border:none; width:110px; height:32px;"
+       src="http://www.spreadfirefox.com/community/images/affiliates/Buttons/110x32/safer.gif"
+       alt="Get Firefox!" />
+</a>
+</div>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</body>
+</html>

data/asciidoc/examples/website/music-filter.txt ADDED Viewed

@@ -0,0 +1,158 @@
+Music Filter
+============
+The AsciiDoc distribution includes a Music Block filter that
+translates music in http://lilypond.org/[LilyPond] or
+http://abcnotation.org.uk/[ABC] notation to standard classical
+notation in the form of a trimmed PNG image which is automatically
+inserted into the AsciiDoc output document (see the <<X1,examples
+below>>).
+Actually the filter (`./filters/music2png.py`) can be used outside
+AsciiDoc to convert LilyPond or ABC music files to PNG images.
+Execute the following command to see how to use it:
+  $ ./filters/music2png.py --help
+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 AsciiDoc
+output document.
+[[X1]]
+[caption="Example 1: "]
+.Music Block containing ABC notation
+=====================================================================
+This Music Block:
+---------------------------------------------------------------------
+ ["music","music1.png",scaledwidth="100%"]
+ ---------------------------------------------------------------------
+ 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):|
+ ---------------------------------------------------------------------
+---------------------------------------------------------------------
+Renders:
+["music","music1.png",scaledwidth="100%"]
+---------------------------------------------------------------------
+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):|
+---------------------------------------------------------------------
+=====================================================================
+[[X2]]
+[caption="Example 2: "]
+.Music Block containing LilyPond notation
+=====================================================================
+This example contains LilyPond musical markup, it uses the 'link'
+attribute so you can click on the music image to display the source
+notation. The `music2.ly` source file is automatically created and
+retained by the `music2png.py` filter when the `-m` option is used.
+---------------------------------------------------------------------
+ ["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
+ }
+ ---------------------------------------------------------------------
+---------------------------------------------------------------------
+Renders:
+["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
+}
+---------------------------------------------------------------------
+=====================================================================
+NOTE: 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
+`convert-ly(1)` utility to update the source to the version that you
+are using.
+Using the Filter
+----------------
+Insert a delimited Music Block containing valid ABC notation into your
+AsciiDoc document:
+- The Music Block delimiter is the word `music` followed by four or
+  more tilde characters.
+- The Music Block attribute list must contain a file name for the PNG
+  output image file followed by the input format (either 'abc' for ABC
+  or 'ly' for LilyPond). If the format is omitted ABC notation is
+  assumed.
+- The filter invokes `music2png` with the `-m` option so that music
+  images will only be regenerated if the block content has changed.
+- The optional named block attributes 'link', 'width' and 'height' are
+  also available (see link:userguide.html#X55[Image macro attributes]
+  in the AsciiDoc User Guide).
+Limitations
+-----------
+- The `asciidoc(1)` output file cannot be `-` (stdout), you must
+  output to a named file.
+- 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 AsciiDoc output file.
+Installation
+------------
+In addition to AsciiDoc you will need to have installed:
+- http://lilypond.org/web/[LilyPond] (most Linux distributions include
+  this package).
+- http://www.imagemagick.org[ImageMagick] (most Linux distributions
+  include this package).
+Test the music filter it by converting the test file to HTML with AsciiDoc:
+   $ asciidoc -v ./filters/music-filter-test.txt
+   $ firefox ./filters/music-filter-test.html &
+The filter was developed and tested on Xubuntu Linux using LilyPond
+2.10.5 and ImageMagick 6.2.4.
+NOTE: 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).