version 8.6.2, 3 October 2010 __________________________________________________________________ 1. Version 8.6.2 (2010-10-03) Additions and changes * docbook45: Enclosed bibliographic lists in a bibliodiv — you can now include block titles with bibliographic lists. * Added optional keywords, description and title document header meta-data attributes to HTML backends for SEO. * AttributeEntry values can span multiple lines with a ' +' line continuation. * Added slidy backend (based on Philip Lord’s slidy backend [1]https://phillordbio-asciidoc-fixes.googlecode.com/hg/). * Implemented OpenBlock partintro style for book part introductions. * Comment lines substitute special characters only. * Backend specific global configuration files (all except asciidoc.conf) are loaded after the header has been parsed — virtually any attribute can now be specified in the document header. * xhtml11: Volnitsky theme: allow bulleted lists to have intervening children. * xhtml11: refactored CSS font-family rules to start of file. * xhtml11: list bullets colored gray. * ifdef and ifndef system block macros accept multiple attribute names: multiple names separated by commas are ored; multiple attribute names separated by pluses are anded. * xhtml11: Volnitsky theme: set max-width on labeled lists. * Vim syntax highlighter: Entities inside quoted text are now highlighted. * Added role and id attributes to HTML outputs generated by OpenBlocks. * Allow floating titles to generate h1 (level 0) titles in HTML outputs. * Added a start attribute to numbered lists to set the start number. See: [2]http://groups.google.com/group/asciidoc/browse_thread/thread/c14 a4c3b1e4f6dc5 * Added two more docinfo attributes docinfo1 and docinfo2 to allow and control inclusion of a shared docinfo file. See [3]http://groups.google.com/group/asciidoc/browse_thread/thread/c94 8697943432e24 * Vim syntax highlighter highlights multi-name conditional attributes. * LaTeX backend patch submitted by Andreas Hermann Braml (see [4]http://groups.google.com/group/asciidoc/browse_thread/thread/1c4 15fc4540ce5e5). * Implemented backend aliases; renamed docbook.conf to docbook45.conf and aliased docbook45 backend to docbook; aliased xhtml11 to html. Bug fixes * FIXED: Filter commands located in filter directories local to the source document that where not in the search PATH where not found. * FIXED: Volnitsky theme: Verseblock font set normal instead of monospaced. * FIXED: xhtml11: Callout icons were not rendered as Data URIs when icons and data-uri attributes were specified. * FIXED: Long standing bug: nested include macros did not restore the parent document infile and indir attributes. See: [5]http://groups.google.com/group/asciidoc/browse_thread/thread/871 2a95e95a292a7 * FIXED: html4: set preamble ID anchor. * FIXED: xhtml11: dropped unusable id and role attributes from preamble template. * FIXED: Bug in multi-name conditional attributes e.g. {x,y#} fails if x or y is undefined. * FIXED: latex filter not being installed by Makefile. Thanks to Grant Edwards for this patch. See [6]http://groups.google.com/group/asciidoc/browse_thread/thread/c44 27a3902d130a8 * FIXED: a2x: Long-standing bug in a2x which always passes --string-param navig.graphics 0 to xsltproc, regardless of whether icons are enabled or not. Reported by Michael Wild: [7]http://groups.google.com/group/asciidoc/browse_thread/thread/59a 610068e4acb58 __________________________________________________________________ 2. Version 8.6.1 (2010-08-22) Additions and changes * a2x: --resource-dir option renamed to --resource. * a2x: --resource option accepts both file and directory names. * a2x: Added -m,--resource-manifest option. * Added Vim syntax highlighting for quote attribute lists. * Load asciidoc.conf from all configuration directories before any other configuration files. This ensures that attributes used for conditional inclusion are set before backend configuration files are processed. Previously if you wanted to control global conf file inclusion your only choice was to modify the global asciidoc.conf file. * AsciiDoc Quote element attributes have been simplified and generalized — positional color and size attributes and named role attribute have been replaced by a single positional attribute. Bug fixes * FIXED: testasciidoc.py: BACKEND command argument was being ignored. * FIXED: Broken docinfo file functionality in html4 and xhtml11 backends (previously the docinfo file was included in the body instead of the header). 2.1. Regression issues This release breaks compatibility with quoted element positional color and size attributes (HTML backends). To revert to the deprecated quote behavior define the deprecated-quotes attribute in the global asciidoc.conf file or on the command-line. For a more detailed explanation of the rationale behind this change see [8]http://groups.google.com/group/asciidoc/browse_thread/thread/b22603b fb879418c. __________________________________________________________________ 3. Version 8.6.0 (2010-08-16) Additions and changes * The AsciiDoc distribution can now be built “out of the box” from the distribution tarball or the Mercurial repository (provided you have the requisite build applications installed). * The global configuration files directory is ignored by both asciidoc and a2x if AsciiDoc configuration files are installed in the same directory as the asciidoc executable. This change allows both a system wide copy and multiple local copies of AsciiDoc to coexist on the same host PC. * CSS quirks mode is no longer the default xhtml11 output ([9]http://groups.google.com/group/asciidoc/browse_thread/thread/1c 02d27d49221aa2). * Relaxed anchor ID name syntax ([10]http://groups.google.com/group/asciidoc/browse_thread/thread/5 f3e825c74ed30c). * Added document files: doc/epub-notes.txt, doc/publishing-ebooks-with-asciidoc.txt. * a2x: If all other resource locations are exhausted then recursively search directories named images and stylesheets in the asciidoc configuration files directory. * a2x: options can also be set in the AsciiDoc source file. If the source file contains a line beginning with // a2x: then the remainder of the line will be treated as a2x command-line options. * Added dblatex table-width processing instruction — tables generated by dblatex now observe the AsciiDoc table width as a percentage (thanks to Gustav Broberg for suggesting this enhancement). * a2x: Don’t exit if the --epubcheck option is set and epubcheck is missing, issue warning and continue. * Added a global plaintext attribute for dealing with large amounts of imported text. * The author name format has been relaxed, if the the author does not match the formal specification then it is assigned to the firstname attribute (previously asciidoc exited with an error message). * FAQ and documentation updates. * Refactored chunked.xsl and epub.xsl files. * Exchanged article.epub for more relevant book.epub on website. * Put asciidoc.epub User Guide on website. * a2x: Chunking EPUB and HTML outputs set to a per chapter basis and the first chapter is separate from preceding contents. * Changed dates format in example article and books to suppress EPUB validation error. * Added style and role CSS classes to xhtml11 section templates. * Added the role element to xhtml11 backend block templates. * Suppressed md5 module deprecation warning from music and Graphviz filters. * Pygments ([11]http://pygments.org/) option added to source code highlight filter. Based on Pygments source code filter written by David Hajage ([12]http://groups.google.com/group/asciidoc/browse_thread/thread/d 8d042f5a3021369/8934ebbb8cb7144b). * xhtml11: Added a new theme (volnitsky). Written and contributed by Leonid V. Volnitsky. * xhtml11: Set body element class name to document type. * Added refentryinfo element and contents (including revdate) to man page DocBook output. Man pages are now dated using the revdate attribute value if it has been defined. Based on patch supplied by Rainer Muller [13]http://groups.google.com/group/asciidoc/browse_frm/thread/319e5 cd94493e330/3fcb83fab067af42. * Added {template:...} system attribute. * Table of contents attribute toc can now be specified in the document header. * Reimplemented music and latex filter -m option functionality when the input is stdin using MD5 checksums. * Added latex filter. * Added auto file name generation to image generating filters (latex,music, graphviz). * Added counter2 and set2 system attributes (to implement image auto file name generation). * Undefined attribute in filter command generates error but does not exit. * Attribute substitution proceeds from start line to end line (previously was in reverse order which was really confusing). * Tidied up music filter code: + Format option is optional and default to abc unless Lilypond notation detected. + The -m option does not apply to stdin input. * Added paragraph styles to music and graphviz filters. * Documented dynamic template names. 753: Graphviz filter can now generate SVG format images. Patch submitted by Elmo Todurov, see: [14]http://groups.google.com/group/asciidoc/browse_frm/thread/fe9b3 3d8f5f1e0af The xhtml11 SVG Graphviz template marked EXPERIMENTAL. No SVG support for other backends. * AsciiDoc template names can now contain embedded attribute references. * Added legalnotice tag to doc/article-docinfo.xml example. * xhtml11 backend: Callouts and callout lists display callout icons when the icons attribute is defined. See [15]http://groups.google.com/group/asciidoc/browse_frm/thread/8eda3 ea812968854 * Document attribute names are case insensitive everywhere, this makes using attribute entries more consistent e.g. previously :VERS: had to be refered to * Hungarian translation of footer-text (submitted by Miklos Vajna). See [16]http://groups.google.com/group/asciidoc/browse_frm/thread/7174c b7598993c72# * asciidocapi.py 0.1.2: Can now load AsciiDoc script named asciidoc. See [17]http://groups.google.com/group/asciidoc/browse_frm/thread/66e7b 59d12cd2f91 Based on patch submitted by Phillip Lord. * German translation of footer-text (submitted by Simon Ruderich). See [18]http://groups.google.com/group/asciidoc/browse_frm/thread/7174c b7598993c72 * Pushed HTML footer text into language conf files with the introduction of a [footer-text] configuration file template section. See [19]http://groups.google.com/group/asciidoc/browse_frm/thread/7174c b7598993c72 Bug fixes * FIXED: Sometimes multiple double quoted text elements in the same paragraph were mistakenly seen as starting with an inline literal. See [20]http://groups.google.com/group/asciidoc/browse_frm/thread/219c8 6ae25b79a21 * FIXED: localtime and doctime attributes calculated incorrect daylight saving / non daylight saving timezones and consequently so did HTML footers. Patch submitted by Slawomir Testowy. See [21]http://groups.google.com/group/asciidoc/browse_frm/thread/af652 507caf6cec9 * FIXED: Missing selector for List of examples title in DocBook CSS file. Patch submitted by Laurent Laville. See [22]http://groups.google.com/group/asciidoc/browse_frm/thread/3f969 00f7fbf5620 * FIXED: Broken accents in lang-hu.conf. See: [23]http://groups.google.com/group/asciidoc/browse_frm/thread/7174c b7598993c72 * FIXED: DocBook XSL generated HTML callout lists are properly aligned. Submitted by Lionel Orry. See [24]http://groups.google.com/group/asciidoc/browse_frm/thread/2ff80 2547b6a75ea * FIXED: Filter execution now occurs prior to filter markup template substitution to ensure image data URI encoding happens after image generation (see [25]http://groups.google.com/group/asciidoc/browse_thread/thread/14 e8fcb289a135b). * FIXED: The section numbers no longer increment when the numbered attribute is undefined (see [26]http://groups.google.com/group/asciidoc/browse_thread/thread/fa a36e9e5c7da019/d24cab3fe363e58d). __________________________________________________________________