Professional Documents
Culture Documents
==================
:website: http://asciidoc.org/
https://groups.google.com/group/asciidoc/browse_thread/thread/1a60eb4507a0555f/264c
39c6a89fc7a0
- 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/04c9
091b0856fc13
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 noone.
- 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/2772
6e7e13f7bfc7?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 Klma.
- 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/a727
a8a564eea76c
- Makefile: Fixed sh compatibility issue. See
https://groups.google.com/group/asciidoc/browse_thread/thread/753a52b2af85fcfc/04c9
091b0856fc13
https://groups.google.com/group/asciidoc/browse_thread/thread/7be28e9714f249c7[disc
ussion
list].
- Documented `{wj}` (word-joiner) attribute and updated FAQ. See:
https://groups.google.com/group/asciidoc/browse_thread/thread/961a957ab5872ebf[disc
ussion
list].
- FAQ: Added 'How can I place a footnote immediately following quoted
text?' See
https://groups.google.com/group/asciidoc/browse_thread/thread/961a957ab5872ebf[disc
ussion
list].
- Added Greek language configuration file. Contributed by Michael
Dourmousoglou. See
https://groups.google.com/group/asciidoc/browse_thread/thread/9e79d8494ef8d870[disc
ussion
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[discuss
ion
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[discuss
ion
list].
+
NOTE: The 'pygments' attribute has been deprecated in favor of the new
'source-highlighter' attribute.
.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[disc
ussion
list].
- *FIXED*: Escape the ']' character inside inline macros. See
https://groups.google.com/group/asciidoc/browse_thread/thread/db3b734a6931cb74[disc
ussion
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[disc
ussion
list].
- *FIXED*: music2png.py: 'FOPException: Raster ByteInterleavedRaster'
error (FOP 1.0, ImageMagick 6.6.9-7).
http://groups.google.com/group/asciidoc/browse_thread/thread/a9762e21ec0cc244/5d3a4
ebf20e6847e[Patch]
submitted by Dag Wiers.
- Added 'replacement3' substitution to enable
http://groups.google.com/group/asciidoc/browse_thread/thread/843d7d3d671006fb/25628
e14c829db3f[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/b5e0b
83fe37ae31a[Patch]
submitted by Lex Trotman.
- Added
http://groups.google.com/group/asciidoc/browse_thread/thread/3d06b0105dfbb780/8c60e
b7a62f522e4[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[discu
ssion
list].
- 'xhtml11', 'html5' backends: Include book part TOC entries for
multi-part books. Patch submitted by Loc 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[discu
ssion
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[discu
ssion
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/47a2c
7586f9e40c6?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/1e120
483dafca109[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[discu
ssion
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/3af3b4
e57b827c78?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).
http://groups.google.com/group/asciidoc/browse_thread/thread/ec8e8481eb0e27b0/d1c03
5092b5bb7a4?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/6597
96dfadad30ea?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/44d13
113a35738ef
- *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/9afc4
559d51e1dbd
- *FIXED*: LaTeX backend: fixed bad escapes. Patch submitted by Mark
McCurry:
http://groups.google.com/group/asciidoc/browse_thread/thread/8c111f1046b33691/158a9
44cf4d5ff0d?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
.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).
.Bug fixes
- *FIXED*: Auto-generated section title ids are now Unicode aware.
- *FIXED*: Setting 'quotes' configuration entries using document
attribute entries failed if the attribute entry was not in the
document header. See:
http://groups.google.com/group/asciidoc/browse_thread/thread/a1dd0562dee8b939
- *FIXED*: If the input and output file names were different then the
output file name was incorrectly used to synthesize 'docinfo' file
names. Reported by Christian Zuckschwerdt.
- *FIXED*: An error can occur when more than one consecutive quotes
are defined as a blank string. Reported by Peggy Russell.
- *FIXED*: Encoding error in automatically generated author initials.
Patch submitted by Xin Wang. See:
http://groups.google.com/group/asciidoc/browse_thread/thread/f44615dca0b834e9
Version 8.6.3 (2010-11-14)
--------------------------
.Additions and changes
- Added and 'unbreakable' option to bulleted and numbered lists
(thanks to Henrik Maier for this patch).
- Added `ifeval::[]` system macro (thanks to Henrik Maier for
suggesting this feature).
- The image 'scale' attribute sets the DocBook 'imagedata' element
'scale' attribute. Patch submitted by Henrik Maier.
- DocBook 'preface', 'colophon' and 'dedication' style section titles
now work. Based on patch submitted by Henrik Maier.
- 'a2x': Do not inject xsltproc parameters if they were specified on
the command-line (parameter double-ups generate xsltproc 'Global
parameter already defined' errors).
- 'a2x': Refactored xsltproc parameter injection.
- 'a2x': articles chunked at section level by default.
- 'attributes', 'titles' and 'specialcharacters' sections are now read
from the local `asciidoc.conf` file before the header is parsed.
This fixes a regression problem. See
http://groups.google.com/group/asciidoc/browse_thread/thread/1b3f88f1f8118ab3
- Document header attributes take precedence over configuration file
attributes.
- Refactored 'music', 'graphviz' and 'latex' filter configurations.
- Refactored source filter configuration and added literal paragraph
source style.
- Separated paragraph styles from paragraph syntax -- any style can be
applied to any syntax.
- Added 'listing' and 'quote' paragraph styles.
- Renamed paragraph 'default' style to 'normal'.
- Updated `--help` option text.
- 'a2x': The `asciidoc_opts`, `dblatex_opts`, `fop_opts` and
`xsltproc_opts` command-line options can be specified multiple
times. This makes embedding multiple 'a2x' options in document
headers easier to manage and less error prone.
- Added ASCIIMathML and LaTeXMathML support to slidy backend.
- Pass the 'encoding' attribute to the Pygments source highlight
filter command.
- 'a2x': HTML Help `.hhk` file named after AsciiDoc source file.
- 'a2x': Added `--xsl-file` option to allow custom XSL stylesheets to
be specified.
- Make builds the man pages. Patch submitted by Sebastian Pipping. See
http://groups.google.com/group/asciidoc/browse_thread/thread/c21c2902c29bae64
.Bug fixes
- *FIXED*: Sometimes double backquotes were misinterpreted as inline
literal macros. See:
http://groups.google.com/group/asciidoc/browse_thread/thread/f510ea82a88aaee8
- *FIXED*: Regression in 8.6.2: command-line attributes were not
available to the global asciidoc.conf.
- *FIXED*: Postponed document title substitutions until backend conf
files have been loaded (8.6.2 regression). See
http://groups.google.com/group/asciidoc/browse_thread/thread/42b63ce90c2563b8
- *FIXED*: The XSL Stylesheets customizations were preventing chapter
and section level TOCs from being generated when using XSL
Stylesheets via 'a2x'. See
http://groups.google.com/group/asciidoc/browse_thread/thread/42b63ce90c2563b8
- *FIXED*: ``UnicodeDecodeError: \'ascii' codec can't decode byte''
error. This error is due to a limitation in the Python HTMLParser
module, see: http://bugs.python.org/issue3932
- *FIXED*: Broken `--no-conf` option (8.6.2 regression).
- *FIXED*: Regression in 8.6.2: configuration attribute entries set in
the document header may cause a 'FAILED: incomplete configuration
files' error.
- *FIXED*: 'html4': corrected self closed meta tags.
- *FIXED*: 'a2x' regression in 8.6.2: HTML Help `.hhp` file name had
reverted to default name instead of the AsciiDoc source file name.
See:
http://groups.google.com/group/asciidoc/browse_thread/thread/dedc961b23e9ac56
- *FIXED*: Attributes in man page title caused it to be dropped
resulting in invalid DocBook output.
- *FIXED*: `make uninstall` now deletes the `asciidoc.1` and `a2x.1`
man pages.
.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').
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
http://groups.google.com/group/asciidoc/browse_thread/thread/b22603bfb879418c.
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
(http://groups.google.com/group/asciidoc/browse_thread/thread/1c02d27d49221aa2).
- Relaxed anchor ID name syntax
(http://groups.google.com/group/asciidoc/browse_thread/thread/5f3e825c74ed30c).
- 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 (http://pygments.org/) option added to source code
highlight filter. Based on Pygments source code filter written by
David Hajage
(http://groups.google.com/group/asciidoc/browse_thread/thread/d8d042f5a3021369/8934
ebbb8cb7144b).
- 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
http://groups.google.com/group/asciidoc/browse_frm/thread/319e5cd94493e330/3fcb83fa
b067af42.
- 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:
http://groups.google.com/group/asciidoc/browse_frm/thread/fe9b33d8f5f1e0af
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
http://groups.google.com/group/asciidoc/browse_frm/thread/8eda3ea812968854
- Document attribute names are case insensitive everywhere, this makes using
attribute entries more consistent e.g. previously :VERS: had to be refered to
with {vers} ({VERS} did not work).
- Hungarian translation of footer-text (submitted by Miklos Vajna).
See
http://groups.google.com/group/asciidoc/browse_frm/thread/7174cb7598993c72#
- asciidocapi.py 0.1.2: Can now load AsciiDoc script named asciidoc.
See
http://groups.google.com/group/asciidoc/browse_frm/thread/66e7b59d12cd2f91
Based on patch submitted by Phillip Lord.
- German translation of footer-text (submitted by Simon Ruderich). See
http://groups.google.com/group/asciidoc/browse_frm/thread/7174cb7598993c72
- Pushed HTML footer text into language conf files with the
introduction of a [footer-text] configuration file template section.
See
http://groups.google.com/group/asciidoc/browse_frm/thread/7174cb7598993c72
.Bug fixes
- *FIXED*: Sometimes multiple double quoted text elements in the same
paragraph were mistakenly seen as starting with an inline literal.
See
http://groups.google.com/group/asciidoc/browse_frm/thread/219c86ae25b79a21
- *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
http://groups.google.com/group/asciidoc/browse_frm/thread/af652507caf6cec9
- *FIXED*: Missing selector for 'List of examples' title in DocBook
CSS file. Patch submitted by Laurent Laville. See
http://groups.google.com/group/asciidoc/browse_frm/thread/3f96900f7fbf5620
- *FIXED*: Broken accents in lang-hu.conf. See:
http://groups.google.com/group/asciidoc/browse_frm/thread/7174cb7598993c72
- *FIXED*: DocBook XSL generated HTML callout lists are properly
aligned. Submitted by Lionel Orry. See
http://groups.google.com/group/asciidoc/browse_frm/thread/2ff802547b6a75ea
- *FIXED*: Filter execution now occurs prior to filter markup template
substitution to ensure image data URI encoding happens after image
generation (see
http://groups.google.com/group/asciidoc/browse_thread/thread/14e8fcb289a135b).
- *FIXED*: The section numbers no longer increment when the 'numbered'
attribute is undefined (see
http://groups.google.com/group/asciidoc/browse_thread/thread/faa36e9e5c7da019/d24ca
b3fe363e58d).
.Bug fixes
- *FIXED*: Regression: system attribute escaping did not work.
- *FIXED*: Website: broken image links in chunked User Guide.
.Bug fixes
- *FIXED*: Absolute 'imagesdir' and 'iconsdir' attribute path names
do not work with the xhtml11 data-uri encoding. See
http://groups.google.com/group/asciidoc/browse_frm/thread/cb8b7694bbc82a6
- *FIXED*: Regression issue with inline data-uri images. See
http://groups.google.com/group/asciidoc/browse_frm/thread/cb8b7694bbc82a6
- *FIXED*: An unexpected error occurred when processing a table
containing CSV data if the 'cols' attribute was not explicitly
specified. See
http://groups.google.com/group/asciidoc/browse_frm/thread/4b0f364b477ec165
.Bug fixes
- *FIXED:* a2x: `--dblatex-opts` is now processed last so
`asciidoc-dblatex.xsl` params can be overridden. Patch submitted by
Mark Fernandes (see
http://groups.google.com/group/asciidoc/browse_frm/thread/5215c99dcc865e7d).
- *FIXED:* An error occurred if a directory in current path with same
name as executable.
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.
.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
http://groups.google.com/group/asciidoc/browse_frm/thread/b9c63be67dd1d11c
- *FIXED:* Only the first occurrence of passthrough macro was
substituted. Patch submitted by Peter Johnson. See
http://groups.google.com/group/asciidoc/browse_frm/thread/1269dc2feb1a482c
- *FIXED:* asciidoc now runs on Jython 2.5.0.
- *FIXED:* Wordpress margins and pads in a number of block
elements
(http://groups.google.com/group/asciidoc/browse_frm/thread/36ff073c79cbc20a).
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 {website}userguide.html#X89[DocBook table widths].
http://groups.google.com/group/asciidoc/browse_thread/thread/62278a054188a038[Noah
Slater]).
- Renamed 'revision' and 'date' attributes to more sensible and consistent
'revnumber' and 'revdate' (old names deprecated but still
recognized).
- Moved backend specific attributes to Appendix H in User Guide.
- Renamed and generalized the docbook backend revision history
inclusion mechanism to 'docinfo' to reflect the use of all article
or book information elements. The old revision history names still
work but have been deprecated.
- Refactored docbook.conf headers.
- Moved line break replacement from `[replacements]` to
`[replacements2]` so the replacement occurs after the mailto macro.
This fixes bug
http://groups.google.com/group/asciidoc/browse_thread/thread/4bdcdfb0af773e2
- The typewriter to punctuation apostrophe replacement can be escaped
with a backslash.
- Graphviz filter outputs images to 'imagesdir' if it is defined.
- Made the block image macro generic so that it can be used for filter
outputs. As a result Music and Graphviz filters:
* Have been greatly simplified.
* Honor the 'data-uri' attribute.
* 'html4' outputs no longer generate W3C validation warning.
- The 'iconsdir' attribute no longer requires a trailing directory
separator character.
- Removed borders around linked html4 images.
- Added 'html4' specific HTML output for music filter.
- 'a2x': Added `--unsafe` option (shortcut for
`--asciidoc-opts=--unsafe`).
- 'a2x': The FOP executable can now be named `fop` (this is the
default name in some distributions).
- Attributes are now substituted in the system macro attribute list.
- If the output is set to stdout (i.e. no output directory is defined)
then Music and Graphviz filters will output included images to the
source file directory.
- Added 'name' directive to 'testasciidoc'.
- Added lots of 'testasciidoc' new tests.
- Moved language specific configuration parameters into `lang-en.conf`
file.
- 'lang' attribute entry can be specified in the AsciiDoc source file
(preceding the header).
- Removed cruft from A-A-P scripts and documented them.
- Added German language config file (`lang-de.conf`) contributed by
Michael Wild.
- Added French language config file (`lang-fr.conf`) contributed by
Yves-Alexis Perez.
- Added Russian language config file (`lang-ru.conf`) contributed by
Artem Zolochevskiy.
- Added Hungarian language config file (`lang-hu.conf`) contributed by
Miklos Vajna.
.Bug fixes
- *FIXED:* Multiple manpage names are now handled correctly when
generating DocBook output, each name now generates a separate
DocBook `<refname>` element. See
http://groups.google.com/group/asciidoc/browse_thread/thread/c93bb4db025225d8
- *FIXED:* A problem that caused AttributeEntries preceding the header
to be overwritten when the language conf file loaded.
- *FIXED:* Possible inline macro name ambiguity e.g. link matches olink.
- *FIXED:* The documented macro definition deletion behavior had been
broken for a long time.
- *FIXED:* Email addresses not recognized when followed by a period
character.
- *FIXED:* Hyphens in mailto macros can delimit nested addresses e.g.
\bloggs@mail was processed inside
\mailto:joe-bloggs@mail-server.com[Mail].
- *FIXED:* User name in FTP URI generated incorrect FTP link. See
http://groups.google.com/group/asciidoc/browse_thread/thread/1d796a9c9ddb2855
- *FIXED:* Source highlighter now works with Wordpress backend (see
http://groups.google.com/group/asciidoc/browse_thread/thread/6d8c716748b109e3).
[[X2]]
Regression issues
~~~~~~~~~~~~~~~~~
. A colon following the date in the AsciiDoc header is treated as a
revision remark delimiter -- this could be an issue if you have used
a colon in the header date.
.Bug fixes
- All combinations of leading comments and attribute entries at the
start of a document are now skipped correctly.
- *FIXED:* `./configure` doesn't support `--docdir` as expected (patch
submitted by Artem Zolochevskiy)
- *FIXED:* Constrained quotes were incorrectly matched across line
boundaries e.g. the string `+\nabc+` incorrectly matched a monospace
quote.
.Bug fixes
- Fixed
http://groups.google.com/group/asciidoc/browse_thread/thread/fd27add515597c06[missi
ng
template section] error.
- The 'testasciidoc.py' `--force` option no longer deletes test data
files that were not specified.
- Dropped second quotes substitution in table cells -- it had
effectively disabled quote escaping in table cells.
.Bug fixes
.Bug fixes
- Dropped `asciidoc(1)` broken undocumented `--profile` option.
- Em dash replacement now recognized at start of block.
Regression issues
~~~~~~~~~~~~~~~~~
Replacing backtick quoting with the 'inline literal' passthrough
raises two regression scenarios for existing documents:
If your existing documents include these cases and you don't want to
upgrade then use the `-a no-inline-literal` command-line option,
alternatively put this in `~/.asciidoc/asciidoc.conf`:
[attributes]
no-inline-literal=
.Bug fixes
- Fixed broken numbered list nesting.
Compatibility issues
~~~~~~~~~~~~~~~~~~~~
The roman numbered list parenthesis syntax is incompatible with the
potentially ambiguous roman period syntax introduced in 8.3.2.
.Bug fixes
- Fixed 8.3.3 regression whereby adjacent lists with the same syntax
but different list styles were incorrectly treated as a single list.
.Bug fixes
- The broken and confusing numeration and numeration2 numbered list
attributes have been dropped, use the style attribute instead.
.Bug fixes
- Old syntax source highlight filter regression: special characters
where not escaped in DocBook outputs.
.Bug fixes
- Regression: Excluding double-quotes from unquoted attribute values
resulted in backward incompatibility, double-quotes in unquoted
attribute values has been reinstated.
- Regression: Text like `&...;` was sometimes mistaken for an entity
reference -- tightened up entity reference matching.
.Bug fixes
- Escaped quote skipped over leading and trailing quote instead of
just the leading quote.
- Fixed bug that was causing false negative safe mode warnings (patch
submitted by Julien Palmas).
- Placed priority of AttributeEntry, AttributeList and BlockTitle
above Title. This ensures an AttributeEntry, AttributeList or
BlockTitle followed by a same length leading ListingBlock delimiter
is not mistaken for a two-line title.
- Vim syntax highlighter: fixed multi-line quoted text.
- Contstrained quote termination after non-space character enforced.
- Vim syntax highlighter: unterminated quoted text is no longer
highlighted.
- Vim syntax highlighter: passthroughs now exactly match AsciiDoc
semantics.
- Vim syntax highlighter: escaped quoted text, attribute references
and inline macros are not highlighted.
- Vim syntax highlighter: TODO's highlighted in CommentBlocks (thanks
to Scott Wall); non-greedy pass:[$$...$$].
- Vim syntax highlighter: Comment lines mistaken for vertical list
labels (thanks to Scott Wall).
- Vim syntax highlighter: Single unmatched $$ mistakenly highlighted
remaining text (patch contributed by Scott Wall).
- Callouts now work in source highlighted listing generated by
dblatex.
- Fixed exception that occured if undefined attribute was present in
filter command.
- AttributeList block can now follow a paragraph without intervening
blank line.
- The include macro tabsize attribute is no longer propagated to
nested includes.
.Omissions
The following features were implemented but then but removed from this
release:
[[X1]]
Compatibility issues
~~~~~~~~~~~~~~~~~~~~
Version 8.3.0 has a number of backward incompatibilities with respect
to the previous 8.2.7 release:
.Bug fixes
- Fixed `stylesheets/xhtml11-manpage.css` not being included when
'linkcss' attribute was used.
- Configuration file `*-style` attributes are now dumped correctly.
- Fixed 'FAILED: malformed section entry' LaTeX backend error.
.Bug fixes
- Fixed broken CSS for decimal ordered lists nested in alpha ordered
list, thanks to Alex Efros.
- A missing closing block delimiter now reports the opening delimiter
line number instead of the end of file line number.
- Fixed an error generated by the asciidoc `-e` option when there are
no block definitions -- patch contributed by Alejandro Mery.
- Handle both `\r\n` (as well as `\n`) line separators that may be
returned by `{sys}` attribute evaluation.
- Numbered attribute names no longer interfere with positional
attribute list values.
.Bug fixes
- Fixed exception thrown by illegal command-line arguments.
- Rolled back the 'with' warning bug fix introduced in 8.2.4 -- it was
incompatible with Python <2.5.
.Bug fixes
- Author information is now correctly set when using attribute entries
in the header instead of an author line (previously the 'author'
attribute was not being calculated correctly and there were
attribute substitution problems).
.Bug fixes
- Fixed an assertion error that occurred when a configuration file
containing an `include::[]` macro was loaded using the
`--conf-file` option and the configuration file name did not
include an explicit directory path -- patch submitted by Dmitry
Potapov.
- Asciidoc titles are only converted to lower case if all characters
are upper case otherwise case is left unchanged -- patch submitted
by Dmitry Potapov.
- Added a missing check that input is not stdin before loading
configuration files from the document directory -- patch submitted
by Dmitry Potapov.
- Attribute list items must evaluate to strings, numbers or None
(previously it was possible to evaluate to other object types which
resulted in surprising attribute values).
- If an AsciiDoc document has no title an empty XHTML 1.1 'title'
element is created -- previously the 'title' element was dropped
which resulted in invalid XHTML 1.1.
- The Vim syntax file no longer highlights escaped callouts.
- The Vim syntax highlighter now correctly highlights Double-dollar
passthroughs when they enclose dollar delimited ASCIIMathML and
LaTeXMathML formulas.
Lorum ipsum ::
+
This change implements the originally intended behavior (as per the
AsciiDoc documentation and examples) so there should be very few
compatibility issues.
.Bug fixes
.Bug fixes
* The example code filter block delimiter is now the word `code`
followed by four or more tilde characters.
* The source highlight filter block delimiter is now the word
`source` followed by four or more tilde characters.
mailto:srackham@gmail.com['Stuart Rackham']
*********************************************************************
- The syntax for index entry macros have have been deprecated from
`+...+` and `++...++` to `((...))` and `(((...)))` respectively.
Rationale:
* Bracketing is consistent other with `[[...]]` and `<<...>>`
reference macros.
* To easily confused with triple plus passthroughs.
* To make way for the new monospace quoting.
abc\\=xyz
+
Results in `name=abc\` and `value=xyz` -- previously this would have
escaped the `=` character.
.Bug fixes
- `a2x(1)` failed when configuration files were installed in the
global `/etc/asciidoc/` directory -- it was only searching the
directory containing the asciidoc executable (thanks to Christian
Wiese for finding and submitting a patch this bug).
- The html4 backend admonition caption now correctly displays the
admonition `caption` attribute (previously displayed the `style`
attribute).
.Bug fixes
- Backslash line continuation is now observed in verbatim paragraphs.
- Fixed errors generated by example
`./examples/website/build-website.sh` script.
.Bug fixes
- Fixed a lot of glaring grammatical and factual errors in the User
Guide.
.Bug fixes
- Explicitly set table CSS border style (`xhtml11` backend) to `solid`
because default border styles vary from browser to browser.
.Bug fixes
- Invalid options are now trapped gracefully.
- Documentation errata.
.Bug fixes
- Illegal character set encoder (specified by the AsciiDoc `encoding`
attribute) and character data are trapped gracefully.
- AsciiDoc table 'format' attribute in table attribute lists were not
recognized.
- The nested horizontal labeled list example in the 'AsciiDoc User
Guide' has been dropped -- it generated invalid DocBook markup.
mailto:srackham@gmail.com['Stuart Rackham']
***************************************************
.Bug fixes
- Included files are no longer read inside conditionally excluded
content.
- Manpage command names containing dashes (in the manpage NAME
section) were misinterpreted as the spaced dash command name/purpose
separator. Bug report and patch supplied by
mailto:david@dgreaves.com[David Greaves].
- Unexpected error following malformed author line error.
.Bug fixes
- Some system attribute evaluation failures caused unexpected
exceptions to occur.
.Bug fixes
- Asciidoc now searches in `/etc/asciidoc/filters` for filters.
.Bug fixes
- Illegal comment syntax in `css-embedded-stylesheet.conf` resulted in
illegal CSS in files generated by the `css-embedded` backend.
mailto:srackham@gmail.com['Stuart Rackham']
***************************************************
.Bug fixes
- Fixed broken backslash line continuation.
- Labeled list end tags were not undergoing attribute substitution.
- Documents without any author information now generate legitimate
DocBook (previously if the author line was not included in the
document header then an empty (illegal) DocBook `author` element was
generated).
- Multiple spaces in filter command arguments were replaced by a
single space. The `./examples/asciidoc2text/asciidoc2text.sh` script
now indents text correctly.
- PDF documentation is now produced from DocBook XML using XSLTLib and
FOP. Previously we processed DocBook SGML with `jw(1)` (which used
Dvips to convert DVI files to PDF). FOP has come a long way in the
last 12 months and produces very acceptable PDF under both Linux and
Windows.
- Sections detailing how to install and use the DocBook XSL
Stylesheets, xsltproc, FOP toolchain and the AsciiDoc XSLT drivers
have been added to the User Guide.
- The PDF output from the he example article template has been
included in the distribution (`./doc/article.pdf`).
- Special characters are emitted using decimal Unicode character codes
(previously used named character entities which cannot be assumed
included in non-HTML documents).
- Added registered trademark (R) to `[replacements]`.
- CSS stylesheet tweaks.
- Admonitions (Note, Tip, Important, Warning, Caution) include icons
when generating css output.
mailto:srackham@gmail.com['Stuart Rackham']
***************************************************
.Compatibility issues:
1. Table titles are no longer in the arguments line, use the new
BlockTitles.
2. Graphic titles are no longer in the 'graphic' block macro caption,
use the new BlockTitles.
3. The code-filter title must be placed in a preceding BlockTitle.
4. SidebarBlock titles must be placed in a preceding BlockTitle.
5. The DelimitedBlock option 'sidebar' has been renamed to 'section'.
6. The default DocBook backend file extension has been changed from
`.docbook` to `.xml` (`.sgml` for the 'docbook-sgml' backend).
'Stuart Rackham'
***************************************************
- Added tables to AsciiDoc.
- Added two special 'subs' options: 'default' specifies the default
substitution options and 'none' specifies no substitution. These
options can only appear singly.
- Line continuation using a trailing backslash character is available
in Paragraphs, ListItems, Tables.
- The left and right quotes for quoted text can now be specified
separately.
- Shipped configuration files implement footnotes (only useful for
DocBook output) using \[[]] quoting.
- Shipped configuration files implement index terms (only useful for
DocBook and LinuxDoc output) using \(()) quoting.
- The shipped 'html' backend configuration now emits valid 'HTML 4.01
Transitional'.
- Added new calculated glossary reference types `{<name>!<value>}`
and `{<name>#<value>}`.
- The DelimitedBlock 'params' option has been dropped in favor of the
new 'block attributes' mechanism. If you have customized block
params options you may need to adjust source files to use the
'block attributes' syntax. The example code filter has been updated
to reflect these changes.
- The code filter now has a `-t tabsize` option.
- Replaced `-w` option with `-v` (verbose) option. The warnings option
was just to confusing.
- Named attributes can now be specified in macro calls.
- The 'tabsize' attribute is recognized in the built-in `include`
macros. A tabsize of zero suppresses tab expansion.
- The configuration file `[options]` section has been split into
`[miscellaneous]` and `[titles]`. If you have customized any of
these settings you will need to adjust the affected configuration
files.
- Configuration file `[miscellaneous]` entries can now also be set
using the command-line `-g` option.
- Fixed: error that occurred when attempting to use zero length
configuration and source files.
- Fixed: blocking filter halt problem.
- Fixed: inline macro escape prefix problem.
- Fixed: missing macros from configuration dump problem.
- Fixed: named macros were dumped incorrectly.
- Many documentation changes/additions/corrections.
specialcharacters,quotes,specialwords,replacements,glossary,macros
- Documentation changes/additions/corrections.