mizuho 0.9.6 → 0.9.8

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

@@ -1,204 +0,0 @@
-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

@@ -1,130 +0,0 @@
-<!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

@@ -1,43 +0,0 @@
-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

@@ -1,130 +0,0 @@
-= 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'.
-