mizuho 0.9.10 → 0.9.11

data/asciidoc/CHANGELOG.txt

@@ -4,9 +4,244 @@ AsciiDoc ChangeLog
 :website: http://www.methods.co.nz/asciidoc/
 
 
-Version 8.6.5 (2011-05-08)
+Version 8.6.7 (2012-03-17)
 --------------------------
-.Additions and changes
+.Release highlights
+No major enhancements but quite a few bug fixes which, among other
+things, fixes Jython compatibility and improves Windows compatibility.
+
+.All additions and changes
+- Vim syntax highlighter: highlight entity refs in macro arguments.
+- Added files with `.asciidoc` extension to Vim file type detection.
+  http://groups.google.com/group/asciidoc/browse_thread/thread/a9762e21ec0cc244/5d3a4ebf20e6847e[Patch]
+  submitted by Dag Wiers.
+- Added 'replacement3' substitution to enable
+  http://groups.google.com/group/asciidoc/browse_thread/thread/843d7d3d671006fb/25628e14c829db3f[ODT
+  whitespace processing].
+- Added 'unbreakable' option to XHTML and HTML 5 backends.
+- Implemented toc::[] block macro and 'toc-placement' attribute for
+  HTML backends to allow the Table of Contents placement to be set
+  manually by the author.
+- Added FAQs: 'How can I control page breaks when printing HTML
+  outputs?' and 'Is it possible to reposition the Table of Contents
+  in HTML outputs?'.
+- Added `--backend` and `--backend-opts` options to the 'a2x' command
+  to allow 'a2x' to use backend plugin code extensions.
+  http://groups.google.com/group/asciidoc/browse_thread/thread/b8e93740b7cd0e1d/b5e0b83fe37ae31a[Patch]
+  submitted by Lex Trotman.
+- Added
+  http://groups.google.com/group/asciidoc/browse_thread/thread/3d06b0105dfbb780/8c60eb7a62f522e4[args
+  block attribute] to source highlight blocks to allow arbitrary
+  parameters to be passed to the source highlighters.
+- If the 'ascii-ids' attribute is defined then non-ascii characters in
+  auto-generated IDs
+  http://groups.google.com/group/asciidoc/browse_thread/thread/33e99b78e2472122[are
+  replaced] by their nearest ascii equivalents (to work around DocBook
+  processor limitations).
+- Added global 'blockname' attribute which is dynamically updated to
+  identify the current block.  See
+  http://groups.google.com/group/asciidoc/browse_thread/thread/8200e29815c40f72[discussion
+  list].
+- 'xhtml11', 'html5' backends: Include book part TOC entries for
+  multi-part books.  Patch submitted by Loïc Paillotin.
+- Removed code filter example from the AsciiDoc User Guide so that
+  backends implemented as external plugins can compile the manual. See
+  http://groups.google.com/group/asciidoc/browse_thread/thread/849e5ea91f43adf2[discussion
+  list].
+- If the delimited block 'skip' option is set then do not consume
+  block title and attributes. This makes it possible for the comment
+  delimited blocks to use an attribute list (previously the comment
+  delimited block was hardwired to skip preceding attributes and
+  titles). See
+  http://groups.google.com/group/asciidoc/browse_thread/thread/e92a75abcc382701[discussion
+  list].
+- Added `backend-confdir` intrinsic attribute.
+
+.Bug fixes
+- *FIXED*: slidy backend: broken 'stylesheet' attribute.
+  http://groups.google.com/group/asciidoc/browse_thread/thread/58d0843ae4345afd[Patch]
+  submitted by Micheal Hackett.
+- *FIXED*: Restored
+  http://groups.google.com/group/asciidoc/browse_thread/thread/b0e69e393b6f9f20/47a2c7586f9e40c6?lnk=gst&q=themes+tarball#47a2c7586f9e40c6[missing
+  themes] to zip file distribution archive.
+- *FIXED*: Grammatical error in error messages.
+  http://groups.google.com/group/asciidoc/browse_thread/thread/b9d705c6b6b39f59/1e120483dafca109[Patch]
+  submitted by Dag Wieers.
+- *FIXED*: Use configured normal substitution in preference to the
+  default one.
+- *FIXED*: The 'eval' block macro would execute multiple times if it
+  evaluated to 'None'.
+- *FIXED*: Duplicated entries in TOC of large document.
+  http://groups.google.com/group/asciidoc/browse_thread/thread/103445ab9d95cb0c[Patch]
+  submitted by Sebastien Helleu.
+- *FIXED*: Python 2.4 backward
+  http://code.google.com/p/asciidoc/issues/detail?id=9[incompatibility].
+- *FIXED*: 8.6.6 regression broke Jython compatibility.  See
+  http://groups.google.com/group/asciidoc/browse_thread/thread/4608b77ec289f6c4[discussion
+  list].
+- *FIXED*: Leaky file handles in a2x and music and latex filters which
+  created incompatibility problems for Jython.
+- *FIXED*: All Python filters are executed with the same Python
+  interpreter that executes the asciidoc parent (previously filters
+  were hardwired to execute the 'python' interpreter). This prevents
+  http://groups.google.com/group/asciidoc/browse_thread/thread/14e8fcb289a135b/3af3b4e57b827c78?lnk=gst&q=archlinux#3af3b4e57b827c78[Python
+  mix-ups].
+- *FIXED*: Microsoft Windows shelled command-line truncation that
+  caused shelled commands to fail e.g. the 'data-uri' attribute
+  failure.
+
+
+Version 8.6.6 (2011-09-04)
+--------------------------
+.Release highlights
+- The AsciiDoc plugin architecture has been enhanced, unified and
+  extended:
+  * Plugin commands have been added to the asciidoc(1) `--backend`
+    option.
+  * An asciidoc(1) `--theme` option has been implemented to specify a
+    theme and to manage theme plugins.
+  * A plugin 'build' command (for creating plugins) added.
+  * 'build', 'install', 'list' and 'remove' plugin commands are all
+    recognized by asciidoc(1) `--backend`, `--filter` and `--theme`
+    options.
+- A security update by Kenny MacDermid removes the use of `eval()` on
+  untrusted input (to disallow code malicious execution).
+
+.All additions and changes
+- 'xhtml11', 'html5': Made verse and quote block text darker to print
+  legibly in Google Chrome browser.
+- Added plugin 'build' command for plugin file creation.
+- Merged `--help plugins` back to `--help manpage` so it matches the
+  asciidoc(1) manpage.
+- The `--filter` command-line option can specify the name of filters
+  that will be unconditionally loaded.
+- If a filter directory contains a file named `__noautoload__` then
+  the filter is not automatically loaded (you can used the `--filter`
+  command-line option to override this behavior).
+- tests: Add Italian language tests.  Patch submitted by Simon
+  Ruderich. See:
+  http://groups.google.com/group/asciidoc/browse_thread/thread/5e2e6f4dd740d51a
+- tests: Add tests for localized man pages.  Patch submitted by Simon
+  Ruderich. See:
+  http://groups.google.com/group/asciidoc/browse_thread/thread/5e2e6f4dd740d51a
+- If the section name is prefixed with a '+' character then the
+  section contents is appended to the contents of an already existing
+  same-named section (the default behavior is to replace the the
+  section).
+- If a configuration file section named 'docinfo' is loaded then it
+  will be included in the document header.  Typically the 'docinfo'
+  section name will be prefixed with a '+' character so that it is
+  appended to (rather than replace) other 'docinfo' sections.
+- Added `{sp}` intrinsic attribute for single space character.  See
+  http://groups.google.com/group/asciidoc/browse_thread/thread/a839aa01db0765d2
+- Fixed TOC and footnotes generator. Patch submitted by Will.  See
+  http://groups.google.com/group/asciidoc/browse_thread/thread/734ac5afed736987
+- The `asciidoc-confdir` attribute is set to the asciidoc executable
+  directory if it contains global configuration files i.e. a local
+  asciidoc installation.
+- asciidoc now throws an error instead of just a warning of the
+  backend configuration file is not found.
+- latex filter: write MD5 file after successful PNG file generation.
+  Always delete temp files irrespective of outcome.
+- Added truecolor option to LaTeX filter. Patch submitted by Michel
+  Krämer. See:
+  http://groups.google.com/group/asciidoc/browse_thread/thread/6436788a10561851
+- Unit test for table column specifiers with merged cells. Patch
+  submitted by Simon Ruderich. See:
+  http://groups.google.com/group/asciidoc/browse_thread/thread/c9238380a1f2507a
+- Added verbose message for `ifeval::[]` macro evaluation.
+- Added test case for `ifeval::[]` evaluation.
+- Security update to remove the use of `eval()` on untrusted input (to
+  disallow code malicious execution).  Patch submitted by Kenny
+  MacDermid.
+- Changed web site layout from table to CSS based.  See
+  http://groups.google.com/group/asciidoc/browse_thread/thread/ec8e8481eb0e27b0/d1c035092b5bb7a4?lnk=gst&q=caption+option#d1c035092b5bb7a4
+- a2x: Pass `--format` option value to asciidoc as 'a2x-format'
+  attribute.  Patch submitted by Lex Trotman
+  (http://groups.google.com/group/asciidoc/browse_thread/thread/3e177b84bc133ca9/659796dfadad30ea?lnk=gst&q=a2x+format#659796dfadad30ea).
+- Added two FAQs submitted by Lex Trotman. See:
+  http://groups.google.com/group/asciidoc/browse_thread/thread/16d3fb9672a408e7
+- html5,xhtml11: Implemented themes directory structure.
+- html5,xhtml11: Implemented asciidoc `--theme` management option
+  (install, list, build and remove commands).
+- html5,xhtml11: A theme can now optionally include a JavaScript file
+  `<theme>.js`
+- html5,xhtml11: If the 'data-uri' attribute is defined then icons
+  from the theme icons directory (if they exist) will be embedded in
+  the generated document.
+- Added optional 'warnings' argument to include macros.
+- The asciidoc `--verbose` option now prints file inclusion messages.
+- xhtml11, html5: Remove necessity for separate manpage CSS files.
+- Added 'css-signature' attribute to tests.
+- Add 'css-signature' attribute to set a CSS signature for the
+  document.  Patch submitted by Peg Russell, see:
+  http://groups.google.com/group/asciidoc/browse_thread/thread/bacbf8aeb8ad6a3a
+- White background for toc2 TOC viewport so that horizontally scrolled
+  content does not obscure the the TOC.  Patch submitted by Lionel
+  Orry, see: http://code.google.com/p/asciidoc/issues/detail?id=8
+
+.Bug fixes
+- *FIXED*: Plugin install command: Delete backend directory is install
+  fails.
+- *FIXED*: Plugin install command: Fixed bug extracting binary files
+  on Windows (reported by Jean-Michel Inglebert).
+- *FIXED*: tests: Skip blank sections in testasciidoc.conf test
+  configuration file instead of throwing an exception (reported by
+  Jean-Michel Inglebert).
+- *FIXED*: If a plugin Zip file does not contain file permissions
+  (probably because it was created under Windows) then install it
+  using the default permissions.
+- *FIXED*: Fixed missing quote in preceding LaTeX filter patch. Fix
+  submitted by Simon Ruderich. See:
+  http://groups.google.com/group/asciidoc/browse_thread/thread/6436788a10561851
+- *FIXED*: Some path attributes were processed as escaped Python
+  strings which could result in corrupted path names with backslash
+  separated Windows path names. Reported by Will. See:
+  http://groups.google.com/group/asciidoc/browse_thread/thread/e8f3938bcb4c8bb4/44d13113a35738ef
+- *FIXED*: Vertically spanned table cells resulted in incorrect column
+  styles being applied to some cells.  Reported by Will:
+  http://groups.google.com/group/asciidoc/browse_thread/thread/c9238380a1f2507a/9afc4559d51e1dbd
+- *FIXED*: LaTeX backend: fixed bad escapes. Patch submitted by Mark
+  McCurry:
+  http://groups.google.com/group/asciidoc/browse_thread/thread/8c111f1046b33691/158a944cf4d5ff0d?lnk=gst&q=latex+escapes#158a944cf4d5ff0d
+- *FIXED*: When using slidy backend, display of characters with
+  accents is wrong because of 'meta http-equiv' line missing. Reported
+  by Fabrice Flore-Thebault.  See:
+  http://groups.google.com/group/asciidoc/browse_thread/thread/eaf25f21d1da180a
+
+
+Version 8.6.5 (2011-05-20)
+--------------------------
+.Release highlights
+- The addition of an 'html5' backend to generate HTML 5 output. Apart
+  from the inclusion of 'audio' and 'video' block macros the 'html5'
+  backend is functionally identical to the 'xhtml11' backend.
+
+- A new 'flask' theme for 'xhtml11' and 'html5' backends inspired by
+  the http://flask.pocoo.org/docs/[Flask website] styling (see 'toc2'
+  example in the next item below).
+
+- The new 'toc2' attribute generates a table of contents in
+  the left hand margin ('xhtml11' and 'html5' backends).
+  link:article-html5-toc2.html[This example] was generated using
+  the following command:
+
+  asciidoc -b html5 -a icons -a toc2 -a theme=flask article.txt
+
+- `a2x(1)` now has a flexible mechanism for copying arbitrary
+  resource files to HTML based outputs -- this is very handy for
+  generating EPUB files with embedded fonts and other resources.
+
+  * The `a2x(1)` `--resource` option can be used to inject any file
+    into EPUB output documents e.g. CSS resources such as fonts and
+    background images.
+  * Explicitly specified resources are added to the EPUB OPF manifest
+    automatically.
+  * You can explicitly specify file extension MIME types.
+  * The enhanced resource processing works around a couple of DocBook
+    XSL bugs (see link:epub-notes.html[EPUB Notes]).
+
+.All additions and changes
 - A new 'flask' theme for 'xhtml11' and 'html5' backends.  A shameless
   knock-off of the http://flask.pocoo.org/docs/[Flask website]
   styling.

data/asciidoc/INSTALL

@@ -1,6 +1,6 @@
                              AsciiDoc Installation
 
-   version 8.6.5, 20 May 2011
+   version 8.6.7, 17 March 2012
 
    Note
        The current version of AsciiDoc requires Python 2.4 or newer to run. If
@@ -24,9 +24,9 @@
      * Make sure you have [6]Mercurial installed, you can check with:
   $ hg --version
      * Go to the directory you want to install AsciiDoc into and download
-       the repository. This example gets the 8.6.5 tagged release:
+       the repository. This example gets the 8.6.7 tagged release:
   $ cd ~/bin
-  $ hg clone -r 8.6.5 https://asciidoc.googlecode.com/hg/ asciidoc-8.6.5
+  $ hg clone -r 8.6.7 https://asciidoc.googlecode.com/hg/ asciidoc-8.6.7
 
    You now have two choices: you can run asciidoc locally from your
    repository or you can use autoconf(1) and make(1) to perform a
@@ -36,8 +36,8 @@
 
    Create a symlink to the AsciiDoc script in a search PATH directory so
    it’s easy to execute asciidoc from the command-line, for example:
-  $ ln -s ~/bin/asciidoc-8.6.5/asciidoc.py ~/bin/asciidoc
-  $ ln -s ~/bin/asciidoc-8.6.5/a2x.py ~/bin/a2x
+  $ ln -s ~/bin/asciidoc-8.6.7/asciidoc.py ~/bin/asciidoc
+  $ ln -s ~/bin/asciidoc-8.6.7/a2x.py ~/bin/a2x
 
    Use the Mercurial pull command to update your local AsciiDoc
    repository.
@@ -74,8 +74,8 @@
 
    The autoconf(1) generated configure script creates a make file that is
    tailored for your system. To install:
-  $ tar -xzf asciidoc-8.6.5.tar.gz
-  $ cd asciidoc-8.6.5
+  $ tar -xzf asciidoc-8.6.7.tar.gz
+  $ cd asciidoc-8.6.7
   $ ./configure
   $ sudo make install
 
@@ -96,9 +96,9 @@
    AsciiDoc is developed and tested on Linux but there seem to be quite a
    few people using it on Windows. To install AsciiDoc on Windows unzip
    the distribution Zip file contents:
-  $ unzip asciidoc-8.6.5.zip
+  $ unzip asciidoc-8.6.7.zip
 
-   This will create the folder asciidoc-8.6.5 containing the asciidoc.py
+   This will create the folder asciidoc-8.6.7 containing the asciidoc.py
    and a2x.py executables along with configuration files and
    documentation.
 
@@ -202,23 +202,23 @@
    See also [26]Packager Notes in the AsciiDoc User Guide.
      __________________________________________________________________
 
-   Version 8.6.5
+   Version 8.6.7
    Last updated 2010-11-15 08:44:54 NZDT
 
 References
 
    1. http://www.python.org/
-   2. file://localhost/tmp/lynxXXXXrHyhys/README.html
+   2. file://localhost/tmp/lynxXXXXJGiksz/README.html
    3. http://www.selenic.com/mercurial/
    4. http://code.google.com/
    5. http://code.google.com/p/asciidoc/source/browse/
    6. http://www.selenic.com/mercurial/
    7. http://sourceforge.net/projects/asciidoc/
-   8. file://localhost/tmp/lynxXXXXrHyhys/L3934-4626TMP.html#X3
+   8. file://localhost/tmp/lynxXXXXJGiksz/L9199-2434TMP.html#X3
    9. http://blog.rainwebs.net/2010/02/25/how-to-create-handsome-pdf-documents-without-frustration/
   10. http://www.cygwin.com/
   11. http://dblatex.sourceforge.net/
-  12. file://localhost/tmp/lynxXXXXrHyhys/testasciidoc.html
+  12. file://localhost/tmp/lynxXXXXJGiksz/testasciidoc.html
   13. http://www.a-a-p.org/
   14. http://packages.debian.org/asciidoc
   15. mailto:stone@debian.org
@@ -232,4 +232,4 @@ References
   23. http://svn.exactcode.de/t2/trunk/package/textproc/asciidoc/
   24. http://dag.wieers.com/rpm/packages/asciidoc/
   25. http://opencsw.org/packages/asciidoc
-  26. file://localhost/tmp/lynxXXXXrHyhys/userguide.html#X38
+  26. file://localhost/tmp/lynxXXXXJGiksz/userguide.html#X38

data/asciidoc/MANIFEST

@@ -84,5 +84,7 @@ tests/testasciidoc.conf
 tests/asciidocapi.py
 tests/data/*.conf
 tests/data/*.txt
+themes/flask/*.css
+themes/volnitsky/*.css
 vim/syntax/asciidoc.vim
 vim/ftdetect/asciidoc_filetype.vim

data/asciidoc/Makefile.in

@@ -60,6 +60,14 @@ latexfilterdir = $(filtersdir)/latex
 latexfilterconf = filters/latex/latex-filter.conf
 latexfilterconfdir = $(filtersdir)/latex
 
+themesdir = $(ASCIIDOCCONF)/themes
+
+flasktheme = themes/flask/flask.css
+flaskthemedir = $(themesdir)/flask
+
+volnitskytheme = themes/volnitsky/volnitsky.css
+volnitskythemedir = $(themesdir)/volnitsky
+
 docbook = $(wildcard docbook-xsl/*.xsl)
 docbookdir = $(ASCIIDOCCONF)/docbook-xsl
 
@@ -80,7 +88,7 @@ iconsdir = $(ASCIIDOCCONF)/images/icons
 
 doc = $(wildcard README*) $(wildcard BUGS*) $(wildcard INSTALL*) $(wildcard CHANGELOG*)
 
-DATATARGETS = manp conf docbook dblatex css js callouts icons codefilterconf musicfilterconf sourcefilterconf graphvizfilterconf latexfilterconf
+DATATARGETS = manp conf docbook dblatex css js callouts icons codefilterconf musicfilterconf sourcefilterconf graphvizfilterconf latexfilterconf flasktheme volnitskytheme
 PROGTARGETS = prog codefilter musicfilter graphvizfilter latexfilter
 TARGETS = $(DATATARGETS) $(PROGTARGETS) doc
 

data/asciidoc/README

@@ -1,6 +1,6 @@
                               AsciiDoc README File
 
-   version 8.6.5, 20 May 2011
+   version 8.6.7, 17 March 2012
      __________________________________________________________________
 
 1. Prerequisites
@@ -36,7 +36,7 @@
    (GPLv2).
      __________________________________________________________________
 
-   Version 8.6.5
+   Version 8.6.7
    Last updated 2011-05-04 18:47:58 NZST
 
 References

data/asciidoc/a2x.py

@@ -23,7 +23,7 @@ import xml.dom.minidom
 import mimetypes
 
 PROG = os.path.basename(os.path.splitext(__file__)[0])
-VERSION = '8.6.5'
+VERSION = '8.6.7'
 
 # AsciiDoc global configuration file directory.
 # NOTE: CONF_DIR is "fixed up" by Makefile -- don't rename or change syntax.
@@ -53,6 +53,7 @@ ASCIIDOC_OPTS = ''
 DBLATEX_OPTS = ''
 FOP_OPTS = ''
 XSLTPROC_OPTS = ''
+BACKEND_OPTS = ''
 
 ######################################################################
 # End of configuration file parameters.
@@ -143,6 +144,20 @@ def find_executable(file_name):
         result = _find_executable(file_name)
     return result
 
+def write_file(filename, data, mode='w'):
+    f = open(filename, mode)
+    try:
+        f.write(data)
+    finally:
+        f.close()
+
+def read_file(filename, mode='r'):
+    f = open(filename, mode)
+    try:
+        return f.read()
+    finally:
+        f.close()
+
 def shell_cd(path):
     verbose('chdir %s' % path)
     if not OPTIONS.dry_run:
@@ -176,7 +191,8 @@ def shell_rmtree(path):
 
 def shell(cmd, raise_error=True):
     '''
-    Execute command cmd in shell and return resulting subprocess.Popen object.
+    Execute command cmd in shell and return tuple
+    (stdoutdata, stderrdata, returncode).
     If raise_error is True then a non-zero return terminates the application.
     '''
     if os.name == 'nt':
@@ -190,25 +206,26 @@ def shell(cmd, raise_error=True):
             mo = re.match(r'^\s*(?P<arg0>[^ ]+)', cmd)
         if mo.group('arg0').endswith('.py'):
             cmd = 'python ' + cmd
-    # Remove redundant quoting -- this is not just costmetic, quoting seems to
-    # dramatically decrease the allowed command length in Windows XP.
-    cmd = re.sub(r'"([^ ]+?)"', r'\1', cmd)
+        # Remove redundant quoting -- this is not just cosmetic,
+        # quoting seems to dramatically decrease the allowed command
+        # length in Windows XP.
+        cmd = re.sub(r'"([^ ]+?)"', r'\1', cmd)
     verbose('executing: %s' % cmd)
     if OPTIONS.dry_run:
         return
-    if OPTIONS.verbose:
-        stdout = stderr = None
-    else:
-        stdout = stderr = subprocess.PIPE
+    stdout = stderr = subprocess.PIPE
     try:
         popen = subprocess.Popen(cmd, stdout=stdout, stderr=stderr,
                 shell=True, env=ENV)
     except OSError, e:
         die('failed: %s: %s' % (cmd, e))
-    popen.wait()
+    stdoutdata, stderrdata = popen.communicate()
+    if OPTIONS.verbose:
+        print stdoutdata
+        print stderrdata
     if popen.returncode != 0 and raise_error:
         die('%s returned non-zero exit status %d' % (cmd, popen.returncode))
-    return popen
+    return (stdoutdata, stderrdata, popen.returncode)
 
 def find_resources(files, tagname, attrname, filter=None):
     '''
@@ -234,19 +251,20 @@ def find_resources(files, tagname, attrname, filter=None):
     if isinstance(files, str):
         files = [files]
     result = []
-    for f in files:
-        verbose('finding resources in: %s' % f)
+    for filename in files:
+        verbose('finding resources in: %s' % filename)
         if OPTIONS.dry_run:
             continue
         parser = FindResources()
         # HTMLParser has problems with non-ASCII strings.
         # See http://bugs.python.org/issue3932
-        mo = re.search(r'^<\?xml.* encoding="(.*?)"', open(f).readline())
+        contents = read_file(filename)
+        mo = re.search(r'\A<\?xml.* encoding="(.*?)"', contents)
         if mo:
             encoding = mo.group(1)
-            parser.feed(open(f).read().decode(encoding))
+            parser.feed(contents.decode(encoding))
         else:
-            parser.feed(open(f).read())
+            parser.feed(contents)
         parser.close()
     result = list(set(result))   # Drop duplicate values.
     result.sort()
@@ -257,12 +275,12 @@ def copy_files(files, src_dir, dst_dir):
     '''
     Copy list of relative file names from src_dir to dst_dir.
     '''
-    for f in files:
-        f = os.path.normpath(f)
-        if os.path.isabs(f):
+    for filename in files:
+        filename = os.path.normpath(filename)
+        if os.path.isabs(filename):
             continue
-        src = os.path.join(src_dir, f)
-        dst = os.path.join(dst_dir, f)
+        src = os.path.join(src_dir, filename)
+        dst = os.path.join(dst_dir, filename)
         if not os.path.exists(dst):
             if not os.path.isfile(src):
                 warning('missing file: %s' % src)
@@ -321,10 +339,14 @@ def get_source_options(asciidoc_file):
     result = []
     if os.path.isfile(asciidoc_file):
         options = ''
-        for line in open(asciidoc_file):
-            mo = re.search(r'^//\s*a2x:', line)
-            if mo:
-                options += ' ' + line[mo.end():].strip()
+        f = open(asciidoc_file)
+        try:
+            for line in f:
+                mo = re.search(r'^//\s*a2x:', line)
+                if mo:
+                    options += ' ' + line[mo.end():].strip()
+        finally:
+            f.close()
         parse_options()
     return result
 
@@ -348,8 +370,12 @@ class A2X(AttrDict):
         self.dblatex_opts  += ' ' + DBLATEX_OPTS
         self.fop_opts      += ' ' + FOP_OPTS
         self.xsltproc_opts += ' ' + XSLTPROC_OPTS
+        self.backend_opts  += ' ' + BACKEND_OPTS
         # Execute to_* functions.
-        self.__getattribute__('to_'+self.format)()
+        if self.backend:
+            self.to_backend()
+        else:
+            self.__getattribute__('to_'+self.format)()
         if not (self.keep_artifacts or self.format == 'docbook' or self.skip_asciidoc):
             shell_rm(self.dst_path('.xml'))
 
@@ -378,6 +404,23 @@ class A2X(AttrDict):
         home_dir = os.environ.get('HOME')
         if home_dir is not None:
             conf_files.append(os.path.join(home_dir, '.asciidoc', CONF_FILE))
+        # If asciidoc is not local to a2x then search the PATH.
+        if not self.asciidoc:
+            self.asciidoc = find_executable(ASCIIDOC)
+            if not self.asciidoc:
+                die('unable to find asciidoc: %s' % ASCIIDOC)
+        # From backend plugin directory.
+        if self.backend is not None:
+            stdout = shell(self.asciidoc + ' --backend list')[0]
+            backends = [(i, os.path.split(i)[1]) for i in stdout.splitlines()]
+            backend_dir = [i[0] for i in backends if i[1] == self.backend]
+            if len(backend_dir) == 0:
+                die('missing %s backend' % self.backend)
+            if len(backend_dir) > 1:
+                die('more than one %s backend' % self.backend)
+            verbose('found %s backend directory: %s' %
+                    (self.backend, backend_dir[0]))
+            conf_files.append(os.path.join(backend_dir[0], 'a2x-backend.py'))
         # From --conf-file option.
         if self.conf_file is not None:
             if not os.path.isfile(self.conf_file):
@@ -391,13 +434,8 @@ class A2X(AttrDict):
         # Load ordered files.
         for f in conf_files:
             if os.path.isfile(f):
-                verbose('loading conf file: %s' % f)
+                verbose('loading configuration file: %s' % f)
                 execfile(f, globals())
-        # If asciidoc is not local to a2x then search the PATH.
-        if not self.asciidoc:
-            self.asciidoc = find_executable(ASCIIDOC)
-            if not self.asciidoc:
-                die('unable to find asciidoc: %s' % ASCIIDOC)
 
     def process_options(self):
         '''
@@ -417,12 +455,16 @@ class A2X(AttrDict):
         if self.resource_manifest:
             if not os.path.isfile(self.resource_manifest):
                 die('missing --resource-manifest: %s' % self.resource_manifest)
-            for r in open(self.resource_manifest):
-                self.resources.append(r.strip())
+            f = open(self.resource_manifest)
+            try:
+                for r in f:
+                    self.resources.append(r.strip())
+            finally:
+                f.close()
         for r in self.resources:
             r = os.path.expanduser(r)
             r = os.path.expandvars(r)
-            if r.endswith(('/','\\')):
+            if r.endswith('/') or r.endswith('\\'):
                 if  os.path.isdir(r):
                     self.resource_dirs.append(r)
                 else:
@@ -580,6 +622,15 @@ class A2X(AttrDict):
                 shell_makedirs(dstdir)
                 shell_copy(src, dst)
 
+    def to_backend(self):
+        '''
+        Convert AsciiDoc source file to a backend output file using the global
+        'to_<backend name>' function (loaded from backend plugin a2x-backend.py
+        file).
+        Executes the global function in an A2X class instance context.
+        '''
+        eval('to_%s(self)' % self.backend)
+
     def to_docbook(self):
         '''
         Use asciidoc to convert asciidoc_file to DocBook.
@@ -590,8 +641,8 @@ class A2X(AttrDict):
             if not os.path.isfile(docbook_file):
                 die('missing docbook file: %s' % docbook_file)
             return
-        shell('"%s" --backend docbook %s --out-file "%s" "%s"' %
-             (self.asciidoc, self.asciidoc_opts, docbook_file, self.asciidoc_file))
+        shell('"%s" --backend docbook -a "a2x-format=%s" %s --out-file "%s" "%s"' %
+             (self.asciidoc, self.format, self.asciidoc_opts, docbook_file, self.asciidoc_file))
         if not self.no_xmllint and XMLLINT:
             shell('"%s" --nonet --noout --valid "%s"' % (XMLLINT, docbook_file))
 
@@ -683,7 +734,7 @@ class A2X(AttrDict):
                     f = os.path.normpath(f)
                     if f not in ['content.opf']:
                         resource_files.append(f)
-        opf = xml.dom.minidom.parseString(open(opf_file).read())
+        opf = xml.dom.minidom.parseString(read_file(opf_file))
         manifest_files = []
         manifest = opf.getElementsByTagName('manifest')[0]
         for el in manifest.getElementsByTagName('item'):
@@ -704,7 +755,7 @@ class A2X(AttrDict):
                 item.setAttribute('media-type', mimetype)
                 manifest.appendChild(item)
         if count > 0:
-            open(opf_file, 'w').write(opf.toxml())
+            write_file(opf_file, opf.toxml())
 
     def to_epub(self):
         self.to_docbook()
@@ -736,7 +787,7 @@ class A2X(AttrDict):
                 try:
                     # Create and add uncompressed mimetype file.
                     verbose('archiving: mimetype')
-                    open('mimetype','w').write('application/epub+zip')
+                    write_file('mimetype', 'application/epub+zip')
                     zip.write('mimetype', compress_type=zipfile.ZIP_STORED)
                     # Compress all remaining files.
                     for (p,dirs,files) in os.walk('.'):
@@ -762,9 +813,9 @@ class A2X(AttrDict):
         text_file = self.dst_path('.text')
         html_file = self.dst_path('.text.html')
         if self.lynx:
-            shell('"%s" %s --conf-file "%s" -b html4 -o "%s" "%s"' %
+            shell('"%s" %s --conf-file "%s" -b html4 -a "a2x-format=%s" -o "%s" "%s"' %
                  (self.asciidoc, self.asciidoc_opts, self.asciidoc_conf_file('text.conf'),
-                  html_file, self.asciidoc_file))
+                  self.format, html_file, self.asciidoc_file))
             shell('"%s" -dump "%s" > "%s"' %
                  (LYNX, html_file, text_file))
         else:
@@ -810,6 +861,9 @@ if __name__ == '__main__':
         action='store', dest='doctype', metavar='DOCTYPE',
         choices=('article','manpage','book'),
         help='article, manpage, book')
+    parser.add_option('-b','--backend',
+        action='store', dest='backend', metavar='BACKEND',
+        help='name of backend plugin')
     parser.add_option('--epubcheck',
         action='store_true', dest='epubcheck', default=False,
         help='check EPUB output with epubcheck')
@@ -864,6 +918,9 @@ if __name__ == '__main__':
     parser.add_option('--dblatex-opts',
         action='append', dest='dblatex_opts', default=[],
         metavar='DBLATEX_OPTS', help='dblatex options')
+    parser.add_option('--backend-opts',
+        action='append', dest='backend_opts', default=[],
+        metavar='BACKEND_OPTS', help='backend plugin options')
     parser.add_option('--fop',
         action='store_true', dest='fop', default=False,
         help='use FOP to generate PDF files')
@@ -882,7 +939,7 @@ if __name__ == '__main__':
     if len(sys.argv) == 1:
         parser.parse_args(['--help'])
     source_options = get_source_options(sys.argv[-1])
-    argv = source_options + sys.argv[1:] 
+    argv = source_options + sys.argv[1:]
     opts, args = parser.parse_args(argv)
     if len(args) != 1:
         parser.error('incorrect number of arguments')
@@ -890,6 +947,7 @@ if __name__ == '__main__':
     opts.dblatex_opts = ' '.join(opts.dblatex_opts)
     opts.fop_opts = ' '.join(opts.fop_opts)
     opts.xsltproc_opts = ' '.join(opts.xsltproc_opts)
+    opts.backend_opts = ' '.join(opts.backend_opts)
     opts = eval(str(opts))  # Convert optparse.Values to dict.
     a2x = A2X(opts)
     OPTIONS = a2x           # verbose and dry_run used by utility functions.