either because they themselves are not ready or because a
dependency isn't. This is annotated by
PYTHON_VERSIONS_INCOMPATIBLE= 33 # not yet ported as of x.y.z
or
PYTHON_VERSIONS_INCOMPATIBLE= 33 # py-foo, py-bar
respectively, please use the same style for other packages,
and check during updates.
Use versioned_dependencies.mk where applicable.
Use REPLACE_PYTHON instead of handcoded alternatives, where applicable.
Reorder Makefile sections into standard order, where applicable.
Remove PYTHON_VERSIONS_INCLUDE_3X lines since that will be default
with the next commit.
Whitespace cleanups and other nits corrected, where necessary.
Upstream changes:
=================
Version 8.6.9 (2013-11-09)
Additions and changes
html5, xhtml11 and slidy outputs now wrap pre element contents at right margin
Vim syntax file: highlight line breaks in lists (patch submitted by Alex Efros).
Vim syntax file: fixed highlighting of lines with spaces preceding an indented paragraph.
Vim syntax file: dropped ) from list of illegal characters following opening quote.
Added + intrinsic attribute.
Allow tabsize=0 in configuration file.
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.
Removed Vim related stuff from the installer makefile.
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.
Added ruler and line-break outputs to HTML Help outputs. Patch submitted by DonM.
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).
Embedded data-uri images now figure file mimetype from file contents rather than the file extension. Patch submitted by Lex Trotman.
Bug fixes
indexterm2:[ ] macro syntax now recognized.
Synthesised *-option attributes for options set in table conf file style entries.
Makefile: Fixed sh compatibility issue.
Upstream changes:
-----------------
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: discussion list.
Documented {wj} (word-joiner) attribute and updated FAQ. See: discussion
list.
FAQ: Added How can I place a footnote immediately following quoted text?
See discussion list.
Added Greek language configuration file. Contributed by Michael
Dourmousoglou. See discussion list.
FAQ: Added Using roles to select fonts for PDF. Submitted by Lex Trotman
and based on solution by Antonio Borneo. See: 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 discussion list.
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 discussion list.
FIXED: Escape the ] character inside inline macros. See 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
discussion list.
FIXED: music2png.py: FOPException: Raster ByteInterleavedRaster error (FOP
1.0, ImageMagick 6.6.9-7).
Upstream changes:
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. Patch
submitted by Dag Wiers.
Added replacement3 substitution to enable 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. Patch submitted by Lex Trotman.
Added 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 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 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 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 discussion list.
Added backend-confdir intrinsic attribute.
Bug fixes:
FIXED: slidy backend: broken stylesheet attribute. Patch submitted by
Micheal Hackett.
FIXED: Restored missing themes to zip file distribution archive.
FIXED: Grammatical error in error messages. 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. Patch submitted by
Sebastien Helleu.
FIXED: Python 2.4 backward incompatibility.
FIXED: 8.6.6 regression broke Jython compatibility. See 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 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).
Complete changelog can be accessed here:
http://www.methods.co.nz/asciidoc/CHANGELOG.html
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 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).
* 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.
o 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.
o Explicitly specified resources are added to the EPUB OPF manifest
automatically.
o You can explicitly specify file extension MIME types.
o The enhanced resource processing works around a couple of DocBook
XSL bugs (see EPUB Notes).
Read the CHANGELOG for a full list of all additions, changes and bug fixes.
Upstream changes:
Additions and changes
* Added text foreground and background color along with text size CSS styles for
XHTML outputs.
* Vim syntax highlighter: highlight macros that start with an attribute
reference (a common idiom).
* Vim syntax highlighter: highlight attribute references in macro attribute lists.
* Attribute entries can be used to set configuration markup templates.
* Double-width East Asian characters in titles now correctly match the title
underline widths.
* Implemented asciidoc(1) filter commands.
* User's home directory now calculated in a platform independent manner.
* Added double-quote characters to French language file.
* Vim Syntax highlighter: Highlight closing OpenBlocks which immediately follow
a literal paragraph.
* Changed UNIX /dev/null to OS independent os.devnull in filters code.
* Vim syntax highlighter: Single and double quoted text now highlights correctly
when preceded by an attributes list.
* Added Ukrainian language file (lang-uk.conf). Added double-quote characters to
Russian language file.conf).
* Single and double quote characters are now set using the {lsquo}, {rsquo},
{ldquo} and {rdquo} attributes. This makes is easy to customise language specific
quotes.
* Implemented conf-files attribute to allow configuration files to be specified
in the source document.
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.
* FIXED: If the input and output file names were different then the output file
name was incorrectly used to synthesize docinfo file names.
* FIXED: An error can occur when more than one consecutive quotes are defined as
a blank string.
* FIXED: Encoding error in automatically generated author initials.
This release was intended primarily to fix regressions introduced by 8.6.2, but
the incubation period was longer than expected and it now also includes a number
of enhancements an few other bug fixes.
Complete CHANGELOG at: http://www.methods.co.nz/asciidoc/CHANGELOG.html
pkgsrc changes:
- take MAINTAINERship (ok gdt@)
upstream changes:
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 Phillip Lord's slidy backend
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: http://groups.google.com/group/asciidoc/browse_thread/thread/c14a4c3b1e4f6dc5
* Added two more docinfo attributes docinfo1 and docinfo2 to allow and
control inclusion of a shared docinfo file.
See http://groups.google.com/group/asciidoc/browse_thread/thread/c948697943432e24
* Vim syntax highlighter highlights multi-name conditional attributes.
* LaTeX backend patch submitted by Andreas Hermann Braml
(see http://groups.google.com/group/asciidoc/browse_thread/thread/1c415fc4540ce5e5).
* 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: http://groups.google.com/group/asciidoc/browse_thread/thread/8712a95e95a292a7
* 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 http://groups.google.com/group/asciidoc/browse_thread/thread/c4427a3902d130a8
* 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:
http://groups.google.com/group/asciidoc/browse_thread/thread/59a610068e4acb58
pkgsrc changes:
- set license
- Install more docs. Note html docs is no longer part of the upstream tarball.
- Add options pdf and epub to ensure the proper tools are installed.
Both are off by default.
Upstream changes:
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').
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/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
http://groups.google.com/group/asciidoc/browse_frm/thread/319e5cd94493e330/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:
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/d24cab3fe363e58d).
1. Version 8.3.3 (2009-01-02)
This release supercedes 8.3.2.
Bug fixes
* The broken and confusing numeration and numeration2 numbered list
attributes have been dropped, use the style attribute instead.
__________________________________________________________________
2. Version 8.3.2 (2009-01-01)
Additions and changes
* Added Gouichi Iisaka's Graphviz filter to distribution.
* The SidebarBlock element can now be rendered with an abstract
style.
* Reorganized filters into a separate subdirectory for each filter.
* Updated Makefile.in and MANIFEST files to reflect new filters
organization.
* Added listing style to LiteralBlock element so listings with nested
listing blocks can be rendered as a listing block.
* Changed example code filter to use preferred ListingBlock syntax
(the old ~ delimited filter syntax is no longer used).
* Implemented enumeration and enumeration2 numbered list attributes
for specifying the list numbering style (arabic, loweralpha,
upperalpha, lowerroman and upperroman).
* AsciiDoc now recognizes upperalpha, lowerroman and upperroman
numbers in listdef-numbered2 numbered lists and sets the number
style based on the style of the first numbered list item
(alternative to setting enumeration2 attribute).
* Updated formatlistpat definition in .vimrc example in User Guide.
* You can now backslash escape system block macros.
* Added Pychart FAQ.
* Drop paragraph text and list text, index and label match groups
from attributes -- they are included in the element's text and we
don't want them processed a second time as attributes.
* Changed comment line block macro to a passthrough block macro to
ensure no substitutions.
* A subslist no longer has to be appended to a PassthroughBlock macro
definition, if omitted no substitutions are performed.
* Code tidy up: replaced deprecated <> operator with !=.
* Removed unused linuxdoc code.
* Code tidy ups: dropped old types module reference; replaced
has_key() with preferred in operator.
Bug fixes
* Old syntax source highlight filter regression: special characters
where not escaped in DocBook outputs.
__________________________________________________________________
3. Version 8.3.1 (2008-12-14)
Additions and changes
* Replaced the install.sh script with Ben Walton's updated autoconf
scripts -- see [1]INSTALL for details.
* Added a generalized AttributeEntry syntax to allow arbitrary
configuration file entries to be set from within an AsciiDoc
document (suggested by Henrik Maier).
* Listing delimited blocks in DocBook outputs now support IDs; IDs of
titled Listing and Literal delimited blocks have been moved to the
enclosing DocBook example tag (thanks to Vijay Kumar for this
patch).
* Replaced vertical typewriter apostrophe with punctuation apostrophe
(thanks to Noah Slater).
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.
__________________________________________________________________
4. Version 8.3.0 (2008-11-29)
Additions and changes
* [2]AsciiDoc new tables is a complete redesign of the tables syntax
and generation. The new syntax and features are a huge improvement
over the old tables. The old tables syntax has been deprecated but
is currently still processed.
* [3]Lists can now be styled like other block elements. This allows a
single list syntax for glossary, qanda (Question and Answer) and
bibliography lists instead of having to remember a different syntax
for each type.
* Inline passthroughs macros have been improved and block passthrough
macros added. Attribute substitution can be optionally specified
when the macro is called.
* The passthrough block has a fully transparent passthrough delimited
block block style called pass.
* The asciimath and latexmath [4]passthrough macros along with
asciimath and latexmath [5]passthrough blocks provide a (backend
dependent) mechanism for rendering mathematical formulas. There are
[6]LaTeX Math, [7]AsciiMathML and [8]LaTeXMathML examples on the
AsciiDoc website.
* Reimplemented and cleaned up filter processing based on a patch
submitted by Kelly Anderson. Uses the newer subprocess module
instead of the deprecated popen2 module. Now works in Win32 command
shell.
* Addition FAQs, more documentation updates.
* Arbitrary HTML/XML entities can be entered in AsciiDoc source.
* Did away with the need for the shaded-literallayout.patch (thanks
to Henrik Maier for this patch).
* Implemented page break block macro.
* Added line breaks and ruler processing instructions to DocBook
outputs (thanks to Henrik Maier for this patch).
* Added deg (degree) and wj (word joiner) entity attributes (thanks
to Henrik Maier).
* Tweaked DocBook indexterm2 macro to avoid white space preceding the
term when used in table cells (thanks to Henrik Maier for this
patch).
* Title elements now process the options attribute like other block
elements.
* Added `single quoted' element.
* Spaces on both sides of a -- em-dash are translated to thin space
characters.
* Improved detection and reporting of malformed attribute lists.
* The list compact style is now a list option.
* Added strong labeled list option which makes the labels bold (HTML
outputs only).
* Dropped unsupported linuxdoc backend.
* Dropped deprecated xhtml-deprecated (version 6) backend.
* Added breakable and unbreakable attribute options to tables to
control table breaking across page boundaries (DocBook XSL/FO
outputs). By and in collaboration with Henrik Maier.
* Added pgwide attribute option to tables to table, block image,
horizontal labeled lists. Specifies that the element should be
rendered across the full text width of the page irrespective of the
current indentation (DocBook XSL/FO outputs). Thanks to Henrik
Maier for this patch.
* Vim syntax highlighter: spaces before/after bullets no longer
highlighted (which is ugly if using a theme that highlights with
underlines). Thanks to Donald Chai for this patch.
* Added a2x(1) --fop option.
* Added a2x(1) --no-xmllint option.
* Highlighted labelled list terms with the navy color in XHTML
outputs.
* Use w3m(1) as default a2x(1) text format generator (fallback to
lynx(1)).
* Changed callout formats in html4 and xhtml11 outputs to angle
brackets to match source highlighter rendering.
* Macros now inject user defined <optionname>-option attributes into
markup.
* Added IRC URLs to AsciiDoc inline macros.
* Added depth attribute to include::[] system macro.
* Added footnoteref inline macro.
* Added stylesheet XHTML attribute to specify additional custom CSS
stylesheet.
* If a paragraph style is specified it will be added to the XHTML
class attribute and DocBook role attribute.
* Replacements can be set in a document using the reserved
AttributeEntry name replacement.
* The prefix for auto-generated section name IDs can be set with the
idprefix attribute.
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 $$...$$.
* 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:
* pi, cdata and comment passthrough macros and passthrough block
styles (creeping featurism, use pass macros instead).
* Generic tag inline macro (creeping featurism, use pass macros
instead).
4.1. Compatibility issues
Version 8.3.0 has a number of backward incompatibilities with respect
to the previous 8.2.7 release:
* The old table syntax is still processed but a DEPRECATED warning is
issued.
* Entity references have to be escaped with a backslash.
* You have to explicitly precede horizontal style labeled lists with
the [horizontal] style attribute -- by default all labeled lists
are rendered vertically.
* The list compact style has been dropped and is now a list option
(use options="compact" in attribute lists).
* AsciiDoc version 6 sytnax no longer supported.
* Linuxdoc been removed from the distribution.
* The unsupported experimental latex backend has not been tested on
this release.
* The introduction of single-quote quoting requires that double-quote
quoting is escaped with two backslashes.
__________________________________________________________________
5. Version 8.2.7 (2008-07-04)
Additions and changes
* Added dvi, ps and tex output format options to a2x(1).
* Added --dblatex option to a2x(1) so dblatex(1) can be used to
generate PDFs.
* Added custom dblatex(1) configuration files (in distribution
./dblatex directory) that are used by a2x(1).
* dblatex(1) is now used to generate the distributed PDF version of
the AsciiDoc User Guide.
* If you don't need a customized the link caption you can enter the
http, https, ftp, file URLs and email addresses without any special
macro syntax -- you get the links by just cutting and pasting URLs
and emails addresses. This also makes it easier to open links
directly form AsciiDoc source ( most editors allow you to open URLs
directly). The Vim syntax highlighter has been updated to reflect
these changes.
* Highlighted source code paragraphs have been implemented -- it's a
much more convenient way to enter short code examples (see [9]the
online docs).
* The source highlighter and music filter syntax has changed -- they
now used the ListingBlock syntax customized with source and music
style attribute values. This follows the Paragraph styling
convention introduced by the source paragraph (previous item) and
is easier to read. The old syntax still works but has been
deprecated.
* QuoteBlocks now have a verse style -- you no longer have to nest a
verse LiteralBlock inside a QuoteBlock for verses. The verse style
on the LiteralBlock has been deprecated (still works though) and
the style attribute is positional attribute 1, pushing attribution
and citetitle attributes to the right (you'll need to insert a
quote attribute into your existing QuoteBlocks).
* It is no up to the DocBook processor to highlight source code
syntax in <programlisting> elements rather than GNU Highlighter --
this is the correct way to handle it, plus dblatex(1) makes a much
better job.
* scaledwidth and align attributes have been added to the image
macro. They apply to DocBook outputs (specifically for PDF
documents). scaledwidth sets the image size as a percent of the
available page width; align applies left, center or right
horizontal image justification.
* Added a2x(1) --fop-opts=FOP_OPTS option (patch submitted by Miklos
Vajna).
* Added a2x(1) --dblatex-opts=DBLATEX_OPTS option.
* Added Mikhail Yakshin's FOP 0.95 patch which fixes a long-standing
fo.xsl problem and allows PDF's to be generated with FOP 0.95
(previously had to use FOP 0.20.5).
* The User Guide has been updated and outdated FOP configuration and
installation sections removed.
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.
See the also the [10]AsciiDoc repository changelog.
bugfixes);
* asciidoc(1) and a2x(1) man pages formatted to conform to
man-pages(7) recommendations.
* Old code-filter syntax (pre-8.1.0) is no longer recognized so that
malformed two-line level 2 titles are no longer confused with
code-filter block delimiters.
- assume that Python 2.4 and 2.5 are compatible and allow checking for
fallout.
- remove PYTHON_VERSIONS_COMPATIBLE that are obsoleted by the 2.3+
default. Modify the others to deal with the removals.
1. Version 8.2.5 (2007-11-18)
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.
__________________________________________________________________
2. Version 8.2.4 (2007-11-10)
Additions and changes
* You can now use the lang attribute to set the DocBook language
attribute.
* Attribute values can now contain attribute references.
* If the lang attribute is defined then configuration files named
like lang-<lang>.conf will be loaded automatically.
* The help file name help-<lang>.conf is based on the AsciiDoc lang
attribute, defaults to help.conf (English).
* Admonition, figure and table captions have been factored into a
predefined set of caption_* attributes. They only apply to directly
generated (X)HTML outputs (DocBook stylesheets generate their own
language specific captions based on the lang attribute).
* Dropped platform dependent doc/asciidoc.chm file from distribution
documentation formats.
Bug fixes
* The spurious warning with will become a reserved keyword in Python
2.6 has been suppressed.
__________________________________________________________________
3. Version 8.2.3 (2007-09-12)
Additions and changes
* Added VMiklos's permalink patch for auto-generated section IDs
(enabled by default by the sectids attribute).
* Added [1]FAQ to website.
* Changed format of {localdate} attribute to ISO 8601 (%Y-%m-%d).
* Added abc2ly --beams=None option to make music2png.py conform to
ABC's notion of beams.
* XHTML level 2 section headings are now styled with an underlining
border.
* XHTML links to AsciiDoc title elements are now implemented with
title ID attributes (previously separate <a> element targets were
generated.
* Multi-word first, middle and last names can be entered in the
header author line using the underscore as a word separator.
* The nested inline macros restriction has now been lifted, for
example you can now include links and inline images inside
footnotes.
* Help topic names can be shortened (so long as they are not
ambiguous). For example asciidoc -hm will print the AsciiDoc man
page.
* Added {two_colons} and {two_semicolons} attributes for escaping
labeled list ambiguity.
* If quirks mode is disabled the XHTML Mime Type is set to the
recommended application/xhtml+xml (rather than text/html).
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).
__________________________________________________________________
4. Version 8.2.2 (2007-07-22)
Additions and changes
* [2]LaTeXMathML capability has been added for users who are more
familiar with or prefer LaTeX math formulas to the [3]ASCIIMathML
notation (thanks to Arthur Sakellariou for the patch).
* The source highlight and code filters now process embedded
callouts.
* Added an --attribute=ATTRIBUTE option to a2x(1) for passing
attribute values to asciidoc(1) (a shortcut for --asciidoc-opts="-a
ATTRIBUTE").
* Image block and inline macros prepend optional {imagesdir}
attribute to image link targets.
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.
__________________________________________________________________
5. Version 8.2.1 (2007-04-06)
Additions and changes
* A number of improvements have been made to the Vim syntax
highlighter, for example the word C++ is no longer mistaken for the
start of an unconstrained monospace quote.
* Labeled list definitions have been tightened -- a list label can no
longer containing trailing spaces. The following example is no
longer recognized as a valid list label:
Lorum ipsum ::
This change implements the originally intended behavior (as per the
AsciiDoc documentation and examples) so there should be very few
compatibility issues.
__________________________________________________________________
6. Version 8.2.0 (2007-04-04)
Additions and changes
* A Vim syntax file is now included in the AsciiDoc distribution
(inspired by Felix Obenhuber's asciidoc.vim script). You can find
it (along with a Vim filetype detection script in the distribution
./vim/ directory (the scripts are installed automatically by the
AsciiDoc installer ./install.sh). See Appendix J of the AsciiDoc
User Guide for details.
* Added toclevel attribute (1..4) which sets the number of title
levels reported in the table of contents. Defaults to 2 and must be
used with the toc attribute. Example usage:
$ asciidoc -a toc -a toclevels=3 doc/asciidoc.txt
* Added a listindex attribute which is the current list item index
(1..). If this attribute appears outside a list its value is the
number of items in the most recently closed list.
* The single line titles syntax now accepts trailing suffixes -- this
syntax matches the title line syntax of a number of popular Wiki
markups.
* If a QuoteBlock has no attribution or citetitle then the DocBook
<attribution> element is not generated (previously generated empty
<attribution> element).
* If the text of a labeled list item is blank then no texttag is
written.
* An end of line backslash performs line continuation for horizontal
labeled list items.
* The Revision line now accommodates Subversion $Id markers (in
addition to CVS and RCS markers). Thanks to Tiago Sturmer Daitx for
this patch.
* Implemented a2x(1) option --skip-asciidoc which allows a2x(1) to
convert DocBook XML files not derived from AsciiDoc sources.
* If a2x(1) --doctype option is not specified it defaults to manpage
if --format=manpage else defaults to article (previously --doctype
always defaulted to article).
* Added an External Resources section to the [4]AsciiDoc home page.
Mention docbook and LaTeX in DESCRiption.
Add sourceforge to MASTER_SITES.
Add more directories to INSTALLATION_DIRS (maybe some are redundant).
Also install a2x.
Install man pages.
Install various configs and icons.
Add do-test target.
Following is from the AsciiDoc ChangeLog:
1. Version 8.1.0 (2006-10-22)
* AsciiDoc generated XHTML documents now display as table of
contents if the toc attribute is defined (JavaScript needs to be
enabled for this to work). Thanks to Troy Hanson who contributed
this feature based on a JavaScript by Mihai Bazon. I've simplified
things somewhat to match Docbook XSL Stylesheets style, see Troy's
[1]tpl User Guide for a fancier layout. Use the -a toc -a numbered
command-line options to produce a number table of contents.
* A [2]music filter is included in the distribution ./filters/
directory. It translates music in [3]LilyPond or [4]ABC notation
to standard classical notation in the form of a trimmed PNG image
which is inserted into the AsciiDoc output document.
* Incorporated Paul Melis's Win32 filter patch. This workaround
allows AsciiDoc to run filters under Windows.
* Added uninstall.sh script.
* Rather than proliferate a confusing number of filter block
delimiters the following convention has been adopted: delimiters
belonging to DelimitedBlock filters distributed with AsciiDoc will
consist of a word (normally a noun identifying the block content)
followed by four or more tilde characters. This has necessitated
changing existing filter delimiters (the old delimiters still work
but may be deprecated in future versions):
+ 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.
* Conditionally redefined subscript and superscripting so they use
the old replacements mechanism when asciidoc7compatible is defined
rather than the asciidoc 8 default unconstrained quoting (patch
for affected files attached).
* Moved the source highlight filter from ./examples/ to ./filter/.
* Added {verbose} intrinsic attribute (useful for passing verbose
flag to filters).
* Added {outdir} intrinsic attribute.
* Renamed {docdir} intrinsic attribute to unambiguous`{indir}
({docdir}` still works but may be removed in future release).
* If asciidoc(1) outputs to stdout then instrinsic attribute
{docname} is extracted from the input file name.
_________________________________________________________________
2. Version 8.0.0 (2006-08-27)
This is a major release because changes to quoting and index entry
handling may break existing documents (see Additions and changes below
and Appendix A: Migration Notes in the AsciiDoc User Guide).
Please report any problems you encounter.
[5]Stuart Rackham
Additions and changes
* Quoting can can occur within words (based on patch submitted by
Benjamin Klum). See the Unconstrained Quotes sub-section in the
User Guide.
* The underline and plus characters can be used as alternatives to
the existing apostrophe and backtick quote characters. They are
arguably better choices than the apostrophe and backtick as they
are not confused with punctuation.
* 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.
* Superscripts and subscripts are implemented as constrained quotes
so they can now be escaped with a leading backslash and prefixed
with with an attribute list.
* An experimental LaTeX backend has been written by Benjamin Klum (a
number additions in this release are to accommodate the LaTeX
backend).
* include macro file names now expand environment variables and
tilde expansions.
* A configuration file [quotes] entry can be undefined by setting to
a blank value.
* Added callto inline macro for Skype callto links.
* Added colnumber attribute for table data markup.
* A leading comment block or comment lines are now skipped
(previously a document had to start with either attribute entries
or a document Title).
* Experimental rows attribute (number of source lines in table)
available in table markup templates (used by experimental LaTeX
backend).
* Included install shell script written by [6]Jacob Mandelson for
installing the tarball distribution.
* Added INSTALL documentation file.
* Added replacements2 substitution options -- a second replacements
section.
* Added the ability to redefine normal and verbatim substitutions
with subsnormal and subsverbatim entries in configuration file
[miscellaneous] section.
* By default AttributeEntry values are substituted for
specialcharacters and attributes, if you want a different
AttributeEntry substitution set the attributeentry-subs attribute.
* The name in name=value configuration file entries can now end with
a backslash, just escape the trailing backslash with a backslash.
For example:
abc\\=xyz
Results in name=abc\ and value=xyz -- previously this would have
escaped the = character.
* A blank configuration file section deletes any preceding section
with the same name (applies to non-markup template sections).
* A command-line attribute value with a @ suffix does not override
existing document and configuration file attributes (normally
command-line attributes have precedence over document and
configuration file attributes).
* localtime attribute is now encoded from the native system encoding
to the output encoding. Patch submitted by [7]FKtPp -- here's his
description of the problem:
"I am a Chinese user of AsciiDoc and I find that when I use UTF-8
(the default encoding) to write asciidoc documents in Windows
platform the resulting html footer line will get screwed. It was
caused by a localized tzname that was always encoded in the
windows native encoding, which in my case is cp936."
* a2x(1) can generate Open Document Text files using [8]docbook2odf.
Currently docbook2odf(1) only processes a subset of DocBook,
unimplemented elements are skipped.
* The a2x(1) format option defaults to xhtml (previously a format
had to be specified explicitly).
* The -d, --doctype=DOCTYPE option has been added to a2x(1) which is
a shortcut for --asciidoc-options="--doctype=DOCTYPE".
* Replaced a2x(1) --no-icons and --no-copy options with their
negated equivalents: --icons and --copy respectively. The default
behavior has also changed: copying and use of icons is disabled by
default. Rationale:
+ To make the default behavior more consistent since use of
icons and CSS stylesheets does not apply to all formats.
+ To make the default behavior less surprising (the creation of
icon and stylesheet output files must now be explicit).
* a2x(1) has been bumped from version 0.1.1 to version 1.0.0.
Bug fixes
* Removed duplicate ./doc/a2x.1.txt from distribution tarball.
* Documentation errata.
* Attribute replacement is no longer performed twice in Titles and
AttributeEntrys.
* a2x(1) skipped asciidoc(1) execution when rerun with different
--asciidoc-options options, it now always executes asciidoc(1).
The problem was that previously asciidoc(1) was executed only if
the output file was missing or older than the source file.
