mizuho 0.9.10 → 0.9.11

data/asciidoc/examples/website/asciidoc.js

@@ -0,0 +1,189 @@
+var asciidoc = {  // Namespace.
+
+/////////////////////////////////////////////////////////////////////
+// Table Of Contents generator
+/////////////////////////////////////////////////////////////////////
+
+/* Author: Mihai Bazon, September 2002
+ * http://students.infoiasi.ro/~mishoo
+ *
+ * Table Of Content generator
+ * Version: 0.4
+ *
+ * Feel free to use this script under the terms of the GNU General Public
+ * License, as long as you do not remove or alter this notice.
+ */
+
+ /* modified by Troy D. Hanson, September 2006. License: GPL */
+ /* modified by Stuart Rackham, 2006, 2009. License: GPL */
+
+// toclevels = 1..4.
+toc: function (toclevels) {
+
+  function getText(el) {
+    var text = "";
+    for (var i = el.firstChild; i != null; i = i.nextSibling) {
+      if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
+        text += i.data;
+      else if (i.firstChild != null)
+        text += getText(i);
+    }
+    return text;
+  }
+
+  function TocEntry(el, text, toclevel) {
+    this.element = el;
+    this.text = text;
+    this.toclevel = toclevel;
+  }
+
+  function tocEntries(el, toclevels) {
+    var result = new Array;
+    var re = new RegExp('[hH]([1-'+(toclevels+1)+'])');
+    // Function that scans the DOM tree for header elements (the DOM2
+    // nodeIterator API would be a better technique but not supported by all
+    // browsers).
+    var iterate = function (el) {
+      for (var i = el.firstChild; i != null; i = i.nextSibling) {
+        if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
+          var mo = re.exec(i.tagName);
+          if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
+            result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
+          }
+          iterate(i);
+        }
+      }
+    }
+    iterate(el);
+    return result;
+  }
+
+  var toc = document.getElementById("toc");
+  if (!toc) {
+    return;
+  }
+
+  // Delete existing TOC entries in case we're reloading the TOC.
+  var tocEntriesToRemove = [];
+  var i;
+  for (i = 0; i < toc.childNodes.length; i++) {
+    var entry = toc.childNodes[i];
+    if (entry.nodeName.toLowerCase() == 'div'
+     && entry.getAttribute("class")
+     && entry.getAttribute("class").match(/^toclevel/))
+      tocEntriesToRemove.push(entry);
+  }
+  for (i = 0; i < tocEntriesToRemove.length; i++) {
+    toc.removeChild(tocEntriesToRemove[i]);
+  }
+  
+  // Rebuild TOC entries.
+  var entries = tocEntries(document.getElementById("content"), toclevels);
+  for (var i = 0; i < entries.length; ++i) {
+    var entry = entries[i];
+    if (entry.element.id == "")
+      entry.element.id = "_toc_" + i;
+    var a = document.createElement("a");
+    a.href = "#" + entry.element.id;
+    a.appendChild(document.createTextNode(entry.text));
+    var div = document.createElement("div");
+    div.appendChild(a);
+    div.className = "toclevel" + entry.toclevel;
+    toc.appendChild(div);
+  }
+  if (entries.length == 0)
+    toc.parentNode.removeChild(toc);
+},
+
+
+/////////////////////////////////////////////////////////////////////
+// Footnotes generator
+/////////////////////////////////////////////////////////////////////
+
+/* Based on footnote generation code from:
+ * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
+ */
+
+footnotes: function () {
+  // Delete existing footnote entries in case we're reloading the footnodes.
+  var i;
+  var noteholder = document.getElementById("footnotes");
+  if (!noteholder) {
+    return;
+  }
+  var entriesToRemove = [];
+  for (i = 0; i < noteholder.childNodes.length; i++) {
+    var entry = noteholder.childNodes[i];
+    if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote")
+      entriesToRemove.push(entry);
+  }
+  for (i = 0; i < entriesToRemove.length; i++) {
+    noteholder.removeChild(entriesToRemove[i]);
+  }
+
+  // Rebuild footnote entries.
+  var cont = document.getElementById("content");
+  var spans = cont.getElementsByTagName("span");
+  var refs = {};
+  var n = 0;
+  for (i=0; i<spans.length; i++) {
+    if (spans[i].className == "footnote") {
+      n++;
+      var note = spans[i].getAttribute("data-note");
+      if (!note) {
+        // Use [\s\S] in place of . so multi-line matches work.
+        // Because JavaScript has no s (dotall) regex flag.
+        note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
+        spans[i].innerHTML =
+          "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
+          "' title='View footnote' class='footnote'>" + n + "</a>]";
+        spans[i].setAttribute("data-note", note);
+      }
+      noteholder.innerHTML +=
+        "<div class='footnote' id='_footnote_" + n + "'>" +
+        "<a href='#_footnoteref_" + n + "' title='Return to text'>" +
+        n + "</a>. " + note + "</div>";
+      var id =spans[i].getAttribute("id");
+      if (id != null) refs["#"+id] = n;
+    }
+  }
+  if (n == 0)
+    noteholder.parentNode.removeChild(noteholder);
+  else {
+    // Process footnoterefs.
+    for (i=0; i<spans.length; i++) {
+      if (spans[i].className == "footnoteref") {
+        var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
+        href = href.match(/#.*/)[0];  // Because IE return full URL.
+        n = refs[href];
+        spans[i].innerHTML =
+          "[<a href='#_footnote_" + n +
+          "' title='View footnote' class='footnote'>" + n + "</a>]";
+      }
+    }
+  }
+},
+
+install: function(toclevels) {
+  var timerId;
+
+  function reinstall() {
+    asciidoc.footnotes();
+    if (toclevels) {
+      asciidoc.toc(toclevels);
+    }
+  }
+
+  function reinstallAndRemoveTimer() {
+    clearInterval(timerId);
+    reinstall();
+  }
+
+  timerId = setInterval(reinstall, 500);
+  if (document.addEventListener)
+    document.addEventListener("DOMContentLoaded", reinstallAndRemoveTimer, false);
+  else
+    window.onload = reinstallAndRemoveTimer;
+}
+
+}

data/asciidoc/examples/website/asciidocapi.txt

@@ -0,0 +1,189 @@
+AsciiDoc API
+============
+
+'asciidocapi' -- a Python API module for 'AsciiDoc'.
+
+
+Introduction
+------------
+The 'asciidocapi' module implements a Python API for AsciiDoc. It
+allows you to set `asciidoc(1)` program options, compile an AsciiDoc
+source file and then interrogate the results.  The `asciidocapi.py`
+module file contains the `AsciiDocAPI` wrapper class for
+`asciidoc.py`.
+
+.Benefits
+- Stable API Shields the user from the undocumented and possibly
+  volatile `asciidoc.py` internals.
+- Easier to use and more flexible than the alternative of running
+  `asciidoc(1)` as a separate process.
+- Executes inside your application (better performance than running
+  separate `asciidoc(1)` command processes).
+
+
+Using asciidocapi
+-----------------
+To use the API just drop the `asciidocapi.py` file into your
+application directory, import it and use the `AsciiDocAPI` class.  The
+only requirement is that a compatible version of 'AsciiDoc' is already
+installed -- simple, no setuptools to run, no Eggs to install, no
+non-standard library dependencies.
+
+You can find `asciidocapi.py` in the AsciiDoc
+http://www.methods.co.nz/asciidoc/INSTALL.html#X1[distribution
+archives] (version 8.4.1 or better).
+
+Once you have `asciidocapi.py` Verify everything is working by running
+the module doctests:
+
+  python asciidocapi.py
+
+If there are no messages then all is well.
+
+The following minimal example compiles `mydoc.txt` to `mydoc.html`:
+
+[source,python]
+-------------------------------------------------------------------------------
+from asciidocapi import AsciiDocAPI
+asciidoc = AsciiDocAPI()
+asciidoc.execute('mydoc.txt')
+-------------------------------------------------------------------------------
+
+The next interactive example uses file-like objects for input and output:
+
+-------------------------------------------------------------------------------
+$ python
+Python 2.5.2 (r252:60911, Jul 31 2008, 17:28:52)
+[GCC 4.2.3 (Ubuntu 4.2.3-2ubuntu7)] on linux2
+Type "help", "copyright", "credits" or "license" for more information.
+>>> from asciidocapi import AsciiDocAPI
+>>> import StringIO
+>>> infile = StringIO.StringIO('Hello *{author}*')
+>>> outfile = StringIO.StringIO()
+>>> asciidoc = AsciiDocAPI()
+>>> asciidoc.options('--no-header-footer')
+>>> asciidoc.attributes['author'] = 'Joe Bloggs'
+>>> asciidoc.execute(infile, outfile, backend='html4')
+>>> print outfile.getvalue()
+<p>Hello <strong>Joe Bloggs</strong></p>
+
+>>>
+-------------------------------------------------------------------------------
+
+
+Implementation Rationale
+------------------------
+.Leverage existing knowledge
+The API maps directly onto the `asciidoc(1)` command -- this is
+deliberate -- if you know the `asciidoc(1)` command learning the API
+will be trivial. A nice side effect of this goal is that API and
+command-line modes share the same code -- virtually no `asciidoc(1)`
+code is specific to API usage.
+
+.Simplicity
+Implemented with a single Python module file (`asciidocapi.py`)
+containing the 'AsciiDocAPI' API class. 'AsciiDocAPI'  contains just
+one method plus a few attributes for processing options and result
+messages.  No external setup tools and no non-standard library
+dependencies are used or required.
+
+.Loose coupling
+The dependency between `asciidocapi.py` and `asciidoc.py` is minimal
+-- the current `asciidocapi.py` module uses only two attributes and
+one function from the `asciidoc.py` module.
+
+.Why isn't the API baked right into the asciidoc.py command script?
+1. You can't just drop `asciidoc.py` into your application because it
+   requires all the related config files and filters -- complex and
+   unnecessary since all this was already done when you installed
+   AsciiDoc.
+2. This scheme separates the API from the AsciiDoc application -- the
+   API implementation can be extended or replaced independently of
+   AsciiDoc.
+
+
+API reference
+-------------
+
+[[X2]]
+Class `AsciiDocAPI(object)`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+This is the 'AsciiDoc' API class.
+
+Instance attributes
+^^^^^^^^^^^^^^^^^^^
+`asciidoc`::
+The imported `asciidoc.py` module.
+
+`attributes`::
+A dictionary of AsciiDoc attribute values passed to AsciiDoc.
+
+- Setting an attribute value to `None` (`name: None`) will undefine
+  (delete) the attribute (this in addition to the `name!` attribute
+  name format that the `asciidoc(1)` command uses).
+- To simply define an attribute set the attribute value to a blank
+  string (`name: ''`) 
+
+`cmd`::
+The file path of the `asciidoc.py` script. Set by the `__init__`
+method.
+
+`messages`::
+A chronologically ordered list of message strings generated during
+AsciiDoc execution (last message at the end of the list).
+
+`options`::
+An instance of the <<X1,Options class>>. Contains a list of command
+options passed to AsciiDoc.
+
+Instance methods
+^^^^^^^^^^^^^^^^
+`__init__(self, asciidoc_py=None)`::
+Locate and import `asciidoc.py` module and verify API compatibility.
+Initialize instance attributes. A search for the `asciidoc` module is
+made in the following order:
+
+. Use the `ASCIIDOC_PY` environment variable if it is set.
+. Use the `asciidoc_py` argument if it is set.
+. Search the environment 'PATH' for `asciidoc.py`, `asciidoc.pyc` and
+  `asciidoc` (in that order).
+. Finally repeat the previous search in the current working directory.
+
+`execute(self, infile, outfile=None, backend=None)`::
+Compile `infile` to `outfile` using `backend` format.  `infile` and
+`outfile` can be file path strings or file-like objects. `backend` is
+name of 'AsciiDoc' backend (takes same values as `asciidoc(1)` command
+`--backend` option). If `outfile` or `backend` are `None` then their
+respective `asciidoc(1)` defaults are used.
+
+
+[[X1]]
+Class `Options(object)`
+~~~~~~~~~~~~~~~~~~~~~~~
+Stores `asciidoc(1)` command options. You can use any `asciidoc(1)`
+options with the exception of the `--doctest` and `--filter` options.
+
+Instance attributes
+^^^^^^^^^^^^^^^^^^^
+`values`::
+The list of `(name,value)` command option tuples.
+
+Instance methods
+^^^^^^^^^^^^^^^^
+`__call__(self, name, value=None)`::
+A shortcut for the `append` method. Example:
+
+  opts = Options()
+  opts('--verbose')
+
+`append(self, name, value=None)`::
+Append `(name,value)` to the options list. Example:
+
+  opts = Options()
+  opts.append('--conf-file', 'blog.conf')
+
+
+Class `AsciiDocError(Exception)`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Thrown by the <<X2,AsciiDocAPI class>> when an 'AsciiDoc' execution
+error occurs.

data/asciidoc/examples/website/asciimathml.txt

@@ -0,0 +1,61 @@
+ASCIIMathML Formulae
+====================
+
+http://www1.chapman.edu/~jipsen/mathml/asciimath.html[ASCIIMathML] is
+a clever JavaScript written by Peter Jipsen that dynamically
+transforms mathematical formulae written in a wiki-like plain text
+markup to http://www.w3.org/Math/[MathML] markup which is displayed as
+standard mathematical notation by the Web Browser.  See 'Appendix E'
+in the AsciiDoc User Guide for more details.
+
+The AsciiDoc `xhtml11` backend supports ASCIIMathML -- it links the
+ASCIIMathML script and escapes ASCIIMathML delimiters and special
+characters to yield valid XHTML. To use ASCIIMathML:
+
+1. Include the `-a asciimath` command-line option when you run
+   `asciidoc(1)`.
+2. Enclose ASCIIMathML formulas inside math or double-dollar
+   passthroughs or in math passthrough blocks.
+
+Here's the link:asciimathml.txt[AsciiDoc source] that generated this
+page.
+
+.NOTE
+- When you use the `asciimath:[]` inline macro you need to escape `]`
+  characters in the formulas with a backslash, escaping is unnecessary
+  if you use the double-dollar macro (for examples see the second
+  formula below).
+- See the
+  http://www1.chapman.edu/~jipsen/mathml/asciimath.html[ASCIIMathML]
+  website for ASCIIMathML documentation and the latest version.
+- If the formulas don't appear to be correct you probably need to
+  install the correct math fonts (see the
+  http://www1.chapman.edu/~jipsen/mathml/asciimath.html[ASCIIMathML]
+  website for details).
+- See the link:latexmathml.html[LaTeXMathML page] if you prefer to use
+  LaTeX math formulas.
+
+A list of example formulas:
+
+- $$`[[a,b],[c,d]]((n),(k))`$$
+- asciimath:[x/x={(1,if x!=0),(text{undefined},if x=0):}]
+- asciimath:[d/dxf(x)=lim_(h->0)(f(x+h)-f(x))/h]
+- +++`sum_(i=1)\^n i=(n(n+1))/2`$+++ and *bold
+  asciimath:[int_0\^(pi/2) sinx\ dx=1]*
+- asciimath:[(a,b\]={x in RR : a < x <= b}]
+- asciimath:[x^2+y_1+z_12^34]
+
+*********************************************************************
+The first three terms factor to give
+asciimath:[(x+b/(2a))^2=(b^2)/(4a^2)-c/a].
+
+asciimath:[x+b/(2a)=+-sqrt((b^2)/(4a^2)-c/a)].
+
+Now we take square roots on both sides and get
+asciimath:[x+b/(2a)=+-sqrt((b^2)/(4a^2)-c/a)].
+Finally we move the asciimath:[b/(2a)] to the right and simplify to
+get the two solutions:
+*asciimath:[x_(1,2)=(-b+-sqrt(b^2-4ac))/(2a)]*.
+
+*********************************************************************
+

data/asciidoc/examples/website/build-website.sh

@@ -0,0 +1,25 @@
+#!/bin/sh
+
+VERS="8.1.0"
+DATE="2006-10-22"
+
+# Leave the desired layout uncommented.
+#LAYOUT=layout1      # Tables based layout.
+LAYOUT=layout2     # CSS based layout.
+
+ASCIIDOC_HTML="python ../../asciidoc.py --backend=xhtml11 --conf-file=${LAYOUT}.conf --attribute icons --attribute iconsdir=./images/icons --attribute=badges --attribute=revision=$VERS  --attribute=date=$DATE"
+
+$ASCIIDOC_HTML -a index-only index.txt
+$ASCIIDOC_HTML -a toc -a numbered userguide.txt
+$ASCIIDOC_HTML -d manpage manpage.txt
+$ASCIIDOC_HTML downloads.txt
+$ASCIIDOC_HTML latex-backend.txt
+$ASCIIDOC_HTML README.txt
+$ASCIIDOC_HTML INSTALL.txt
+$ASCIIDOC_HTML CHANGELOG.txt
+$ASCIIDOC_HTML README-website.txt
+$ASCIIDOC_HTML support.txt
+$ASCIIDOC_HTML source-highlight-filter.txt
+$ASCIIDOC_HTML music-filter.txt
+$ASCIIDOC_HTML a2x.1.txt
+$ASCIIDOC_HTML asciimath.txt