Asciidoc

---------------------------
.Additions and changes
- Improve reproducibility of builds (e.g. support SOURCE_DATE_EPOCH)
- Add SVG output support
- Improve documentation
- Update translations
- Full list of changes is at https://github.com/asciidoc/asciidoc/compare/asciidoc:8.6.9...asciidoc:8.6.10

--------------------------
.Additions and changes
- 'html5', 'xhtml11' and 'slidy' outputs now wrap 'pre' element
contents at right margin (see
https://groups.google.com/group/asciidoc/browse_thread/thread/9877a316b7a47309).
- Vim syntax file: highlight line breaks in lists (patch submitted by
Alex Efros). See
https://groups.google.com/group/asciidoc/browse_thread/thread/5145e4c0b65cde0a).
- Vim syntax file: fixed highlighting of lines with spaces preceding
an indented paragraph. See
https://groups.google.com/group/asciidoc/browse_thread/thread/5145e4c0b65cde0a
- Vim syntax file: dropped ')' from list of illegal characters
following opening quote. See
https://groups.google.com/group/asciidoc/browse_thread/thread/1a60eb4507a0555f/264c39c6a89fc7a0
- Added {plus} intrinsic attribute. See
http://code.google.com/p/asciidoc/issues/detail?id=14
- Allow `tabsize=0 in` configuration file. See
https://groups.google.com/group/asciidoc/browse_thread/thread/c88457020288ce1d
- Removed 'wordpress' backend into the blogpost project (where it
belongs) as an AsciiDoc backend plugin.
- Added HTML5 footer badges.
- Added favicon to AsciiDoc website.
- Changed AsciiDoc website domain to 'asciidoc.org'.
- Vim syntax file: closing quote character cannot be immediately
followed by same closing quote character.
- Documentation updates.
- If admonition icons are embedded using the Data URI Scheme and the
icons directory is undefined or does not exist then the 'iconsdir'
attribute is set to the location of the icons installed in the
AsciiDoc configuration directory.
- Updated `./stylesheets/pygments.css` from pygments 1.4.
- HTML backends: Align inline images to text-bottom.
- html4 backend: Added 'hr' attribute to make the inter-section
horizontal ruler element optional.
- Documented 'Callout lists cannot be used within tables'. See:
https://groups.google.com/group/asciidoc/browse_thread/thread/268f9b46ebc192d3
- Removed Vim related stuff from the installer makefile. See:
https://groups.google.com/group/asciidoc/browse_thread/thread/753a52b2af85fcfc/04c9091b0856fc13
and
https://groups.google.com/group/asciidoc/browse_thread/thread/cd07629fa7a53fb3
- Dropped `vim/ftdetect/asciidoc_filetype.vim` from distribution, the
file detection was broken and the default settings satisfied no one.
- Vim syntax highlighter: increase sync backtracking to catch changes
to large block elements.
- Added Romanian language configuration file. Contributed by Vitalie
Lazu. See
https://groups.google.com/group/asciidoc/browse_thread/thread/2fe14a10dbf20d20/27726e7e13f7bfc7?lnk=gst&q=romanian#27726e7e13f7bfc7
- Added ruler and line-break outputs to HTML Help outputs. Patch
submitted by DonM. See
https://groups.google.com/group/asciidoc/browse_thread/thread/b131d0155eccd73e
- Added Czech language configuration file. Contributed by Petr Klíma.
- html4 backend: allow embedded images and icons (data-uri
attribute).
- html4 backend: table and example block caption place at bottom for
consistency.
- html4 backend: dropped border around example block.
- html4 backend: cellpaddings made equal to 4 for consistency.
- Vim syntax highligher: Highlight closing OpenBlock delimiter when it
immediately follows a list.
- Updated html5 backend (previous commit was xhtml11 only). See:
https://groups.google.com/group/asciidoc/browse_thread/thread/dbdfaf838f93e020
- Embedded data-uri images now figure file mimetype from file contents
rather than the file extension. Patch submitted by Lex Trotman. See:
https://groups.google.com/group/asciidoc/browse_thread/thread/dbdfaf838f93e020

.Bug fixes
- `indexterm2:[]` macro syntax now recognized. See
https://groups.google.com/group/asciidoc/browse_thread/thread/1b3f1a0f0a21425e
- Synthesised `*-option` attributes for options set in table conf file
style entries. See
https://groups.google.com/group/asciidoc/browse_thread/thread/8aa340a3069ef5f1/a727a8a564eea76c
- Makefile: Fixed sh compatibility issue. See
https://groups.google.com/group/asciidoc/browse_thread/thread/753a52b2af85fcfc/04c9091b0856fc13

--------------------------
.Release highlights
Added full complement of styles to 'Open Blocks' and 'Normal
Paragraphs' -- those with a minimalist bent could construct virtually
any document using just Title, Normal Paragraph and Open Block
syntaxes.

.Other additions and changes
- Increased default maximum include depth from 5 to 10.
- Emit warning if maximum include depth is exceeded.
- Suppress repeated console messages.
- Music filter: removed '--beams=None' option from abc2ly invocation
because it is broken on LilyPond 2.14 (Ubuntu 12.04).
- Replaced obsolete '<tt>' tag with '<code>' in HTML backends.
- Allow configuration attribute entries to create a new section
(previously you could only modify existing sections). See:
https://groups.google.com/group/asciidoc/browse_thread/thread/7be28e9714f249c7[discussion
list].
- Documented `{wj}` (word-joiner) attribute and updated FAQ. See:
https://groups.google.com/group/asciidoc/browse_thread/thread/961a957ab5872ebf[discussion
list].
- FAQ: Added 'How can I place a footnote immediately following quoted
text?' See
https://groups.google.com/group/asciidoc/browse_thread/thread/961a957ab5872ebf[discussion
list].
- Added Greek language configuration file. Contributed by Michael
Dourmousoglou. See
https://groups.google.com/group/asciidoc/browse_thread/thread/9e79d8494ef8d870[discussion
list].
- FAQ: Added 'Using roles to select fonts for PDF'. Submitted by Lex
Trotman and based on solution by Antonio Borneo. See:
https://groups.google.com/group/asciidoc/browse_frm/thread/64b071bb21de9cf0[discussion
list].
- Apply same monospaced font size to all monospaced text.
- Changed '0' number padding to spaces in numbered GNU
source-highlight outputs.
- Allow 'highlight' source highlighter to use 'python' for Python
`{language}` name. r1142: Update the AsciiDoc 'source' filter to
allow the use of the 'highlight' source code highlighter. See
https://groups.google.com/group/asciidoc/browse_frm/thread/e045c9986c71d72a[discussion
list].
+
NOTE: The 'pygments' attribute has been deprecated in favor of the new
'source-highlighter' attribute.

- Vim syntax highlighter: Don't confuse trailing open block delimiter
with section underline.
- Added 'skip' option to paragraphs (c.f. Delimited Block 'skip'
option).

.Bug fixes
- *FIXED*: latex, music and graphviz filters: When the filter output
image is data-uri encoded write it to the indir (instead of the
outdir) so that encoder can find it. See
https://groups.google.com/group/asciidoc/browse_thread/thread/f5174f450a61f14b[discussion
list].
- *FIXED*: Escape the ']' character inside inline macros. See
https://groups.google.com/group/asciidoc/browse_thread/thread/db3b734a6931cb74[discussion
list].
- *FIXED*: source highlighter filter: Pass 'role' attribute to HTML
backends.
- *FIXED*: source highlight filter: docbook backend: 'role' attribute
was not passed to listings without a title. Patch submitted by Lex
Trotman. See
https://groups.google.com/group/asciidoc/browse_thread/thread/13c9ee97930342b3[discussion
list].
- *FIXED*: music2png.py: 'FOPException: Raster ByteInterleavedRaster'
error (FOP 1.0, ImageMagick 6.6.9-7).

--------------------------
.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.

--------------------------
.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

--------------------------
.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.
- Added HTML 5 article with 'toc2' table of contents to the example on
the AsciiDoc website home page.
- Added 'filters' and 'topics' help topics. Fixed documentation
errors in help text. Patch submitted by Lionel Orry, see:
http://groups.google.com/group/asciidoc/browse_thread/thread/9da9d48a6461ff14
- Pass parent configuration files, command-line attributes and header
attributes to table asciidoc filters. Based on patch submitted by
Simon Ruderich, see:
http://groups.google.com/group/asciidoc/browse_thread/thread/5c792cbb395b753b
- Allow a 'title' attribute entry in the document header so that HTML
backends can set the 'title' element separately from the displayed
document title (the 'doctitle' attribute).
- Pass 'lang' attribute to 'asciidoc' table style filter. Patch
submitted by Simon Ruderich, see:
http://groups.google.com/group/asciidoc/browse_thread/thread/e2100b7cb29283ce
- xhtml11,html5: Added 'toc2' attribute which generates a scrollable
table of contents in the left hand margin. Based on customized CSS
written by Suraj Kurapati, see
http://groups.google.com/group/asciidoc/browse_thread/thread/c5e30ee5555877f5
- Added 'asciidoc-confdir' intrinsic attribute which expands to the
global conf directory.
- Documented that you can specify multiple CSS files with the a2x(1)
`--stylesheet` command option. See:
http://groups.google.com/group/asciidoc/browse_thread/thread/baf3218551d05a05
- Improved xhtml11 backend's table of contents generation latency.
Patch submitted by Hongli Lai. See:
http://groups.google.com/group/asciidoc/browse_thread/thread/5a7fe64fbfd65ad
- Added html5 backend.
- For consistency converted all DOS formatted configuration and text
files to UNIX format.
- html4: Added ability to use 'role' attribute with most block
elements. Patch contributed by Simon Ruderich. See
http://groups.google.com/group/asciidoc/browse_thread/thread/5620ba634fdb030a
- Added Dutch language configuration file and accompanying test file
(contributed by Dag Wieers, see
http://groups.google.com/group/asciidoc/browse_thread/thread/f969b9ce987d7f5d).
- Configuration files are loaded in two passes when the -e
command-line option is used (the same behavior as when the -e option
is not used). Patch submitted by haad. See
http://groups.google.com/group/asciidoc/browse_thread/thread/cd0f47495fd04181
and
http://code.google.com/p/asciidoc/issues/detail?id=6&q=label%3APriority-Medium
- Documented how to include embedded fonts in an EPUB document.
- a2x: Added `.<ext>=<mimetype>` resource specifier syntax.
- a2x: Enable admonition icons in example EPUBs.
- a2x: allow environment variables and tilde home directories in
resource manifest files.
- a2x: don't process non-existent resource directories.
- a2x: assume resource option is a directory if the name ends with a
directory separator.
- a2x: Added a new syntax to the `--resource` option specifier which
allows the destination path to be specified.
- a2x: Copy resources referenced in the OPF and resources referenced
by the generated HTML (in theory DocBook XSL should ensure they are
identical but this is not always the case e.g.
http://sourceforge.net/tracker/?func=detail&atid=373747&aid=2854075&group_id=21935).
- Drop border from callout list image links.
- html4: Moved manpage NAME section out of header so that the name
section is rendered when the asciidoc(1) `--no-header-footer` option
is specified (so that manpages processed blogpost include the NAME
section).
- Vim syntax highlighter: TODO markers now appear in list items and
literal paragraphs and blocks.
- Constrained quotes can now be bounded on the left by a } character.
See:
http://groups.google.com/group/asciidoc/browse_thread/thread/b24cc3362f35b801
- Added text-decoration roles (underline, overline, line-through,
blink) for xhtml11 and html5 outputs.

.Bug fixes
- *FIXED*: epubcheck 1.1 previously issued a warning for files not
registered in the manifest (epubcheck 1.0.5 did not). This resulted
in a problem compiling the adventures-of-sherlock-holmes.txt example
(the `underline.png` resource was not in the manifest).