mizuho 0.9.6 → 0.9.8

data/asciidoc/doc/latex-filter.txt

@@ -0,0 +1,196 @@
+LaTeX Filter
+============
+
+:blogpost-status: published
+:blogpost-doctype: article
+:blogpost-posttype: page
+:blogpost-categories: AsciiDoc,LaTeX,python
+
+The AsciiDoc distribution includes a LaTeX filter that translates
+LaTeX source to PNG image which is automatically inserted into the
+AsciiDoc output document. Although it can accept any LaTeX source, the
+primary use is to render mathematical formulae (see the examples
+below).  The filter implements the 'latex' Listing block and Paragraph
+styles.
+
+This LaTeX paragraph:
+
+[listing]
+.....................................................................
+[latex]
+$y = \int_0^\infty \gamma^2 \cos(x) dx$
+.....................................................................
+
+Renders:
+
+[latex]
+$y = \int_0^\infty \gamma^2 \cos(x) dx$
+
+This LaTeX block:
+
+[listing]
+.....................................................................
+["latex","latex1.png",align="center"]
+---------------------------------------------------------------------
+$\displaystyle{ V_i = C_0 - C_3
+\frac{C_1\cos(\theta_i+C_3)}{C_4+C_1\cos(\theta_i+C_2)} }$
+---------------------------------------------------------------------
+.....................................................................
+
+Renders:
+
+["latex","latex1.png",align="center"]
+---------------------------------------------------------------------
+$\displaystyle{ V_i = C_0 - C_3
+\frac{C_1\cos(\theta_i+C_3)}{C_4+C_1\cos(\theta_i+C_2)} }$
+---------------------------------------------------------------------
+
+This LaTeX block:
+
+[listing]
+.....................................................................
+.LaTeX filter example
+[latex]
+["latex","latex3.png"]
+---------------------------------------------------------------------
+\begin{equation}
+\Re{z} =\frac{n\pi \dfrac{\theta +\psi}{2}}{
+\left(\dfrac{\theta +\psi}{2}\right)^2 + \left( \dfrac{1}{2}
+\log \left\lvert\dfrac{B}{A}\right\rvert\right)^2}.
+\end{equation}
+
+\begin{equation}
+\boxed{\eta \leq C(\delta(\eta) +\Lambda_M(0,\delta))}
+\end{equation}
+
+\begin{equation}\label{first}
+a=b+c
+\end{equation}
+
+\begin{subequations}\label{grp}
+\begin{align}
+a&=b+c\label{second}\\
+d&=e+f+g\label{third}\\
+h&=i+j\label{fourth}
+\end{align}
+\end{subequations}
+---------------------------------------------------------------------
+.....................................................................
+
+Renders:
+
+.LaTeX filter example
+[latex]
+---------------------------------------------------------------------
+\begin{equation}
+\Re{z} =\frac{n\pi \dfrac{\theta +\psi}{2}}{
+\left(\dfrac{\theta +\psi}{2}\right)^2 + \left( \dfrac{1}{2}
+\log \left\lvert\dfrac{B}{A}\right\rvert\right)^2}.
+\end{equation}
+
+\begin{equation}
+\boxed{\eta \leq C(\delta(\eta) +\Lambda_M(0,\delta))}
+\end{equation}
+
+\begin{equation}\label{first}
+a=b+c
+\end{equation}
+
+\begin{subequations}\label{grp}
+\begin{align}
+a&=b+c\label{second}\\
+d&=e+f+g\label{third}\\
+h&=i+j\label{fourth}
+\end{align}
+\end{subequations}
+---------------------------------------------------------------------
+
+This LaTeX paragraph:
+
+[listing]
+.....................................................................
+.A LaTeX table
+[latex]
+\begin{tabular}{c r @{.} l}
+Pi expression &
+\multicolumn{2}{c}{Value} \\
+\hline
+$\pi$ & 3&1416 \\
+$\pi^{\pi}$ & 36&46 \\
+$(\pi^{\pi})^{\pi}$ & 80662&7 \\
+\end{tabular}
+.....................................................................
+
+Renders:
+
+.A LaTeX table
+[latex]
+\begin{tabular}{c r @{.} l}
+Pi expression &
+\multicolumn{2}{c}{Value} \\
+\hline
+$\pi$ & 3&1416 \\
+$\pi^{\pi}$ & 36&46 \\
+$(\pi^{\pi})^{\pi}$ & 80662&7 \\
+\end{tabular}
+
+
+Using the Filter
+----------------
+- The LaTeX filter is invoked by setting the Listing block or
+  Paragraph style (the first positional block attribute) to 'latex'.
+- The second positional attribute (named 'target' is optional, it sets
+  the name of the generated PNG image file. If this is not supplied a
+  file name like `{docname}__{target-number}.png` is synthesised
+  (where `{docname}` is the document file name and `{target-number}`
+  is an integer number.
+- The third positional attribute, named 'dpi', is also optional; it is
+  an integer number that sets the output resolution in dots per inch.
+
+Because the LaTeX images are rendered using the image block templates
+you can also use the optional named image block attributes (see
+link:userguide.html#X55[Image macro attributes] in the AsciiDoc User
+Guide).
+
+[TIP]
+=====================================================================
+You can also change the image size using the following LaTeX commands:
+
+  \tiny
+  \scriptsize
+  \footnotesize
+  \small
+  \normalsize
+  \large
+  \Large
+  \LARGE
+  \huge
+
+For example:
+
+  [latex]
+  \Large $y = \int_0^\infty \gamma^2 \cos(x) dx$
+
+The `\Large` command is outside the `$` math delimiters.
+
+=====================================================================
+
+The filter (`./filters/latex/latex2png.py`) can be used outside
+AsciiDoc to convert LaTeX source to PNG images.
+
+Execute the following command to see how to use it:
+
+  $ ./filters/latex/latex2png.py --help
+
+
+Limitations
+-----------
+- The `asciidoc(1)` input and output files cannot both be `-` (stdin
+  and stdout), either the input or output files (or both) must be a
+  named file.
+
+
+Installation
+------------
+In addition to AsciiDoc you will need to have `latex(1)` and
+`dvipng(1)` installed.

data/asciidoc/doc/latexmath.txt

@@ -1,9 +1,11 @@
 Embedding LaTeX Math in AsciiDoc dblatex documents
 ==================================================
 
-You can include
-ftp://ftp.ams.org/pub/tex/doc/amsmath/short-math-guide.pdf[LaTeX math]
-equations in AsciiDoc documents that are processed by 'dblatex'.
+You can include LaTeX math equations in AsciiDoc documents that are
+processed by http://dblatex.sourceforge.net/[dblatex]. The AsciiDoc
+'latexmath' macros and passthrough blocks generate DocBook
+'inlineequation', 'informalequation' and 'equation' elements
+containing the LaTeX markup which is processed by 'dblatex'.
 
 
 Inline equations
@@ -12,24 +14,18 @@ This markup:
 
 ---------------------------------------------------------------------
 An inline equation latexmath:[$C = \alpha + \beta Y^{\gamma} + \epsilon$]
-using the 'math' inline macro.
-
-You can use the same 'math' macro to inject arbitrary latexmath:[\LaTeX] markup
-(but beware, this is an undocumented trick).
+using the 'latexmath' inline macro.
 ---------------------------------------------------------------------
 
 Renders:
 
 An inline equation latexmath:[$C = \alpha + \beta Y^{\gamma} + \epsilon$]
-using the 'math' inline macro.
-
-You can use the same 'math' macro to inject arbitrary latexmath:[\LaTeX] markup
-(but beware, this is an undocumented trick).
+using the 'latexmath' inline macro.
 
 
 Informal equations
 ------------------
-Informal (untitled) equations are generated with a 'math' style
+Informal (untitled) equations are generated with a 'latexmath' style
 passthrough delimited block. This markup:
 
 ---------------------------------------------------------------------
@@ -59,13 +55,13 @@ latexmath::[\[C = \alpha + \beta Y^{\gamma} + \epsilon\]]
 
 Formal equations
 ----------------
-Formal equations are titled and are generated with a 'math' style
+Formal equations are titled and are generated with a 'latexmath' style
 passthrough delimited block.
 
 This markup:
 
 ---------------------------------------------------------------------
-.Unnumbered
+.First equation
 [latexmath]
 ++++++++++++++++++++++++++++++++++++++++++++
 \[C = \alpha + \beta Y^{\gamma} + \epsilon\]
@@ -74,7 +70,7 @@ This markup:
 
 Renders:
 
-.Unnumbered
+.First equation
 [latexmath]
 ++++++++++++++++++++++++++++++++++++++++++++
 \[C = \alpha + \beta Y^{\gamma} + \epsilon\]
@@ -82,127 +78,6 @@ Renders:
 
 This markup:
 
----------------------------------------------------------------------
-.Aligned
-[latexmath]
-++++++++++++++++++++++++++++++++++++++++++++
-\begin{align*}
-2x^2 + 3(x-1)(x-2) & = 2x^2 + 3(x^2-3x+2) \\
-&= 2x^2 + 3x^2 - 9x + 6 \\
-&= 5x^2 - 9x + 6
-\end{align*}
-++++++++++++++++++++++++++++++++++++++++++++
----------------------------------------------------------------------
-
-Renders:
-
-.Unnumbered
-.Aligned
-[latexmath]
-++++++++++++++++++++++++++++++++++++++++++++
-\begin{align*}
-2x^2 + 3(x-1)(x-2) & = 2x^2 + 3(x^2-3x+2) \\
-&= 2x^2 + 3x^2 - 9x + 6 \\
-&= 5x^2 - 9x + 6
-\end{align*}
-++++++++++++++++++++++++++++++++++++++++++++
-
-This markup:
-
----------------------------------------------------------------------
-.Array
-[latexmath]
-++++++++++++++++++++++++++++++++++++++++++++
-\begin{eqnarray}
-x & = & \frac{-7 \pm \sqrt{49 - 24}}{6} \\
-& = & -2 \textrm{ or } -\frac13
-\end{eqnarray}
-++++++++++++++++++++++++++++++++++++++++++++
----------------------------------------------------------------------
-
-Renders:
-
-.Array
-[latexmath]
-++++++++++++++++++++++++++++++++++++++++++++
-\begin{eqnarray}
-x & = & \frac{-7 \pm \sqrt{49 - 24}}{6} \\
-& = & -2 \textrm{ or } -\frac13
-\end{eqnarray}
-++++++++++++++++++++++++++++++++++++++++++++
-
-This markup:
-
----------------------------------------------------------------------
-.Array
-[latexmath]
-++++++++++++++++++++++++++++++++++++++++++++
-\begin{eqnarray*}
-4r^2\int_0^{\pi/2} \cos^2 \theta\, d\theta
-&=& 4r^2\int_0^{\pi/2} \frac{1}{2}(1 + \cos 2\theta) \,d\theta\\
-& = & {2r^2\theta}\Bigg{|}_0^{\pi/2}
-  + 2r^2\int_0^{\pi/2} \cos 2\theta \,d\theta\\
-& = & \pi r^2 + 2r^2(\sin2\theta)\Bigg{|}_0^{\pi/2}\\
-& = & \pi r^2
-\end{eqnarray*}
-++++++++++++++++++++++++++++++++++++++++++++
----------------------------------------------------------------------
-
-Renders:
-
-.Array
-[latexmath]
-++++++++++++++++++++++++++++++++++++++++++++
-\begin{eqnarray*}
-4r^2\int_0^{\pi/2} \cos^2 \theta\, d\theta
-&=& 4r^2\int_0^{\pi/2} \frac{1}{2}(1 + \cos 2\theta) \,d\theta\\
-& = & {2r^2\theta}\Bigg{|}_0^{\pi/2}
-  + 2r^2\int_0^{\pi/2} \cos 2\theta \,d\theta\\
-& = & \pi r^2 + 2r^2(\sin2\theta)\Bigg{|}_0^{\pi/2}\\
-& = & \pi r^2
-\end{eqnarray*}
-++++++++++++++++++++++++++++++++++++++++++++
-
-This markup:
-
----------------------------------------------------------------------
-.List
-[latexmath]
-++++++++++++++++++++++++++++++++++++++++++++
-\begin{enumerate}
-\item $\frac{da}{dx} = 0$
-\item $\frac{d}{dx} ax = a$
-\item $\frac{d}{dx} x^n = nx^{n-1}$
-\item $\displaystyle \frac{d}{dx} (f(x) + g(x))
-  = \frac{d}{dx} f(x) + \frac{d}{dx} g(x)$
-\item $\displaystyle \frac{d}{dx} f(x)g(x)
-  = g(x) \frac{d}{dx} f(x) + f(x) \frac{d}{dx} g(x)$
-\item $\displaystyle  \frac{d}{dx} \frac{f(x)}{g(x)}
-  = \frac{g(x) \frac{d}{dx} f(x) - f(x) \frac{d}{dx} g(x)}{(g(x))^2}$
-\end{enumerate}
-++++++++++++++++++++++++++++++++++++++++++++
----------------------------------------------------------------------
-
-Renders:
-
-.List
-[latexmath]
-++++++++++++++++++++++++++++++++++++++++++++
-\begin{enumerate}
-\item $\frac{da}{dx} = 0$
-\item $\frac{d}{dx} ax = a$
-\item $\frac{d}{dx} x^n = nx^{n-1}$
-\item $\displaystyle \frac{d}{dx} (f(x) + g(x))
-  = \frac{d}{dx} f(x) + \frac{d}{dx} g(x)$
-\item $\displaystyle \frac{d}{dx} f(x)g(x)
-  = g(x) \frac{d}{dx} f(x) + f(x) \frac{d}{dx} g(x)$
-\item $\displaystyle  \frac{d}{dx} \frac{f(x)}{g(x)}
-  = \frac{g(x) \frac{d}{dx} f(x) - f(x) \frac{d}{dx} g(x)}{(g(x))^2}$
-\end{enumerate}
-++++++++++++++++++++++++++++++++++++++++++++
-
-This markup:
-
 ---------------------------------------------------------------------
 .Matrix
 [latexmath]
@@ -242,3 +117,5 @@ Renders:
   \end{array}
 \right] \]
 ++++++++++++++++++++++++++++++++++++++++++++
+
+

data/asciidoc/doc/latexmathml.txt

@@ -17,14 +17,14 @@ attribute instead of the `asciimath` attribute.
 http://www.maths.nottingham.ac.uk/personal/drw/lm.html[LaTeXMathML]
 website for details.
 
-Here's the link:latexmath.txt[AsciiDoc source] that generated this
+Here's the link:latexmathml.txt[AsciiDoc source] that generated this
 page.
 
 Some example 'LaTeXMathML' formulas:
 
 - latexmath:[$R_x = 10.0 \times \sin(R_\phi)$]
 
-- [,,2]##latexmath:[$\sum_{n=1}^\infty \frac{1}{2^n}$]##
+- latexmath:[$\sum_{n=1}^\infty \frac{1}{2^n}$]
 
 - latexmath:[$\lim_{x\to\infty} f(x) = k \choose r + \frac ab
   \sum_{n=1}^\infty a_n + \displaystyle{ \left\{ \frac{1}{13}

data/asciidoc/doc/main.aap

@@ -1,297 +1,233 @@
-#####################################################################
-#
-# 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 \
-        latexmath.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 \
-        ../examples/oldtables.xml ../examples/oldtables.html
-
-
-#####################################################################
-# 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 and LaTeX Math PDFs 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
-    latexmath.pdf: latexmath.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
-
-asciimathml.html: asciimathml.txt
-    :sys $ASCIIDOC -a asciimath $source
-    # No xmllint(1) checking -- fails on embedded JavaScript.
-
-latexmathml.html: latexmathml.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.
+#####################################################################
+#
+# A-A-P file for making AsciiDoc distribution documentation.
+# (you can obtain A-A-P from http://www.a-a-p.org)
+#
+# Stuart Rackham <srackham@gmail.com>
+#####################################################################
+
+:execute ../common.aap
+
+ASCIIDOC = python ../asciidoc.py -a revnumber=$(VERS)@ -a revdate="$(DATE)@"
+A2X = python ../a2x.py
+
+:syseval which fop | :assign FOP
+@if not _no.FOP:
+    :syseval which fop.sh | :assign FOP
+: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.
+:syseval which aspell | :assign ASPELL
+:syseval which xsltproc | :assign 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_DIR/index.html \
+        $CHUNK_DIR/index.html \
+        article.pdf \
+        latexmath.pdf \
+        latex-filter.pdf \
+        source-highlight-filter.pdf \
+        music-filter.pdf \
+        book.epub \
+        article-standalone.html \
+        article-html5-toc2.html
+
+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 \
+        book.epub asciidoc.epub \
+
+
+#####################################################################
+# Filetype build rules.
+#####################################################################
+
+:rule %.epub : %.txt
+    :sys $A2X -f epub -d book --epubcheck --icons $source
+
+:rule %.text : %.txt
+    # Convert AsciiDoc to HTML then use lynx(1) to convert HTML to text.
+    @if 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
+
+: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' or source_list[0].startswith('book'):
+        opt += -d book
+    :sys $ASCIIDOC $opt -b docbook $(source[0])
+    @if _no.XMLLINT:
+        :sys $XMLLINT --nonet --noout --valid $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
+    @if source_list[0] == 'asciidoc.txt' or source_list[0].startswith('book'):
+        opt += -d book
+    :sys $ASCIIDOC $opt -b docbook-sgml $(source[0])
+
+:rule %.html: %.xml
+    :sys $XSLTPROC --nonet --stringparam admon.textlabel 0 --stringparam html.stylesheet ./docbook-xsl.css ../docbook-xsl/xhtml.xsl $source >$target
+
+:rule %.man : %.xml
+    :sys $XSLTPROC --nonet ../docbook-xsl/manpage.xsl $source
+    :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 and LaTeX related PDFs to be generated
+# using dblatex so we include a dblatex example in the distribution.
+@if _no.DBLATEX:
+    asciidoc.pdf: asciidoc.txt
+        :sys $ASCIIDOC -b docbook $(source[0])
+        :sys $DBLATEX -p ../dblatex/asciidoc-dblatex.xsl -s ../dblatex/asciidoc-dblatex.sty -o $target asciidoc.xml
+    latexmath.pdf: latexmath.xml
+        :sys $DBLATEX -p ../dblatex/asciidoc-dblatex.xsl -s ../dblatex/asciidoc-dblatex.sty -o $target $source
+    latex-filter.pdf: latex-filter.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
+
+@if _no.FOP:
+    :rule %.pdf: %.fo
+        :sys $FOP $source $target
+@elif _no.DBLATEX:
+    # Fall back to dblatex if no FOP.
+    :rule %.pdf: %.xml
+        :sys $DBLATEX -p ../dblatex/asciidoc-dblatex.xsl -s ../dblatex/asciidoc-dblatex.sty -o $target $source
+@else:
+    :rule %.pdf:
+        :print WARNING: PDF processor  unavailable: skipping $target file generation
+
+
+#####################################################################
+# Explicit file generation (cases that don't fit the rules).
+#####################################################################
+
+article-standalone.html: article.txt
+    :sys $ASCIIDOC -a data-uri -a icons -a toc -a max-width=55em -o $target $source
+
+article-html5-toc2.html: article.txt
+    :sys $ASCIIDOC -b html5 -a icons -a toc2 -a theme=flask -o $target $source
+
+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.txt
+    :sys $A2X -fchunked -dbook --icons -D ./ asciidoc.txt
+
+# HTML Help formatted User Guide.
+$HTMLHELP_DIR/index.html: asciidoc.xml
+    :sys $A2X -fhtmlhelp -dbook --icons -D ./ asciidoc.txt
+
+../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
+
+asciimathml.html: asciimathml.txt
+    :sys $ASCIIDOC -a asciimath $source
+    # No xmllint(1) checking -- fails on embedded JavaScript.
+
+latexmathml.html: latexmathml.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 faq.txt asciidocapi.txt testasciidoc.txt \
+        epub-notes.txt publishing-ebooks-with-asciidoc.txt \
+        source-highlight-filter.txt \
+        slidy.txt slidy-example.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.