FooBarWidget-mizuho 0.9.0

data/asciidoc/README

@@ -0,0 +1,46 @@
+                              AsciiDoc README File
+
+   version 8.2.7, 4 July 2008
+     __________________________________________________________________
+
+1. Prerequisites
+
+   AsciiDoc is written in Python so you need a Python interpreter (version
+   2.4 or later) to execute asciidoc(1). Python is installed by default in
+   most Linux distributions. You can download Python from the official
+   Python website [1]http://www.python.org.
+     __________________________________________________________________
+
+2. Obtaining AsciiDoc
+
+   The latest AsciiDoc version and online documentation can be found at
+   [2]http://www.methods.co.nz/asciidoc/ and at the SourceForge
+   [3]http://sourceforge.net/projects/asciidoc/.
+     __________________________________________________________________
+
+3. Tools
+
+   Current AsciiDoc version tested on Xubuntu Linux 7.10 with:
+     * Python 2.5.1
+     * bash 3.2.25(1)
+     * DocBook XSL Stylesheets 1.72.0 (with AsciiDoc drivers and patches).
+     * xsltproc (libxml 20629, libxslt 10121 and libexslt 813).
+     * lynx 2.8.5rel.1.
+     * dblatex 0.2.8
+     * FOP 0.95beta
+     __________________________________________________________________
+
+4. COPYING
+
+   Copyright � 2002-2008 Stuart Rackham. Free use of this software is
+   granted under the terms of the GNU General Public License (GPL).
+     __________________________________________________________________
+
+   Version 8.2.7
+   Last updated 2008-07-04 23:26:27 NZDT
+
+References
+
+   1. http://www.python.org/
+   2. http://www.methods.co.nz/asciidoc/
+   3. http://sourceforge.net/projects/asciidoc/

data/asciidoc/README.txt

@@ -0,0 +1,36 @@
+AsciiDoc README File
+====================
+
+Prerequisites
+-------------
+AsciiDoc is written in Python so you need a Python interpreter
+(version 2.4 or later) to execute asciidoc(1). Python is installed by
+default in most Linux distributions.  You can download Python from the
+official Python website http://www.python.org.
+
+
+Obtaining AsciiDoc
+------------------
+The latest AsciiDoc version and online documentation can be found at
+http://www.methods.co.nz/asciidoc/ and at the SourceForge
+http://sourceforge.net/projects/asciidoc/.
+
+
+Tools
+-----
+Current AsciiDoc version tested on Xubuntu Linux 7.10 with:
+
+- Python 2.5.1
+- bash 3.2.25(1)
+- DocBook XSL Stylesheets 1.72.0 (with AsciiDoc drivers and patches).
+- xsltproc (libxml 20629, libxslt 10121 and libexslt 813).
+- lynx 2.8.5rel.1.
+- dblatex 0.2.8
+- FOP 0.95beta
+
+
+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/a2x

@@ -0,0 +1,641 @@
+#!/usr/bin/env bash
+#
+# a2x - convert Asciidoc text file to PDF, XHTML, HTML Help, manpage
+#                  or plain text
+#
+# Copyright (C) 2007 Stuart Rackham. Free use of this software is granted
+# under the terms of the GNU General Public License (GPL).
+#
+
+VERSION=1.0.0
+BASENAME=$(basename "$0")
+REALNAME="$0"
+if [ ! -e "$REALNAME" ]; then
+    REALNAME=$(which "$REALNAME")
+fi
+REALNAME="$(readlink -f "$REALNAME")"
+CONF_DIR=/etc/asciidoc
+FOP_COMMAND="fop.sh"    # FOP executable.
+
+#--------------------------------------------------------------------
+# Constants.
+#--------------------------------------------------------------------
+
+# These are mostly related to command options and are set by parse_options().
+ASCIIDOC_OPTS=
+COPY=no
+DESTINATION_DIR=
+DOCTYPE=
+DRY_RUN=no
+FORMAT=xhtml
+ICONS=no
+ICONS_DIR=./images/icons
+SKIP_ASCIIDOC=no
+SRC_DIR=
+SRC_FILE=
+SRC_NAME=           # Source file name sans path and file name extension.
+STYLESHEET=./docbook-xsl.css
+VERBOSE_2=no
+VERBOSE=no
+XSLTPROC_OPTS=
+DBLATEX_OPTS=
+FOP_OPTS=
+FOP=no
+
+#--------------------------------------------------------------------
+# General purpose functions
+#--------------------------------------------------------------------
+
+# Write $1 to stderr with backslash-escaped characters and no trailing newline.
+function write_console()
+{
+        echo -ne "$1" >&2
+}
+
+# Write newline to stderr.
+function newline()
+{
+        echo >&2
+}
+
+# Write $1 message to stderr.
+function console_msg()
+{
+        echo "$BASENAME: $1" >&2
+}
+
+# Write $1 to stderr if verbose or dry-run options set.
+function verbose_msg()
+{
+    if isyes "$VERBOSE" || isyes "$DRY_RUN"; then
+            console_msg "$1"
+    fi
+}
+
+# Return 0 if $1 is interpreted as an affirmative string.
+function isyes()
+{
+    case "$1" in
+        y|Y|yes|YES|Yes|true|TRUE|True) return 0;;
+    esac
+    return 1
+}
+
+# Log message $1 and exit with status $2 (default 1).
+function quit()
+{
+    local err tmp
+    err=${2:-1}
+    if [ $err -ne 0 ]; then
+        tmp="$VERBOSE"
+        VERBOSE=yes     # Force console error exit message.
+        console_msg "failed: $1"
+        VERBOSE="$tmp"
+    else
+        console_msg "$1"
+    fi
+    cleanup
+        exit $err
+}
+
+# Execute the $1 command in the current shell subject to VERBOSE, DRY_RUN shell
+# variables.
+function execute_command()
+{
+    if isyes "$VERBOSE" || isyes "$DRY_RUN"; then
+    console_msg "eval: $1"
+    fi
+    if isyes "$DRY_RUN"; then
+        return 0
+    else
+        eval $1
+        return $?
+    fi
+}
+
+# Same as execute_command() but if error occurs prints optional $2 message and
+# exits program.
+function execute_command_2()
+{
+    local msg
+    execute_command "$1"
+    if [ $? -ne 0 ]; then
+        if [ -n "$2" ]; then
+            msg="$2"
+        else
+            msg="$1"
+        fi
+        quit "$msg"
+    fi
+}
+
+# Return 0 if $1 command can be executed.
+function is_executable()
+{
+    if which "$1" >/dev/null 2>&1; then
+        return 0
+    else
+        return 1
+    fi
+}
+
+# Return 127 if $1 is not in search path else return 0.
+function require()
+{
+    if ! is_executable "$1"; then
+        quit "cannot find required program: $1" 127
+    fi
+}
+
+# Join path $1 to path $2.
+function join()
+{
+    if [ -n "$1" ]; then
+        echo "$1/$2"
+    else
+        echo "$2"
+    fi
+}
+
+# Echo the total size in bytes of file name arguments.
+function file_size()
+{
+    echo $(du -cb "$@" | tail -1 | awk '{print $1}')
+}
+
+#--------------------------------------------------------------------
+# Application specific functions
+#--------------------------------------------------------------------
+
+# Trap interrupts.
+function set_trap()
+{
+    # By convention exit code is 128 + signal number.
+    trap "newline; quit 'exiting: SIGINT' 130" SIGINT
+    trap "newline; quit 'exiting: SIGQUIT' 131" SIGQUIT
+    trap "quit 'exiting: SIGHUP' 129" SIGHUP
+    trap "quit 'exiting: SIGTERM' 143" SIGTERM
+}
+
+# Called at program exit.
+function cleanup()
+{
+    if [ "$(pwd)" != "$PWD" ]; then
+        execute_command "cd \"$PWD\""
+    fi
+}
+
+# Print help summary.
+function help()
+{
+    cat <<EOF
+synopsis:
+
+  $BASENAME [OPTIONS] FILE
+
+options:
+  -a, --attribute=ATTRIBUTE      set asciidoc attribute value
+  --asciidoc-opts=ASCIIDOC_OPTS  asciidoc options
+  --copy                         copy icons or HTML stylesheet
+  -D, --destination-dir=PATH     output directory (defaults to FILE directory)
+  -d, --doctype=DOCTYPE          article, manpage, book
+  -f, --format=FORMAT            chunked,htmlhelp,manpage,pdf,text,xhtml,dvi,ps,tex
+  -h, --help                     print command syntax summary
+  --icons                        use admonition, callout and navigation icons
+  --icons-dir=PATH               admonition and navigation icon directory
+  -n, --dry-run                  don't do anything just print the commands
+  -s, --skip-asciidoc            skip asciidoc execution
+  --stylesheet=PATH              target HTML CSS stylesheet file name
+  --version                      print program version to stdout
+  -v, --verbose                  print operational details to stderr
+  --dblatex-opts=DBLATEX_OPTS    dblatex options
+  --fop-opts=FOP_OPTS            options for FOP pdf generation
+  --xsltproc-opts=XSLTPROC_OPTS  xsltproc options
+EOF
+}
+
+# Print full path name of file $1 searching first in the directory containing
+# the asciidoc executable and then in the global configuration directory.
+function conf_file()
+{
+    local result dir
+    # First look in same directory as asciidoc executable.
+    dir="$(dirname "$REALNAME")"
+    if [ ! -f "$dir/$1" -a -d $CONF_DIR ]; then
+        dir=$CONF_DIR
+    fi
+    result="$dir/$1"
+    echo $result
+}
+
+#--------------------------------------------------------------------
+# Process command-line arguments $@
+#--------------------------------------------------------------------
+function parse_options()
+{
+    if [ -z "$*" ]; then
+        help; exit 0
+    fi
+    require "getopt"
+    getopt -T >/dev/null
+    if [ $? -ne 4 ]; then
+        quit "enhanced getopt(1) required"
+    fi
+    short_opts="a:d:D:f:hnsv"
+    long_opts="attribute:,asciidoc-opts:,destination-dir:,doctype:,help,icons-dir:,dry-run,format:,copy,icons,skip-asciidoc,stylesheet:,version,verbose,xsltproc-opts:,dblatex-opts:,fop-opts:"
+    args=$(getopt -o $short_opts -l $long_opts -n $BASENAME -- "$@" 2>/dev/null)
+    if [ $? -ne 0 ]; then
+        quit "invalid command options, run: a2x --help"
+    fi
+    eval set -- "$args"     # Set positional variables.
+    while true ; do
+        case "$1" in
+            -a|--attribute)
+                ASCIIDOC_OPTS="$ASCIIDOC_OPTS -a \"$2\""
+                shift 2 ;;
+            --asciidoc-opts)
+                ASCIIDOC_OPTS="$ASCIIDOC_OPTS $2"
+                shift 2 ;;
+            --copy)
+                COPY=yes;
+                shift ;;
+            -d|--doctype)
+                DOCTYPE=$2
+                shift 2 ;;
+            -D|--destination-dir)
+                DESTINATION_DIR=$2
+                shift 2 ;;
+            -f|--format)
+                FORMAT=$2
+                shift 2 ;;
+            -h|--help)
+                help; exit 0 ;;
+            --icons)
+                ICONS=yes
+                shift ;;
+            --icons-dir)
+                ICONS_DIR=$2
+                shift 2 ;;
+            -n|--dry-run)
+                DRY_RUN=yes;
+                shift ;;
+            -s|--skip-asciidoc)
+                SKIP_ASCIIDOC=yes;
+                shift ;;
+            --stylesheet)
+                STYLESHEET=$2
+                shift 2 ;;
+            --version)
+                echo "$BASENAME $VERSION" ; exit 0 ;;
+            -v|--verbose)
+                if isyes "$VERBOSE"; then
+                    VERBOSE_2=yes
+                else
+                    VERBOSE=yes
+                fi
+                shift ;;
+            --xsltproc-opts)
+                XSLTPROC_OPTS="$XSLTPROC_OPTS $2"
+                shift 2 ;;
+            --fop-opts)
+                FOP_OPTS="$FOP_OPTS $2"
+                FOP=yes
+                shift 2 ;;
+            --dblatex-opts)
+                DBLATEX_OPTS="$DBLATEX_OPTS $2"
+                shift 2 ;;
+            --)
+                shift; break ;;
+            *)
+                quit "unrecognized option: $1" ;;
+        esac
+    done
+
+    if isyes "$DRY_RUN"; then
+        VERBOSE=yes
+    fi
+
+    if [ $# -eq 0 ]; then
+        quit "source file not specified"
+    fi
+    if [ $# -ne 1 ]; then
+        quit "only one source file allowed"
+    fi
+    if [ ! -r "$1" ]; then
+        quit "source file not found: $1"
+    fi
+    SRC_FILE=$1
+    SRC_DIR=$(dirname "$1")
+    SRC_NAME=$1
+    SRC_NAME=${SRC_NAME##*/}    # Strip path.
+    SRC_NAME=${SRC_NAME%.*}     # Strip extension.
+    # Use FOP if there is no dblatex.
+    if ! is_executable dblatex && is_executable "$FOP_COMMAND"; then
+        FOP=yes
+    fi
+}
+
+#--------------------------------------------------------------------
+# Validate program options.
+#--------------------------------------------------------------------
+function validate_options()
+{
+    case "$FORMAT" in
+        chunked|dvi|htmlhelp|manpage|odt|pdf|ps|tex|text|xhtml) ;;
+        *) quit "illegal format: $FORMAT" ;;
+    esac
+
+    if [ -z "$DOCTYPE" ]; then
+        if [ "$FORMAT" = "manpage" ]; then
+            DOCTYPE=manpage
+        else
+            DOCTYPE=article
+        fi
+    fi
+    case "$DOCTYPE" in
+        article|book|manpage) ;;
+        *) quit "illegal doctype: $DOCTYPE" ;;
+    esac
+
+    if [ -z "$ICONS_DIR" ]; then
+        quit "icons directory not specified"
+    fi
+    if [[ "$ICONS_DIR" == /* ]]; then
+        quit "icons directory must be relative: $ICONS_DIR"
+    fi
+    ICONS_DIR=${ICONS_DIR%*/}     # Strip trailing backslash.
+
+    if [ ! -z "$DESTINATION_DIR" ]; then
+        if [ ! -d "$DESTINATION_DIR" ]; then
+            quit "destination directory not found: $DESTINATION_DIR"
+        fi
+    else
+        DESTINATION_DIR="$SRC_DIR"
+    fi
+
+    if [ -z "$STYLESHEET" ]; then
+        quit "stylesheet cannot be blank"
+    fi
+    if [[ "$STYLESHEET" == /* ]]; then
+        quit "stylesheet path must be relative: $STYLESHEET"
+    fi
+}
+
+# Conditionally copy distribution stylesheet and admonition and navigation
+# icons to destination directory $1.
+function copy_stylesheet_and_icons()
+{
+    if isyes $COPY; then
+        copy_stylesheet "$1"
+        if isyes $ICONS; then
+            copy_icons "$1/$ICONS_DIR"
+        fi
+    fi
+}
+
+# Copy distribution stylesheet to destination directory $1.
+function copy_stylesheet()
+{
+    local src dst
+    src=$(conf_file stylesheets/docbook-xsl.css)
+    if [ ! -r "$src" ]; then
+        quit "file not found: $src"
+    fi
+    dst="$1/$STYLESHEET"
+    # Check we're not trying to copy the file onto itself.
+    if [[ "$src" -ef "$dst" ]]; then
+        return
+    fi
+    execute_command_2 "cp -u \"$src\" \"$dst\""
+}
+
+# Copy distribution admonition and navigation icons to destination directory
+# $1.
+function copy_icons()
+{
+    local src dst
+    dst="$1"
+    # Set source icons directory.
+    src=$(conf_file images/icons/home.png)
+    if [ ! -r "$src" ]; then
+        quit "file not found: $src"
+    fi
+    src=$(dirname "$src")
+    # Check we're not trying to copy the file onto itself.
+    if [[ "$src" -ef "$dst" ]]; then
+        return
+    fi
+    if [ -e "$dst" ]; then
+        if [ ! -d "$dst" ]; then
+            quit "icon destination must be a directory: $dst"
+        fi
+    else
+        execute_command_2 "mkdir -p \"$dst\""
+    fi
+    execute_command_2 "cp -rfu  \"$src/\"* \"$dst\""
+}
+
+#--------------------------------------------------------------------
+# Format conversion functions.
+#--------------------------------------------------------------------
+
+# Convert AsciiDoc $SRC_FILE to DocBook XML if it is newer than the
+# XML output file.  $1 has additional asciidoc(1) options.
+function to_docbook()
+{
+    local xml
+    xml="$SRC_DIR/$SRC_NAME.xml"
+    if isyes $SKIP_ASCIIDOC; then
+        if [ ! -r "$xml" ]; then
+            quit "file not found: $xml"
+        fi
+        return
+    fi
+    require "asciidoc"
+    execute_command_2 "asciidoc $ASCIIDOC_OPTS $1 -b docbook \"$SRC_FILE\""
+}
+
+function to_xhtml()
+{
+    require "xsltproc"
+    local xsl xml html
+    xsl=$(conf_file docbook-xsl/xhtml.xsl)
+    if [ ! -r "$xsl" ]; then
+        quit "file not found: $xsl"
+    fi
+    to_docbook
+    xml=$(readlink -f "$SRC_DIR/$SRC_NAME.xml")
+    html="$SRC_NAME.html"
+    copy_stylesheet_and_icons "$DESTINATION_DIR"
+    execute_command_2 "cd \"$DESTINATION_DIR\""
+    execute_command_2 "xsltproc $XSLTPROC_OPTS --nonet \
+        \"$xsl\" \"$xml\" >\"$html\""
+    execute_command_2 "cd - >/dev/null"
+}
+
+function to_chunked()
+{
+    require "xsltproc"
+    local chunkdir xsl xml hhp chm
+    case "$FORMAT" in
+        chunked)
+            chunkdir="$DESTINATION_DIR/$SRC_NAME.chunked"
+            xsl=chunked.xsl
+        ;;
+        htmlhelp)
+            chunkdir="$DESTINATION_DIR/$SRC_NAME.htmlhelp"
+            hhp="$SRC_NAME.hhp"
+            chm="$SRC_NAME.chm"
+            XSLTPROC_OPTS="$XSLTPROC_OPTS \
+                --stringparam htmlhelp.hhp \"$hhp\"
+                --stringparam htmlhelp.chm \"$chm\""
+            xsl=htmlhelp.xsl
+        ;;
+    esac
+    xsl=$(conf_file docbook-xsl/$xsl)
+    if [ ! -r "$xsl" ]; then
+        quit "file not found: $xsl"
+    fi
+    to_docbook
+    xml=$(readlink -f "$SRC_DIR/$SRC_NAME.xml")
+    if [ ! -d "$chunkdir" ]; then
+        execute_command_2 "mkdir \"$chunkdir\""
+    fi
+    execute_command_2 "rm -f \"$chunkdir/*.html\""
+    copy_stylesheet_and_icons "$chunkdir"
+    execute_command_2 "cd \"$DESTINATION_DIR\""
+    execute_command_2 "xsltproc $XSLTPROC_OPTS --nonet \
+        --stringparam base.dir \"$(basename "$chunkdir")/\" \
+        \"$xsl\" \"$xml\""
+    execute_command_2 "cd - >/dev/null"
+}
+
+function to_manpage()
+{
+    require "xsltproc"
+    local xsl xml
+    xsl=$(conf_file docbook-xsl/manpage.xsl)
+    if [ ! -r "$xsl" ]; then
+        quit "file not found: $xsl"
+    fi
+    to_docbook "-d manpage"
+    xml=$(readlink -f "$SRC_DIR/$SRC_NAME.xml")
+    execute_command_2 "cd \"$DESTINATION_DIR\""
+    execute_command_2 "xsltproc $XSLTPROC_OPTS --nonet \
+        \"$xsl\" \"$xml\""
+    execute_command_2 "cd - >/dev/null"
+}
+
+function run_dblatex()
+{
+    require "dblatex"
+    local xsl xml sty
+    to_docbook
+    xml="$SRC_DIR/$SRC_NAME.xml"
+    xsl=$(conf_file dblatex/asciidoc-dblatex.xsl)
+    sty=$(conf_file dblatex/asciidoc-dblatex.sty)
+    execute_command_2 "dblatex $DBLATEX_OPTS -t $FORMAT -p \"$xsl\" -s \"$sty\" \"$xml\""
+}
+
+function run_fop()
+{
+    local xsl xml fo pdf
+    xml="$SRC_DIR/$SRC_NAME.xml"
+    pdf="$DESTINATION_DIR/$SRC_NAME.pdf"
+    require "xsltproc"
+    require "$FOP_COMMAND"
+    xsl=$(conf_file docbook-xsl/fo.xsl)
+    if [ ! -r "$xsl" ]; then
+        quit "file not found: $xsl"
+    fi
+    fo="$SRC_DIR/$SRC_NAME.fo"
+    to_docbook
+    execute_command_2 "xsltproc $XSLTPROC_OPTS --nonet \
+        \"$xsl\" \"$xml\" >\"$fo\""
+    execute_command_2 "\"$FOP_COMMAND\" $FOP_OPTS -fo \"$fo\" -pdf \"$pdf\""
+}
+
+function to_pdf()
+{
+    if isyes $FOP; then
+        run_fop
+    else
+        run_dblatex
+    fi
+}
+
+function to_odt()
+{
+    require "docbook2odf"
+    local xml odt opts
+    xml="$SRC_DIR/$SRC_NAME.xml"
+    odt="$DESTINATION_DIR/$SRC_NAME.odt"
+    opts="--force"
+    if ! isyes $VERBOSE; then
+        opts="$opts --quiet"
+    fi
+    to_docbook
+    execute_command_2 "docbook2odf $opts \"$xml\" --output-file \"$odt\""
+}
+
+function to_text()
+{
+    require "asciidoc"
+    require "lynx"
+    local html text conf
+    html="$SRC_DIR/$SRC_NAME.html"
+    text="$DESTINATION_DIR/$SRC_NAME.text"
+    conf=$(conf_file text.conf)
+    execute_command_2 "asciidoc $ASCIIDOC_OPTS -f "$conf" -b html4 \
+        -o - \"$SRC_FILE\" | lynx -dump -stdin >\"$text\""
+}
+
+#--------------------------------------------------------------------
+# Main
+#--------------------------------------------------------------------
+
+PWD=`pwd`
+set_trap
+parse_options "$@"
+validate_options
+ASCIIDOC_OPTS="--doctype=$DOCTYPE $ASCIIDOC_OPTS"
+if isyes $VERBOSE_2; then
+    ASCIIDOC_OPTS="$ASCIIDOC_OPTS --verbose"
+    XSLTPROC_OPTS="$XSLTPROC_OPTS --verbose"
+fi
+case "$FORMAT" in
+    xhtml|chunked|htmlhelp)
+        XSLTPROC_OPTS="$XSLTPROC_OPTS \
+            --stringparam html.stylesheet \"$STYLESHEET\""
+    ;;
+esac
+if isyes $ICONS; then
+    XSLTPROC_OPTS="$XSLTPROC_OPTS --stringparam callout.graphics 1 \
+        --stringparam navig.graphics 0 \
+        --stringparam admon.textlabel 0 \
+        --stringparam admon.graphics 1 \
+        --stringparam admon.graphics.path \"$ICONS_DIR/\" \
+        --stringparam callout.graphics.path \"$ICONS_DIR/callouts/\" \
+        --stringparam navig.graphics.path \"$ICONS_DIR/\""
+else
+    XSLTPROC_OPTS="$XSLTPROC_OPTS --stringparam callout.graphics 0 \
+        --stringparam navig.graphics 0 \
+        --stringparam admon.textlabel 1 \
+        --stringparam admon.graphics 0"
+fi
+case "$FORMAT" in
+    chunked|htmlhelp)   to_chunked;;
+    manpage)            to_manpage;;
+    odt)                to_odt;;
+    pdf)                to_pdf;;
+    text)               to_text;;
+    xhtml)              to_xhtml;;
+    dvi)                run_dblatex;;
+    ps)                 run_dblatex;;
+    tex)                run_dblatex;;
+esac
+cleanup
+
+#--------------------------------------------------------------------
+# vim: set et ts=4 sw=4 sts=4:
+#--------------------------------------------------------------------