1. Version 8.5.2 (2009-12-09)
Additions and changes
* Added Italian language configuration file (contributed by Fabio
Inguaggiato).
* Added header table style. See:
[1]http://groups.google.com/group/asciidoc/browse_frm/thread/a23fea
28394c8ca9
* Pass icons, data-uri, imagesdir, iconsdir attributes to asciidoc
table style filter so that images are rendered in table cells.
* Pass trace and verbose attributes to asciidoc table style filter so
diagnostic information is printed from table cell source.
* The eval system attribute can be nested inside other system
attributes.
* HTML outputs: Table and figure caption punctuation set to more
usual syntax.
* docbook backend: footnotes can now contain embedded images. See
[2]http://groups.google.com/group/asciidoc/browse_frm/thread/50b28f
6941de111a
* CSS tweaks so that tables processed by DocBook XSL Stylesheets have
the default asciidoc xhtml11 backend styling. See
[3]http://groups.google.com/group/asciidoc/browse_frm/thread/dfe520
4d5b2c9685
* Block titles take precedence over section titles to avoid titled
delimited blocks being mistaken for two line section titles (see
[4]http://groups.google.com/group/asciidoc/browse_frm/thread/f0b6f9
989f828c3).
* Section title trace displays level and title text.
* FAQ additions.
* Added {zwsp} (zero width space) attribute.
* Undefined paragraph styles are reported (previously threw a runtime
error).
* Eliminated empty preamble generation.
* Floating titles now processed in all contexts.
* Implemented auto-lettered appendix names and updated example
documents.
* Section numbering can be disabled in HTML outputs with a
:numbered!: AttributeEntry.
* xhtml11: Nicer default quote block styling.
* Exclude floating titles from xhtml11 table of contents. Patch
submitted by Mark Burton (see
[5]http://groups.google.com/group/asciidoc/browse_frm/thread/14aefc
1cb6bd85f5).
* Enhanced doc/article-docinfo.xml example docinfo file.
* Vim syntax highlighter improvements.
Bug fixes
* FIXED: Absolute imagesdir and iconsdir attribute path names do not
work with the xhtml11 data-uri encoding. See
[6]http://groups.google.com/group/asciidoc/browse_frm/thread/cb8b76
94bbc82a6
* FIXED: Regression issue with inline data-uri images. See
[7]http://groups.google.com/group/asciidoc/browse_frm/thread/cb8b76
94bbc82a6
* FIXED: An unexpected error occurred when processing a table
containing CSV data if the cols attribute was not explicitly
specified. See
[8]http://groups.google.com/group/asciidoc/browse_frm/thread/4b0f36
4b477ec165
__________________________________________________________________
2. Version 8.5.1 (2009-10-31)
Additions and changes
* If an AsciiDoc document file begins with a UTF-8 BOM (byte order
mark) then it is passed transparently through to the output file.
The BOM is stripped from included files. See
[9]http://groups.google.com/group/asciidoc/browse_frm/thread/e5e618
23ff4203cd
* Added AsciiDoc role attribute to quoted text. Sets class attribute
in HTML outputs; role attribute in DocBook outputs. See:
[10]http://groups.google.com/group/asciidoc/browse_frm/thread/2aa3e
5711d243045
* Conditional attribute syntax extended: they now accept multiple
ORed or ANDed attribute names.
* The xhtml11 backend dynamically processes footnotes using
JavaScript.
* Tidied up and namespaced xhtml11 JavaScript.
* Superceded javascripts/toc.js with javascripts/asciidoc-xhtml11.js.
* Added disable-javascript attribute (xhtml11 backend).
* Styled HTML footnotes.
* Added links to HTML footnote refs.
* Added title attribute to inline image macros to display popup
"tooltip" (HTML outputs only).
* Single-quoted attribute values are substituted in block macros
(just like the AttributeList element).
* For consistency changed underscores to dashes in attribute names.
Public attributes with underscores retained for compatibility.
* Added Brazilian Portuguese language configuration file (contributed
by Thiago Farina).
* Added leveloffset attribute to make it easier to combine documents.
Bug fixes
* FIXED: a2x: --dblatex-opts is now processed last so
asciidoc-dblatex.xsl params can be overridden. Patch submitted by
Mark Fernandes (see
[11]http://groups.google.com/group/asciidoc/browse_frm/thread/5215c
99dcc865e7d).
* FIXED: An error occurred if a directory in current path with same
name as executable.
2.1. Regression issues
There's been quite a bit of tiding up to the xhtml11 JavaScript. The
most obvious change is that the toc.js script has been superceded by
asciidoc-xhtml11.js so if you're linking you'll need get a copy of the
new file from the distribution javascripts directory.
If you use customised xhtml11 configuration file [header] and [footer]
sections and you want them to use the new footnotes feature then you've
got a bit more work to do:
1. The onload event expression changed.
2. The new
...
div envelopes document content.
3. You need to add div to the
[footnotes] section for footnotes to work.
4. Drop the ifdef::toc[] macro that surround JavaScript inclusion.
Take a look at the [header] and [footer] changes in the xhtml11.conf
diff to see what's going on:
[12]http://hg.sharesource.org/asciidoc/diff/55a5999bfd04/xhtml11.conf
__________________________________________________________________
3. Version 8.5.0 (2009-10-04)
Additions and changes
* Implemented a float attribute for tables and block images (HTML
outputs only).
* Added unfloat::[] block macro to cancel floating.
* Added table align attribute to (HTML outputs only).
* The image align attribute now works with HTML backends.
* Renamed table cell align attribute to halign so it doesn't clash
with the new table align attribute.
* Added breakable and unbreakable options to AsciiDoc example and
block image elements.
* [miscellaneous] section entries now update properly when set from a
document AttributeEntry.
* [miscellaneous] section pagewidth entry accepts fractional values.
* Fractional column widths are now calculated correctly when using
fractional pageunits (DocBook tables).
* Use DocBook XSL table width processing instructions.
* asciidoc KeyboardInterrupt exits with error code 1.
* Added set system attribute to allow attributes to be set from
configuration file templates.
* Allow constrained quotes to be bounded on the left by a colons and
semicolons, see
[13]http://groups.google.com/group/asciidoc/browse_frm/thread/b276a
927fdc87995
* Titled listing and literal blocks (DocBook outputs) no longer
default to examples. See
[14]http://groups.google.com/group/asciidoc/browse_frm/thread/f4df7
c9eec01a9bd
* Updated language file table, figure and example captions to
accommodate new auto-numbering in html4 and xhtml11 backends.
* Titled source highlight filter listings generated by docbook
backend are now rendered as examples. See
[15]http://groups.google.com/group/asciidoc/browse_frm/thread/f4df7
c9eec01a9bd
* Implemented counter system attribute.
* Use counter system attributes to number titled tables and block
images in HTML backends.
* Added program name suffix to console messages.
* Added substitution to the AttributeEntry passthrough syntax, this
replaces the now unnecessary attributeentry-subs attribute.
* Allow passthrough inline macro syntax to be used in
AttributeEntrys.
* Reinstated 8.4.4 default lang attribute behavior. See
[16]http://groups.google.com/group/asciidoc/browse_frm/thread/d2992
4043e21cb6a.
* Added max-width attribute to the xhtml11 backend to set maximum
display width. See
[17]http://groups.google.com/group/asciidoc/browse_frm/thread/74d9a
542b79ccd50.
* Added a2x.py, a rewritten and much enhanced version of the old a2x
bash script.
* The new a2x can output EPUB formatted documents.
* Added --safe option and deprecated --unsafe option. Patch submitted
by Todd Zullinger. See
[18]http://groups.google.com/group/asciidoc/browse_frm/thread/ea3a8
ea399ae5d2a and
[19]http://groups.google.com/group/asciidoc/browse_frm/thread/69b31
83fdab7c6a5
* Added CHECK and TEST todo highlight words to Vim syntax
highlighter.
* Line breaks, page breaks, and horizontal rulers are now processed
by dblatex, thanks to a patch submitted by Mark Fernandes
([20]http://groups.google.com/group/asciidoc/browse_frm/thread/a254
cf949ea7c6c5).
* Allow footnote macros hard up against the preceding word so the
rendered footnote mark can be placed against the noted text without
an intervening space (patch submitted by Stas Bushuev,
[21]http://groups.google.com/group/asciidoc/browse_frm/thread/e1dcb
7ee0efc17b5).
* Normalized path in safe_filename function (submitted by Todd
Zullinger,
[22]http://groups.google.com/group/asciidoc/browse_frm/thread/69b31
83fdab7c6a5).
* The Asciidoc numbered and toc attributes cause DocBook outputs to
include asciidoc-numbered and asciidoc-toc processing instructions,
these are used by DocBook XSL to include section numbering and
table of contents (like Asciidoc HTML backends). For backward
compatibility both numbered and toc attributes are defined by
default when the docbook backend is used. See
[23]http://groups.google.com/group/asciidoc/browse_frm/thread/1bada
d21ff9447ac.
* data-uri attribute is now evaluated dynamically and can be set in
document body (previously could only be set from command-line).
* Added sys3 and eval3 system attributes to passthrough generated
output, this fixes the data-uri inline image problem:
[24]http://groups.google.com/group/asciidoc/browse_frm/thread/a42db
6bc54c2c537.
* Missing language file generates a warning instead of an error.
* Updated Spanish language file (updates contributed by Gustavo
Andrés Gómez Farhat).
Bug fixes
* FIXED: Options in an AttributeList option attribute are merged with
(rather than replace) configuration file options.
* FIXED: Comment blocks and comment block macros no longer consume
preceding block titles and attribute lists.
* FIXED: examples/website/layout1.conf and
examples/website/layout2.conf TOC problem. Submitted by Mark
(burtoogle). See
[25]http://groups.google.com/group/asciidoc/browse_frm/thread/b9c63
be67dd1d11c
* FIXED: Only the first occurrence of passthrough macro was
substituted. Patch submitted by Peter Johnson. See
[26]http://groups.google.com/group/asciidoc/browse_frm/thread/1269d
c2feb1a482c
* FIXED: asciidoc now runs on Jython 2.5.0.
* FIXED: Wordpress margins and pads in a number of block elements
([27]http://groups.google.com/group/asciidoc/browse_frm/thread/36ff
073c79cbc20a).
3.1. Regression issues
* Tables generated by dblatex occupy 100% of the available space
regardless of the width attribute setting. To restore width
behavior change the pageunits miscellaneous parameter to pt. You
can do this from the command-line with the -a pageunits=pt option.
See [28]DocBook table widths.