mizuho 0.9.6

data/asciidoc/examples/website/a2x.1.txt

@@ -0,0 +1,204 @@
+A2X(1)
+======
+Stuart Rackham <srackham@gmail.com>
+
+
+NAME
+----
+a2x - convert Asciidoc text file to PDF, XHTML, HTML Help, manpage or
+plain text
+
+
+SYNOPSIS
+--------
+*a2x* ['OPTIONS'] 'FILE'
+
+
+DESCRIPTION
+-----------
+A DocBook toolchain wrapper script that translates an AsciiDoc text
+file 'FILE' to PDF, DVI, PS, LaTeX, XHTML (single page or chunked),
+man page, HTML Help or plain text formats. PDF, XHTML, man page and
+HTML Help formats are are generated using the asciidoc(1),
+xsltproc(1), DocBook XSL Stylesheets, dblatex (or FOP) toolchain.
+Plain text is produced by passing asciidoc(1) generated HTML through
+lynx(1). The htmlhelp format option generates .hhp, .hhc and .html
+files suitable for compilation to an HTML Help .chm file.
+
+
+OPTIONS
+-------
+*-a, --attribute*='ATTRIBUTE'::
+  Set asciidoc(1) attribute value (shortcut for *--asciidoc-opts*='"-a
+  ATTRIBUTE"' option).  This option may be specified more than once.
+
+*--asciidoc-opts*='ASCIIDOC_OPTS'::
+  Additional asciidoc(1) options.  This option may be specified more
+  than once.
+
+*--copy*::
+  Copy distributed docbook-xsl CSS stylesheet admonition and
+  navigation icons to their respective destinations. Applies to
+  'xhtml', 'chunked', 'htmlhelp' formats. The default behavior is to
+  suppress copying.
+
+*-D, --destination-dir*='PATH'::
+  Output directory. Defaults to source 'FILE' directory.
+
+*-d, --doctype*='DOCTYPE'::
+  DocBook document type: 'article', 'manpage' or 'book'.  Default
+  document type is 'article' unless the format is 'manpage' (in which
+  case it defaults to 'manpage').
+
+*-f, --format*='FORMAT'::
+  Output format: 'chunked', 'dvi', 'htmlhelp', 'manpage', 'pdf', 'ps',
+  'tex', 'text' or 'xhtml'.
+
+*-h, --help*::
+  Print command-line syntax and program options to stdout.
+
+*--icons*::
+  Use admonition or navigation icon images in output documents. The
+  default behavior is to use text in place of icons.
+
+*--icons-dir*='PATH'::
+  A path (relative to destination HTML files) containing admonition
+  and navigation icons. Defaults to './images/icons/'.
+  Applies to 'xhtml', 'chunked', 'htmlhelp' formats.
+
+*-L, --no-xmllint*::
+  Don't check asciidoc output with 'xmllint(1)'.
+
+*-n, --dry-run*::
+  Don't do anything just print what would have been done.
+
+*-s, --skip-asciidoc*::
+  Skip asciidoc execution. This is useful for converting DocBook XML
+  files not derived from AsciiDoc sources. Ignored if '--format=text'.
+
+*--stylesheet*='PATH'::
+  A path (relative to destination HTML files) specifying the
+  docbook-xsl CSS stylesheet file. Defaults to './docbook-xsl.css'.
+  Applies to 'xhtml', 'chunked', 'htmlhelp' formats.
+
+*-v, --verbose*::
+  Print operational details to stderr.
+  A second *-v* option applies the verbose option to toolchain commands.
+
+*--version*::
+  Print program version to stdout.
+
+*--xsltproc-opts*='XSLTPROC_OPTS'::
+  Additional xsltproc(1) options.  This option may be specified more
+  than once.
+
+*--fop*::
+  Use FOP to generate PDFs.
+
+*--fop-opts*='FOP_OPTS'::
+  Additional fop options.  This option may be specified more than
+  once. If this option is specified FOP is used to generate PDFs.
+
+*--dblatex-opts*='DBLATEX_OPTS'::
+  Additional dblatex options.  This option may be specified more than once.
+
+
+OUTPUT FILES
+------------
+Output files are written to the directory specified by the
+*--destination-dir* option. If no *--destination-dir* option is set
+output files are written to the source FILE directory.
+
+Output files have the same name as the source 'FILE' but with an
+appropriate file name extension: .html for 'xhtml'; .hhp for
+'htmlhelp'; .pdf for 'pdf'; .text for 'text'. By convention manpages
+have no .man extension (man page section number only). Chunked HTML
+directory names have a .chunked extension; chunked HTML Help directory
+names have a .htmlhelp extension.
+
+Same named existing files are overwritten.
+
+Intermediate output files are written to the source 'FILE' directory
+and are not automatically deleted.
+
+Intermediate DocBook XML files generated by AsciiDoc are only
+regenerated if out of date with respect to the AsciiDoc source 'FILE'.
+
+In addition to generating HTML files the 'xhtml', 'chunked' and
+'htmlhelp' formats copy the DocBook XSL stylesheet plus admonition and
+navigation icons distributed with AsciiDoc to their respective
+destination locations. Existing stylesheets and icons are only copied
+if they are newer than the destination files or if the destination
+files are missing.
+
+The 'xhtml' format generates a single XHTML output page.  The
+'chunked' format writes multiple per-section HTML pages to a chunked
+directory in the destination directory. The chunked directory has the
+same name as the source 'FILE' name plus a .chunked extension.
+
+
+EXAMPLES
+--------
+`a2x -f pdf doc/source-highlight-filter.txt`::
+  Generates doc/source-highlight-filter.pdf file.
+
+`a2x -f chunked -D ../webpages guide.txt`::
+  Creates chunked directory `../webpages/guide.chunked` containing
+  chunked HTML files. Also copies `docbook-xsl.css` stylesheet to the
+  `../webpages/guide.chunked` directory plus admonition and navigation
+  icons to the `../webpages/guide.chunked/images/icons` directory.
+
+
+REQUISITES
+----------
+This script runs under the bash(1) shell and requires the following
+programs (which may or may not be prepackaged with your Linux
+distribution):
+
+Asciidoc::
+  http://www.methods.co.nz/asciidoc/
+
+xsltproc::
+  http://xmlsoft.org/XSLT/
+
+DocBook XSL Stylesheets::
+  http://docbook.sourceforge.net/projects/xsl/
+
+dblatex (for PDF, DVI, PostScript and LaTeX file generation)::
+  http://dblatex.sourceforge.net/
+
+FOP (alternative PDF file generation)::
+  http://xmlgraphics.apache.org/fop/
+
+w3m (text file generation)::
+  http://w3m.sourceforge.net/index.en.html
+
+Lynx (used for text file generation if `w3m(1)` not installed)::
+  http://lynx.isc.org/
+
+See also the latest README file.
+
+
+BUGS
+----
+- The odt output format is undocumented and experimental.
+- See also 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/asciidoc-docbook-xsl.html

@@ -0,0 +1,130 @@
+<!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>AsciiDoc DocBook XSL Stylesheets Notes</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="asciidoc-docbook-xsl.txt">Page&nbsp;Source</a></div>
+</td>
+<td>
+<div id="layout-content">
+<div id="header">
+<h1>AsciiDoc DocBook XSL Stylesheets Notes</h1>
+</div>
+<div id="preamble">
+<div class="sectionbody">
+<div class="paragraph"><p>PDF generation from <em>AsciiDoc</em> generated DocBook using FOP plus DocBook XSL
+Stylesheets.</p></div>
+<div class="ulist"><ul>
+<li>
+<p>
+FOP 0.95beta.
+</p>
+</li>
+<li>
+<p>
+DocBook XSL Stylesheets version 1.74.0.
+</p>
+</li>
+</ul></div>
+<div class="paragraph"><p>Output file customisation is achieved by tweaking the DocBook XSL
+stylesheets.  I&#8217;ve tried to keep customization to a minimum and
+confine it to the separate XSL driver files in the distribution
+<tt>./docbook-xsl/</tt> directory (see the User Guide for details).</p></div>
+<div class="paragraph"><p>To polish some rough edges I&#8217;ve written some patches for the DocBook
+XSL stylesheets&#8201;&#8212;&#8201;you don&#8217;t need them but they&#8217;re documented below
+and included in the distribution <tt>./docbook-xsl/</tt> directory.</p></div>
+</div>
+</div>
+<h2 id="_manually_upgrading_debian_to_the_latest_docbook_xsl_stylesheets">Manually upgrading Debian to the latest DocBook XSL stylesheets</h2>
+<div class="sectionbody">
+<div class="paragraph"><p>The DocBook XSL Stylesheets distribution is just a directory full of
+text files and you can switch between releases by changing the
+directory name in the system XML catalog.</p></div>
+<div class="paragraph"><p>To upgrade to the latest docbook-xsl stylesheets without having to
+wait for the Debian <tt>docbook-xsl</tt> package:</p></div>
+<div class="ulist"><ul>
+<li>
+<p>
+Download the latest docbook-xsl tarball from
+  <a href="http://sourceforge.net/projects/docbook/">http://sourceforge.net/projects/docbook/</a>.
+</p>
+</li>
+<li>
+<p>
+Unzip the tarball to <tt>/usr/share/xml/docbook/stylesheet/</tt>:
+</p>
+<div class="literalblock">
+<div class="content">
+<pre><tt>$ cd /usr/share/xml/docbook/stylesheet
+$ sudo tar -xzf /tmp/docbook-xsl-1.72.0.tar.gz</tt></pre>
+</div></div>
+</li>
+<li>
+<p>
+Edit <tt>/etc/xml/docbook-xsl.xml</tt> catalog and replace occurences of
+  the current stylesheets directory with the new one (in our example
+  it would be <tt>/usr/share/xml/docbook/stylesheet/docbook-xsl-1.72.0</tt>.
+</p>
+<div class="literalblock">
+<div class="content">
+<pre><tt>$ cd /etc/xml/
+$ sudo cp -p docbook-xsl.xml docbook-xsl.xml.ORIG
+$ sudo vi docbook-xsl.xml</tt></pre>
+</div></div>
+</li>
+</ul></div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 8.3.3<br />
+Last updated 2009-01-02 11:18:43 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/asciidoc-docbook-xsl.txt

@@ -0,0 +1,43 @@
+AsciiDoc DocBook XSL Stylesheets Notes
+======================================
+
+PDF generation from AsciiDoc generated DocBook using FOP plus DocBook XSL
+Stylesheets.
+
+- FOP 0.95beta.
+- DocBook XSL Stylesheets version 1.74.0.
+
+Output file customisation is achieved by tweaking the DocBook XSL
+stylesheets.  I've tried to keep customization to a minimum and
+confine it to the separate XSL driver files in the distribution
+`./docbook-xsl/` directory (see the User Guide for details).
+
+To polish some rough edges I've written some patches for the DocBook
+XSL stylesheets -- you don't need them but they're documented below
+and included in the distribution `./docbook-xsl/` directory.
+
+
+Manually upgrading Debian to the latest DocBook XSL stylesheets
+---------------------------------------------------------------
+The DocBook XSL Stylesheets distribution is just a directory full of
+text files and you can switch between releases by changing the
+directory name in the system XML catalog.
+
+To upgrade to the latest docbook-xsl stylesheets without having to
+wait for the Debian `docbook-xsl` package:
+
+- Download the latest docbook-xsl tarball from
+  http://sourceforge.net/projects/docbook/.
+
+- Unzip the tarball to `/usr/share/xml/docbook/stylesheet/`:
+
+  $ cd /usr/share/xml/docbook/stylesheet
+  $ sudo tar -xzf /tmp/docbook-xsl-1.72.0.tar.gz
+  
+- Edit `/etc/xml/docbook-xsl.xml` catalog and replace occurences of
+  the current stylesheets directory with the new one (in our example
+  it would be `/usr/share/xml/docbook/stylesheet/docbook-xsl-1.72.0`.
+
+  $ cd /etc/xml/
+  $ sudo cp -p docbook-xsl.xml docbook-xsl.xml.ORIG
+  $ sudo vi docbook-xsl.xml

data/asciidoc/examples/website/asciidoc-graphviz-sample.txt

@@ -0,0 +1,130 @@
+= Graphviz filter for AsciiDoc =
+
+Author: Gouichi Iisaka
+
+Version: 1.0
+
+== Introduction ==
+
+Graph visualization is a way of representing structural information
+as diagrams of abstract graphs and networks.
+
+AsciiDoc can external shell commands used to process Paragraph and 
+DelimitedBlock content by Filter.
+
+
+== Simple Example ==
+
+--------------------------------------------------------------------
+ ["graphviz", "sample1.png"]
+ ---------------------------------------------------------------------
+ digraph G { rankdir=LR; Graphviz->AsciiDoc->HTML}
+ ---------------------------------------------------------------------
+--------------------------------------------------------------------
+
+["graphviz", "sample1.png"]
+---------------------------------------------------------------------
+digraph G { rankdir=LR; Graphviz->AsciiDoc->HTML}
+---------------------------------------------------------------------
+
+---------------------------------------------------------------------
+ ["graphviz", "sample2.png"]
+ ---------------------------------------------------------------------
+ digraph automata_0 {
+    size ="8.5, 11";
+    node [shape = circle];
+    0 [ style = filled, color=lightgrey ];
+    2 [ shape = doublecircle ];
+    0 -> 2 [ label = "a " ];
+    0 -> 1 [ label = "other " ];
+    1 -> 2 [ label = "a " ];
+    1 -> 1 [ label = "other " ];
+    2 -> 2 [ label = "a " ];
+    2 -> 1 [ label = "other " ];
+    "Machine: a" [ shape = plaintext ];
+ } 
+ ---------------------------------------------------------------------
+---------------------------------------------------------------------
+
+["graphviz", "sample3.png"]
+---------------------------------------------------------------------
+digraph automata_0 {
+    size ="8.5, 11";
+    node [shape = circle];
+    0 [ style = filled, color=lightgrey ];
+    2 [ shape = doublecircle ];
+    0 -> 2 [ label = "a " ];
+    0 -> 1 [ label = "other " ];
+    1 -> 2 [ label = "a " ];
+    1 -> 1 [ label = "other " ];
+    2 -> 2 [ label = "a " ];
+    2 -> 1 [ label = "other " ];
+    "Machine: a" [ shape = plaintext ];
+} 
+---------------------------------------------------------------------
+
+
+--------------------------------------------------------------------
+ ["graphviz", "sample4.png", "dot"]
+ ---------------------------------------------------------------------
+ digraph finite_state_machine {
+    rankdir=LR;
+    size="8,5"
+    node [shape = doublecircle]; LR_0 LR_3 LR_4 LR_8;
+    node [shape = circle];
+    LR_0 -> LR_2 [ label = "SS(B)" ];
+    LR_0 -> LR_1 [ label = "SS(S)" ];
+    LR_1 -> LR_3 [ label = "S($end)" ];
+    LR_2 -> LR_6 [ label = "SS(b)" ];
+    LR_2 -> LR_5 [ label = "SS(a)" ];
+    LR_2 -> LR_4 [ label = "S(A)" ];
+    LR_5 -> LR_7 [ label = "S(b)" ];
+    LR_5 -> LR_5 [ label = "S(a)" ];
+    LR_6 -> LR_6 [ label = "S(b)" ];
+    LR_6 -> LR_5 [ label = "S(a)" ];
+    LR_7 -> LR_8 [ label = "S(b)" ];
+    LR_7 -> LR_5 [ label = "S(a)" ];
+    LR_8 -> LR_6 [ label = "S(b)" ];
+    LR_8 -> LR_5 [ label = "S(a)" ];
+ }
+ ---------------------------------------------------------------------
+--------------------------------------------------------------------
+
+.Example for `dot':
+["graphviz", "sample4.png", "dot"]
+---------------------------------------------------------------------
+digraph finite_state_machine {
+    rankdir=LR;
+    size="8,5"
+    node [shape = doublecircle]; LR_0 LR_3 LR_4 LR_8;
+    node [shape = circle];
+    LR_0 -> LR_2 [ label = "SS(B)" ];
+    LR_0 -> LR_1 [ label = "SS(S)" ];
+    LR_1 -> LR_3 [ label = "S($end)" ];
+    LR_2 -> LR_6 [ label = "SS(b)" ];
+    LR_2 -> LR_5 [ label = "SS(a)" ];
+    LR_2 -> LR_4 [ label = "S(A)" ];
+    LR_5 -> LR_7 [ label = "S(b)" ];
+    LR_5 -> LR_5 [ label = "S(a)" ];
+    LR_6 -> LR_6 [ label = "S(b)" ];
+    LR_6 -> LR_5 [ label = "S(a)" ];
+    LR_7 -> LR_8 [ label = "S(b)" ];
+    LR_7 -> LR_5 [ label = "S(a)" ];
+    LR_8 -> LR_6 [ label = "S(b)" ];
+    LR_8 -> LR_5 [ label = "S(a)" ];
+ }
+---------------------------------------------------------------------
+
+
+== Layout ==
+
+layout for graphviz as follows.
+
+ * dot::    filter for drawing directed graphs
+ * neato::  filter for drawing undirected graphs
+ * twopi::  filter for radial layouts of graphs
+ * circo::  filter for circular layout of graphs
+ * fdp::    filter for drawing undirected graphs
+
+default is `dot'.
+