FooBarWidget-mizuho 0.9.0
Sign up to get free protection for your applications and to get access to all the features.
- data/LICENSE.txt +20 -0
- data/README.markdown +68 -0
- data/Rakefile +9 -0
- data/asciidoc/BUGS +34 -0
- data/asciidoc/BUGS.txt +28 -0
- data/asciidoc/CHANGELOG +1585 -0
- data/asciidoc/CHANGELOG.txt +1595 -0
- data/asciidoc/COPYING +339 -0
- data/asciidoc/COPYRIGHT +18 -0
- data/asciidoc/INSTALL +82 -0
- data/asciidoc/INSTALL.txt +71 -0
- data/asciidoc/README +46 -0
- data/asciidoc/README.txt +36 -0
- data/asciidoc/a2x +641 -0
- data/asciidoc/asciidoc.conf +404 -0
- data/asciidoc/asciidoc.py +4255 -0
- data/asciidoc/common.aap +9 -0
- data/asciidoc/dblatex/asciidoc-dblatex.sty +18 -0
- data/asciidoc/dblatex/asciidoc-dblatex.xsl +17 -0
- data/asciidoc/dblatex/dblatex-readme.txt +22 -0
- data/asciidoc/doc/a2x.1 +246 -0
- data/asciidoc/doc/a2x.1.txt +195 -0
- data/asciidoc/doc/article.css-embedded.html +579 -0
- data/asciidoc/doc/article.html +62 -0
- data/asciidoc/doc/article.pdf +0 -0
- data/asciidoc/doc/article.txt +124 -0
- data/asciidoc/doc/asciidoc-revhistory.xml +27 -0
- data/asciidoc/doc/asciidoc.1 +161 -0
- data/asciidoc/doc/asciidoc.1.css-embedded.html +562 -0
- data/asciidoc/doc/asciidoc.1.css.html +212 -0
- data/asciidoc/doc/asciidoc.1.html +190 -0
- data/asciidoc/doc/asciidoc.1.txt +118 -0
- data/asciidoc/doc/asciidoc.conf +8 -0
- data/asciidoc/doc/asciidoc.css-embedded.html +7954 -0
- data/asciidoc/doc/asciidoc.css.html +7553 -0
- data/asciidoc/doc/asciidoc.dict +673 -0
- data/asciidoc/doc/asciidoc.html +3502 -0
- data/asciidoc/doc/asciidoc.txt +4757 -0
- data/asciidoc/doc/asciimath.txt +47 -0
- data/asciidoc/doc/book-multi.css-embedded.html +575 -0
- data/asciidoc/doc/book-multi.html +72 -0
- data/asciidoc/doc/book-multi.txt +159 -0
- data/asciidoc/doc/book.css-embedded.html +585 -0
- data/asciidoc/doc/book.html +60 -0
- data/asciidoc/doc/book.txt +133 -0
- data/asciidoc/doc/customers.csv +18 -0
- data/asciidoc/doc/faq.txt +262 -0
- data/asciidoc/doc/latex-backend.html +224 -0
- data/asciidoc/doc/latex-backend.txt +193 -0
- data/asciidoc/doc/latexmath.txt +35 -0
- data/asciidoc/doc/main.aap +293 -0
- data/asciidoc/doc/music-filter.html +513 -0
- data/asciidoc/doc/music-filter.pdf +0 -0
- data/asciidoc/doc/music-filter.txt +158 -0
- data/asciidoc/doc/source-highlight-filter.html +183 -0
- data/asciidoc/doc/source-highlight-filter.pdf +0 -0
- data/asciidoc/doc/source-highlight-filter.txt +174 -0
- data/asciidoc/docbook-xsl/asciidoc-docbook-xsl.txt +71 -0
- data/asciidoc/docbook-xsl/chunked.xsl +19 -0
- data/asciidoc/docbook-xsl/common.xsl +67 -0
- data/asciidoc/docbook-xsl/fo.xsl +117 -0
- data/asciidoc/docbook-xsl/htmlhelp.xsl +17 -0
- data/asciidoc/docbook-xsl/manpage.xsl +28 -0
- data/asciidoc/docbook-xsl/shaded-literallayout.patch +32 -0
- data/asciidoc/docbook-xsl/xhtml.xsl +14 -0
- data/asciidoc/docbook.conf +606 -0
- data/asciidoc/examples/website/CHANGELOG.html +3828 -0
- data/asciidoc/examples/website/INSTALL.html +163 -0
- data/asciidoc/examples/website/README-website.html +129 -0
- data/asciidoc/examples/website/README-website.txt +29 -0
- data/asciidoc/examples/website/README.html +125 -0
- data/asciidoc/examples/website/a2x.1.html +395 -0
- data/asciidoc/examples/website/asciidoc-docbook-xsl.html +165 -0
- data/asciidoc/examples/website/asciimath.html +157 -0
- data/asciidoc/examples/website/build-website.sh +25 -0
- data/asciidoc/examples/website/downloads.html +219 -0
- data/asciidoc/examples/website/downloads.txt +98 -0
- data/asciidoc/examples/website/faq.html +372 -0
- data/asciidoc/examples/website/index.html +398 -0
- data/asciidoc/examples/website/index.txt +222 -0
- data/asciidoc/examples/website/latex-backend.html +640 -0
- data/asciidoc/examples/website/latexmath.html +119 -0
- data/asciidoc/examples/website/layout1.conf +161 -0
- data/asciidoc/examples/website/layout1.css +65 -0
- data/asciidoc/examples/website/layout2.conf +158 -0
- data/asciidoc/examples/website/layout2.css +93 -0
- data/asciidoc/examples/website/manpage.html +266 -0
- data/asciidoc/examples/website/music-filter.html +242 -0
- data/asciidoc/examples/website/music1.abc +12 -0
- data/asciidoc/examples/website/music1.png +0 -0
- data/asciidoc/examples/website/music2.ly +9 -0
- data/asciidoc/examples/website/music2.png +0 -0
- data/asciidoc/examples/website/source-highlight-filter.html +251 -0
- data/asciidoc/examples/website/support.html +78 -0
- data/asciidoc/examples/website/support.txt +5 -0
- data/asciidoc/examples/website/userguide.html +7597 -0
- data/asciidoc/examples/website/version9.html +143 -0
- data/asciidoc/examples/website/version9.txt +48 -0
- data/asciidoc/filters/code-filter-readme.txt +37 -0
- data/asciidoc/filters/code-filter-test-c++.txt +7 -0
- data/asciidoc/filters/code-filter-test.txt +15 -0
- data/asciidoc/filters/code-filter.conf +8 -0
- data/asciidoc/filters/code-filter.py +239 -0
- data/asciidoc/filters/music-filter-test.txt +40 -0
- data/asciidoc/filters/music-filter.conf +40 -0
- data/asciidoc/filters/music2png.py +189 -0
- data/asciidoc/filters/source-highlight-filter-test.txt +19 -0
- data/asciidoc/filters/source-highlight-filter.conf +100 -0
- data/asciidoc/help.conf +213 -0
- data/asciidoc/html4.conf +363 -0
- data/asciidoc/images/highlighter.png +0 -0
- data/asciidoc/images/icons/README +5 -0
- data/asciidoc/images/icons/callouts/1.png +0 -0
- data/asciidoc/images/icons/callouts/10.png +0 -0
- data/asciidoc/images/icons/callouts/11.png +0 -0
- data/asciidoc/images/icons/callouts/12.png +0 -0
- data/asciidoc/images/icons/callouts/13.png +0 -0
- data/asciidoc/images/icons/callouts/14.png +0 -0
- data/asciidoc/images/icons/callouts/15.png +0 -0
- data/asciidoc/images/icons/callouts/2.png +0 -0
- data/asciidoc/images/icons/callouts/3.png +0 -0
- data/asciidoc/images/icons/callouts/4.png +0 -0
- data/asciidoc/images/icons/callouts/5.png +0 -0
- data/asciidoc/images/icons/callouts/6.png +0 -0
- data/asciidoc/images/icons/callouts/7.png +0 -0
- data/asciidoc/images/icons/callouts/8.png +0 -0
- data/asciidoc/images/icons/callouts/9.png +0 -0
- data/asciidoc/images/icons/caution.png +0 -0
- data/asciidoc/images/icons/example.png +0 -0
- data/asciidoc/images/icons/home.png +0 -0
- data/asciidoc/images/icons/important.png +0 -0
- data/asciidoc/images/icons/next.png +0 -0
- data/asciidoc/images/icons/note.png +0 -0
- data/asciidoc/images/icons/prev.png +0 -0
- data/asciidoc/images/icons/tip.png +0 -0
- data/asciidoc/images/icons/up.png +0 -0
- data/asciidoc/images/icons/warning.png +0 -0
- data/asciidoc/images/smallnew.png +0 -0
- data/asciidoc/images/tiger.png +0 -0
- data/asciidoc/install.sh +55 -0
- data/asciidoc/javascripts/ASCIIMathML.js +938 -0
- data/asciidoc/javascripts/LaTeXMathML.js +1223 -0
- data/asciidoc/javascripts/toc.js +69 -0
- data/asciidoc/lang-es.conf +15 -0
- data/asciidoc/latex.conf +663 -0
- data/asciidoc/linuxdoc.conf +285 -0
- data/asciidoc/math.conf +50 -0
- data/asciidoc/stylesheets/docbook-xsl.css +271 -0
- data/asciidoc/stylesheets/xhtml-deprecated-manpage.css +21 -0
- data/asciidoc/stylesheets/xhtml-deprecated.css +247 -0
- data/asciidoc/stylesheets/xhtml11-manpage.css +18 -0
- data/asciidoc/stylesheets/xhtml11-quirks.css +49 -0
- data/asciidoc/stylesheets/xhtml11.css +284 -0
- data/asciidoc/t.conf +20 -0
- data/asciidoc/text.conf +16 -0
- data/asciidoc/vim/ftdetect/asciidoc_filetype.vim +53 -0
- data/asciidoc/vim/syntax/asciidoc.vim +139 -0
- data/asciidoc/xhtml-deprecated-css.conf +235 -0
- data/asciidoc/xhtml-deprecated.conf +351 -0
- data/asciidoc/xhtml11-quirks.conf +57 -0
- data/asciidoc/xhtml11.conf +514 -0
- data/bin/mizuho +40 -0
- data/lib/mizuho/chapter.rb +54 -0
- data/lib/mizuho/generator.rb +106 -0
- data/lib/mizuho/heading.rb +46 -0
- data/lib/mizuho/parser.rb +99 -0
- data/lib/mizuho/template.rb +50 -0
- data/mizuho.gemspec +34 -0
- data/templates/asciidoc.css +358 -0
- data/templates/asciidoc.html.erb +86 -0
- data/templates/manualsonrails.css +165 -0
- data/templates/manualsonrails.html.erb +97 -0
- data/test/parser_spec.rb +190 -0
- data/test/spec_helper.rb +43 -0
- metadata +234 -0
@@ -0,0 +1,3828 @@
|
|
1
|
+
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
|
2
|
+
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
|
3
|
+
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
|
4
|
+
<head>
|
5
|
+
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
6
|
+
<meta name="generator" content="AsciiDoc 8.2.7" />
|
7
|
+
<link rel="stylesheet" href="./xhtml11.css" type="text/css" />
|
8
|
+
<link rel="stylesheet" href="./xhtml11-quirks.css" type="text/css" />
|
9
|
+
<link rel="stylesheet" href="./layout1.css" type="text/css" />
|
10
|
+
<title>AsciiDoc ChangeLog</title>
|
11
|
+
</head>
|
12
|
+
<body>
|
13
|
+
<div id="layout-banner">
|
14
|
+
<div id="layout-title">AsciiDoc</div>
|
15
|
+
<div id="layout-description">Text based document generation</div>
|
16
|
+
</div>
|
17
|
+
<table>
|
18
|
+
<tr valign="top">
|
19
|
+
<td id="layout-menu">
|
20
|
+
<div>»<a href="index.html">Home</a></div>
|
21
|
+
<div>»<a href="manpage.html">Man Page</a></div>
|
22
|
+
<div>»<a href="userguide.html">User Guide</a></div>
|
23
|
+
<div>»<a href="http://powerman.name/doc/asciidoc">Cheatsheet</a></div>
|
24
|
+
<div>»<a href="a2x.1.html">a2x</a></div>
|
25
|
+
<div>»<a href="README.html">README</a></div>
|
26
|
+
<div>»<a href="CHANGELOG.html">ChangeLog</a></div>
|
27
|
+
<div>»<a href="INSTALL.html">Installation</a></div>
|
28
|
+
<div>»<a href="downloads.html">Downloads</a></div>
|
29
|
+
<div>»<a href="faq.html">FAQ</a></div>
|
30
|
+
<div>»<a href="support.html">Support</a></div>
|
31
|
+
<div id="page-source">»<a href="CHANGELOG.txt">Page Source</a></div>
|
32
|
+
</td>
|
33
|
+
<td>
|
34
|
+
<div id="layout-content">
|
35
|
+
<div id="header">
|
36
|
+
<h1>AsciiDoc ChangeLog</h1>
|
37
|
+
</div>
|
38
|
+
<h2 id="_version_8_2_7_2008_07_04">Version 8.2.7 (2008-07-04)</h2>
|
39
|
+
<div class="sectionbody">
|
40
|
+
<div class="para"><p>See the <a href="http://hg.sharesource.org/asciidoc/shortlog"><em>AsciiDoc</em> Mercurial
|
41
|
+
repository</a> for a full list of changes.</p></div>
|
42
|
+
<div class="ilist"><div class="title">Additions and changes</div><ul>
|
43
|
+
<li>
|
44
|
+
<p>
|
45
|
+
Added <tt>dvi</tt>, <tt>ps</tt> and <tt>tex</tt> output format options to <tt>a2x(1)</tt>.
|
46
|
+
</p>
|
47
|
+
</li>
|
48
|
+
<li>
|
49
|
+
<p>
|
50
|
+
Added <tt>—dblatex</tt> option to <tt>a2x(1)</tt> so <tt>dblatex(1)</tt> can be used to
|
51
|
+
generate PDFs.
|
52
|
+
</p>
|
53
|
+
</li>
|
54
|
+
<li>
|
55
|
+
<p>
|
56
|
+
Added custom <tt>dblatex(1)</tt> configuration files (in distribution
|
57
|
+
<tt>./dblatex</tt> directory) which are used by <tt>a2x(1)</tt>.
|
58
|
+
</p>
|
59
|
+
</li>
|
60
|
+
<li>
|
61
|
+
<p>
|
62
|
+
<tt>dblatex(1)</tt> is now used to generate the distributed PDF version of
|
63
|
+
the <em>AsciiDoc</em> User Guide.
|
64
|
+
</p>
|
65
|
+
</li>
|
66
|
+
<li>
|
67
|
+
<p>
|
68
|
+
If you don't need a customized the link caption you can enter the
|
69
|
+
<em>http</em>, <em>https</em>, <em>ftp</em>, <em>file</em> URLs and email addresses without any
|
70
|
+
special macro syntax — you get the links by just cutting and
|
71
|
+
pasting URLs and emails addresses. This also makes it easier to open
|
72
|
+
links directly form <em>AsciiDoc</em> source ( most editors allow you to open
|
73
|
+
URLs directly). The Vim syntax highlighter has been updated to
|
74
|
+
reflect these changes.
|
75
|
+
</p>
|
76
|
+
</li>
|
77
|
+
<li>
|
78
|
+
<p>
|
79
|
+
Highlighted source code paragraphs have been implemented — it's a
|
80
|
+
much more convenient way to enter short code examples (see
|
81
|
+
<a href="http://www.methods.co.nz/asciidoc/source-highlight-filter.html">the
|
82
|
+
online docs</a>).
|
83
|
+
</p>
|
84
|
+
</li>
|
85
|
+
<li>
|
86
|
+
<p>
|
87
|
+
The source highlighter and music filter syntax has changed — they
|
88
|
+
now used the ListingBlock syntax customized with <em>source</em> and
|
89
|
+
<em>music</em> style attribute values. This follows the Paragraph styling
|
90
|
+
convention introduced by the source paragraph (previous item) and is
|
91
|
+
easier to read. The old syntax still works but has been deprecated.
|
92
|
+
</p>
|
93
|
+
</li>
|
94
|
+
<li>
|
95
|
+
<p>
|
96
|
+
QuoteBlocks now have a <em>verse</em> style — you no longer have to nest a
|
97
|
+
<em>verse</em> LiteralBlock inside a QuoteBlock for verses. The <em>verse</em>
|
98
|
+
style on the LiteralBlock has been deprecated (still works though)
|
99
|
+
and the <em>style</em> attribute is positional attribute 1, pushing
|
100
|
+
<em>attribution</em> and <em>citetitle</em> attributes to the right (you'll need
|
101
|
+
to insert a <em>quote</em> attribute into your existing QuoteBlocks).
|
102
|
+
</p>
|
103
|
+
</li>
|
104
|
+
<li>
|
105
|
+
<p>
|
106
|
+
It is no up to the DocBook processor to highlight source code syntax
|
107
|
+
in <tt><programlisting></tt> elements rather than GNU Highlighter — this
|
108
|
+
is the correct way to handle it, plus <tt>dblatex(1)</tt> makes a much
|
109
|
+
better job.
|
110
|
+
</p>
|
111
|
+
</li>
|
112
|
+
<li>
|
113
|
+
<p>
|
114
|
+
<em>scaledwidth</em> and <em>align</em> attributes have been added to the <em>image</em>
|
115
|
+
macro. They apply to DocBook outputs (specifically for PDF
|
116
|
+
documents). <em>scaledwidth</em> sets the image size as a percent of the
|
117
|
+
available page width; <em>align</em> applies <em>left</em>, <em>center</em> or <em>right</em>
|
118
|
+
horizontal image justification.
|
119
|
+
</p>
|
120
|
+
</li>
|
121
|
+
<li>
|
122
|
+
<p>
|
123
|
+
Added <tt>a2x(1)</tt> <tt>—fop-opts=FOP_OPTS</tt> option (patch submitted by Miklos
|
124
|
+
Vajna).
|
125
|
+
</p>
|
126
|
+
</li>
|
127
|
+
<li>
|
128
|
+
<p>
|
129
|
+
Added <tt>a2x(1)</tt> <tt>—dblatex-opts=DBLATEX_OPTS</tt> option.
|
130
|
+
</p>
|
131
|
+
</li>
|
132
|
+
<li>
|
133
|
+
<p>
|
134
|
+
Added Mikhail Yakshin's FOP 0.95 patch which fixes a long-standing
|
135
|
+
<tt>fo.xsl</tt> problem and allows PDF's to be generated with FOP 0.95
|
136
|
+
(previously had to use FOP 0.20.5).
|
137
|
+
</p>
|
138
|
+
</li>
|
139
|
+
<li>
|
140
|
+
<p>
|
141
|
+
The User Guide has been updated and outdated FOP configuration and
|
142
|
+
installation sections removed.
|
143
|
+
</p>
|
144
|
+
</li>
|
145
|
+
</ul></div>
|
146
|
+
<div class="ilist"><div class="title">Bug fixes</div><ul>
|
147
|
+
<li>
|
148
|
+
<p>
|
149
|
+
Fixed <tt>stylesheets/xhtml11-manpage.css</tt> not being included when
|
150
|
+
<em>linkcss</em> attribute was used.
|
151
|
+
</p>
|
152
|
+
</li>
|
153
|
+
<li>
|
154
|
+
<p>
|
155
|
+
Configuration file <tt>*-style</tt> attributes are now dumped correctly.
|
156
|
+
</p>
|
157
|
+
</li>
|
158
|
+
<li>
|
159
|
+
<p>
|
160
|
+
Fixed <em>FAILED: malformed section entry</em> LaTeX backend error.
|
161
|
+
</p>
|
162
|
+
</li>
|
163
|
+
</ul></div>
|
164
|
+
<div class="para"><p>See the also the <a href="https://sharesource.org/hg/asciidoc/"><em>AsciiDoc</em>
|
165
|
+
repository changelog</a>.</p></div>
|
166
|
+
</div>
|
167
|
+
<h2 id="_version_8_2_6_2008_04_29">Version 8.2.6 (2008-04-29)</h2>
|
168
|
+
<div class="sectionbody">
|
169
|
+
<div class="para"><p>See the <a href="http://hg.sharesource.org/asciidoc/shortlog"><em>AsciiDoc</em> Mercurial
|
170
|
+
repository</a> for a full list of changes.</p></div>
|
171
|
+
<div class="ilist"><div class="title">Additions and changes</div><ul>
|
172
|
+
<li>
|
173
|
+
<p>
|
174
|
+
Enhancements to the Vim <em>AsciiDoc</em> syntax highlighter, for example,
|
175
|
+
quoted text is now highlighted in titles and macro captions.
|
176
|
+
</p>
|
177
|
+
</li>
|
178
|
+
<li>
|
179
|
+
<p>
|
180
|
+
If you define the <tt>data-uri</tt> intrinsic attribute images referenced
|
181
|
+
by <em>image</em> macros will be embedded in XHTML using the
|
182
|
+
<a href="http://en.wikipedia.org/wiki/Data:_URI_scheme">data: URI scheme</a>.
|
183
|
+
<strong>NOTE</strong>: Microsoft browser support for the <em>data: URI scheme</em> is
|
184
|
+
currently limited to MSIE 8 beta 1.
|
185
|
+
</p>
|
186
|
+
</li>
|
187
|
+
<li>
|
188
|
+
<p>
|
189
|
+
Added <tt>toc-title</tt> attribute to allow custom table of contents
|
190
|
+
titles.
|
191
|
+
</p>
|
192
|
+
</li>
|
193
|
+
<li>
|
194
|
+
<p>
|
195
|
+
Added references to Alex Efros's <em>AsciiDoc</em> Cheatsheet to <em>AsciiDoc</em>
|
196
|
+
website.
|
197
|
+
</p>
|
198
|
+
</li>
|
199
|
+
<li>
|
200
|
+
<p>
|
201
|
+
<tt><tt>asciidoc(1)</tt></tt> and <tt><tt>a2x(1)</tt></tt> man pages formatted to conform to
|
202
|
+
<tt>man-pages(7)</tt> recommendations.
|
203
|
+
</p>
|
204
|
+
</li>
|
205
|
+
<li>
|
206
|
+
<p>
|
207
|
+
Old code-filter syntax (pre-8.1.0) is no longer recognized so that
|
208
|
+
malformed two-line level 2 titles are no longer confused with
|
209
|
+
<em>code-filter</em> block delimiters.
|
210
|
+
</p>
|
211
|
+
</li>
|
212
|
+
<li>
|
213
|
+
<p>
|
214
|
+
Added → ← ⇒ ⇐ arrow replacements from the Arrows block of
|
215
|
+
Unicode.
|
216
|
+
</p>
|
217
|
+
</li>
|
218
|
+
<li>
|
219
|
+
<p>
|
220
|
+
Added DocBook refentry lang attribute — patch contributed by
|
221
|
+
VMiklos.
|
222
|
+
</p>
|
223
|
+
</li>
|
224
|
+
<li>
|
225
|
+
<p>
|
226
|
+
AttributeEntry names can now be numeric (“named macro targets”).
|
227
|
+
</p>
|
228
|
+
</li>
|
229
|
+
<li>
|
230
|
+
<p>
|
231
|
+
Hide Table of Contents title if Table of Contents empty — patch
|
232
|
+
contributed by Alex Efros.
|
233
|
+
</p>
|
234
|
+
</li>
|
235
|
+
<li>
|
236
|
+
<p>
|
237
|
+
Various XHTML CSS tweaks.
|
238
|
+
</p>
|
239
|
+
</li>
|
240
|
+
<li>
|
241
|
+
<p>
|
242
|
+
Code cleanup:
|
243
|
+
</p>
|
244
|
+
<div class="ilist"><ul>
|
245
|
+
<li>
|
246
|
+
<p>
|
247
|
+
Replaced <tt>realpath()</tt> with Python 2.2 <tt>os.path.realpath()</tt> library
|
248
|
+
function.
|
249
|
+
</p>
|
250
|
+
</li>
|
251
|
+
<li>
|
252
|
+
<p>
|
253
|
+
Replaced old string library functions with string methods.
|
254
|
+
</p>
|
255
|
+
</li>
|
256
|
+
<li>
|
257
|
+
<p>
|
258
|
+
Use file generators instead of <tt>readlines()</tt>.
|
259
|
+
</p>
|
260
|
+
</li>
|
261
|
+
<li>
|
262
|
+
<p>
|
263
|
+
Renamed entities that shadowed builtins.
|
264
|
+
</p>
|
265
|
+
</li>
|
266
|
+
<li>
|
267
|
+
<p>
|
268
|
+
Standardized string quoting.
|
269
|
+
</p>
|
270
|
+
</li>
|
271
|
+
<li>
|
272
|
+
<p>
|
273
|
+
Dropped <tt>readlines()</tt> function.
|
274
|
+
</p>
|
275
|
+
</li>
|
276
|
+
</ul></div>
|
277
|
+
</li>
|
278
|
+
</ul></div>
|
279
|
+
<div class="ilist"><div class="title">Bug fixes</div><ul>
|
280
|
+
<li>
|
281
|
+
<p>
|
282
|
+
Fixed broken CSS for decimal ordered lists nested in alpha ordered
|
283
|
+
list, thanks to Alex Efros.
|
284
|
+
</p>
|
285
|
+
</li>
|
286
|
+
<li>
|
287
|
+
<p>
|
288
|
+
A missing closing block delimiter now reports the opening delimiter
|
289
|
+
line number instead of the end of file line number.
|
290
|
+
</p>
|
291
|
+
</li>
|
292
|
+
<li>
|
293
|
+
<p>
|
294
|
+
Fixed an error generated by the asciidoc <tt>-e</tt> option when there are
|
295
|
+
no block definitions — patch contributed by Alejandro Mery.
|
296
|
+
</p>
|
297
|
+
</li>
|
298
|
+
<li>
|
299
|
+
<p>
|
300
|
+
Handle both <tt>\r\n</tt> (as well as <tt>\n</tt>) line separators that may be
|
301
|
+
returned by <tt>{sys}</tt> attribute evaluation.
|
302
|
+
</p>
|
303
|
+
</li>
|
304
|
+
<li>
|
305
|
+
<p>
|
306
|
+
Numbered attribute names no longer interfere with positional
|
307
|
+
attribute list values.
|
308
|
+
</p>
|
309
|
+
</li>
|
310
|
+
</ul></div>
|
311
|
+
</div>
|
312
|
+
<h2 id="_version_8_2_5_2007_11_18">Version 8.2.5 (2007-11-18)</h2>
|
313
|
+
<div class="sectionbody">
|
314
|
+
<div class="ilist"><div class="title">Bug fixes</div><ul>
|
315
|
+
<li>
|
316
|
+
<p>
|
317
|
+
Fixed exception thrown by illegal command-line arguments.
|
318
|
+
</p>
|
319
|
+
</li>
|
320
|
+
<li>
|
321
|
+
<p>
|
322
|
+
Rolled back the <em>with</em> warning bug fix introduced in 8.2.4 — it was
|
323
|
+
incompatible with Python <2.5.
|
324
|
+
</p>
|
325
|
+
</li>
|
326
|
+
</ul></div>
|
327
|
+
</div>
|
328
|
+
<h2 id="_version_8_2_4_2007_11_10">Version 8.2.4 (2007-11-10)</h2>
|
329
|
+
<div class="sectionbody">
|
330
|
+
<div class="ilist"><div class="title">Additions and changes</div><ul>
|
331
|
+
<li>
|
332
|
+
<p>
|
333
|
+
You can now use the <tt>lang</tt> attribute to set the DocBook language
|
334
|
+
attribute.
|
335
|
+
</p>
|
336
|
+
</li>
|
337
|
+
<li>
|
338
|
+
<p>
|
339
|
+
Attribute values can now contain attribute references.
|
340
|
+
</p>
|
341
|
+
</li>
|
342
|
+
<li>
|
343
|
+
<p>
|
344
|
+
If the <tt>lang</tt> attribute is defined then configuration files named
|
345
|
+
like <tt>lang-<lang>.conf</tt> will be loaded automatically.
|
346
|
+
</p>
|
347
|
+
</li>
|
348
|
+
<li>
|
349
|
+
<p>
|
350
|
+
The help file name <tt>help-<lang>.conf</tt> is based on the <em>AsciiDoc</em>
|
351
|
+
<tt>lang</tt> attribute, defaults to <tt>help.conf</tt> (English).
|
352
|
+
</p>
|
353
|
+
</li>
|
354
|
+
<li>
|
355
|
+
<p>
|
356
|
+
Admonition, figure and table captions have been factored into a
|
357
|
+
predefined set of <tt>caption_*</tt> attributes. They only apply to
|
358
|
+
directly generated (X)HTML outputs (DocBook stylesheets generate
|
359
|
+
their own language specific captions based on the <tt>lang</tt> attribute).
|
360
|
+
</p>
|
361
|
+
</li>
|
362
|
+
<li>
|
363
|
+
<p>
|
364
|
+
Dropped platform dependent <tt>doc/asciidoc.chm</tt> file from
|
365
|
+
distribution documentation formats.
|
366
|
+
</p>
|
367
|
+
</li>
|
368
|
+
</ul></div>
|
369
|
+
<div class="ilist"><div class="title">Bug fixes</div><ul>
|
370
|
+
<li>
|
371
|
+
<p>
|
372
|
+
The spurious warning <em>with will become a reserved keyword
|
373
|
+
in Python 2.6</em> has been suppressed.
|
374
|
+
</p>
|
375
|
+
</li>
|
376
|
+
</ul></div>
|
377
|
+
</div>
|
378
|
+
<h2 id="_version_8_2_3_2007_09_12">Version 8.2.3 (2007-09-12)</h2>
|
379
|
+
<div class="sectionbody">
|
380
|
+
<div class="ilist"><div class="title">Additions and changes</div><ul>
|
381
|
+
<li>
|
382
|
+
<p>
|
383
|
+
Added VMiklos's <em>permalink</em> patch for auto-generated section IDs
|
384
|
+
(enabled by default by the <tt>sectids</tt> attribute).
|
385
|
+
</p>
|
386
|
+
</li>
|
387
|
+
<li>
|
388
|
+
<p>
|
389
|
+
Added <a href="http://www.methods.co.nz/asciidoc/faq.html">FAQ</a> to website.
|
390
|
+
</p>
|
391
|
+
</li>
|
392
|
+
<li>
|
393
|
+
<p>
|
394
|
+
Changed format of {localdate} attribute to ISO 8601 (<tt>%Y-%m-%d</tt>).
|
395
|
+
</p>
|
396
|
+
</li>
|
397
|
+
<li>
|
398
|
+
<p>
|
399
|
+
Added <tt>abc2ly —beams=None</tt> option to make <tt>music2png.py</tt> conform to
|
400
|
+
ABC's notion of beams.
|
401
|
+
</p>
|
402
|
+
</li>
|
403
|
+
<li>
|
404
|
+
<p>
|
405
|
+
XHTML level 2 section headings are now styled with an underlining
|
406
|
+
border.
|
407
|
+
</p>
|
408
|
+
</li>
|
409
|
+
<li>
|
410
|
+
<p>
|
411
|
+
XHTML links to <em>AsciiDoc</em> title elements are now implemented with
|
412
|
+
title ID attributes (previously separate <tt><a></tt> element targets were
|
413
|
+
generated.
|
414
|
+
</p>
|
415
|
+
</li>
|
416
|
+
<li>
|
417
|
+
<p>
|
418
|
+
Multi-word first, middle and last names can be entered in the header
|
419
|
+
author line using the underscore as a word separator.
|
420
|
+
</p>
|
421
|
+
</li>
|
422
|
+
<li>
|
423
|
+
<p>
|
424
|
+
The nested inline macros restriction has now been lifted, for
|
425
|
+
example you can now include links and inline images inside
|
426
|
+
footnotes.
|
427
|
+
</p>
|
428
|
+
</li>
|
429
|
+
<li>
|
430
|
+
<p>
|
431
|
+
Help topic names can be shortened (so long as they are not
|
432
|
+
ambiguous). For example <tt>asciidoc -hm</tt> will print the <em>AsciiDoc</em> man
|
433
|
+
page.
|
434
|
+
</p>
|
435
|
+
</li>
|
436
|
+
<li>
|
437
|
+
<p>
|
438
|
+
Added <tt>{two_colons}</tt> and <tt>{two_semicolons}</tt> attributes for
|
439
|
+
escaping labeled list ambiguity.
|
440
|
+
</p>
|
441
|
+
</li>
|
442
|
+
<li>
|
443
|
+
<p>
|
444
|
+
If quirks mode is disabled the XHTML Mime Type is set to the
|
445
|
+
recommended <tt>application/xhtml+xml</tt> (rather than <tt>text/html</tt>).
|
446
|
+
</p>
|
447
|
+
</li>
|
448
|
+
</ul></div>
|
449
|
+
<div class="ilist"><div class="title">Bug fixes</div><ul>
|
450
|
+
<li>
|
451
|
+
<p>
|
452
|
+
Author information is now correctly set when using attribute entries
|
453
|
+
in the header instead of an author line (previously the <em>author</em>
|
454
|
+
attribute was not being calculated correctly and there were
|
455
|
+
attribute substitution problems).
|
456
|
+
</p>
|
457
|
+
</li>
|
458
|
+
</ul></div>
|
459
|
+
</div>
|
460
|
+
<h2 id="_version_8_2_2_2007_07_22">Version 8.2.2 (2007-07-22)</h2>
|
461
|
+
<div class="sectionbody">
|
462
|
+
<div class="ilist"><div class="title">Additions and changes</div><ul>
|
463
|
+
<li>
|
464
|
+
<p>
|
465
|
+
<a href="http://www.maths.nottingham.ac.uk/personal/drw/lm.html">LaTeXMathML</a>
|
466
|
+
capability has been added for users who are more familiar with or
|
467
|
+
prefer LaTeX math formulas to the
|
468
|
+
<a href="http://www.methods.co.nz/asciidoc/asciimath.html">ASCIIMathML</a>
|
469
|
+
notation (thanks to Arthur Sakellariou for the patch).
|
470
|
+
</p>
|
471
|
+
</li>
|
472
|
+
<li>
|
473
|
+
<p>
|
474
|
+
The <em>source highlight</em> and <em>code</em> filters now process embedded
|
475
|
+
callouts.
|
476
|
+
</p>
|
477
|
+
</li>
|
478
|
+
<li>
|
479
|
+
<p>
|
480
|
+
Added an <tt>—attribute=ATTRIBUTE</tt> option to <tt><tt>a2x(1)</tt></tt> for passing
|
481
|
+
attribute values to <tt>asciidoc(1)</tt> (a shortcut for <tt>—asciidoc-opts="-a
|
482
|
+
ATTRIBUTE"</tt>).
|
483
|
+
</p>
|
484
|
+
</li>
|
485
|
+
<li>
|
486
|
+
<p>
|
487
|
+
Image block and inline macros prepend optional <tt>{imagesdir}</tt>
|
488
|
+
attribute to image link targets.
|
489
|
+
</p>
|
490
|
+
</li>
|
491
|
+
</ul></div>
|
492
|
+
<div class="ilist"><div class="title">Bug fixes</div><ul>
|
493
|
+
<li>
|
494
|
+
<p>
|
495
|
+
Fixed an assertion error that occurred when a configuration file
|
496
|
+
containing an <tt>include::[]</tt> macro was loaded using the
|
497
|
+
<tt>--conf-file</tt> option and the configuration file name did not
|
498
|
+
include an explicit directory path — patch submitted by Dmitry
|
499
|
+
Potapov.
|
500
|
+
</p>
|
501
|
+
</li>
|
502
|
+
<li>
|
503
|
+
<p>
|
504
|
+
Asciidoc titles are only converted to lower case if all characters
|
505
|
+
are upper case otherwise case is left unchanged — patch submitted
|
506
|
+
by Dmitry Potapov.
|
507
|
+
</p>
|
508
|
+
</li>
|
509
|
+
<li>
|
510
|
+
<p>
|
511
|
+
Added a missing check that input is not stdin before loading
|
512
|
+
configuration files from the document directory — patch submitted
|
513
|
+
by Dmitry Potapov.
|
514
|
+
</p>
|
515
|
+
</li>
|
516
|
+
<li>
|
517
|
+
<p>
|
518
|
+
Attribute list items must evaluate to strings, numbers or None
|
519
|
+
(previously it was possible to evaluate to other object types which
|
520
|
+
resulted in surprising attribute values).
|
521
|
+
</p>
|
522
|
+
</li>
|
523
|
+
<li>
|
524
|
+
<p>
|
525
|
+
If an <em>AsciiDoc</em> document has no title an empty XHTML 1.1 <em>title</em>
|
526
|
+
element is created — previously the <em>title</em> element was dropped
|
527
|
+
which resulted in invalid XHTML 1.1.
|
528
|
+
</p>
|
529
|
+
</li>
|
530
|
+
<li>
|
531
|
+
<p>
|
532
|
+
The Vim syntax file no longer highlights escaped callouts.
|
533
|
+
</p>
|
534
|
+
</li>
|
535
|
+
<li>
|
536
|
+
<p>
|
537
|
+
The Vim syntax highlighter now correctly highlights Double-dollar
|
538
|
+
passthroughs when they enclose dollar delimited ASCIIMathML and
|
539
|
+
LaTeXMathML formulas.
|
540
|
+
</p>
|
541
|
+
</li>
|
542
|
+
</ul></div>
|
543
|
+
</div>
|
544
|
+
<h2 id="_version_8_2_1_2007_04_06">Version 8.2.1 (2007-04-06)</h2>
|
545
|
+
<div class="sectionbody">
|
546
|
+
<div class="ilist"><div class="title">Additions and changes</div><ul>
|
547
|
+
<li>
|
548
|
+
<p>
|
549
|
+
A number of improvements have been made to the Vim syntax
|
550
|
+
highlighter, for example the word C++ is no longer mistaken for the
|
551
|
+
start of an unconstrained monospace quote.
|
552
|
+
</p>
|
553
|
+
</li>
|
554
|
+
<li>
|
555
|
+
<p>
|
556
|
+
Labeled list definitions have been tightened — a list label can no
|
557
|
+
longer containing trailing spaces. The following example is no
|
558
|
+
longer recognized as a valid list label:
|
559
|
+
</p>
|
560
|
+
<div class="literalblock">
|
561
|
+
<div class="content">
|
562
|
+
<pre><tt>Lorum ipsum ::</tt></pre>
|
563
|
+
</div></div>
|
564
|
+
<div class="para"><p>This change implements the originally intended behavior (as per the
|
565
|
+
<em>AsciiDoc</em> documentation and examples) so there should be very few
|
566
|
+
compatibility issues.</p></div>
|
567
|
+
</li>
|
568
|
+
</ul></div>
|
569
|
+
</div>
|
570
|
+
<h2 id="_version_8_2_0_2007_04_04">Version 8.2.0 (2007-04-04)</h2>
|
571
|
+
<div class="sectionbody">
|
572
|
+
<div class="ilist"><div class="title">Additions and changes</div><ul>
|
573
|
+
<li>
|
574
|
+
<p>
|
575
|
+
A Vim syntax file is now included in the <em>AsciiDoc</em> distribution
|
576
|
+
(inspired by Felix Obenhuber's <tt>asciidoc.vim</tt> script). You can find
|
577
|
+
it (along with a Vim filetype detection script in the distribution
|
578
|
+
<tt>./vim/</tt> directory (the scripts are installed automatically by the
|
579
|
+
<em>AsciiDoc</em> installer <tt>./install.sh</tt>). See <em>Appendix J</em> of the
|
580
|
+
<em><em>AsciiDoc</em> User Guide</em> for details.
|
581
|
+
</p>
|
582
|
+
</li>
|
583
|
+
<li>
|
584
|
+
<p>
|
585
|
+
Added <em>toclevel</em> attribute (1..4) which sets the number of title
|
586
|
+
levels reported in the table of contents. Defaults to 2 and must be
|
587
|
+
used with the <em>toc</em> attribute. Example usage:
|
588
|
+
</p>
|
589
|
+
<div class="literalblock">
|
590
|
+
<div class="content">
|
591
|
+
<pre><tt>$ asciidoc -a toc -a toclevels=3 doc/asciidoc.txt</tt></pre>
|
592
|
+
</div></div>
|
593
|
+
</li>
|
594
|
+
<li>
|
595
|
+
<p>
|
596
|
+
Added a <tt>listindex</tt> attribute which is the current list item index
|
597
|
+
(1..). If this attribute appears outside a list its value is the
|
598
|
+
number of items in the most recently closed list.
|
599
|
+
</p>
|
600
|
+
</li>
|
601
|
+
<li>
|
602
|
+
<p>
|
603
|
+
The single line titles syntax now accepts trailing suffixes — this
|
604
|
+
syntax matches the title line syntax of a number of popular Wiki
|
605
|
+
markups.
|
606
|
+
</p>
|
607
|
+
</li>
|
608
|
+
<li>
|
609
|
+
<p>
|
610
|
+
If a QuoteBlock has no attribution or citetitle then the DocBook
|
611
|
+
<tt><attribution></tt> element is not generated (previously generated empty
|
612
|
+
<tt><attribution></tt> element).
|
613
|
+
</p>
|
614
|
+
</li>
|
615
|
+
<li>
|
616
|
+
<p>
|
617
|
+
If the text of a labeled list item is blank then no <tt>texttag</tt> is
|
618
|
+
written.
|
619
|
+
</p>
|
620
|
+
</li>
|
621
|
+
<li>
|
622
|
+
<p>
|
623
|
+
An end of line backslash performs line continuation for horizontal
|
624
|
+
labeled list items.
|
625
|
+
</p>
|
626
|
+
</li>
|
627
|
+
<li>
|
628
|
+
<p>
|
629
|
+
The Revision line now accommodates Subversion <tt>$Id</tt> markers (in
|
630
|
+
addition to CVS and RCS markers). Thanks to Tiago Sturmer Daitx for
|
631
|
+
this patch.
|
632
|
+
</p>
|
633
|
+
</li>
|
634
|
+
<li>
|
635
|
+
<p>
|
636
|
+
Implemented <tt><tt>a2x(1)</tt></tt> option <tt>—skip-asciidoc</tt> which allows <tt><tt>a2x(1)</tt></tt>
|
637
|
+
to convert DocBook XML files not derived from <em>AsciiDoc</em> sources.
|
638
|
+
</p>
|
639
|
+
</li>
|
640
|
+
<li>
|
641
|
+
<p>
|
642
|
+
If <tt><tt>a2x(1)</tt> —doctype</tt> option is not specified it defaults to
|
643
|
+
<tt>manpage</tt> if <tt>—format=manpage</tt> else defaults to <tt>article</tt>
|
644
|
+
(previously <tt>—doctype</tt> always defaulted to <tt>article</tt>).
|
645
|
+
</p>
|
646
|
+
</li>
|
647
|
+
<li>
|
648
|
+
<p>
|
649
|
+
Added an <em>External Resources</em> section to the
|
650
|
+
<a href="http://www.methods.co.nz/asciidoc/index.html"><em>AsciiDoc</em> home page</a>.
|
651
|
+
</p>
|
652
|
+
</li>
|
653
|
+
</ul></div>
|
654
|
+
</div>
|
655
|
+
<h2 id="_version_8_1_0_2006_10_22">Version 8.1.0 (2006-10-22)</h2>
|
656
|
+
<div class="sectionbody">
|
657
|
+
<div class="ilist"><div class="title">Additions and changes</div><ul>
|
658
|
+
<li>
|
659
|
+
<p>
|
660
|
+
<em>AsciiDoc</em> generated XHTML documents now display a table of contents
|
661
|
+
if the <em>toc</em> attribute is defined (JavaScript needs to be enabled
|
662
|
+
for this to work). Thanks to Troy Hanson who contributed this
|
663
|
+
feature based on a JavaScript by Mihai Bazon. I've simplified things
|
664
|
+
somewhat to match Docbook XSL Stylesheets style, see Troy's
|
665
|
+
<a href="http://tpl.sourceforge.net/userguide.html">tpl User Guide</a> for a
|
666
|
+
fancier layout. Use the <tt>-a toc -a numbered</tt> command-line options to
|
667
|
+
produce a number table of contents.
|
668
|
+
</p>
|
669
|
+
</li>
|
670
|
+
<li>
|
671
|
+
<p>
|
672
|
+
A <a href="http://www.methods.co.nz/asciidoc/music-filter.html">music filter</a>
|
673
|
+
is included in the distribution <tt>./filters/</tt> directory. It
|
674
|
+
translates music in <a href="http://lilypond.org/">LilyPond</a> or
|
675
|
+
<a href="http://abcnotation.org.uk/">ABC</a> notation to standard classical
|
676
|
+
notation in the form of a trimmed PNG image which is inserted into
|
677
|
+
the <em>AsciiDoc</em> output document.
|
678
|
+
</p>
|
679
|
+
</li>
|
680
|
+
<li>
|
681
|
+
<p>
|
682
|
+
Incorporated Paul Melis's Win32 filter patch. This workaround
|
683
|
+
allows <em>AsciiDoc</em> to run filters under Windows.
|
684
|
+
</p>
|
685
|
+
</li>
|
686
|
+
<li>
|
687
|
+
<p>
|
688
|
+
Added <tt>uninstall.sh</tt> script.
|
689
|
+
</p>
|
690
|
+
</li>
|
691
|
+
<li>
|
692
|
+
<p>
|
693
|
+
Rather than proliferate a confusing number of filter block
|
694
|
+
delimiters the following convention has been adopted: delimiters
|
695
|
+
belonging to DelimitedBlock filters distributed with <em>AsciiDoc</em> will
|
696
|
+
consist of a word (normally a noun identifying the block content)
|
697
|
+
followed by four or more tilde characters. This has necessitated
|
698
|
+
changing existing filter delimiters (the old delimiters still work
|
699
|
+
but may be deprecated in future versions):
|
700
|
+
</p>
|
701
|
+
<div class="ilist"><ul>
|
702
|
+
<li>
|
703
|
+
<p>
|
704
|
+
The example code filter block delimiter is now the word <tt>code</tt>
|
705
|
+
followed by four or more tilde characters.
|
706
|
+
</p>
|
707
|
+
</li>
|
708
|
+
<li>
|
709
|
+
<p>
|
710
|
+
The source highlight filter block delimiter is now the word
|
711
|
+
<tt>source</tt> followed by four or more tilde characters.
|
712
|
+
</p>
|
713
|
+
</li>
|
714
|
+
</ul></div>
|
715
|
+
</li>
|
716
|
+
<li>
|
717
|
+
<p>
|
718
|
+
Conditionally redefined subscript and superscripting so they use the
|
719
|
+
old replacements mechanism when asciidoc7compatible is defined
|
720
|
+
rather than the asciidoc 8 default unconstrained quoting (patch for
|
721
|
+
affected files attached).
|
722
|
+
</p>
|
723
|
+
</li>
|
724
|
+
<li>
|
725
|
+
<p>
|
726
|
+
Moved the source highlight filter from <tt>./examples/</tt> to <tt>./filter/</tt>.
|
727
|
+
</p>
|
728
|
+
</li>
|
729
|
+
<li>
|
730
|
+
<p>
|
731
|
+
Added <tt>{verbose}</tt> intrinsic attribute (useful for passing verbose
|
732
|
+
flag to filters).
|
733
|
+
</p>
|
734
|
+
</li>
|
735
|
+
<li>
|
736
|
+
<p>
|
737
|
+
Added <tt>{outdir}</tt> intrinsic attribute.
|
738
|
+
</p>
|
739
|
+
</li>
|
740
|
+
<li>
|
741
|
+
<p>
|
742
|
+
Renamed <tt>{docdir}</tt> intrinsic attribute to unambiguous`{indir}<tt>
|
743
|
+
(</tt>{docdir}` still works but may be removed in future release).
|
744
|
+
</p>
|
745
|
+
</li>
|
746
|
+
<li>
|
747
|
+
<p>
|
748
|
+
If <tt><tt>asciidoc(1)</tt></tt> outputs to stdout then intrinsic attribute
|
749
|
+
<tt>{docname}</tt> is extracted from the input file name.
|
750
|
+
</p>
|
751
|
+
</li>
|
752
|
+
</ul></div>
|
753
|
+
</div>
|
754
|
+
<h2 id="_version_8_0_0_2006_08_27">Version 8.0.0 (2006-08-27)</h2>
|
755
|
+
<div class="sectionbody">
|
756
|
+
<div class="sidebarblock">
|
757
|
+
<div class="sidebar-content">
|
758
|
+
<div class="para"><p>This is a major release because changes to quoting and index entry
|
759
|
+
handling may break existing documents (see <em>Additions and changes</em>
|
760
|
+
below and <em>Appendix A: Migration Notes</em> in the <em>AsciiDoc</em> User Guide).</p></div>
|
761
|
+
<div class="para"><p>Please report any problems you encounter.</p></div>
|
762
|
+
<div class="para"><p><a href="mailto:srackham@gmail.com"><em>Stuart Rackham</em></a></p></div>
|
763
|
+
</div></div>
|
764
|
+
<div class="ilist"><div class="title">Additions and changes</div><ul>
|
765
|
+
<li>
|
766
|
+
<p>
|
767
|
+
Quoting can can occur within words (based on patch submitted by
|
768
|
+
Benjamin Klum). See the <em>Unconstrained Quotes</em> sub-section in the
|
769
|
+
User Guide.
|
770
|
+
</p>
|
771
|
+
</li>
|
772
|
+
<li>
|
773
|
+
<p>
|
774
|
+
The underline and plus characters can be used as alternatives to the
|
775
|
+
existing apostrophe and backtick quote characters. They are arguably
|
776
|
+
better choices than the apostrophe and backtick as they are not
|
777
|
+
confused with punctuation.
|
778
|
+
</p>
|
779
|
+
</li>
|
780
|
+
<li>
|
781
|
+
<p>
|
782
|
+
The syntax for index entry macros have have been deprecated from
|
783
|
+
<tt>+…+</tt> and <tt><tt>+…</tt>+</tt> to <tt>((…))</tt> and <tt>(((…)))</tt> respectively.
|
784
|
+
Rationale:
|
785
|
+
</p>
|
786
|
+
<div class="ilist"><ul>
|
787
|
+
<li>
|
788
|
+
<p>
|
789
|
+
Bracketing is consistent other with <tt>[[…]]</tt> and <tt><<…>></tt>
|
790
|
+
reference macros.
|
791
|
+
</p>
|
792
|
+
</li>
|
793
|
+
<li>
|
794
|
+
<p>
|
795
|
+
To easily confused with triple plus passthroughs.
|
796
|
+
</p>
|
797
|
+
</li>
|
798
|
+
<li>
|
799
|
+
<p>
|
800
|
+
To make way for the new monospace quoting.
|
801
|
+
</p>
|
802
|
+
</li>
|
803
|
+
</ul></div>
|
804
|
+
</li>
|
805
|
+
<li>
|
806
|
+
<p>
|
807
|
+
Superscripts and subscripts are implemented as constrained quotes so
|
808
|
+
they can now be escaped with a leading backslash and prefixed with
|
809
|
+
with an attribute list.
|
810
|
+
</p>
|
811
|
+
</li>
|
812
|
+
<li>
|
813
|
+
<p>
|
814
|
+
An experimental LaTeX backend has been written by Benjamin Klum (a
|
815
|
+
number additions in this release are to accommodate the LaTeX
|
816
|
+
backend).
|
817
|
+
</p>
|
818
|
+
</li>
|
819
|
+
<li>
|
820
|
+
<p>
|
821
|
+
<tt>include</tt> macro file names now expand environment variables and
|
822
|
+
tilde expansions.
|
823
|
+
</p>
|
824
|
+
</li>
|
825
|
+
<li>
|
826
|
+
<p>
|
827
|
+
A configuration file <tt>[quotes]</tt> entry can be undefined by setting to
|
828
|
+
a blank value.
|
829
|
+
</p>
|
830
|
+
</li>
|
831
|
+
<li>
|
832
|
+
<p>
|
833
|
+
Added <tt>callto</tt> inline macro for Skype <em>callto</em> links.
|
834
|
+
</p>
|
835
|
+
</li>
|
836
|
+
<li>
|
837
|
+
<p>
|
838
|
+
Added <tt>colnumber</tt> attribute for table data markup.
|
839
|
+
</p>
|
840
|
+
</li>
|
841
|
+
<li>
|
842
|
+
<p>
|
843
|
+
A leading comment block or comment lines are now skipped (previously
|
844
|
+
a document had to start with either attribute entries or a document
|
845
|
+
Title).
|
846
|
+
</p>
|
847
|
+
</li>
|
848
|
+
<li>
|
849
|
+
<p>
|
850
|
+
Experimental <tt>rows</tt> attribute (number of source lines in table)
|
851
|
+
available in table markup templates (used by experimental LaTeX
|
852
|
+
backend).
|
853
|
+
</p>
|
854
|
+
</li>
|
855
|
+
<li>
|
856
|
+
<p>
|
857
|
+
Included install shell script written by <a href="mailto:jlm@ofb.net">Jacob
|
858
|
+
Mandelson</a> for installing the tarball distribution.
|
859
|
+
</p>
|
860
|
+
</li>
|
861
|
+
<li>
|
862
|
+
<p>
|
863
|
+
Added INSTALL documentation file.
|
864
|
+
</p>
|
865
|
+
</li>
|
866
|
+
<li>
|
867
|
+
<p>
|
868
|
+
Added <em>replacements2</em> substitution options — a second replacements
|
869
|
+
section.
|
870
|
+
</p>
|
871
|
+
</li>
|
872
|
+
<li>
|
873
|
+
<p>
|
874
|
+
Added the ability to redefine <em>normal</em> and <em>verbatim</em> substitutions
|
875
|
+
with <tt>subsnormal</tt> and <tt>subsverbatim</tt> entries in configuration file
|
876
|
+
<tt>[miscellaneous]</tt> section.
|
877
|
+
</p>
|
878
|
+
</li>
|
879
|
+
<li>
|
880
|
+
<p>
|
881
|
+
By default <tt>AttributeEntry</tt> values are substituted for
|
882
|
+
<tt>specialcharacters</tt> and <tt>attributes</tt>, if you want a different
|
883
|
+
AttributeEntry substitution set the <tt>attributeentry-subs</tt> attribute.
|
884
|
+
</p>
|
885
|
+
</li>
|
886
|
+
<li>
|
887
|
+
<p>
|
888
|
+
The <tt>name</tt> in <tt>name=value</tt> configuration file entries can now end
|
889
|
+
with a backslash, just escape the trailing backslash with a
|
890
|
+
backslash. For example:
|
891
|
+
</p>
|
892
|
+
<div class="literalblock">
|
893
|
+
<div class="content">
|
894
|
+
<pre><tt>abc\\=xyz</tt></pre>
|
895
|
+
</div></div>
|
896
|
+
<div class="para"><p>Results in <tt>name=abc\</tt> and <tt>value=xyz</tt> — previously this would have
|
897
|
+
escaped the <tt>=</tt> character.</p></div>
|
898
|
+
</li>
|
899
|
+
<li>
|
900
|
+
<p>
|
901
|
+
A blank configuration file section deletes any preceding section
|
902
|
+
with the same name (applies to non-markup template sections).
|
903
|
+
</p>
|
904
|
+
</li>
|
905
|
+
<li>
|
906
|
+
<p>
|
907
|
+
A command-line attribute value with a <tt>@</tt> suffix does not override
|
908
|
+
existing document and configuration file attributes (normally
|
909
|
+
command-line attributes have precedence over document and
|
910
|
+
configuration file attributes).
|
911
|
+
</p>
|
912
|
+
</li>
|
913
|
+
<li>
|
914
|
+
<p>
|
915
|
+
<tt>localtime</tt> attribute is now encoded from the native system encoding
|
916
|
+
to the output encoding. Patch submitted by
|
917
|
+
<a href="mailto:m_pupil@yahoo.com.cn">FKtPp</a> — here's his description of the
|
918
|
+
problem:
|
919
|
+
</p>
|
920
|
+
<div class="para"><p>“I am a Chinese user of <em>AsciiDoc</em> and I find that when I use UTF-8
|
921
|
+
(the default encoding) to write asciidoc documents in Windows platform
|
922
|
+
the resulting html footer line will get screwed. It was caused by a
|
923
|
+
localized tzname that was always encoded in the windows native
|
924
|
+
encoding, which in my case is <em>cp936</em>.”</p></div>
|
925
|
+
</li>
|
926
|
+
<li>
|
927
|
+
<p>
|
928
|
+
<tt>a2x(1)</tt> can generate Open Document Text files using
|
929
|
+
<a href="http://open.comsultia.com/docbook2odf/">docbook2odf</a>. Currently
|
930
|
+
<tt>docbook2odf(1)</tt> only processes a subset of DocBook, unimplemented
|
931
|
+
elements are skipped.
|
932
|
+
</p>
|
933
|
+
</li>
|
934
|
+
<li>
|
935
|
+
<p>
|
936
|
+
The <tt>a2x(1)</tt> format option defaults to <tt>xhtml</tt> (previously a format
|
937
|
+
had to be specified explicitly).
|
938
|
+
</p>
|
939
|
+
</li>
|
940
|
+
<li>
|
941
|
+
<p>
|
942
|
+
The <tt>-d, --doctype=DOCTYPE</tt> option has been added to <tt>a2x(1)</tt> which
|
943
|
+
is a shortcut for <tt>--asciidoc-options="--doctype=DOCTYPE"</tt>.
|
944
|
+
</p>
|
945
|
+
</li>
|
946
|
+
<li>
|
947
|
+
<p>
|
948
|
+
Replaced <tt>a2x(1)</tt> <tt>--no-icons</tt> and <tt>--no-copy</tt> options with their
|
949
|
+
negated equivalents: <tt>--icons</tt> and <tt>--copy</tt> respectively. The
|
950
|
+
default behavior has also changed: copying and use of icons is
|
951
|
+
disabled by default. Rationale:
|
952
|
+
</p>
|
953
|
+
<div class="ilist"><ul>
|
954
|
+
<li>
|
955
|
+
<p>
|
956
|
+
To make the default behavior more consistent since use of icons
|
957
|
+
and CSS stylesheets does not apply to all formats.
|
958
|
+
</p>
|
959
|
+
</li>
|
960
|
+
<li>
|
961
|
+
<p>
|
962
|
+
To make the default behavior less surprising (the creation of icon
|
963
|
+
and stylesheet output files must now be explicit).
|
964
|
+
</p>
|
965
|
+
</li>
|
966
|
+
</ul></div>
|
967
|
+
</li>
|
968
|
+
<li>
|
969
|
+
<p>
|
970
|
+
<tt>a2x(1)</tt> has been bumped from version 0.1.1 to version 1.0.0.
|
971
|
+
</p>
|
972
|
+
</li>
|
973
|
+
</ul></div>
|
974
|
+
<div class="ilist"><div class="title">Bug fixes</div><ul>
|
975
|
+
<li>
|
976
|
+
<p>
|
977
|
+
Removed duplicate <tt>./doc/a2x.1.txt</tt> from distribution tarball.
|
978
|
+
</p>
|
979
|
+
</li>
|
980
|
+
<li>
|
981
|
+
<p>
|
982
|
+
Documentation errata.
|
983
|
+
</p>
|
984
|
+
</li>
|
985
|
+
<li>
|
986
|
+
<p>
|
987
|
+
Attribute replacement is no longer performed twice in Titles and
|
988
|
+
AttributeEntrys.
|
989
|
+
</p>
|
990
|
+
</li>
|
991
|
+
<li>
|
992
|
+
<p>
|
993
|
+
<tt>a2x(1)</tt> skipped <tt>asciidoc(1)</tt> execution when rerun with different
|
994
|
+
<tt>--asciidoc-options</tt> options, it now always executes <tt>asciidoc(1)</tt>.
|
995
|
+
The problem was that previously <tt>asciidoc(1)</tt> was executed only if the
|
996
|
+
output file was missing or older than the source file.
|
997
|
+
</p>
|
998
|
+
</li>
|
999
|
+
</ul></div>
|
1000
|
+
</div>
|
1001
|
+
<h2 id="_version_7_1_2_2006_03_07">Version 7.1.2 (2006-03-07)</h2>
|
1002
|
+
<div class="sectionbody">
|
1003
|
+
<div class="ilist"><div class="title">Additions and changes</div><ul>
|
1004
|
+
<li>
|
1005
|
+
<p>
|
1006
|
+
Support for
|
1007
|
+
<a href="http://www1.chapman.edu/~jipsen/mathml/asciimath.html">ASCIIMathML</a>
|
1008
|
+
has been added. See <em>Appendix I: ASCIIMathML Support</em> in the User
|
1009
|
+
Guide and the examples at
|
1010
|
+
<a href="http://www.methods.co.nz/asciidoc/asciimath.html">http://www.methods.co.nz/asciidoc/asciimath.html</a>.
|
1011
|
+
</p>
|
1012
|
+
</li>
|
1013
|
+
<li>
|
1014
|
+
<p>
|
1015
|
+
You can now prefix quoted text with inline attributes lists. You
|
1016
|
+
can use this to set font size and color (XHTML and HTML outputs).
|
1017
|
+
</p>
|
1018
|
+
</li>
|
1019
|
+
<li>
|
1020
|
+
<p>
|
1021
|
+
Added <tt>#…#</tt> quoting — it does nothing — it's purpose is to
|
1022
|
+
allow inline attributes to be applied to normal text.
|
1023
|
+
</p>
|
1024
|
+
</li>
|
1025
|
+
<li>
|
1026
|
+
<p>
|
1027
|
+
An <a href="userguide.html#X50">inline passthrough</a> mechanism has been
|
1028
|
+
implemented.
|
1029
|
+
</p>
|
1030
|
+
</li>
|
1031
|
+
<li>
|
1032
|
+
<p>
|
1033
|
+
Configuration file comment lines can be escaped with a backslash —
|
1034
|
+
this is to allows the inclusion of configuration lines that start
|
1035
|
+
with a hash character.
|
1036
|
+
</p>
|
1037
|
+
</li>
|
1038
|
+
<li>
|
1039
|
+
<p>
|
1040
|
+
The <tt>scriptsdir</tt> attribute can be used to specify the name of the
|
1041
|
+
directory containing linked JavaScripts (see the
|
1042
|
+
<a href="userguide.html#X33">User Guide</a> for details.
|
1043
|
+
</p>
|
1044
|
+
</li>
|
1045
|
+
<li>
|
1046
|
+
<p>
|
1047
|
+
The BackendBlock has been renamed PassthroughBlock for consistency
|
1048
|
+
with the new inline passthrough naming.
|
1049
|
+
</p>
|
1050
|
+
</li>
|
1051
|
+
<li>
|
1052
|
+
<p>
|
1053
|
+
<tt><tt>a2x(1)</tt></tt> now works with the older <tt>bash(1)</tt> version 2.05b. Patch
|
1054
|
+
submitted by <a href="mailto:francis@daoine.org">Francis Daly</a>.
|
1055
|
+
</p>
|
1056
|
+
</li>
|
1057
|
+
<li>
|
1058
|
+
<p>
|
1059
|
+
Content included by the <tt>include1::[]</tt> system macro is no longer
|
1060
|
+
subject to attribute substitution so that ambiguities no longer
|
1061
|
+
arise when used to include CSS or JavaScript files.
|
1062
|
+
</p>
|
1063
|
+
</li>
|
1064
|
+
</ul></div>
|
1065
|
+
</div>
|
1066
|
+
<h2 id="_version_7_1_1_2006_02_24">Version 7.1.1 (2006-02-24)</h2>
|
1067
|
+
<div class="sectionbody">
|
1068
|
+
<div class="ilist"><div class="title">Additions and changes</div><ul>
|
1069
|
+
<li>
|
1070
|
+
<p>
|
1071
|
+
The <tt>caption</tt> attribute can be used to customize admonition captions
|
1072
|
+
as well as image, table and example block element title prefixes
|
1073
|
+
(<tt>xhtml11</tt> and <tt>html4</tt> backends).
|
1074
|
+
</p>
|
1075
|
+
</li>
|
1076
|
+
<li>
|
1077
|
+
<p>
|
1078
|
+
You can now override the default icon image using the <tt>icon</tt>
|
1079
|
+
attribute to specify the path of the linked image (xhtml11 and html4
|
1080
|
+
backends only).
|
1081
|
+
</p>
|
1082
|
+
</li>
|
1083
|
+
<li>
|
1084
|
+
<p>
|
1085
|
+
The deprecated <tt>imagesdir</tt> attribute is no longer recognized (use
|
1086
|
+
<tt>iconsdir</tt> instead).
|
1087
|
+
</p>
|
1088
|
+
</li>
|
1089
|
+
<li>
|
1090
|
+
<p>
|
1091
|
+
Added <em>Appendix H: Using <em>AsciiDoc</em> with non-English Languages</em> to the
|
1092
|
+
<em>AsciiDoc</em> User Guide.
|
1093
|
+
</p>
|
1094
|
+
</li>
|
1095
|
+
<li>
|
1096
|
+
<p>
|
1097
|
+
Added <em>Admonition Icons and Captions</em> subsection to the User Guide
|
1098
|
+
explaining how to customize Admonition elements.
|
1099
|
+
</p>
|
1100
|
+
</li>
|
1101
|
+
</ul></div>
|
1102
|
+
<div class="ilist"><div class="title">Bug fixes</div><ul>
|
1103
|
+
<li>
|
1104
|
+
<p>
|
1105
|
+
<tt><tt>a2x(1)</tt></tt> failed when configuration files were installed in the
|
1106
|
+
global <tt>/etc/asciidoc/</tt> directory — it was only searching the
|
1107
|
+
directory containing the asciidoc executable (thanks to Christian
|
1108
|
+
Wiese for finding and submitting a patch this bug).
|
1109
|
+
</p>
|
1110
|
+
</li>
|
1111
|
+
<li>
|
1112
|
+
<p>
|
1113
|
+
The html4 backend admonition caption now correctly displays the
|
1114
|
+
admonition <tt>caption</tt> attribute (previously displayed the <tt>style</tt>
|
1115
|
+
attribute).
|
1116
|
+
</p>
|
1117
|
+
</li>
|
1118
|
+
</ul></div>
|
1119
|
+
</div>
|
1120
|
+
<h2 id="_version_7_1_0_2006_01_13">Version 7.1.0 (2006-01-13)</h2>
|
1121
|
+
<div class="sectionbody">
|
1122
|
+
<div class="ilist"><div class="title">Additions and changes</div><ul>
|
1123
|
+
<li>
|
1124
|
+
<p>
|
1125
|
+
<tt><tt>a2x(1)</tt></tt> toolchain wrapper utility. This overcomes the biggest
|
1126
|
+
hurdle for new users which seems to be assembling and using a
|
1127
|
+
working DocBook XML toolchain. With <tt><tt>a2x(1)</tt></tt> you can generate XHTML
|
1128
|
+
(chunked and unchunked), PDF, man page, HTML Help and text file
|
1129
|
+
outputs from an <em>AsciiDoc</em> input file with a single command. All you
|
1130
|
+
need to install (in addition to <em>AsciiDoc</em>) is xsltproc(1), DocBook XSL
|
1131
|
+
Stylesheets and optionally FOP (if you want PDF) or lynx(1) (if you
|
1132
|
+
want text).
|
1133
|
+
</p>
|
1134
|
+
</li>
|
1135
|
+
<li>
|
1136
|
+
<p>
|
1137
|
+
Block titles can now start with any non-space character (previously
|
1138
|
+
where not allowed to start with <tt>.~-_</tt> characters).
|
1139
|
+
</p>
|
1140
|
+
</li>
|
1141
|
+
<li>
|
1142
|
+
<p>
|
1143
|
+
<tt>./stylesheets/docbook.css</tt> renamed to
|
1144
|
+
<tt>./stylesheets/docbook-xsl.css</tt> to clarify its function.
|
1145
|
+
</p>
|
1146
|
+
</li>
|
1147
|
+
<li>
|
1148
|
+
<p>
|
1149
|
+
Renamed <tt>./docbook-xsl/manpages.xsl</tt> to <tt>./docbook-xsl/manpage.xsl</tt>
|
1150
|
+
for consistency.
|
1151
|
+
</p>
|
1152
|
+
</li>
|
1153
|
+
<li>
|
1154
|
+
<p>
|
1155
|
+
Admonition and navigation icons moved to <tt>./images/icons/</tt> to
|
1156
|
+
clarify usage and conform with <tt>a2x(1)</tt> usage.
|
1157
|
+
</p>
|
1158
|
+
</li>
|
1159
|
+
<li>
|
1160
|
+
<p>
|
1161
|
+
Renamed xhtml11 intrinsic attribute <tt>imagesdir</tt> to <tt>iconsdir</tt> to
|
1162
|
+
keep vocab consistent and changed default value to <tt>./images/icons</tt>
|
1163
|
+
(previously <tt>./images</tt>). <tt>imagesdir</tt> attribute still accepted but
|
1164
|
+
deprecated.
|
1165
|
+
</p>
|
1166
|
+
</li>
|
1167
|
+
<li>
|
1168
|
+
<p>
|
1169
|
+
Unused image files have been weeded out of the distribution.
|
1170
|
+
</p>
|
1171
|
+
</li>
|
1172
|
+
<li>
|
1173
|
+
<p>
|
1174
|
+
Packager notes (appendix B) have been updated to reflect the needs
|
1175
|
+
of <tt><tt>a2x(1)</tt></tt>.
|
1176
|
+
</p>
|
1177
|
+
</li>
|
1178
|
+
</ul></div>
|
1179
|
+
<div class="admonitionblock">
|
1180
|
+
<table><tr>
|
1181
|
+
<td class="icon">
|
1182
|
+
<img src="./images/icons/important.png" alt="Important" />
|
1183
|
+
</td>
|
1184
|
+
<td class="content">The renaming of the xhtml11 backend <tt>imagesdir</tt> intrinsic
|
1185
|
+
attribute and it's new default value introduces a backward
|
1186
|
+
compatibility issue: if you use the <tt>icons</tt> attribute you will need to
|
1187
|
+
either move your icons to the new default <tt>./images/icons</tt> location or
|
1188
|
+
include an <tt>—attribute iconsdir="your_icons_path"</tt> option in
|
1189
|
+
your asciidoc commands.</td>
|
1190
|
+
</tr></table>
|
1191
|
+
</div>
|
1192
|
+
<div class="ilist"><div class="title">Bug fixes</div><ul>
|
1193
|
+
<li>
|
1194
|
+
<p>
|
1195
|
+
Backslash line continuation is now observed in verbatim paragraphs.
|
1196
|
+
</p>
|
1197
|
+
</li>
|
1198
|
+
<li>
|
1199
|
+
<p>
|
1200
|
+
Fixed errors generated by example
|
1201
|
+
<tt>./examples/website/build-website.sh</tt> script.
|
1202
|
+
</p>
|
1203
|
+
</li>
|
1204
|
+
</ul></div>
|
1205
|
+
</div>
|
1206
|
+
<h2 id="_version_7_0_4_2005_12_08">Version 7.0.4 (2005-12-08)</h2>
|
1207
|
+
<div class="sectionbody">
|
1208
|
+
<div class="ilist"><div class="title">Additions and changes</div><ul>
|
1209
|
+
<li>
|
1210
|
+
<p>
|
1211
|
+
Added ternary conditional attributes
|
1212
|
+
<tt>{<name>@<regexp>:<value1>[:<value2>]}</tt> and
|
1213
|
+
<tt>{<name>$<regexp>:<value1>[:<value2>]}</tt>.
|
1214
|
+
</p>
|
1215
|
+
</li>
|
1216
|
+
<li>
|
1217
|
+
<p>
|
1218
|
+
Safety violations now generate errors (they previously generated
|
1219
|
+
warnings).
|
1220
|
+
</p>
|
1221
|
+
</li>
|
1222
|
+
<li>
|
1223
|
+
<p>
|
1224
|
+
<tt>asciidoc(1)</tt> now defaults to safe mode, consequently the
|
1225
|
+
<tt>[miscellaneous]</tt> safe mode entry and <tt>—safe</tt> command-line option
|
1226
|
+
are no longer necessary (though for backward compatibility
|
1227
|
+
<tt>asciidoc(1)</tt> still accepts the <tt>—safe</tt> option).
|
1228
|
+
</p>
|
1229
|
+
</li>
|
1230
|
+
<li>
|
1231
|
+
<p>
|
1232
|
+
Backend Blocks are now flagged unsafe (they could be used to include
|
1233
|
+
arbitrary and hence potentially unsafe output content).
|
1234
|
+
</p>
|
1235
|
+
</li>
|
1236
|
+
<li>
|
1237
|
+
<p>
|
1238
|
+
Filters are no longer considered unsafe. There's not much point in
|
1239
|
+
insisting on filter safety since the installation of an unsafe
|
1240
|
+
filter would require the introduction of new or modified
|
1241
|
+
configuration files — if your application configurations can be
|
1242
|
+
compromised you're in all sorts of trouble (safe mode protects
|
1243
|
+
against unsafe input files not unsafe configuration). As with all
|
1244
|
+
filters, before installing, you should verify that they can't be
|
1245
|
+
coerced into generating malicious output or exposing sensitive
|
1246
|
+
information.
|
1247
|
+
</p>
|
1248
|
+
</li>
|
1249
|
+
</ul></div>
|
1250
|
+
<div class="ilist"><div class="title">Bug fixes</div><ul>
|
1251
|
+
<li>
|
1252
|
+
<p>
|
1253
|
+
Fixed a lot of glaring grammatical and factual errors in the User
|
1254
|
+
Guide.
|
1255
|
+
</p>
|
1256
|
+
</li>
|
1257
|
+
</ul></div>
|
1258
|
+
</div>
|
1259
|
+
<h2 id="_version_7_0_3_2005_12_01">Version 7.0.3 (2005-12-01)</h2>
|
1260
|
+
<div class="sectionbody">
|
1261
|
+
<div class="ilist"><div class="title">Additions and changes</div><ul>
|
1262
|
+
<li>
|
1263
|
+
<p>
|
1264
|
+
Added <tt>—safe</tt> and <tt>—unsafe</tt> command-line options — <em>AsciiDoc</em> can
|
1265
|
+
now be executed in a <em>safe mode</em> which disallows the execution of
|
1266
|
+
arbitrary code or the inclusion of arbitrary files (see
|
1267
|
+
<a href="userguide.html#X39">Appendix C in the <em>AsciiDoc</em> User Guide</a>).
|
1268
|
+
</p>
|
1269
|
+
</li>
|
1270
|
+
<li>
|
1271
|
+
<p>
|
1272
|
+
Included <a href="source-highlight-filter.html">source-highlight filter</a>
|
1273
|
+
in the distribution <tt>./examples/source-highlight-filter/</tt> directory
|
1274
|
+
(based on filter submitted by <a href="mailto:trolocsis@gmail.com">Ryan
|
1275
|
+
Phillips</a>).
|
1276
|
+
</p>
|
1277
|
+
</li>
|
1278
|
+
<li>
|
1279
|
+
<p>
|
1280
|
+
Included the DocBook XSL Stylesheets 1.69.1 customizations used to
|
1281
|
+
generate the distributed <em>AsciiDoc</em> documentation (read the
|
1282
|
+
<tt>asciidoc-docbook-xsl.txt</tt> file in the distribution <tt>./docbook-xsl/</tt>
|
1283
|
+
directory).
|
1284
|
+
</p>
|
1285
|
+
</li>
|
1286
|
+
<li>
|
1287
|
+
<p>
|
1288
|
+
<em>AsciiDoc</em> DocBook XSL Stylesheet drivers moved from <tt>./doc/</tt> to
|
1289
|
+
<tt>./docbook-xsl/</tt>.
|
1290
|
+
</p>
|
1291
|
+
</li>
|
1292
|
+
<li>
|
1293
|
+
<p>
|
1294
|
+
Modified <tt>./doc/manpages.xsl</tt> so only URL content is displayed in
|
1295
|
+
manpages.
|
1296
|
+
</p>
|
1297
|
+
</li>
|
1298
|
+
</ul></div>
|
1299
|
+
<div class="ilist"><div class="title">Bug fixes</div><ul>
|
1300
|
+
<li>
|
1301
|
+
<p>
|
1302
|
+
Explicitly set table CSS border style (<tt>xhtml11</tt> backend) to <tt>solid</tt>
|
1303
|
+
because default border styles vary from browser to browser.
|
1304
|
+
</p>
|
1305
|
+
</li>
|
1306
|
+
</ul></div>
|
1307
|
+
</div>
|
1308
|
+
<h2 id="_version_7_0_2_2005_08_28">Version 7.0.2 (2005-08-28)</h2>
|
1309
|
+
<div class="sectionbody">
|
1310
|
+
<div class="ilist"><div class="title">Additions and changes</div><ul>
|
1311
|
+
<li>
|
1312
|
+
<p>
|
1313
|
+
There are now long versions of all <em>AsciiDoc</em> options.
|
1314
|
+
</p>
|
1315
|
+
</li>
|
1316
|
+
<li>
|
1317
|
+
<p>
|
1318
|
+
If the <tt>—backend</tt> is not specified it defaults to <tt>xhtml11</tt>.
|
1319
|
+
</p>
|
1320
|
+
</li>
|
1321
|
+
<li>
|
1322
|
+
<p>
|
1323
|
+
Added CSS simulated frames layout to the examples website (see
|
1324
|
+
<tt>./examples/website/layout2/README-website.txt</tt>). This layout does
|
1325
|
+
not work with IE6 and the original tables based layout is still the
|
1326
|
+
default.
|
1327
|
+
</p>
|
1328
|
+
</li>
|
1329
|
+
<li>
|
1330
|
+
<p>
|
1331
|
+
Support page added to <em>AsciiDoc</em> website.
|
1332
|
+
</p>
|
1333
|
+
</li>
|
1334
|
+
</ul></div>
|
1335
|
+
<div class="ilist"><div class="title">Bug fixes</div><ul>
|
1336
|
+
<li>
|
1337
|
+
<p>
|
1338
|
+
Invalid options are now trapped gracefully.
|
1339
|
+
</p>
|
1340
|
+
</li>
|
1341
|
+
<li>
|
1342
|
+
<p>
|
1343
|
+
Documentation errata.
|
1344
|
+
</p>
|
1345
|
+
</li>
|
1346
|
+
</ul></div>
|
1347
|
+
</div>
|
1348
|
+
<h2 id="_version_7_0_1_2005_06_24">Version 7.0.1 (2005-06-24)</h2>
|
1349
|
+
<div class="sectionbody">
|
1350
|
+
<div class="ilist"><div class="title">Additions and changes</div><ul>
|
1351
|
+
<li>
|
1352
|
+
<p>
|
1353
|
+
Reverted to use of <tt>strong</tt>, <tt>em</tt>, <tt>tt</tt> XHTML tags — they're more
|
1354
|
+
obvious and no less correct than <tt>span</tt> tags, besides, the generated
|
1355
|
+
file sizes are smaller (the <em>User Guide</em> was 11% smaller).
|
1356
|
+
</p>
|
1357
|
+
</li>
|
1358
|
+
<li>
|
1359
|
+
<p>
|
1360
|
+
Table title rendered with <tt>caption</tt> tag rather than a separate
|
1361
|
+
<tt>div</tt>.
|
1362
|
+
</p>
|
1363
|
+
</li>
|
1364
|
+
<li>
|
1365
|
+
<p>
|
1366
|
+
The <em>AsciiDoc</em> <em>stylesdir</em> attribute (if specified) is now recognized
|
1367
|
+
when searching for embedded stylesheets (previously only searched
|
1368
|
+
default <tt>./stylesheets</tt> directory).
|
1369
|
+
</p>
|
1370
|
+
</li>
|
1371
|
+
<li>
|
1372
|
+
<p>
|
1373
|
+
Default charset encoding changed from ISO-8859-1 to UTF-8 — it's
|
1374
|
+
less language specific and displays most common languages.
|
1375
|
+
</p>
|
1376
|
+
</li>
|
1377
|
+
<li>
|
1378
|
+
<p>
|
1379
|
+
<tt>template::[]</tt> macros now expand in all configuration file sections
|
1380
|
+
previously only in markup template sections.
|
1381
|
+
</p>
|
1382
|
+
</li>
|
1383
|
+
<li>
|
1384
|
+
<p>
|
1385
|
+
Cleaned up example website layout CSS and configuration
|
1386
|
+
(presentation has not been changed).
|
1387
|
+
</p>
|
1388
|
+
</li>
|
1389
|
+
<li>
|
1390
|
+
<p>
|
1391
|
+
Refactored <tt>xhtml11.conf</tt> configuration file.
|
1392
|
+
</p>
|
1393
|
+
</li>
|
1394
|
+
<li>
|
1395
|
+
<p>
|
1396
|
+
Set consistent and sensible permissions on distributed files.
|
1397
|
+
</p>
|
1398
|
+
</li>
|
1399
|
+
<li>
|
1400
|
+
<p>
|
1401
|
+
White space is now stripped from DSV formatted table cell data.
|
1402
|
+
</p>
|
1403
|
+
</li>
|
1404
|
+
<li>
|
1405
|
+
<p>
|
1406
|
+
<tt>class="tableblock"</tt> attribute added to tables generated by
|
1407
|
+
<tt>xhtml-deprecated-css.conf</tt> to assist CSS.
|
1408
|
+
</p>
|
1409
|
+
</li>
|
1410
|
+
</ul></div>
|
1411
|
+
<div class="ilist"><div class="title">Bug fixes</div><ul>
|
1412
|
+
<li>
|
1413
|
+
<p>
|
1414
|
+
Illegal character set encoder (specified by the <em>AsciiDoc</em> <tt>encoding</tt>
|
1415
|
+
attribute) and character data are trapped gracefully.
|
1416
|
+
</p>
|
1417
|
+
</li>
|
1418
|
+
<li>
|
1419
|
+
<p>
|
1420
|
+
<em>AsciiDoc</em> table <em>format</em> attribute in table attribute lists were not
|
1421
|
+
recognized.
|
1422
|
+
</p>
|
1423
|
+
</li>
|
1424
|
+
<li>
|
1425
|
+
<p>
|
1426
|
+
The nested horizontal labeled list example in the <em><em>AsciiDoc</em> User
|
1427
|
+
Guide</em> has been dropped — it generated invalid DocBook markup.
|
1428
|
+
</p>
|
1429
|
+
</li>
|
1430
|
+
</ul></div>
|
1431
|
+
</div>
|
1432
|
+
<h2 id="_version_7_0_0_2005_06_06">Version 7.0.0 (2005-06-06)</h2>
|
1433
|
+
<div class="sectionbody">
|
1434
|
+
<div class="sidebarblock">
|
1435
|
+
<div class="sidebar-content">
|
1436
|
+
<div class="para"><p>This is a major release with many code and
|
1437
|
+
documentation changes.
|
1438
|
+
Please report any problems you encounter.</p></div>
|
1439
|
+
<div class="para"><p><a href="mailto:srackham@gmail.com"><em>Stuart Rackham</em></a></p></div>
|
1440
|
+
</div></div>
|
1441
|
+
<div class="ilist"><div class="title">Additions and changes</div><ul>
|
1442
|
+
<li>
|
1443
|
+
<p>
|
1444
|
+
A new <em>xhtml11</em> backend generates XHTML 1.1 with integrated CSS2
|
1445
|
+
replacing the previous <em>xhtml</em>, <em>css</em>, and <em>css-embedded</em> backends.
|
1446
|
+
</p>
|
1447
|
+
</li>
|
1448
|
+
<li>
|
1449
|
+
<p>
|
1450
|
+
The CSS stylesheets have finally been rewritten.
|
1451
|
+
</p>
|
1452
|
+
</li>
|
1453
|
+
<li>
|
1454
|
+
<p>
|
1455
|
+
The <tt>asciidoc(1)</tt> command help now includes user
|
1456
|
+
<a href="userguide.html#X36">customizable help</a> topics. When asciidoc is
|
1457
|
+
invoked with the <tt>--help</tt> option the command argument is
|
1458
|
+
interpreted as a help topic.
|
1459
|
+
</p>
|
1460
|
+
</li>
|
1461
|
+
<li>
|
1462
|
+
<p>
|
1463
|
+
The previous example website has been replaced by the actual
|
1464
|
+
<em>AsciiDoc</em> website (see <tt>./examples/website/</tt>.
|
1465
|
+
</p>
|
1466
|
+
</li>
|
1467
|
+
<li>
|
1468
|
+
<p>
|
1469
|
+
XHTML generation options now controlled by the following attributes:
|
1470
|
+
<em>badges</em>, <em>linkcss</em>, <em>icons</em>, <em>numbered</em>, <em>quirks</em>, <em>theme</em>,
|
1471
|
+
<em>stylesdir</em>, <em>imagesdir</em> (see the <a href="userguide.html#X33">User
|
1472
|
+
Guide</a> for details.
|
1473
|
+
</p>
|
1474
|
+
</li>
|
1475
|
+
<li>
|
1476
|
+
<p>
|
1477
|
+
By default HTML and XHTML are output as stand-alone documents (no
|
1478
|
+
embedded CSS and no linked admonition icon images).
|
1479
|
+
</p>
|
1480
|
+
</li>
|
1481
|
+
<li>
|
1482
|
+
<p>
|
1483
|
+
Documents encoded with the UTF-8 Unicode character set are now
|
1484
|
+
processed thanks to a patch supplied by
|
1485
|
+
<a href="mailto:viktor@rbg.informatik.tu-darmstadt.de">Viktor Vasilev</a>.
|
1486
|
+
</p>
|
1487
|
+
</li>
|
1488
|
+
<li>
|
1489
|
+
<p>
|
1490
|
+
The <tt>-a ^name</tt> command-line syntax to undefine an attribute has been
|
1491
|
+
deprecated in favor of the <tt>-a name!</tt> syntax.
|
1492
|
+
</p>
|
1493
|
+
</li>
|
1494
|
+
<li>
|
1495
|
+
<p>
|
1496
|
+
AttributeEntry syntax addition: <tt>:name!:</tt> to undefine <tt>name</tt> attribute.
|
1497
|
+
</p>
|
1498
|
+
</li>
|
1499
|
+
<li>
|
1500
|
+
<p>
|
1501
|
+
Added <tt>template</tt> system block macro to allow the inclusion of one
|
1502
|
+
configuration file template section within another.
|
1503
|
+
</p>
|
1504
|
+
</li>
|
1505
|
+
<li>
|
1506
|
+
<p>
|
1507
|
+
A <em>verse</em> style attribute can now be applied to literal paragraphs
|
1508
|
+
and blocks to reproduce line breaks and white space from the source
|
1509
|
+
document.
|
1510
|
+
</p>
|
1511
|
+
</li>
|
1512
|
+
<li>
|
1513
|
+
<p>
|
1514
|
+
Replacements and Special Words can now be escaped with leading
|
1515
|
+
backslashes.
|
1516
|
+
</p>
|
1517
|
+
</li>
|
1518
|
+
<li>
|
1519
|
+
<p>
|
1520
|
+
Replacements are now processed in configuration file order (previous
|
1521
|
+
ordering was indeterminate).
|
1522
|
+
</p>
|
1523
|
+
</li>
|
1524
|
+
<li>
|
1525
|
+
<p>
|
1526
|
+
System macros can now be used in the base <tt>asciidoc.conf</tt>
|
1527
|
+
configuration file.
|
1528
|
+
</p>
|
1529
|
+
</li>
|
1530
|
+
<li>
|
1531
|
+
<p>
|
1532
|
+
Deprecated features that emitted warnings in prior versions are no
|
1533
|
+
longer tolerated.
|
1534
|
+
</p>
|
1535
|
+
</li>
|
1536
|
+
<li>
|
1537
|
+
<p>
|
1538
|
+
The <tt>eval</tt> system attribute expression evaluates to <tt>False</tt> the
|
1539
|
+
attribute is undefined, if it evaluates to <tt>True</tt> the result is an
|
1540
|
+
empty string.
|
1541
|
+
</p>
|
1542
|
+
</li>
|
1543
|
+
<li>
|
1544
|
+
<p>
|
1545
|
+
The Paragraph and DelimitedBlock <em>presubs</em> parameter can be aliased
|
1546
|
+
as <em>subs</em>.
|
1547
|
+
</p>
|
1548
|
+
</li>
|
1549
|
+
<li>
|
1550
|
+
<p>
|
1551
|
+
Added <em>verbatim</em> substitutions option.
|
1552
|
+
</p>
|
1553
|
+
</li>
|
1554
|
+
<li>
|
1555
|
+
<p>
|
1556
|
+
Renamed <em>List Continuation Block</em> to <em>List Block</em> and renamed the
|
1557
|
+
<em>listcontinuation</em> option to <em>list</em>.
|
1558
|
+
</p>
|
1559
|
+
</li>
|
1560
|
+
<li>
|
1561
|
+
<p>
|
1562
|
+
Deprecated <em>default</em> substitutions option (use <em>normal</em> instead).
|
1563
|
+
</p>
|
1564
|
+
</li>
|
1565
|
+
<li>
|
1566
|
+
<p>
|
1567
|
+
The <em>section-numbers</em> section numbering attribute has be renamed
|
1568
|
+
<em>numbered</em>.
|
1569
|
+
</p>
|
1570
|
+
</li>
|
1571
|
+
<li>
|
1572
|
+
<p>
|
1573
|
+
Dropped the <em>#UNDER CONSTRUCTION#</em> block macro.
|
1574
|
+
</p>
|
1575
|
+
</li>
|
1576
|
+
<li>
|
1577
|
+
<p>
|
1578
|
+
Rewrote Paragraph and DelimitedBlock handlers adding a
|
1579
|
+
<a href="userguide.html#X23">styles</a> configuration entry.
|
1580
|
+
</p>
|
1581
|
+
</li>
|
1582
|
+
</ul></div>
|
1583
|
+
<div class="ilist"><div class="title">Bug fixes</div><ul>
|
1584
|
+
<li>
|
1585
|
+
<p>
|
1586
|
+
Included files are no longer read inside conditionally excluded
|
1587
|
+
content.
|
1588
|
+
</p>
|
1589
|
+
</li>
|
1590
|
+
<li>
|
1591
|
+
<p>
|
1592
|
+
Manpage command names containing dashes (in the manpage NAME
|
1593
|
+
section) were misinterpreted as the spaced dash command name/purpose
|
1594
|
+
separator. Bug report and patch supplied by
|
1595
|
+
<a href="mailto:david@dgreaves.com">David Greaves</a>.
|
1596
|
+
</p>
|
1597
|
+
</li>
|
1598
|
+
<li>
|
1599
|
+
<p>
|
1600
|
+
Unexpected error following malformed author line error.
|
1601
|
+
</p>
|
1602
|
+
</li>
|
1603
|
+
</ul></div>
|
1604
|
+
</div>
|
1605
|
+
<h2 id="_version_6_0_3_2005_04_20">Version 6.0.3 (2005-04-20)</h2>
|
1606
|
+
<div class="sectionbody">
|
1607
|
+
<div class="ilist"><div class="title">Additions and changes</div><ul>
|
1608
|
+
<li>
|
1609
|
+
<p>
|
1610
|
+
Special characters are now substituted in AttributeEntry element
|
1611
|
+
values.
|
1612
|
+
</p>
|
1613
|
+
</li>
|
1614
|
+
<li>
|
1615
|
+
<p>
|
1616
|
+
Spaced and unspaced em dashes are now recognized (previously only
|
1617
|
+
spaced em dashes were recognized).
|
1618
|
+
</p>
|
1619
|
+
</li>
|
1620
|
+
<li>
|
1621
|
+
<p>
|
1622
|
+
Replaced the table <em>noborders</em> option with richer <em>frame</em> and <em>grid</em>
|
1623
|
+
attributes.
|
1624
|
+
</p>
|
1625
|
+
</li>
|
1626
|
+
<li>
|
1627
|
+
<p>
|
1628
|
+
The <tt>duplicate macro</tt> warning message now only occurs when the
|
1629
|
+
verbose (<tt>-v</tt>) option is enabled.
|
1630
|
+
</p>
|
1631
|
+
</li>
|
1632
|
+
<li>
|
1633
|
+
<p>
|
1634
|
+
Single lines starting with two forward slashes hard up against the
|
1635
|
+
left margin are treated as comments and are not processed.
|
1636
|
+
</p>
|
1637
|
+
</li>
|
1638
|
+
<li>
|
1639
|
+
<p>
|
1640
|
+
Renamed <em>section</em> delimited block option to <em>sectionbody</em> to more
|
1641
|
+
accurately reflect it's role.
|
1642
|
+
</p>
|
1643
|
+
</li>
|
1644
|
+
<li>
|
1645
|
+
<p>
|
1646
|
+
Added a List Continuation block — a specialized delimited block
|
1647
|
+
that is functionally equivalent to the List Item Continuation
|
1648
|
+
feature except that the list contained within the block does not
|
1649
|
+
require explicit <em>+</em> list item continuation lines.
|
1650
|
+
</p>
|
1651
|
+
</li>
|
1652
|
+
<li>
|
1653
|
+
<p>
|
1654
|
+
Dropped deprecated <tt><u></tt> tags from generated HTML.
|
1655
|
+
</p>
|
1656
|
+
</li>
|
1657
|
+
<li>
|
1658
|
+
<p>
|
1659
|
+
Literal Block delimiters must now consist of at least four points
|
1660
|
+
(previously three) to avoid lone ellipsis ambiguity.
|
1661
|
+
</p>
|
1662
|
+
</li>
|
1663
|
+
</ul></div>
|
1664
|
+
<div class="ilist"><div class="title">Bug fixes</div><ul>
|
1665
|
+
<li>
|
1666
|
+
<p>
|
1667
|
+
Some system attribute evaluation failures caused unexpected
|
1668
|
+
exceptions to occur.
|
1669
|
+
</p>
|
1670
|
+
</li>
|
1671
|
+
</ul></div>
|
1672
|
+
</div>
|
1673
|
+
<h2 id="_version_6_0_2_2005_03_30">Version 6.0.2 (2005-03-30)</h2>
|
1674
|
+
<div class="sectionbody">
|
1675
|
+
<div class="ilist"><div class="title">Additions and changes</div><ul>
|
1676
|
+
<li>
|
1677
|
+
<p>
|
1678
|
+
Three new <em>system</em> block macros have been added — <tt>eval</tt>, <tt>sys</tt> and
|
1679
|
+
<tt>sys2</tt> which are the block macro equivalents to the same named
|
1680
|
+
system attributes.
|
1681
|
+
</p>
|
1682
|
+
</li>
|
1683
|
+
<li>
|
1684
|
+
<p>
|
1685
|
+
<em>Intrinsic</em> macros have been renamed <em>system</em> macros along with
|
1686
|
+
<em>action</em> attributes which have been renamed <em>system</em> attributes:
|
1687
|
+
</p>
|
1688
|
+
<div class="ilist"><ul>
|
1689
|
+
<li>
|
1690
|
+
<p>
|
1691
|
+
To reflect their common (though contextually different) behavior.
|
1692
|
+
</p>
|
1693
|
+
</li>
|
1694
|
+
<li>
|
1695
|
+
<p>
|
1696
|
+
To avoid confusion with <em>intrinsic attributes</em>.
|
1697
|
+
</p>
|
1698
|
+
</li>
|
1699
|
+
</ul></div>
|
1700
|
+
</li>
|
1701
|
+
</ul></div>
|
1702
|
+
<div class="ilist"><div class="title">Bug fixes</div><ul>
|
1703
|
+
<li>
|
1704
|
+
<p>
|
1705
|
+
Asciidoc now searches in <tt>/etc/asciidoc/filters</tt> for filters.
|
1706
|
+
</p>
|
1707
|
+
</li>
|
1708
|
+
</ul></div>
|
1709
|
+
</div>
|
1710
|
+
<h2 id="_version_6_0_1_2005_03_06">Version 6.0.1 (2005-03-06)</h2>
|
1711
|
+
<div class="sectionbody">
|
1712
|
+
<div class="ilist"><div class="title">Additions and changes</div><ul>
|
1713
|
+
<li>
|
1714
|
+
<p>
|
1715
|
+
A global configuration file location <tt>/etc/asciidoc</tt> has been added
|
1716
|
+
and is now processed before all other locations (patch supplied by
|
1717
|
+
<a href="mailto:stone@debian.org">Fredrik Steen</a>).
|
1718
|
+
</p>
|
1719
|
+
</li>
|
1720
|
+
<li>
|
1721
|
+
<p>
|
1722
|
+
Recoded <tt>tempfile.mktemp()</tt> and other artifacts that are no longer
|
1723
|
+
necessary or desirable (patches supplied by
|
1724
|
+
<a href="mailto:stone@debian.org">Fredrik Steen</a>).
|
1725
|
+
</p>
|
1726
|
+
</li>
|
1727
|
+
<li>
|
1728
|
+
<p>
|
1729
|
+
Added BUGS file to the distribution.
|
1730
|
+
</p>
|
1731
|
+
</li>
|
1732
|
+
</ul></div>
|
1733
|
+
<div class="ilist"><div class="title">Bug fixes</div><ul>
|
1734
|
+
<li>
|
1735
|
+
<p>
|
1736
|
+
Illegal comment syntax in <tt>css-embedded-stylesheet.conf</tt> resulted in
|
1737
|
+
illegal CSS in files generated by the <tt>css-embedded</tt> backend.
|
1738
|
+
</p>
|
1739
|
+
</li>
|
1740
|
+
</ul></div>
|
1741
|
+
</div>
|
1742
|
+
<h2 id="_version_6_0_0_2005_01_28">Version 6.0.0 (2005-01-28)</h2>
|
1743
|
+
<div class="sectionbody">
|
1744
|
+
<div class="sidebarblock">
|
1745
|
+
<div class="sidebar-content">
|
1746
|
+
<div class="para"><p>This release has had some fairly major code and
|
1747
|
+
documentation changes. Please report any problems
|
1748
|
+
you encounter.</p></div>
|
1749
|
+
<div class="para"><p><a href="mailto:srackham@gmail.com"><em>Stuart Rackham</em></a></p></div>
|
1750
|
+
</div></div>
|
1751
|
+
<div class="para"><p>A lot of new stuff. A new major version number — some regression
|
1752
|
+
incompatibility (hopefully mitigated by <em>deprecated</em> warnings).</p></div>
|
1753
|
+
<div class="para"><p>Went mad trying to rein in the current feature anarchy — established
|
1754
|
+
a unified notion of document attributes. Attempted to introduce a
|
1755
|
+
consistent vocabulary — renamed many poorly or inconsistently named
|
1756
|
+
entities.</p></div>
|
1757
|
+
<div class="para"><p>Actually, deprecated syntax is still processed correctly in almost all
|
1758
|
+
cases. One source of incompatibility that may arise if you have
|
1759
|
+
customized CSS stylesheets is the change of <em>AsciiDoc</em> CSS class names
|
1760
|
+
(see below). I guess the moral is if you've done a lot of
|
1761
|
+
configuration file customization and are happy with version 5 then you
|
1762
|
+
may want to stay put.</p></div>
|
1763
|
+
<div class="admonitionblock">
|
1764
|
+
<table><tr>
|
1765
|
+
<td class="icon">
|
1766
|
+
<img src="./images/icons/note.png" alt="Note" />
|
1767
|
+
</td>
|
1768
|
+
<td class="content">This version requires Python 2.3 or better to run.</td>
|
1769
|
+
</tr></table>
|
1770
|
+
</div>
|
1771
|
+
<div class="ilist"><div class="title">Additions and changes</div><ul>
|
1772
|
+
<li>
|
1773
|
+
<p>
|
1774
|
+
<em>Glossary entries</em> have been renamed <em>attributes</em>. This eliminates
|
1775
|
+
confusion with the accepted meaning of glossary.
|
1776
|
+
</p>
|
1777
|
+
</li>
|
1778
|
+
<li>
|
1779
|
+
<p>
|
1780
|
+
An <tt>AttributeEntry</tt> block element has been added so that document
|
1781
|
+
attributes can be assigned from within an <em>AsciiDoc</em> document.
|
1782
|
+
</p>
|
1783
|
+
</li>
|
1784
|
+
<li>
|
1785
|
+
<p>
|
1786
|
+
The <tt>AttributeList</tt> block element has been added which is a more
|
1787
|
+
general solution than the (now deprecated) DelimitedBlock arguments.
|
1788
|
+
</p>
|
1789
|
+
</li>
|
1790
|
+
<li>
|
1791
|
+
<p>
|
1792
|
+
An BlockId element has been added for setting block element anchor
|
1793
|
+
(link target) IDs.
|
1794
|
+
</p>
|
1795
|
+
</li>
|
1796
|
+
<li>
|
1797
|
+
<p>
|
1798
|
+
Quoted text can now span multiple lines (thanks to James Bowlin for
|
1799
|
+
this patch).
|
1800
|
+
</p>
|
1801
|
+
</li>
|
1802
|
+
<li>
|
1803
|
+
<p>
|
1804
|
+
Inline macros can now span multiple lines.
|
1805
|
+
</p>
|
1806
|
+
</li>
|
1807
|
+
<li>
|
1808
|
+
<p>
|
1809
|
+
``double backtick / apostrophe'' quotes generate “curly quotes”.
|
1810
|
+
</p>
|
1811
|
+
</li>
|
1812
|
+
<li>
|
1813
|
+
<p>
|
1814
|
+
A warning is now emitted for out of order list item (applies to
|
1815
|
+
explicitly enumerated numbered list items).
|
1816
|
+
</p>
|
1817
|
+
</li>
|
1818
|
+
<li>
|
1819
|
+
<p>
|
1820
|
+
Added <tt>include</tt> action attribute.
|
1821
|
+
</p>
|
1822
|
+
</li>
|
1823
|
+
<li>
|
1824
|
+
<p>
|
1825
|
+
A line of three or more apostrophes generates an HTML horizontal
|
1826
|
+
ruler (<tt><hr/></tt> tag). You will get a warning if processed with
|
1827
|
+
non-HTML backend.
|
1828
|
+
</p>
|
1829
|
+
</li>
|
1830
|
+
<li>
|
1831
|
+
<p>
|
1832
|
+
An <tt>{imagesdir}</tt> attribute specifies image file location for images
|
1833
|
+
referenced in configuration files when generating HTML (the default
|
1834
|
+
location is <tt>images</tt>).
|
1835
|
+
</p>
|
1836
|
+
</li>
|
1837
|
+
<li>
|
1838
|
+
<p>
|
1839
|
+
An <tt>{stylesdir}</tt> attribute specifies the location of CSS
|
1840
|
+
stylesheets when generating styled HTML (the default location for
|
1841
|
+
configured markup is <tt>.</tt>).
|
1842
|
+
</p>
|
1843
|
+
</li>
|
1844
|
+
<li>
|
1845
|
+
<p>
|
1846
|
+
list entry has been deprecated, use <tt>{0}</tt> instead.
|
1847
|
+
</p>
|
1848
|
+
</li>
|
1849
|
+
<li>
|
1850
|
+
<p>
|
1851
|
+
New <em>ExampleBlock</em> delimited block along with associated variants
|
1852
|
+
Note, Tip, Warning, Caution and Important.
|
1853
|
+
</p>
|
1854
|
+
</li>
|
1855
|
+
<li>
|
1856
|
+
<p>
|
1857
|
+
The <tt>docbook.conf</tt> file now facilitates the optional inclusion of a
|
1858
|
+
DocBook revision history file.
|
1859
|
+
</p>
|
1860
|
+
</li>
|
1861
|
+
<li>
|
1862
|
+
<p>
|
1863
|
+
To better reflect their purpose the following block elements have
|
1864
|
+
been renamed: <tt>VerbatimBlock</tt> to <tt>ListingBlock</tt>; <tt>IndentedBlock</tt> to
|
1865
|
+
<tt>LiteralBlock</tt>; <tt>IndentedParagraph</tt> to <tt>LiteralParagraph</tt>;
|
1866
|
+
<tt>CustomBlock</tt> to <tt>BackendBlock</tt>; <tt>SimpleSection</tt> to <tt>SectionBody</tt>.
|
1867
|
+
Any corresponding CSS class names have also been changed which could
|
1868
|
+
result in backward incompatibility in customized stylesheets.
|
1869
|
+
</p>
|
1870
|
+
</li>
|
1871
|
+
<li>
|
1872
|
+
<p>
|
1873
|
+
Swapped plain DocBook admonition icons for Jimmac's DocBook icons
|
1874
|
+
(<a href="http://jimmac.musichall.cz/ikony.php3">http://jimmac.musichall.cz/ikony.php3</a>). The original plain icons
|
1875
|
+
have been moved to <tt>./images/plain</tt>.
|
1876
|
+
</p>
|
1877
|
+
</li>
|
1878
|
+
<li>
|
1879
|
+
<p>
|
1880
|
+
Renamed <tt>html</tt> backend to <tt>xhtml</tt> to better reflect it's function
|
1881
|
+
(former <tt>html-4</tt> backend renamed to <tt>html</tt>).
|
1882
|
+
</p>
|
1883
|
+
</li>
|
1884
|
+
<li>
|
1885
|
+
<p>
|
1886
|
+
A new inline anchor macro syntax <tt>[[[<id>]]]</tt> is available, it
|
1887
|
+
displays <tt>[<id>]</tt> at the anchor location and is for anchoring
|
1888
|
+
bibliography list entries.
|
1889
|
+
</p>
|
1890
|
+
</li>
|
1891
|
+
<li>
|
1892
|
+
<p>
|
1893
|
+
An optional <em>single-line titles</em> syntax can be used.
|
1894
|
+
</p>
|
1895
|
+
</li>
|
1896
|
+
<li>
|
1897
|
+
<p>
|
1898
|
+
Tweaks to distributed CSS stylesheets and FOP <tt>fo.xsl</tt> customization
|
1899
|
+
file.
|
1900
|
+
</p>
|
1901
|
+
</li>
|
1902
|
+
<li>
|
1903
|
+
<p>
|
1904
|
+
<em>List Item Continuation</em> has been implemented which allows
|
1905
|
+
additional block elements to be included in list items by separating
|
1906
|
+
them from the preceding list item element with a line containing a
|
1907
|
+
single plus character.
|
1908
|
+
</p>
|
1909
|
+
</li>
|
1910
|
+
<li>
|
1911
|
+
<p>
|
1912
|
+
A new <em>Horizontal Labeled List</em> list type has been added. Generates
|
1913
|
+
two column list — the first column contains the list element
|
1914
|
+
labels, the second contains the element text. Same syntax as
|
1915
|
+
<tt>Vertical Labeled Lists</tt> except the double colon label suffix is
|
1916
|
+
followed by the start of the list item text.
|
1917
|
+
</p>
|
1918
|
+
</li>
|
1919
|
+
</ul></div>
|
1920
|
+
<div class="ilist"><div class="title">Bug fixes</div><ul>
|
1921
|
+
<li>
|
1922
|
+
<p>
|
1923
|
+
Fixed broken backslash line continuation.
|
1924
|
+
</p>
|
1925
|
+
</li>
|
1926
|
+
<li>
|
1927
|
+
<p>
|
1928
|
+
Labeled list end tags were not undergoing attribute substitution.
|
1929
|
+
</p>
|
1930
|
+
</li>
|
1931
|
+
<li>
|
1932
|
+
<p>
|
1933
|
+
Documents without any author information now generate legitimate
|
1934
|
+
DocBook (previously if the author line was not included in the
|
1935
|
+
document header then an empty (illegal) DocBook <tt>author</tt> element was
|
1936
|
+
generated).
|
1937
|
+
</p>
|
1938
|
+
</li>
|
1939
|
+
<li>
|
1940
|
+
<p>
|
1941
|
+
Multiple spaces in filter command arguments were replaced by a
|
1942
|
+
single space. The <tt>./examples/asciidoc2text/asciidoc2text.sh</tt> script
|
1943
|
+
now indents text correctly.
|
1944
|
+
</p>
|
1945
|
+
</li>
|
1946
|
+
</ul></div>
|
1947
|
+
</div>
|
1948
|
+
<h2 id="_version_5_1_1_2004_10_10">Version 5.1.1 (2004-10-10)</h2>
|
1949
|
+
<div class="sectionbody">
|
1950
|
+
<div class="para"><p><strong>15-December-2004: Interim update:</strong> Updated <tt>asciidoc.py</tt> to fix
|
1951
|
+
broken <tt>join_lines</tt> function — no other changes.</p></div>
|
1952
|
+
<div class="ilist"><ul>
|
1953
|
+
<li>
|
1954
|
+
<p>
|
1955
|
+
PDF documentation is now produced from DocBook XML using XSLTLib and
|
1956
|
+
FOP. Previously we processed DocBook SGML with <tt>jw(1)</tt> (which used
|
1957
|
+
Dvips to convert DVI files to PDF). FOP has come a long way in the
|
1958
|
+
last 12 months and produces very acceptable PDF under both Linux and
|
1959
|
+
Windows.
|
1960
|
+
</p>
|
1961
|
+
</li>
|
1962
|
+
<li>
|
1963
|
+
<p>
|
1964
|
+
Sections detailing how to install and use the DocBook XSL
|
1965
|
+
Stylesheets, xsltproc, FOP toolchain and the <em>AsciiDoc</em> XSLT drivers
|
1966
|
+
have been added to the User Guide.
|
1967
|
+
</p>
|
1968
|
+
</li>
|
1969
|
+
<li>
|
1970
|
+
<p>
|
1971
|
+
The PDF output from the he example article template has been
|
1972
|
+
included in the distribution (<tt>./doc/article.pdf</tt>).
|
1973
|
+
</p>
|
1974
|
+
</li>
|
1975
|
+
<li>
|
1976
|
+
<p>
|
1977
|
+
Special characters are emitted using decimal Unicode character codes
|
1978
|
+
(previously used named character entities which cannot be assumed
|
1979
|
+
included in non-HTML documents).
|
1980
|
+
</p>
|
1981
|
+
</li>
|
1982
|
+
<li>
|
1983
|
+
<p>
|
1984
|
+
Added registered trademark ® to <tt>[replacements]</tt>.
|
1985
|
+
</p>
|
1986
|
+
</li>
|
1987
|
+
<li>
|
1988
|
+
<p>
|
1989
|
+
CSS stylesheet tweaks.
|
1990
|
+
</p>
|
1991
|
+
</li>
|
1992
|
+
<li>
|
1993
|
+
<p>
|
1994
|
+
Admonitions (Note, Tip, Important, Warning, Caution) include icons
|
1995
|
+
when generating css output.
|
1996
|
+
</p>
|
1997
|
+
</li>
|
1998
|
+
</ul></div>
|
1999
|
+
</div>
|
2000
|
+
<h2 id="_version_5_1_0_2004_09_18">Version 5.1.0 (2004-09-18)</h2>
|
2001
|
+
<div class="sectionbody">
|
2002
|
+
<div class="ilist"><ul>
|
2003
|
+
<li>
|
2004
|
+
<p>
|
2005
|
+
Callouts have been implemented (see the <em>Callouts</em> section of the
|
2006
|
+
<em>AsciiDoc</em> User Guide for details).
|
2007
|
+
</p>
|
2008
|
+
</li>
|
2009
|
+
<li>
|
2010
|
+
<p>
|
2011
|
+
Added XSL drivers for generating XHTML, chunked XHTML and HTML Help
|
2012
|
+
from DocBook XML using XSL stylesheets and xsltproc(1).
|
2013
|
+
</p>
|
2014
|
+
</li>
|
2015
|
+
<li>
|
2016
|
+
<p>
|
2017
|
+
Added CSS stylesheet for HTML generated from DocBook XML using XSL
|
2018
|
+
stylesheets.
|
2019
|
+
</p>
|
2020
|
+
</li>
|
2021
|
+
<li>
|
2022
|
+
<p>
|
2023
|
+
Distribution contains HTML Help formatted User Guide
|
2024
|
+
(<tt>./doc/asciidoc.chm</tt>), the User Guide tells you how it's generated.
|
2025
|
+
</p>
|
2026
|
+
</li>
|
2027
|
+
<li>
|
2028
|
+
<p>
|
2029
|
+
Images referred to by distributed stylesheets are now located in the
|
2030
|
+
<tt>./images</tt> subdirectory (previously located in <tt>.</tt>).
|
2031
|
+
</p>
|
2032
|
+
</li>
|
2033
|
+
<li>
|
2034
|
+
<p>
|
2035
|
+
Filters path names are now handled properly under Cygwin.
|
2036
|
+
</p>
|
2037
|
+
</li>
|
2038
|
+
<li>
|
2039
|
+
<p>
|
2040
|
+
The usual documentation and examples additions, updates and
|
2041
|
+
polishing.
|
2042
|
+
</p>
|
2043
|
+
</li>
|
2044
|
+
</ul></div>
|
2045
|
+
</div>
|
2046
|
+
<h2 id="_version_5_0_9_2004_09_09">Version 5.0.9 (2004-09-09)</h2>
|
2047
|
+
<div class="sectionbody">
|
2048
|
+
<div class="ilist"><ul>
|
2049
|
+
<li>
|
2050
|
+
<p>
|
2051
|
+
The convention of using a <tt>.asc</tt> file extension for <em>AsciiDoc</em> files
|
2052
|
+
has been dropped in favor of the familiar <tt>.txt</tt> extension. It makes
|
2053
|
+
more sense in that <em>AsciiDoc</em> is a text presentation format and
|
2054
|
+
because <tt>.asc</tt> clashed with the same extension used by other
|
2055
|
+
applications. It's only a naming convention — you don't have to
|
2056
|
+
switch if you don't want to.
|
2057
|
+
</p>
|
2058
|
+
</li>
|
2059
|
+
<li>
|
2060
|
+
<p>
|
2061
|
+
Changed the subscript formatting character from underline to tilde
|
2062
|
+
since underscores in file names are reasonably common (especially in
|
2063
|
+
link and image macros).
|
2064
|
+
</p>
|
2065
|
+
</li>
|
2066
|
+
<li>
|
2067
|
+
<p>
|
2068
|
+
An alternative syntax for the index term inline macro has been
|
2069
|
+
added: <tt><tt><primary>,<secondary>,<tertiary></tt></tt>.
|
2070
|
+
</p>
|
2071
|
+
</li>
|
2072
|
+
<li>
|
2073
|
+
<p>
|
2074
|
+
Index terms that have secondary and tertiary entries now
|
2075
|
+
additionally generate separate index terms for the secondary and
|
2076
|
+
tertiary entries.
|
2077
|
+
</p>
|
2078
|
+
</li>
|
2079
|
+
<li>
|
2080
|
+
<p>
|
2081
|
+
A <tt><tt><primary></tt></tt> index term inline macro has been added which
|
2082
|
+
displays the term in the primary text flow.
|
2083
|
+
</p>
|
2084
|
+
</li>
|
2085
|
+
<li>
|
2086
|
+
<p>
|
2087
|
+
Added alternative variable list definition using double semi-colon
|
2088
|
+
terminator as opposed to the standard double colon terminator so
|
2089
|
+
variable lists can be nested to two levels.
|
2090
|
+
</p>
|
2091
|
+
</li>
|
2092
|
+
<li>
|
2093
|
+
<p>
|
2094
|
+
Footnotes now appear on a separate line in HTML and Linuxdoc
|
2095
|
+
outputs.
|
2096
|
+
</p>
|
2097
|
+
</li>
|
2098
|
+
<li>
|
2099
|
+
<p>
|
2100
|
+
Python version compatibility is checked at startup.
|
2101
|
+
</p>
|
2102
|
+
</li>
|
2103
|
+
<li>
|
2104
|
+
<p>
|
2105
|
+
Preface and appendix section titles in multi-part Book documents are
|
2106
|
+
meant to be out of sequence — warnings are no longer emitted when
|
2107
|
+
outputting HTML.
|
2108
|
+
</p>
|
2109
|
+
</li>
|
2110
|
+
<li>
|
2111
|
+
<p>
|
2112
|
+
Empty section warnings have been replaced by error messages and are
|
2113
|
+
emitted only if invalid markup would result.
|
2114
|
+
</p>
|
2115
|
+
</li>
|
2116
|
+
<li>
|
2117
|
+
<p>
|
2118
|
+
Missing macro sections or invalid macro name warnings are only
|
2119
|
+
generated at startup if the <tt>-v</tt> (verbose) option is set. Otherwise
|
2120
|
+
they are deferred until a matching macro is encountered in the input
|
2121
|
+
file.
|
2122
|
+
</p>
|
2123
|
+
</li>
|
2124
|
+
<li>
|
2125
|
+
<p>
|
2126
|
+
Missing or invalid table definition warnings are only generated at
|
2127
|
+
startup if the <tt>-v</tt> (verbose) option is set. Otherwise they are
|
2128
|
+
deferred until a matching table is encountered in the input file.
|
2129
|
+
</p>
|
2130
|
+
</li>
|
2131
|
+
<li>
|
2132
|
+
<p>
|
2133
|
+
<em>AsciiDoc</em> now makes more of an effort to continue in the face of
|
2134
|
+
errors.
|
2135
|
+
</p>
|
2136
|
+
</li>
|
2137
|
+
<li>
|
2138
|
+
<p>
|
2139
|
+
Fixed broken <tt>./examples/website/main.aap</tt> script.
|
2140
|
+
</p>
|
2141
|
+
</li>
|
2142
|
+
<li>
|
2143
|
+
<p>
|
2144
|
+
Converted distribution text files DOS text format as a sop to
|
2145
|
+
Windows users with challenged text editors.
|
2146
|
+
</p>
|
2147
|
+
</li>
|
2148
|
+
<li>
|
2149
|
+
<p>
|
2150
|
+
Documentation additions and corrections.
|
2151
|
+
</p>
|
2152
|
+
</li>
|
2153
|
+
</ul></div>
|
2154
|
+
</div>
|
2155
|
+
<h2 id="_version_5_0_8_2004_05_15">Version 5.0.8 (2004-05-15)</h2>
|
2156
|
+
<div class="sectionbody">
|
2157
|
+
<div class="ilist"><ul>
|
2158
|
+
<li>
|
2159
|
+
<p>
|
2160
|
+
Spurious <em>out of sequence</em> level 2 warnings no longer appear when
|
2161
|
+
processing <em>book</em> document multi-part book top level Preface and
|
2162
|
+
Appendix sub-sections since they are (correctly) out of sequence.
|
2163
|
+
</p>
|
2164
|
+
</li>
|
2165
|
+
<li>
|
2166
|
+
<p>
|
2167
|
+
A warning is no longer emitted for empty Index sections since this
|
2168
|
+
is normal when generating DocBook outputs.
|
2169
|
+
</p>
|
2170
|
+
</li>
|
2171
|
+
<li>
|
2172
|
+
<p>
|
2173
|
+
Fixed: <tt>[quotes]</tt> configuration file entries where not being
|
2174
|
+
overridden by downstream configuration file entries.
|
2175
|
+
</p>
|
2176
|
+
</li>
|
2177
|
+
<li>
|
2178
|
+
<p>
|
2179
|
+
Footnote text is now output enclosed in square brackets in HTML
|
2180
|
+
documents.
|
2181
|
+
</p>
|
2182
|
+
</li>
|
2183
|
+
<li>
|
2184
|
+
<p>
|
2185
|
+
Added superscripts and subscripts to the standard PRS configuration
|
2186
|
+
files.
|
2187
|
+
</p>
|
2188
|
+
</li>
|
2189
|
+
<li>
|
2190
|
+
<p>
|
2191
|
+
Adjusted CSS stylesheets so list titles don't have so much space
|
2192
|
+
between title and first list item (broken in IE6 due to poor CSS
|
2193
|
+
compliance). Lessened sidebar title top margin.
|
2194
|
+
</p>
|
2195
|
+
</li>
|
2196
|
+
</ul></div>
|
2197
|
+
</div>
|
2198
|
+
<h2 id="_version_5_0_7_2004_04_22">Version 5.0.7 (2004-04-22)</h2>
|
2199
|
+
<div class="sectionbody">
|
2200
|
+
<div class="ilist"><ul>
|
2201
|
+
<li>
|
2202
|
+
<p>
|
2203
|
+
The version 5.0.6 README incorrectly stated that <em>AsciiDoc</em> would run
|
2204
|
+
under Python 2.0, in fact it requires Python 2.1 or better. The
|
2205
|
+
README has been corrected.
|
2206
|
+
</p>
|
2207
|
+
</li>
|
2208
|
+
<li>
|
2209
|
+
<p>
|
2210
|
+
Documented techniques for combining and splitting <em>AsciiDoc</em> documents
|
2211
|
+
and processing the combined and split parts (see the <em>Tips and
|
2212
|
+
Tricks</em> section of the User Guide).
|
2213
|
+
</p>
|
2214
|
+
</li>
|
2215
|
+
<li>
|
2216
|
+
<p>
|
2217
|
+
An example of marking up superscripts and subscripts is documented
|
2218
|
+
in the <em>Tips and Tricks</em> section of the User Guide (the example
|
2219
|
+
configuration file is in the <em>AsciiDoc</em> <tt>examples</tt> directory).
|
2220
|
+
</p>
|
2221
|
+
</li>
|
2222
|
+
<li>
|
2223
|
+
<p>
|
2224
|
+
Added ellipsis to shipped <tt>[replacements]</tt>; three periods output an
|
2225
|
+
ellipsis entity.
|
2226
|
+
</p>
|
2227
|
+
</li>
|
2228
|
+
<li>
|
2229
|
+
<p>
|
2230
|
+
Removed unused <em>SectionClose</em> class.
|
2231
|
+
</p>
|
2232
|
+
</li>
|
2233
|
+
<li>
|
2234
|
+
<p>
|
2235
|
+
The <em>AsciiDoc</em> <em>Preamble</em> element is output as a DocBook <em>Preface</em>
|
2236
|
+
when processed as a <em>book</em> document type (in older <em>AsciiDoc</em> versions
|
2237
|
+
a warning was issued and processing stopped).
|
2238
|
+
</p>
|
2239
|
+
</li>
|
2240
|
+
<li>
|
2241
|
+
<p>
|
2242
|
+
Fixed a quoting anomaly: quoted text can no longer begin or end with
|
2243
|
+
with white space.
|
2244
|
+
</p>
|
2245
|
+
</li>
|
2246
|
+
</ul></div>
|
2247
|
+
</div>
|
2248
|
+
<h2 id="_version_5_0_6_2004_03_07">Version 5.0.6 (2004-03-07)</h2>
|
2249
|
+
<div class="sectionbody">
|
2250
|
+
<div class="ilist"><ul>
|
2251
|
+
<li>
|
2252
|
+
<p>
|
2253
|
+
New <em>image</em> macro implements optional image scaling and linking and
|
2254
|
+
works in both inline and block contexts. The <em>image</em> macro obsolesces
|
2255
|
+
the existing <em>graphic</em> block macro and <em>icon</em> inline macro.
|
2256
|
+
</p>
|
2257
|
+
</li>
|
2258
|
+
<li>
|
2259
|
+
<p>
|
2260
|
+
Macro substitution section names now have <tt>-inlinemacro</tt> and
|
2261
|
+
<tt>-blockmacro</tt> suffixes to resolve context ambiguity, make their
|
2262
|
+
purpose clearer and relieve section namespace congestion.
|
2263
|
+
</p>
|
2264
|
+
</li>
|
2265
|
+
<li>
|
2266
|
+
<p>
|
2267
|
+
Header derived glossary entries can now be overridden from the
|
2268
|
+
command-line.
|
2269
|
+
</p>
|
2270
|
+
</li>
|
2271
|
+
<li>
|
2272
|
+
<p>
|
2273
|
+
Special character substitution is now performed on AuthorLine
|
2274
|
+
derived author names.
|
2275
|
+
</p>
|
2276
|
+
</li>
|
2277
|
+
<li>
|
2278
|
+
<p>
|
2279
|
+
A macro or block argument called <em>options</em> can be used as a shortcut
|
2280
|
+
for a list named arguments with zero length string values.
|
2281
|
+
</p>
|
2282
|
+
</li>
|
2283
|
+
<li>
|
2284
|
+
<p>
|
2285
|
+
Tables can be output without borders using the <tt>options="noborders"</tt>
|
2286
|
+
argument.
|
2287
|
+
</p>
|
2288
|
+
</li>
|
2289
|
+
<li>
|
2290
|
+
<p>
|
2291
|
+
Table data lines that do not immediately follow a table section
|
2292
|
+
underline can now be blank. This allows CSV data with embedded blank
|
2293
|
+
lines to be processed correctly.
|
2294
|
+
</p>
|
2295
|
+
</li>
|
2296
|
+
<li>
|
2297
|
+
<p>
|
2298
|
+
Blank DSV format table data lines are silently skipped.
|
2299
|
+
</p>
|
2300
|
+
</li>
|
2301
|
+
<li>
|
2302
|
+
<p>
|
2303
|
+
Tightened up on enforcement of configuration file section names to
|
2304
|
+
reduce the possibility of section content being seen as a section
|
2305
|
+
header line.
|
2306
|
+
</p>
|
2307
|
+
</li>
|
2308
|
+
<li>
|
2309
|
+
<p>
|
2310
|
+
Section titles can be optionally suffixed with title arguments
|
2311
|
+
enclosed in double square brackets.
|
2312
|
+
</p>
|
2313
|
+
</li>
|
2314
|
+
<li>
|
2315
|
+
<p>
|
2316
|
+
A replacement has been added to <tt>asciidoc.conf</tt> to replace inline
|
2317
|
+
double dashes with the <tt>&mdash;</tt> entity.
|
2318
|
+
</p>
|
2319
|
+
</li>
|
2320
|
+
<li>
|
2321
|
+
<p>
|
2322
|
+
Changed the <tt>.UNDER-CONSTRUCTION.</tt> macro syntax to
|
2323
|
+
<tt>#UNDER-CONSTRUCTION#</tt> so it is not mistaken for a BlockTitle.
|
2324
|
+
Similarly changed the <tt>.NEW.</tt> replacement with
|
2325
|
+
<tt>#NEW#</tt>.
|
2326
|
+
</p>
|
2327
|
+
</li>
|
2328
|
+
<li>
|
2329
|
+
<p>
|
2330
|
+
<tt>#NEW#</tt> and <tt>#UNDER-CONSTRUCTION#</tt> macros are now
|
2331
|
+
included in the DocBook backend.
|
2332
|
+
</p>
|
2333
|
+
</li>
|
2334
|
+
<li>
|
2335
|
+
<p>
|
2336
|
+
Replaced shipped <tt>smallnew.gif</tt> with <tt>smallnew.png</tt>.
|
2337
|
+
</p>
|
2338
|
+
</li>
|
2339
|
+
<li>
|
2340
|
+
<p>
|
2341
|
+
Documentation tidy ups.
|
2342
|
+
</p>
|
2343
|
+
</li>
|
2344
|
+
</ul></div>
|
2345
|
+
</div>
|
2346
|
+
<h2 id="_version_5_0_5_2004_02_25">Version 5.0.5 (2004-02-25)</h2>
|
2347
|
+
<div class="sectionbody">
|
2348
|
+
<div class="ilist"><ul>
|
2349
|
+
<li>
|
2350
|
+
<p>
|
2351
|
+
Fixed the disappearing paragraph titles problem that was caused by
|
2352
|
+
Inline macros (incorrectly) processing BlockTitles.
|
2353
|
+
</p>
|
2354
|
+
</li>
|
2355
|
+
<li>
|
2356
|
+
<p>
|
2357
|
+
Tightened AuthorLine validation. Previously invalid email addresses
|
2358
|
+
and embedded special characters in the AuthorLine resulted in
|
2359
|
+
invalid output markup.
|
2360
|
+
</p>
|
2361
|
+
</li>
|
2362
|
+
</ul></div>
|
2363
|
+
</div>
|
2364
|
+
<h2 id="_version_5_0_4_2004_02_09">Version 5.0.4 (2004-02-09)</h2>
|
2365
|
+
<div class="sectionbody">
|
2366
|
+
<div class="ilist"><ul>
|
2367
|
+
<li>
|
2368
|
+
<p>
|
2369
|
+
Reinstated missing <tt>infile</tt>, <tt>outfile</tt>, <tt>filetype</tt> and
|
2370
|
+
<tt>filetype-<filetype></tt> glossary entries.
|
2371
|
+
</p>
|
2372
|
+
</li>
|
2373
|
+
<li>
|
2374
|
+
<p>
|
2375
|
+
As of version 5.0.3 <tt>asciidoc(1)</tt> now requires Python 2.0 or greater,
|
2376
|
+
this has now been documented.
|
2377
|
+
</p>
|
2378
|
+
</li>
|
2379
|
+
</ul></div>
|
2380
|
+
</div>
|
2381
|
+
<h2 id="_version_5_0_3_2004_01_23">Version 5.0.3 (2004-01-23)</h2>
|
2382
|
+
<div class="sectionbody">
|
2383
|
+
<div class="ilist"><ul>
|
2384
|
+
<li>
|
2385
|
+
<p>
|
2386
|
+
Fixed problem that caused any filters directory file containing
|
2387
|
+
<tt>.conf</tt> (not just those with the <tt>.conf</tt> extension) from being
|
2388
|
+
loaded.
|
2389
|
+
</p>
|
2390
|
+
</li>
|
2391
|
+
<li>
|
2392
|
+
<p>
|
2393
|
+
All <tt>[miscellaneous]</tt> configuration file entries can now be
|
2394
|
+
referenced like glossary entries (they are now processed internally
|
2395
|
+
as glossary entries).
|
2396
|
+
</p>
|
2397
|
+
</li>
|
2398
|
+
<li>
|
2399
|
+
<p>
|
2400
|
+
The output file line terminator (previously hardwired to <tt>\r\n</tt> is
|
2401
|
+
now set using the <tt>newline</tt> entry in the configuration file
|
2402
|
+
<tt>[miscellaneous]</tt> section.
|
2403
|
+
</p>
|
2404
|
+
</li>
|
2405
|
+
<li>
|
2406
|
+
<p>
|
2407
|
+
The misspelt <tt>blocktitles</tt> configuration file entry name has been
|
2408
|
+
corrected (to <tt>blocktitle</tt>).
|
2409
|
+
</p>
|
2410
|
+
</li>
|
2411
|
+
<li>
|
2412
|
+
<p>
|
2413
|
+
An <tt>{empty}</tt> glossary entry has been added to the default
|
2414
|
+
configuration which is useful for outputting trailing blank lines
|
2415
|
+
from configuration file substitution sections.
|
2416
|
+
</p>
|
2417
|
+
</li>
|
2418
|
+
</ul></div>
|
2419
|
+
</div>
|
2420
|
+
<h2 id="_version_5_0_2_2003_12_18">Version 5.0.2 (2003-12-18)</h2>
|
2421
|
+
<div class="sectionbody">
|
2422
|
+
<div class="ilist"><ul>
|
2423
|
+
<li>
|
2424
|
+
<p>
|
2425
|
+
New (alternative) <em>anchor</em> and <em>xref</em> macro syntax (old syntax still
|
2426
|
+
valid).
|
2427
|
+
</p>
|
2428
|
+
</li>
|
2429
|
+
<li>
|
2430
|
+
<p>
|
2431
|
+
DocBook <tt>mediaobject</tt> and <tt>inlinemediaobject</tt> tags are generated in
|
2432
|
+
place of <tt>graphic</tt> and <tt>inlinegraphic</tt> tags by the <em>AsciiDoc</em>
|
2433
|
+
<tt>graphic</tt> and <tt>icon</tt> macros. If a macro argument is specified it is
|
2434
|
+
the alternative text output if the target document format does not
|
2435
|
+
support the specified graphic file format.
|
2436
|
+
</p>
|
2437
|
+
</li>
|
2438
|
+
<li>
|
2439
|
+
<p>
|
2440
|
+
Dropped the LinuxDoc left and right square bracket special character
|
2441
|
+
substitutions as they interfered with macro substitution.
|
2442
|
+
</p>
|
2443
|
+
</li>
|
2444
|
+
<li>
|
2445
|
+
<p>
|
2446
|
+
Documentation updates and corrections.
|
2447
|
+
</p>
|
2448
|
+
</li>
|
2449
|
+
</ul></div>
|
2450
|
+
</div>
|
2451
|
+
<h2 id="_version_5_0_1_2003_12_09">Version 5.0.1 (2003-12-09)</h2>
|
2452
|
+
<div class="sectionbody">
|
2453
|
+
<div class="ilist"><ul>
|
2454
|
+
<li>
|
2455
|
+
<p>
|
2456
|
+
Fixed problem with anchor tag when generating CSS styled HTML.
|
2457
|
+
</p>
|
2458
|
+
</li>
|
2459
|
+
</ul></div>
|
2460
|
+
</div>
|
2461
|
+
<h2 id="_version_5_0_2003_12_08">Version 5.0 (2003-12-08)</h2>
|
2462
|
+
<div class="sectionbody">
|
2463
|
+
<div class="sidebarblock">
|
2464
|
+
<div class="sidebar-content">
|
2465
|
+
<div class="para"><p>This release has had some fairly major code and
|
2466
|
+
documentation changes. Please report any problems
|
2467
|
+
you encounter.</p></div>
|
2468
|
+
<div class="para"><p><a href="mailto:srackham@gmail.com"><em>Stuart Rackham</em></a></p></div>
|
2469
|
+
</div></div>
|
2470
|
+
<div class="ilist"><ul>
|
2471
|
+
<li>
|
2472
|
+
<p>
|
2473
|
+
<em>AsciiDoc</em> can now produce a full-blown multi-part DocBook book
|
2474
|
+
including dedication, abstract, preface, colophon, glossary,
|
2475
|
+
appendix, bibliography and book part elements using the new
|
2476
|
+
<tt>specialsections</tt> configuration file section.
|
2477
|
+
</p>
|
2478
|
+
</li>
|
2479
|
+
<li>
|
2480
|
+
<p>
|
2481
|
+
All Section element children (Paragraph, DelimitedBlock, List,
|
2482
|
+
Table, BlockMacro) can now be titled using the BlockTitle element.
|
2483
|
+
A BlockTitle element is a single line containing a title and
|
2484
|
+
beginning with a period.
|
2485
|
+
</p>
|
2486
|
+
</li>
|
2487
|
+
<li>
|
2488
|
+
<p>
|
2489
|
+
The <tt>index</tt> and <tt>backmatter</tt> macros have been dropped, superseded by
|
2490
|
+
<tt>specialsections</tt>.
|
2491
|
+
</p>
|
2492
|
+
</li>
|
2493
|
+
<li>
|
2494
|
+
<p>
|
2495
|
+
The <em>AsciiDoc</em> <em>Preface</em> element has been renamed <em>Preamble</em> (to avoid
|
2496
|
+
confusion with the DocBook book preface element).
|
2497
|
+
</p>
|
2498
|
+
</li>
|
2499
|
+
<li>
|
2500
|
+
<p>
|
2501
|
+
Out of sequence titles are now tolerated with a warning. This allows
|
2502
|
+
book document level 0 sections to be processed.
|
2503
|
+
</p>
|
2504
|
+
</li>
|
2505
|
+
<li>
|
2506
|
+
<p>
|
2507
|
+
An <em>anchor</em> inline macro has been added for document link target
|
2508
|
+
creation.
|
2509
|
+
</p>
|
2510
|
+
</li>
|
2511
|
+
<li>
|
2512
|
+
<p>
|
2513
|
+
<em>Note</em>, <em>Tip</em>, <em>Important</em> and <em>Warning</em> paragraph types have been
|
2514
|
+
added to support the corresponding DocBook elements.
|
2515
|
+
</p>
|
2516
|
+
</li>
|
2517
|
+
<li>
|
2518
|
+
<p>
|
2519
|
+
Title substitution is now performed in SidebarBlock titles.
|
2520
|
+
</p>
|
2521
|
+
</li>
|
2522
|
+
<li>
|
2523
|
+
<p>
|
2524
|
+
DocBook graphics now output as <tt>figure</tt> and <tt>informalfigure</tt>
|
2525
|
+
elements rather than <tt>mediaobjects</tt>. This ensures numbered figures
|
2526
|
+
and a lists of figures are produced by the DocBook toolchain.
|
2527
|
+
</p>
|
2528
|
+
</li>
|
2529
|
+
<li>
|
2530
|
+
<p>
|
2531
|
+
You can now escape block argument lines by appending a backslash.
|
2532
|
+
Alternatively, if you embed arguments in the delimiter line <em>AsciiDoc</em>
|
2533
|
+
does not check for an arguments line.
|
2534
|
+
</p>
|
2535
|
+
</li>
|
2536
|
+
<li>
|
2537
|
+
<p>
|
2538
|
+
The default DocBook backend file extension has been changed from
|
2539
|
+
<tt>.docbook</tt> to <tt>.xml</tt> (<tt>.sgml</tt> for the <em>docbook-sgml</em> backend).
|
2540
|
+
</p>
|
2541
|
+
</li>
|
2542
|
+
<li>
|
2543
|
+
<p>
|
2544
|
+
Warnings are output by default (previously they only printed when
|
2545
|
+
verbose option enabled).
|
2546
|
+
</p>
|
2547
|
+
</li>
|
2548
|
+
<li>
|
2549
|
+
<p>
|
2550
|
+
A Question and Answer variable list definition has been added to the
|
2551
|
+
shipped configuration files, primarily to create DocBook <tt>qanda</tt>
|
2552
|
+
DocBook elements.
|
2553
|
+
</p>
|
2554
|
+
</li>
|
2555
|
+
<li>
|
2556
|
+
<p>
|
2557
|
+
Fixed broken code-filter <tt>-b linuxdoc</tt> option. The asciidoc.asc User
|
2558
|
+
Guide can now be processed by linuxdoc(1) (although tables are
|
2559
|
+
dropped because LinuxDoc does not implement tables).
|
2560
|
+
</p>
|
2561
|
+
</li>
|
2562
|
+
</ul></div>
|
2563
|
+
<div class="olist"><div class="title">Compatibility issues:</div><ol>
|
2564
|
+
<li>
|
2565
|
+
<p>
|
2566
|
+
Table titles are no longer in the arguments line, use the new
|
2567
|
+
BlockTitles.
|
2568
|
+
</p>
|
2569
|
+
</li>
|
2570
|
+
<li>
|
2571
|
+
<p>
|
2572
|
+
Graphic titles are no longer in the <em>graphic</em> block macro caption,
|
2573
|
+
use the new BlockTitles.
|
2574
|
+
</p>
|
2575
|
+
</li>
|
2576
|
+
<li>
|
2577
|
+
<p>
|
2578
|
+
The code-filter title must be placed in a preceding BlockTitle.
|
2579
|
+
</p>
|
2580
|
+
</li>
|
2581
|
+
<li>
|
2582
|
+
<p>
|
2583
|
+
SidebarBlock titles must be placed in a preceding BlockTitle.
|
2584
|
+
</p>
|
2585
|
+
</li>
|
2586
|
+
<li>
|
2587
|
+
<p>
|
2588
|
+
The DelimitedBlock option <em>sidebar</em> has been renamed to <em>section</em>.
|
2589
|
+
</p>
|
2590
|
+
</li>
|
2591
|
+
<li>
|
2592
|
+
<p>
|
2593
|
+
The default DocBook backend file extension has been changed from
|
2594
|
+
<tt>.docbook</tt> to <tt>.xml</tt> (<tt>.sgml</tt> for the <em>docbook-sgml</em> backend).
|
2595
|
+
</p>
|
2596
|
+
</li>
|
2597
|
+
</ol></div>
|
2598
|
+
</div>
|
2599
|
+
<h2 id="_version_4_2_2003_11_26">Version 4.2 (2003-11-26)</h2>
|
2600
|
+
<div class="sectionbody">
|
2601
|
+
<div class="ilist"><ul>
|
2602
|
+
<li>
|
2603
|
+
<p>
|
2604
|
+
The default HTML output is now XHTML 1.0 markup. To output the
|
2605
|
+
former HTML 4 markup specify the <tt>html-4</tt> backend.
|
2606
|
+
</p>
|
2607
|
+
</li>
|
2608
|
+
<li>
|
2609
|
+
<p>
|
2610
|
+
The default DocBook output is now DocBook XML. To output the former
|
2611
|
+
DocBook SGML specify the <tt>docbook-sgml</tt> backend. The associated
|
2612
|
+
<tt>docbook-sgml.conf</tt> file illustrates how to support minor DTD
|
2613
|
+
variations. Examples of using the <tt>xmlto(1)</tt> command for DocBook
|
2614
|
+
conversion have been added to the User Guide.
|
2615
|
+
</p>
|
2616
|
+
</li>
|
2617
|
+
<li>
|
2618
|
+
<p>
|
2619
|
+
Glossary entries set using the command-line -g option can now be
|
2620
|
+
referenced in configuration files.
|
2621
|
+
</p>
|
2622
|
+
</li>
|
2623
|
+
<li>
|
2624
|
+
<p>
|
2625
|
+
Configuration dumps (<tt>-c</tt> command-line option) no longer output
|
2626
|
+
redundant undefined glossary entries.
|
2627
|
+
</p>
|
2628
|
+
</li>
|
2629
|
+
<li>
|
2630
|
+
<p>
|
2631
|
+
DelimitedBlock arguments can now be specified in a separate arguments
|
2632
|
+
line immediately following the leading delimiter line, This is in
|
2633
|
+
preference to the existing delimiter embedded arguments. Reasons:
|
2634
|
+
</p>
|
2635
|
+
<div class="ilist"><ul>
|
2636
|
+
<li>
|
2637
|
+
<p>
|
2638
|
+
The syntax is in keeping with the Tables arguments syntax.
|
2639
|
+
</p>
|
2640
|
+
</li>
|
2641
|
+
<li>
|
2642
|
+
<p>
|
2643
|
+
It's easier to enter and implements line continuation.
|
2644
|
+
</p>
|
2645
|
+
</li>
|
2646
|
+
</ul></div>
|
2647
|
+
</li>
|
2648
|
+
<li>
|
2649
|
+
<p>
|
2650
|
+
A new QuoteBlock DelimitedBlock definition has been added to the
|
2651
|
+
distribution configuration files.
|
2652
|
+
</p>
|
2653
|
+
</li>
|
2654
|
+
<li>
|
2655
|
+
<p>
|
2656
|
+
The table arguments lines can be continued using the backslash line
|
2657
|
+
continuation character.
|
2658
|
+
</p>
|
2659
|
+
</li>
|
2660
|
+
<li>
|
2661
|
+
<p>
|
2662
|
+
Added new calculated glossary reference type <tt>{<name>%<value>}</tt>.
|
2663
|
+
</p>
|
2664
|
+
</li>
|
2665
|
+
<li>
|
2666
|
+
<p>
|
2667
|
+
Double-quote characters can now appear in unquoted positional
|
2668
|
+
arguments.
|
2669
|
+
</p>
|
2670
|
+
</li>
|
2671
|
+
</ul></div>
|
2672
|
+
</div>
|
2673
|
+
<h2 id="_version_4_1_2003_11_13">Version 4.1 (2003-11-13)</h2>
|
2674
|
+
<div class="sectionbody">
|
2675
|
+
<div class="ilist"><ul>
|
2676
|
+
<li>
|
2677
|
+
<p>
|
2678
|
+
Added DSV (Delimiter Separated Values) tables format.
|
2679
|
+
</p>
|
2680
|
+
</li>
|
2681
|
+
<li>
|
2682
|
+
<p>
|
2683
|
+
<tt>{eval:<expr>}</tt> glossary references drop the containing line if
|
2684
|
+
<tt><expr></tt> evaluates to <tt>None</tt>.
|
2685
|
+
</p>
|
2686
|
+
</li>
|
2687
|
+
<li>
|
2688
|
+
<p>
|
2689
|
+
Block, Table and Macro arguments can now be positional (quoted or
|
2690
|
+
unquoted).
|
2691
|
+
</p>
|
2692
|
+
</li>
|
2693
|
+
<li>
|
2694
|
+
<p>
|
2695
|
+
Vocabulary change: DelimitedBlock, Table and Macro <em>attributes</em> are
|
2696
|
+
now referred to as <em>arguments</em>. This makes more sense in light of the
|
2697
|
+
extended syntax and avoids confusion with backend markup tag
|
2698
|
+
attributes.
|
2699
|
+
</p>
|
2700
|
+
</li>
|
2701
|
+
<li>
|
2702
|
+
<p>
|
2703
|
+
<em>tablewidth</em> table ruler parameter can now be expressed in percent
|
2704
|
+
units (0..100). If between 0 and 1 then the original fractional unit
|
2705
|
+
measure is applied.
|
2706
|
+
</p>
|
2707
|
+
</li>
|
2708
|
+
<li>
|
2709
|
+
<p>
|
2710
|
+
The use of quoting for generating footnotes and index entries has
|
2711
|
+
been dropped in favor of <em>footnote</em> and <em>indexterm</em> inline macros.
|
2712
|
+
</p>
|
2713
|
+
</li>
|
2714
|
+
<li>
|
2715
|
+
<p>
|
2716
|
+
<em>backmatter</em> inline macro included in distribution.
|
2717
|
+
</p>
|
2718
|
+
</li>
|
2719
|
+
<li>
|
2720
|
+
<p>
|
2721
|
+
Fixed: CSS styled HTML tables are now fully XHTML 1.0 conformant.
|
2722
|
+
</p>
|
2723
|
+
</li>
|
2724
|
+
<li>
|
2725
|
+
<p>
|
2726
|
+
Fixed: <em>tablewidth</em> was processed incorrectly when passed as table
|
2727
|
+
argument.
|
2728
|
+
</p>
|
2729
|
+
</li>
|
2730
|
+
<li>
|
2731
|
+
<p>
|
2732
|
+
Fixed: Glossary references like <tt>{x={y}}</tt> were one character off
|
2733
|
+
if {x] was defined and <tt>{y}</tt> was not.
|
2734
|
+
</p>
|
2735
|
+
</li>
|
2736
|
+
</ul></div>
|
2737
|
+
</div>
|
2738
|
+
<h2 id="_version_4_0_2003_11_08">Version 4.0 (2003-11-08)</h2>
|
2739
|
+
<div class="sectionbody">
|
2740
|
+
<div class="sidebarblock">
|
2741
|
+
<div class="sidebar-content">
|
2742
|
+
<div class="para"><p>This release has had some fairly major code and
|
2743
|
+
documentation changes. Please report any problems
|
2744
|
+
you encounter.</p></div>
|
2745
|
+
<div class="para"><p><em>Stuart Rackham</em></p></div>
|
2746
|
+
</div></div>
|
2747
|
+
<div class="ilist"><ul>
|
2748
|
+
<li>
|
2749
|
+
<p>
|
2750
|
+
Added tables to <em>AsciiDoc</em>.
|
2751
|
+
</p>
|
2752
|
+
</li>
|
2753
|
+
<li>
|
2754
|
+
<p>
|
2755
|
+
Added two special <em>subs</em> options: <em>default</em> specifies the default
|
2756
|
+
substitution options and <em>none</em> specifies no substitution. These
|
2757
|
+
options can only appear singly.
|
2758
|
+
</p>
|
2759
|
+
</li>
|
2760
|
+
<li>
|
2761
|
+
<p>
|
2762
|
+
Line continuation using a trailing backslash character is available
|
2763
|
+
in Paragraphs, ListItems, Tables.
|
2764
|
+
</p>
|
2765
|
+
</li>
|
2766
|
+
<li>
|
2767
|
+
<p>
|
2768
|
+
The left and right quotes for quoted text can now be specified
|
2769
|
+
separately.
|
2770
|
+
</p>
|
2771
|
+
</li>
|
2772
|
+
<li>
|
2773
|
+
<p>
|
2774
|
+
Shipped configuration files implement footnotes (only useful for
|
2775
|
+
DocBook output) using \[[]] quoting.
|
2776
|
+
</p>
|
2777
|
+
</li>
|
2778
|
+
<li>
|
2779
|
+
<p>
|
2780
|
+
Shipped configuration files implement index terms (only useful for
|
2781
|
+
DocBook and LinuxDoc output) using \(()) quoting.
|
2782
|
+
</p>
|
2783
|
+
</li>
|
2784
|
+
<li>
|
2785
|
+
<p>
|
2786
|
+
The shipped <em>html</em> backend configuration now emits valid <em>HTML 4.01
|
2787
|
+
Transitional</em>.
|
2788
|
+
</p>
|
2789
|
+
</li>
|
2790
|
+
<li>
|
2791
|
+
<p>
|
2792
|
+
Added new calculated glossary reference types <tt>{<name>!<value>}</tt>
|
2793
|
+
and <tt>{<name>#<value>}</tt>.
|
2794
|
+
</p>
|
2795
|
+
</li>
|
2796
|
+
<li>
|
2797
|
+
<p>
|
2798
|
+
The DelimitedBlock <em>params</em> option has been dropped in favor of the
|
2799
|
+
new <em>block attributes</em> mechanism. If you have customized block
|
2800
|
+
params options you may need to adjust source files to use the
|
2801
|
+
<em>block attributes</em> syntax. The example code filter has been updated
|
2802
|
+
to reflect these changes.
|
2803
|
+
</p>
|
2804
|
+
</li>
|
2805
|
+
<li>
|
2806
|
+
<p>
|
2807
|
+
The code filter now has a <tt>-t tabsize</tt> option.
|
2808
|
+
</p>
|
2809
|
+
</li>
|
2810
|
+
<li>
|
2811
|
+
<p>
|
2812
|
+
Replaced <tt>-w</tt> option with <tt>-v</tt> (verbose) option. The warnings option
|
2813
|
+
was just to confusing.
|
2814
|
+
</p>
|
2815
|
+
</li>
|
2816
|
+
<li>
|
2817
|
+
<p>
|
2818
|
+
Named attributes can now be specified in macro calls.
|
2819
|
+
</p>
|
2820
|
+
</li>
|
2821
|
+
<li>
|
2822
|
+
<p>
|
2823
|
+
The <em>tabsize</em> attribute is recognized in the built-in <tt>include</tt>
|
2824
|
+
macros. A tabsize of zero suppresses tab expansion.
|
2825
|
+
</p>
|
2826
|
+
</li>
|
2827
|
+
<li>
|
2828
|
+
<p>
|
2829
|
+
The configuration file <tt>[options]</tt> section has been split into
|
2830
|
+
<tt>[miscellaneous]</tt> and <tt>[titles]</tt>. If you have customized any of
|
2831
|
+
these settings you will need to adjust the affected configuration
|
2832
|
+
files.
|
2833
|
+
</p>
|
2834
|
+
</li>
|
2835
|
+
<li>
|
2836
|
+
<p>
|
2837
|
+
Configuration file <tt>[miscellaneous]</tt> entries can now also be set
|
2838
|
+
using the command-line <tt>-g</tt> option.
|
2839
|
+
</p>
|
2840
|
+
</li>
|
2841
|
+
<li>
|
2842
|
+
<p>
|
2843
|
+
Fixed: error that occurred when attempting to use zero length
|
2844
|
+
configuration and source files.
|
2845
|
+
</p>
|
2846
|
+
</li>
|
2847
|
+
<li>
|
2848
|
+
<p>
|
2849
|
+
Fixed: blocking filter halt problem.
|
2850
|
+
</p>
|
2851
|
+
</li>
|
2852
|
+
<li>
|
2853
|
+
<p>
|
2854
|
+
Fixed: inline macro escape prefix problem.
|
2855
|
+
</p>
|
2856
|
+
</li>
|
2857
|
+
<li>
|
2858
|
+
<p>
|
2859
|
+
Fixed: missing macros from configuration dump problem.
|
2860
|
+
</p>
|
2861
|
+
</li>
|
2862
|
+
<li>
|
2863
|
+
<p>
|
2864
|
+
Fixed: named macros were dumped incorrectly.
|
2865
|
+
</p>
|
2866
|
+
</li>
|
2867
|
+
<li>
|
2868
|
+
<p>
|
2869
|
+
Many documentation changes/additions/corrections.
|
2870
|
+
</p>
|
2871
|
+
</li>
|
2872
|
+
</ul></div>
|
2873
|
+
</div>
|
2874
|
+
<h2 id="_version_3_2_2_2003_10_26">Version 3.2.2 (2003-10-26)</h2>
|
2875
|
+
<div class="sectionbody">
|
2876
|
+
<div class="ilist"><ul>
|
2877
|
+
<li>
|
2878
|
+
<p>
|
2879
|
+
Added <tt>-n</tt> option (synonym for <tt>-g section-numbers</tt>).
|
2880
|
+
</p>
|
2881
|
+
</li>
|
2882
|
+
<li>
|
2883
|
+
<p>
|
2884
|
+
Dropped the processing commentary (hey, this is Unix).
|
2885
|
+
</p>
|
2886
|
+
</li>
|
2887
|
+
<li>
|
2888
|
+
<p>
|
2889
|
+
Added new calculated glossary reference type <tt>{<name>?<value>}</tt>.
|
2890
|
+
<tt><name></tt> is the glossary entry name and <tt><value></tt> is the text
|
2891
|
+
substituted if the glossary entry is defined. <tt><value></tt> can only
|
2892
|
+
contain literal text (no glossary references allowed).
|
2893
|
+
</p>
|
2894
|
+
</li>
|
2895
|
+
<li>
|
2896
|
+
<p>
|
2897
|
+
Added <tt>asciidoc2text</tt> to distribution <tt>examples/asciidoc2text</tt>
|
2898
|
+
directory (converts <em>AsciiDoc</em> source to text file with section
|
2899
|
+
numbering).
|
2900
|
+
</p>
|
2901
|
+
</li>
|
2902
|
+
<li>
|
2903
|
+
<p>
|
2904
|
+
Fixed incorrect nesting of Simple lists inside Variable lists.
|
2905
|
+
</p>
|
2906
|
+
</li>
|
2907
|
+
<li>
|
2908
|
+
<p>
|
2909
|
+
List definitions have been modified so that list items can be
|
2910
|
+
indented. This allows a more intuitive indentation of nested lists
|
2911
|
+
in <em>AsciiDoc</em> source.
|
2912
|
+
</p>
|
2913
|
+
</li>
|
2914
|
+
<li>
|
2915
|
+
<p>
|
2916
|
+
Lists must be separated from preceding paragraphs by a blank line.
|
2917
|
+
This is to avoid paragraph lines being mistaken for list items.
|
2918
|
+
</p>
|
2919
|
+
</li>
|
2920
|
+
<li>
|
2921
|
+
<p>
|
2922
|
+
Corrected asciidoc man page documentation error: the`-f` option does
|
2923
|
+
<strong>not</strong> search relative to source document directory for the
|
2924
|
+
configuration file.
|
2925
|
+
</p>
|
2926
|
+
</li>
|
2927
|
+
<li>
|
2928
|
+
<p>
|
2929
|
+
Minor updates to various distribution <tt>.conf</tt> files.
|
2930
|
+
</p>
|
2931
|
+
</li>
|
2932
|
+
<li>
|
2933
|
+
<p>
|
2934
|
+
Included <tt>badges.conf</tt> in <tt>examples</tt> directory.
|
2935
|
+
</p>
|
2936
|
+
</li>
|
2937
|
+
<li>
|
2938
|
+
<p>
|
2939
|
+
<tt>css-embedded-stylesheet.conf</tt> now supports footer badges.
|
2940
|
+
</p>
|
2941
|
+
</li>
|
2942
|
+
<li>
|
2943
|
+
<p>
|
2944
|
+
The default in-line element processing order has been changed:
|
2945
|
+
Glossary References are now processed before Inline Macros. This
|
2946
|
+
allows glossary expansions to occur inside macro references.
|
2947
|
+
</p>
|
2948
|
+
</li>
|
2949
|
+
<li>
|
2950
|
+
<p>
|
2951
|
+
Glossary entries are now allowed in Author and Revision lines.
|
2952
|
+
</p>
|
2953
|
+
</li>
|
2954
|
+
<li>
|
2955
|
+
<p>
|
2956
|
+
Default List <tt>subs</tt> options and Paragraph <tt>presubs</tt> options are
|
2957
|
+
assigned the following default value if not specified:
|
2958
|
+
</p>
|
2959
|
+
<div class="literalblock">
|
2960
|
+
<div class="content">
|
2961
|
+
<pre><tt>specialcharacters,quotes,specialwords,replacements,glossary,macros</tt></pre>
|
2962
|
+
</div></div>
|
2963
|
+
</li>
|
2964
|
+
<li>
|
2965
|
+
<p>
|
2966
|
+
Documentation changes/additions/corrections.
|
2967
|
+
</p>
|
2968
|
+
</li>
|
2969
|
+
</ul></div>
|
2970
|
+
</div>
|
2971
|
+
<h2 id="_version_3_2_2003_05_26">Version 3.2 (2003-05-26)</h2>
|
2972
|
+
<div class="sectionbody">
|
2973
|
+
<div class="ilist"><ul>
|
2974
|
+
<li>
|
2975
|
+
<p>
|
2976
|
+
Added a <tt>-s</tt> command-line option to suppress the output of
|
2977
|
+
<tt>[header]</tt> and <tt>[footer]</tt> sections.
|
2978
|
+
</p>
|
2979
|
+
</li>
|
2980
|
+
<li>
|
2981
|
+
<p>
|
2982
|
+
Article document headers are no longer mandatory: this allows
|
2983
|
+
<em>AsciiDoc</em> to process arbitrary chunks of text. When used in
|
2984
|
+
conjunction with the new <tt>-s</tt> command-line option corresponding
|
2985
|
+
chunks of backend markup can be generated.
|
2986
|
+
</p>
|
2987
|
+
</li>
|
2988
|
+
<li>
|
2989
|
+
<p>
|
2990
|
+
<em>AsciiDoc</em> now emits a warning message and continues when an out of
|
2991
|
+
sequence section title is detected (previously it failed and
|
2992
|
+
halted). This allows document sections to be processed separately.
|
2993
|
+
</p>
|
2994
|
+
</li>
|
2995
|
+
<li>
|
2996
|
+
<p>
|
2997
|
+
Optional <em>presubs</em> and <em>postsubs</em> entries have been added to
|
2998
|
+
<em>DelimitedBlock</em> and <em>Paragraph</em> definitions. As a consequence
|
2999
|
+
substitution options are no longer legal in <em>options</em> entries.
|
3000
|
+
</p>
|
3001
|
+
</li>
|
3002
|
+
<li>
|
3003
|
+
<p>
|
3004
|
+
<em>presubs</em> and <em>postsubs</em> substitutions are processed in the order
|
3005
|
+
the options are specified (rather than the fixed <em>options</em> order of
|
3006
|
+
previous versions).
|
3007
|
+
</p>
|
3008
|
+
</li>
|
3009
|
+
<li>
|
3010
|
+
<p>
|
3011
|
+
./filters subdirectories are automatically searched for filter
|
3012
|
+
commands.
|
3013
|
+
</p>
|
3014
|
+
</li>
|
3015
|
+
<li>
|
3016
|
+
<p>
|
3017
|
+
A <em>title-subs</em> configuration option specifies the substitutions
|
3018
|
+
performed on document Header and Section titles.
|
3019
|
+
</p>
|
3020
|
+
</li>
|
3021
|
+
<li>
|
3022
|
+
<p>
|
3023
|
+
A <em>subs</em> entry in now included in List configuration file
|
3024
|
+
definitions that specified substitutions performed on list entry
|
3025
|
+
text.
|
3026
|
+
</p>
|
3027
|
+
</li>
|
3028
|
+
<li>
|
3029
|
+
<p>
|
3030
|
+
Configuration files are auto-loaded from ./filters subdirectories.
|
3031
|
+
</p>
|
3032
|
+
</li>
|
3033
|
+
<li>
|
3034
|
+
<p>
|
3035
|
+
Added example code filter (see ./examples/filters).
|
3036
|
+
</p>
|
3037
|
+
</li>
|
3038
|
+
<li>
|
3039
|
+
<p>
|
3040
|
+
Bug fix: if section was empty you may have got erroneous <em>missing
|
3041
|
+
tag "paragraph"</em> error.
|
3042
|
+
</p>
|
3043
|
+
</li>
|
3044
|
+
<li>
|
3045
|
+
<p>
|
3046
|
+
Internal code tidy up.
|
3047
|
+
</p>
|
3048
|
+
</li>
|
3049
|
+
</ul></div>
|
3050
|
+
</div>
|
3051
|
+
<h2 id="_version_3_1_2003_05_18">Version 3.1 (2003-05-18)</h2>
|
3052
|
+
<div class="sectionbody">
|
3053
|
+
<div class="ilist"><ul>
|
3054
|
+
<li>
|
3055
|
+
<p>
|
3056
|
+
In version 3.0 a <tt>[macros]</tt> section entry of the form <em>name</em> was
|
3057
|
+
equivalent to <em>name=</em>. An entry of the form <em>name</em> now undefines the
|
3058
|
+
entry (to bring it in line with the behavior of other special
|
3059
|
+
sections).
|
3060
|
+
</p>
|
3061
|
+
</li>
|
3062
|
+
<li>
|
3063
|
+
<p>
|
3064
|
+
Paragraphs have now been generalized (in the same way as Lists and
|
3065
|
+
DelimitedBlocks).
|
3066
|
+
</p>
|
3067
|
+
</li>
|
3068
|
+
<li>
|
3069
|
+
<p>
|
3070
|
+
The <em>indentsize</em> option has been dropped as as consequence of
|
3071
|
+
paragraph generalization.
|
3072
|
+
</p>
|
3073
|
+
</li>
|
3074
|
+
<li>
|
3075
|
+
<p>
|
3076
|
+
Pipe | characters can be included in substituted tag and
|
3077
|
+
substitution section text using the {brvbar} (broken vertical bar)
|
3078
|
+
glossary reference.
|
3079
|
+
</p>
|
3080
|
+
</li>
|
3081
|
+
<li>
|
3082
|
+
<p>
|
3083
|
+
Removed the restriction requiring substitution section text
|
3084
|
+
placeholders | to be on a separate line.
|
3085
|
+
</p>
|
3086
|
+
</li>
|
3087
|
+
<li>
|
3088
|
+
<p>
|
3089
|
+
Added an <tt>-e</tt> <tt>asciidoc(1)</tt> command option that excludes implicit
|
3090
|
+
configuration files (used in conjunction with <tt>-c</tt> generated
|
3091
|
+
configuration files).
|
3092
|
+
</p>
|
3093
|
+
</li>
|
3094
|
+
<li>
|
3095
|
+
<p>
|
3096
|
+
Version 3.0 documentation has undergone a considerable cleanup.
|
3097
|
+
</p>
|
3098
|
+
</li>
|
3099
|
+
<li>
|
3100
|
+
<p>
|
3101
|
+
The dumping of quoted section entries (see <tt>-c</tt> option) now works
|
3102
|
+
correctly.
|
3103
|
+
</p>
|
3104
|
+
</li>
|
3105
|
+
<li>
|
3106
|
+
<p>
|
3107
|
+
The format of special section entries has been made consistent:
|
3108
|
+
<tt>name</tt> undefines the entry; <tt>name=</tt> sets the entry value to a blank
|
3109
|
+
string; <tt>name=value</tt> sets the entry value to <tt>value</tt>.
|
3110
|
+
</p>
|
3111
|
+
</li>
|
3112
|
+
<li>
|
3113
|
+
<p>
|
3114
|
+
As a consequence of the previous change the caret prefix is no
|
3115
|
+
longer used in glossary configuration file entries (although it is
|
3116
|
+
still used when undefining an entry using the <tt>-g</tt> command-line
|
3117
|
+
option).
|
3118
|
+
</p>
|
3119
|
+
</li>
|
3120
|
+
</ul></div>
|
3121
|
+
</div>
|
3122
|
+
<h2 id="_version_3_0_2003_05_13">Version 3.0 (2003-05-13)</h2>
|
3123
|
+
<div class="sectionbody">
|
3124
|
+
<div class="para"><p>This version is the culmination of work begun in the 2.x releases
|
3125
|
+
whereby fixed policy has been replaced by extensible mechanisms.</p></div>
|
3126
|
+
<div class="ilist"><ul>
|
3127
|
+
<li>
|
3128
|
+
<p>
|
3129
|
+
Added <tt>-c</tt> command-line option to dump a composite <tt>asciidoc(1)</tt>
|
3130
|
+
configuration file to stdout.
|
3131
|
+
</p>
|
3132
|
+
</li>
|
3133
|
+
<li>
|
3134
|
+
<p>
|
3135
|
+
Lists and Delimited Blocks are now defined by a set of configuration
|
3136
|
+
file parameter sections. The user can modify the default
|
3137
|
+
definitions or add new ones.
|
3138
|
+
</p>
|
3139
|
+
</li>
|
3140
|
+
<li>
|
3141
|
+
<p>
|
3142
|
+
Block content can now be processed through external filters.
|
3143
|
+
</p>
|
3144
|
+
</li>
|
3145
|
+
<li>
|
3146
|
+
<p>
|
3147
|
+
The default behavior for Custom Blocks is to perform glossary
|
3148
|
+
substitution (previously there was no substitution inside Custom
|
3149
|
+
Blocks).
|
3150
|
+
</p>
|
3151
|
+
</li>
|
3152
|
+
<li>
|
3153
|
+
<p>
|
3154
|
+
The old 2.x style macros have been reimplemented; as with Lists and
|
3155
|
+
Delimited Blocks there syntax and behavior can be configured by the
|
3156
|
+
user. The default macro syntax remains the same but the semantics
|
3157
|
+
are now (hopefully) a bit more intelligible.
|
3158
|
+
</p>
|
3159
|
+
</li>
|
3160
|
+
<li>
|
3161
|
+
<p>
|
3162
|
+
Block and Builtin macros use :: delimiter instead of the 2.x single
|
3163
|
+
colon delimit (to distinguish them from inline macros). The 2.x
|
3164
|
+
syntax is still supported for backward compatibility.
|
3165
|
+
</p>
|
3166
|
+
</li>
|
3167
|
+
<li>
|
3168
|
+
<p>
|
3169
|
+
Nested lists are now supported and IndentedParagraphs can be
|
3170
|
+
included in list items.
|
3171
|
+
</p>
|
3172
|
+
</li>
|
3173
|
+
<li>
|
3174
|
+
<p>
|
3175
|
+
Conditional source inclusion can be specified using built in <tt>ifdef</tt>,
|
3176
|
+
<tt>ifndef</tt> and <tt>endif</tt> macros.
|
3177
|
+
</p>
|
3178
|
+
</li>
|
3179
|
+
<li>
|
3180
|
+
<p>
|
3181
|
+
The new conditional source inclusion feature has been used to reduce
|
3182
|
+
the number of default configuration files down to one per backend.
|
3183
|
+
</p>
|
3184
|
+
</li>
|
3185
|
+
<li>
|
3186
|
+
<p>
|
3187
|
+
A change of name: 2.x <em>Substitutions</em> are now called <em>Replacements</em>
|
3188
|
+
and the 2.x <tt>[substitutions]</tt> configuration file section is now
|
3189
|
+
called <tt>[replacements]</tt> (the old name is still recognized for
|
3190
|
+
backward compatibility).
|
3191
|
+
</p>
|
3192
|
+
</li>
|
3193
|
+
<li>
|
3194
|
+
<p>
|
3195
|
+
The line break is now implemented as a <em>Replacements</em> substitution.
|
3196
|
+
</p>
|
3197
|
+
</li>
|
3198
|
+
<li>
|
3199
|
+
<p>
|
3200
|
+
Inline <em>icon</em> macro for inline images has been added to default
|
3201
|
+
configuration files.
|
3202
|
+
</p>
|
3203
|
+
</li>
|
3204
|
+
</ul></div>
|
3205
|
+
</div>
|
3206
|
+
<h2 id="_version_2_2_2003_04_07">Version 2.2 (2003-04-07)</h2>
|
3207
|
+
<div class="sectionbody">
|
3208
|
+
<div class="ilist"><ul>
|
3209
|
+
<li>
|
3210
|
+
<p>
|
3211
|
+
The <tt>master.conf</tt> configuration file name has been deprecated in
|
3212
|
+
favor of <tt>asciidoc.conf</tt>.
|
3213
|
+
</p>
|
3214
|
+
</li>
|
3215
|
+
<li>
|
3216
|
+
<p>
|
3217
|
+
The standard configuration files set is now loaded from the
|
3218
|
+
<tt>.asciidoc</tt> folder in the users home directory (if it exists) and
|
3219
|
+
then from the source document directory. Configuration files that
|
3220
|
+
don't exist are silently skipped.
|
3221
|
+
</p>
|
3222
|
+
</li>
|
3223
|
+
<li>
|
3224
|
+
<p>
|
3225
|
+
Configuration files named like the source file will be automatically
|
3226
|
+
loaded if they are found in the source file directory. For example
|
3227
|
+
if the source file is <tt>mydoc.asc</tt> and the <tt>-b html</tt> option is used
|
3228
|
+
then <tt>asciidoc(1)</tt> will look for <tt>mydoc.conf</tt> and <tt>mydoc-html.conf</tt> in
|
3229
|
+
that order.
|
3230
|
+
</p>
|
3231
|
+
</li>
|
3232
|
+
<li>
|
3233
|
+
<p>
|
3234
|
+
The characters used to quote formatted text can be configured and
|
3235
|
+
extended by the user (see the master.conf [quotes] section).
|
3236
|
+
</p>
|
3237
|
+
</li>
|
3238
|
+
<li>
|
3239
|
+
<p>
|
3240
|
+
Quoted text can now be escaped by prefixing a backslash character to
|
3241
|
+
the leading quote.
|
3242
|
+
</p>
|
3243
|
+
</li>
|
3244
|
+
<li>
|
3245
|
+
<p>
|
3246
|
+
The double single-quote '' strong text quote has been deprecated in
|
3247
|
+
favor of an asterisk * character.
|
3248
|
+
</p>
|
3249
|
+
</li>
|
3250
|
+
<li>
|
3251
|
+
<p>
|
3252
|
+
Added {eval:expression}, {sys:command} and {sys2:command}
|
3253
|
+
glossary reference actions.
|
3254
|
+
</p>
|
3255
|
+
</li>
|
3256
|
+
<li>
|
3257
|
+
<p>
|
3258
|
+
Trailing brace characters <tt>}</tt> are now allowed inside glossary
|
3259
|
+
references provided they are escaped with a backslash character.
|
3260
|
+
</p>
|
3261
|
+
</li>
|
3262
|
+
<li>
|
3263
|
+
<p>
|
3264
|
+
Glossary entries can now be escaped by prefixing a backslash
|
3265
|
+
character to the leading brace character (use this in preference to
|
3266
|
+
placing the backslash inside the brace).
|
3267
|
+
</p>
|
3268
|
+
</li>
|
3269
|
+
<li>
|
3270
|
+
<p>
|
3271
|
+
The output macro has been deprecated (use the new include1 macro
|
3272
|
+
inside a CustomBlock).
|
3273
|
+
</p>
|
3274
|
+
</li>
|
3275
|
+
<li>
|
3276
|
+
<p>
|
3277
|
+
The default document type is <tt>article</tt> (asciidoc no longer attempts
|
3278
|
+
to guess).
|
3279
|
+
</p>
|
3280
|
+
</li>
|
3281
|
+
<li>
|
3282
|
+
<p>
|
3283
|
+
Files included within DelimitedBlocks are not searched for block
|
3284
|
+
termination underlines. This ensures the entire file is part of the
|
3285
|
+
DelimitedBlock.
|
3286
|
+
</p>
|
3287
|
+
</li>
|
3288
|
+
<li>
|
3289
|
+
<p>
|
3290
|
+
<tt>include</tt> macros can now be used in configuration files.
|
3291
|
+
</p>
|
3292
|
+
</li>
|
3293
|
+
<li>
|
3294
|
+
<p>
|
3295
|
+
Corrected {infile} and {outfile} glossary entry documentation.
|
3296
|
+
</p>
|
3297
|
+
</li>
|
3298
|
+
<li>
|
3299
|
+
<p>
|
3300
|
+
File inclusion is now limited to a depth of 5 to catch recursion
|
3301
|
+
loops.
|
3302
|
+
</p>
|
3303
|
+
</li>
|
3304
|
+
<li>
|
3305
|
+
<p>
|
3306
|
+
Inline tags have been deprecated, they're not necessary and they
|
3307
|
+
immediately make the source document backend specific. Use
|
3308
|
+
CustomBlocks or Substitutions instead.
|
3309
|
+
</p>
|
3310
|
+
</li>
|
3311
|
+
</ul></div>
|
3312
|
+
</div>
|
3313
|
+
<h2 id="_version_2_1_2003_03_17">Version 2.1 (2003-03-17)</h2>
|
3314
|
+
<div class="sectionbody">
|
3315
|
+
<div class="ilist"><ul>
|
3316
|
+
<li>
|
3317
|
+
<p>
|
3318
|
+
Added section auto numbering <tt>{sectnum}</tt> glossary entry
|
3319
|
+
(auto-numbering function contributed by Ludovico Magnocavallo).
|
3320
|
+
</p>
|
3321
|
+
</li>
|
3322
|
+
<li>
|
3323
|
+
<p>
|
3324
|
+
<tt>asciidoc(1)</tt> now correctly returns non-zero exit status if an error
|
3325
|
+
occurs.
|
3326
|
+
</p>
|
3327
|
+
</li>
|
3328
|
+
<li>
|
3329
|
+
<p>
|
3330
|
+
An <em>AsciiDoc</em> example website has been included in the <em>AsciiDoc</em>
|
3331
|
+
distribution <tt>examples/website</tt> directory (also online at
|
3332
|
+
<a href="http://www.methods.co.nz/asciidoc/examples/website/">http://www.methods.co.nz/asciidoc/examples/website/</a>).
|
3333
|
+
</p>
|
3334
|
+
</li>
|
3335
|
+
<li>
|
3336
|
+
<p>
|
3337
|
+
NOTE: The <tt>asciidoc</tt> wrapper script included in the 2.0 distribution
|
3338
|
+
has been dropped, if you've symlinked or aliased to <tt>asciidoc</tt> you'll
|
3339
|
+
need to change them to point directly to <tt>asciidoc.py</tt> instead.
|
3340
|
+
</p>
|
3341
|
+
</li>
|
3342
|
+
<li>
|
3343
|
+
<p>
|
3344
|
+
An RCS $Id$ marker can be used as the document header revision line
|
3345
|
+
(based on a patch submitted by Ludovico Magnocavallo).
|
3346
|
+
</p>
|
3347
|
+
</li>
|
3348
|
+
<li>
|
3349
|
+
<p>
|
3350
|
+
In addition to the <tt>name=value</tt> glossary entry format two new ones
|
3351
|
+
have been introduced: <tt>name</tt> (the default value is set to an empty
|
3352
|
+
string) and <tt>^name</tt> (the glossary entry is undefined).
|
3353
|
+
</p>
|
3354
|
+
</li>
|
3355
|
+
<li>
|
3356
|
+
<p>
|
3357
|
+
The <tt>-q</tt> command-line option has been deprecated and the <tt>-w level</tt>
|
3358
|
+
command-line option added.<br />
|
3359
|
+
NOTE: By default skipped substitution warnings are now suppressed.
|
3360
|
+
</p>
|
3361
|
+
</li>
|
3362
|
+
<li>
|
3363
|
+
<p>
|
3364
|
+
If a configuration file specified with the <tt>-f</tt> command-line option
|
3365
|
+
is not found relative to the current working directory then the
|
3366
|
+
search is repeated relative to the <tt>asciidoc(1)</tt> directory. This
|
3367
|
+
allows global configuration files to be used.
|
3368
|
+
</p>
|
3369
|
+
</li>
|
3370
|
+
<li>
|
3371
|
+
<p>
|
3372
|
+
Added <tt>{infile}</tt>, <tt>{outfile}</tt> predefined glossary entries.
|
3373
|
+
</p>
|
3374
|
+
</li>
|
3375
|
+
<li>
|
3376
|
+
<p>
|
3377
|
+
Added <tt>under-construction</tt> macro to HTML article configuration
|
3378
|
+
files.
|
3379
|
+
</p>
|
3380
|
+
</li>
|
3381
|
+
<li>
|
3382
|
+
<p>
|
3383
|
+
Deprecated <tt>{asciidoc_version}</tt> glossary entry in favor of
|
3384
|
+
<tt>{asciidoc-version}</tt> (to it consistent with other entries).
|
3385
|
+
</p>
|
3386
|
+
</li>
|
3387
|
+
</ul></div>
|
3388
|
+
</div>
|
3389
|
+
<h2 id="_version_2_0_2003_02_24">Version 2.0 (2003-02-24)</h2>
|
3390
|
+
<div class="sectionbody">
|
3391
|
+
<div class="ilist"><ul>
|
3392
|
+
<li>
|
3393
|
+
<p>
|
3394
|
+
The emphasized, strong and monospaced words options have been
|
3395
|
+
generalized with the introduction of macro based <em>special words</em>
|
3396
|
+
lists.
|
3397
|
+
</p>
|
3398
|
+
</li>
|
3399
|
+
<li>
|
3400
|
+
<p>
|
3401
|
+
Glossary references can now appear in both the document and macro
|
3402
|
+
bodies.
|
3403
|
+
</p>
|
3404
|
+
</li>
|
3405
|
+
<li>
|
3406
|
+
<p>
|
3407
|
+
All output files use <tt>crlf</tt> line termination (previously used UNIX
|
3408
|
+
<tt>lf</tt> (newline) termination).
|
3409
|
+
</p>
|
3410
|
+
</li>
|
3411
|
+
<li>
|
3412
|
+
<p>
|
3413
|
+
Added [substitutions] section which implements arbitrary regular
|
3414
|
+
expression based substitutions.
|
3415
|
+
</p>
|
3416
|
+
</li>
|
3417
|
+
<li>
|
3418
|
+
<p>
|
3419
|
+
An optional <tt>master.conf</tt> configuration file can be used for entries
|
3420
|
+
that are not backend or document type specific.
|
3421
|
+
</p>
|
3422
|
+
</li>
|
3423
|
+
<li>
|
3424
|
+
<p>
|
3425
|
+
Special character definitions moved from the code to the new
|
3426
|
+
[special_characters] configuration file section.
|
3427
|
+
</p>
|
3428
|
+
</li>
|
3429
|
+
<li>
|
3430
|
+
<p>
|
3431
|
+
Configuration file glossary added.
|
3432
|
+
</p>
|
3433
|
+
</li>
|
3434
|
+
<li>
|
3435
|
+
<p>
|
3436
|
+
Command-line -g glossary entry added.
|
3437
|
+
</p>
|
3438
|
+
</li>
|
3439
|
+
<li>
|
3440
|
+
<p>
|
3441
|
+
A new <em>book</em> document type has been implemented for the <em>docbook</em>
|
3442
|
+
backend. It outputs DocBook <em>book</em> documents.
|
3443
|
+
</p>
|
3444
|
+
</li>
|
3445
|
+
<li>
|
3446
|
+
<p>
|
3447
|
+
A major internal change has been the implementation of parametrized
|
3448
|
+
user definable <em>macros</em>. Internally most document elements are now
|
3449
|
+
processed as macros.
|
3450
|
+
</p>
|
3451
|
+
</li>
|
3452
|
+
<li>
|
3453
|
+
<p>
|
3454
|
+
Configuration file macro variables can be specified with default
|
3455
|
+
values (literals or other macro variables).
|
3456
|
+
</p>
|
3457
|
+
</li>
|
3458
|
+
<li>
|
3459
|
+
<p>
|
3460
|
+
An attempt has been made to tighten up the vocabulary used to
|
3461
|
+
describe the <em>AsciiDoc</em> document syntax.
|
3462
|
+
</p>
|
3463
|
+
</li>
|
3464
|
+
<li>
|
3465
|
+
<p>
|
3466
|
+
The term abstract has been replaced by the more general term
|
3467
|
+
<em>preface</em> and a new preface section introduced into article
|
3468
|
+
configuration files (replacing the synopsis sections).
|
3469
|
+
</p>
|
3470
|
+
</li>
|
3471
|
+
<li>
|
3472
|
+
<p>
|
3473
|
+
Any section elements can now be put in the document preface
|
3474
|
+
(previous versions only allowed paragraphs).
|
3475
|
+
</p>
|
3476
|
+
</li>
|
3477
|
+
<li>
|
3478
|
+
<p>
|
3479
|
+
<em>AsciiDoc</em> Blocks have been unified and their behavior can be user
|
3480
|
+
defined and parametrized.
|
3481
|
+
</p>
|
3482
|
+
</li>
|
3483
|
+
<li>
|
3484
|
+
<p>
|
3485
|
+
An <em>output</em> inclusion allows an external file to be written directly
|
3486
|
+
to the backend output file.
|
3487
|
+
</p>
|
3488
|
+
</li>
|
3489
|
+
<li>
|
3490
|
+
<p>
|
3491
|
+
A new CustomBlock has been added. Default behavior is to insert the
|
3492
|
+
enveloped <em>AsciiDoc</em> source lines directly into the output file.
|
3493
|
+
</p>
|
3494
|
+
</li>
|
3495
|
+
<li>
|
3496
|
+
<p>
|
3497
|
+
A <em>line break</em> tag can be inserted by terminating a line with a <em>+</em>
|
3498
|
+
character (only really useful for HTML backends).
|
3499
|
+
</p>
|
3500
|
+
</li>
|
3501
|
+
<li>
|
3502
|
+
<p>
|
3503
|
+
An fourth section level has been introduced.
|
3504
|
+
</p>
|
3505
|
+
</li>
|
3506
|
+
<li>
|
3507
|
+
<p>
|
3508
|
+
The SidebarBlock delimiter line characters have been changed. The
|
3509
|
+
deprecated underline is still accepted.
|
3510
|
+
</p>
|
3511
|
+
</li>
|
3512
|
+
<li>
|
3513
|
+
<p>
|
3514
|
+
Levels 2 and 3 title underline characters have been changed. The
|
3515
|
+
deprecated underlines are still accepted.
|
3516
|
+
</p>
|
3517
|
+
</li>
|
3518
|
+
<li>
|
3519
|
+
<p>
|
3520
|
+
Lines with backend specific inline tags can be inserted into
|
3521
|
+
<em>AsciiDoc</em> source files.
|
3522
|
+
</p>
|
3523
|
+
</li>
|
3524
|
+
<li>
|
3525
|
+
<p>
|
3526
|
+
Single words enveloped by underscores are no longer emphasized. This
|
3527
|
+
feature was deprecated as it is redundant (use single quotes
|
3528
|
+
instead) and was being applied to file names with underscores.
|
3529
|
+
</p>
|
3530
|
+
</li>
|
3531
|
+
<li>
|
3532
|
+
<p>
|
3533
|
+
A <tt>-q</tt> quiet option has been added to suppress warning messages.
|
3534
|
+
</p>
|
3535
|
+
</li>
|
3536
|
+
<li>
|
3537
|
+
<p>
|
3538
|
+
Badge images sourced locally.
|
3539
|
+
</p>
|
3540
|
+
</li>
|
3541
|
+
<li>
|
3542
|
+
<p>
|
3543
|
+
Added <em>author</em> and <em>author-mail</em> meta tags to HTML configuration
|
3544
|
+
files.
|
3545
|
+
</p>
|
3546
|
+
</li>
|
3547
|
+
</ul></div>
|
3548
|
+
</div>
|
3549
|
+
<h2 id="_version_1_5_2003_01_08">Version 1.5 (2003-01-08)</h2>
|
3550
|
+
<div class="sectionbody">
|
3551
|
+
<div class="ilist"><ul>
|
3552
|
+
<li>
|
3553
|
+
<p>
|
3554
|
+
Implemented sidebar document elements.
|
3555
|
+
</p>
|
3556
|
+
</li>
|
3557
|
+
<li>
|
3558
|
+
<p>
|
3559
|
+
Explicit checks for user specified configuration files and input
|
3560
|
+
file (rather than throwing exception).
|
3561
|
+
</p>
|
3562
|
+
</li>
|
3563
|
+
</ul></div>
|
3564
|
+
</div>
|
3565
|
+
<h2 id="_version_1_4_2003_01_04">Version 1.4 (2003-01-04)</h2>
|
3566
|
+
<div class="sectionbody">
|
3567
|
+
<div class="ilist"><ul>
|
3568
|
+
<li>
|
3569
|
+
<p>
|
3570
|
+
New configuration file options <em>emphasizedwords</em> and <em>strongwords</em>.
|
3571
|
+
These allow the definition of words that will always be emphasized
|
3572
|
+
or rendered in a strong font without inline formatting.
|
3573
|
+
</p>
|
3574
|
+
</li>
|
3575
|
+
<li>
|
3576
|
+
<p>
|
3577
|
+
Document and section titles are no long subject to inline
|
3578
|
+
formatting.
|
3579
|
+
</p>
|
3580
|
+
</li>
|
3581
|
+
<li>
|
3582
|
+
<p>
|
3583
|
+
Multiple configuration files can be overlaid in a single command.
|
3584
|
+
</p>
|
3585
|
+
</li>
|
3586
|
+
<li>
|
3587
|
+
<p>
|
3588
|
+
Configuration file tags and options entries can now be overridden on
|
3589
|
+
an entry by entry basis (previously the entire section was
|
3590
|
+
overloaded).
|
3591
|
+
</p>
|
3592
|
+
</li>
|
3593
|
+
<li>
|
3594
|
+
<p>
|
3595
|
+
Configuration file tags and options entries are now cached this has
|
3596
|
+
resulted in around 37% performance improvement over version 1.3.
|
3597
|
+
</p>
|
3598
|
+
</li>
|
3599
|
+
<li>
|
3600
|
+
<p>
|
3601
|
+
Variable lists can now contain multiple terms per list item.
|
3602
|
+
</p>
|
3603
|
+
</li>
|
3604
|
+
<li>
|
3605
|
+
<p>
|
3606
|
+
Placeholder paragraph eliminated from empty sections that contain
|
3607
|
+
subsections.
|
3608
|
+
</p>
|
3609
|
+
</li>
|
3610
|
+
<li>
|
3611
|
+
<p>
|
3612
|
+
Added {asciidoc_version} substitution variable.
|
3613
|
+
</p>
|
3614
|
+
</li>
|
3615
|
+
<li>
|
3616
|
+
<p>
|
3617
|
+
More documentation additions and tidy ups.
|
3618
|
+
</p>
|
3619
|
+
</li>
|
3620
|
+
</ul></div>
|
3621
|
+
</div>
|
3622
|
+
<h2 id="_version_1_3_2003_01_01">Version 1.3 (2003-01-01)</h2>
|
3623
|
+
<div class="sectionbody">
|
3624
|
+
<div class="ilist"><ul>
|
3625
|
+
<li>
|
3626
|
+
<p>
|
3627
|
+
A new <em>strong</em> text formatting convention has been implemented:
|
3628
|
+
Word phrases enclosed in pairs of single quote characters (acute
|
3629
|
+
accents) are rendered in a strong font (usually bold).
|
3630
|
+
</p>
|
3631
|
+
</li>
|
3632
|
+
<li>
|
3633
|
+
<p>
|
3634
|
+
Paragraphs can now be followed immediately by Simple lists and
|
3635
|
+
Ordered lists without an intervening blank line.
|
3636
|
+
</p>
|
3637
|
+
</li>
|
3638
|
+
<li>
|
3639
|
+
<p>
|
3640
|
+
A user specified configuration file (<tt><tt>asciidoc(1)</tt></tt> -f option)
|
3641
|
+
overlays the default configuration file rather than replacing it.
|
3642
|
+
Custom configuration files need only contain those sections
|
3643
|
+
that have been customized.
|
3644
|
+
</p>
|
3645
|
+
</li>
|
3646
|
+
<li>
|
3647
|
+
<p>
|
3648
|
+
Comment Block delimiters have been relaxed slightly. They must start
|
3649
|
+
with three forward slashes /// but the remainder can contain any
|
3650
|
+
characters, this allows comments to be embedded in the delimiter line.
|
3651
|
+
</p>
|
3652
|
+
</li>
|
3653
|
+
<li>
|
3654
|
+
<p>
|
3655
|
+
Leading non-digit characters preceding revision number are now
|
3656
|
+
ignored.
|
3657
|
+
</p>
|
3658
|
+
</li>
|
3659
|
+
<li>
|
3660
|
+
<p>
|
3661
|
+
Set default indentsize [option] from 2 to documented default value
|
3662
|
+
of zero in HTML backend html-article.conf and html-manpage.conf
|
3663
|
+
files.
|
3664
|
+
</p>
|
3665
|
+
</li>
|
3666
|
+
<li>
|
3667
|
+
<p>
|
3668
|
+
Fixed error that occurred when taking input from stdin without
|
3669
|
+
explicitly specifying a document type.
|
3670
|
+
</p>
|
3671
|
+
</li>
|
3672
|
+
<li>
|
3673
|
+
<p>
|
3674
|
+
Restored file name and line number error message information.
|
3675
|
+
</p>
|
3676
|
+
</li>
|
3677
|
+
<li>
|
3678
|
+
<p>
|
3679
|
+
Changed deprecated -t option to -d in asciidoc —help and usage
|
3680
|
+
command output.
|
3681
|
+
</p>
|
3682
|
+
</li>
|
3683
|
+
<li>
|
3684
|
+
<p>
|
3685
|
+
CSS styles tweaking.
|
3686
|
+
</p>
|
3687
|
+
</li>
|
3688
|
+
<li>
|
3689
|
+
<p>
|
3690
|
+
Code, configuration file and documentation tidy ups.
|
3691
|
+
</p>
|
3692
|
+
</li>
|
3693
|
+
</ul></div>
|
3694
|
+
</div>
|
3695
|
+
<h2 id="_version_1_2_2002_12_28">Version 1.2 (2002-12-28)</h2>
|
3696
|
+
<div class="sectionbody">
|
3697
|
+
<div class="ilist"><ul>
|
3698
|
+
<li>
|
3699
|
+
<p>
|
3700
|
+
Implemented <em>include</em> URL to allow file inclusion.
|
3701
|
+
</p>
|
3702
|
+
</li>
|
3703
|
+
<li>
|
3704
|
+
<p>
|
3705
|
+
<tt>fileextension</tt> configuration file [option] renamed to more sensible
|
3706
|
+
<tt>outfilesuffix</tt> (<tt>fileextension</tt> still accepted by this version but
|
3707
|
+
will be dropped in future).
|
3708
|
+
</p>
|
3709
|
+
</li>
|
3710
|
+
<li>
|
3711
|
+
<p>
|
3712
|
+
Improved error reporting.
|
3713
|
+
</p>
|
3714
|
+
</li>
|
3715
|
+
<li>
|
3716
|
+
<p>
|
3717
|
+
CSS backends generate valid XHTML.
|
3718
|
+
</p>
|
3719
|
+
</li>
|
3720
|
+
<li>
|
3721
|
+
<p>
|
3722
|
+
New <tt>css-embedded</tt> backend generates HTML with embedded stylesheets
|
3723
|
+
(use the <tt>css</tt> backend for linked stylesheets). The css-embedded
|
3724
|
+
backend output contains no linked images so the generated html files
|
3725
|
+
are completely self contained.
|
3726
|
+
</p>
|
3727
|
+
</li>
|
3728
|
+
<li>
|
3729
|
+
<p>
|
3730
|
+
Bug fixes.
|
3731
|
+
</p>
|
3732
|
+
</li>
|
3733
|
+
</ul></div>
|
3734
|
+
</div>
|
3735
|
+
<h2 id="_version_1_1_2002_12_03">Version 1.1 (2002-12-03)</h2>
|
3736
|
+
<div class="sectionbody">
|
3737
|
+
<div class="ilist"><ul>
|
3738
|
+
<li>
|
3739
|
+
<p>
|
3740
|
+
Added css (cascading style sheets) backend
|
3741
|
+
</p>
|
3742
|
+
</li>
|
3743
|
+
<li>
|
3744
|
+
<p>
|
3745
|
+
Implemented IndentedBlock document element.
|
3746
|
+
</p>
|
3747
|
+
</li>
|
3748
|
+
<li>
|
3749
|
+
<p>
|
3750
|
+
Tabsize command-line option has been deprecated in
|
3751
|
+
favor of configuration file.
|
3752
|
+
</p>
|
3753
|
+
</li>
|
3754
|
+
<li>
|
3755
|
+
<p>
|
3756
|
+
Default indent width changed to zero.
|
3757
|
+
</p>
|
3758
|
+
</li>
|
3759
|
+
<li>
|
3760
|
+
<p>
|
3761
|
+
Added {localdate} and {localtime} substitution variables.
|
3762
|
+
</p>
|
3763
|
+
</li>
|
3764
|
+
<li>
|
3765
|
+
<p>
|
3766
|
+
Added optional [options] configuration file section with
|
3767
|
+
fileextension, tabsize and indentsize options.
|
3768
|
+
</p>
|
3769
|
+
</li>
|
3770
|
+
<li>
|
3771
|
+
<p>
|
3772
|
+
Implemented {authorinitials} substitution variable.
|
3773
|
+
</p>
|
3774
|
+
</li>
|
3775
|
+
<li>
|
3776
|
+
<p>
|
3777
|
+
Added https link type.
|
3778
|
+
</p>
|
3779
|
+
</li>
|
3780
|
+
<li>
|
3781
|
+
<p>
|
3782
|
+
Corrected [graphic] substitution from {title} to {caption}
|
3783
|
+
in linuxdoc-article.conf configuration file.
|
3784
|
+
</p>
|
3785
|
+
</li>
|
3786
|
+
<li>
|
3787
|
+
<p>
|
3788
|
+
Fixed error that occurred when <em>==</em> title underline was
|
3789
|
+
used.
|
3790
|
+
</p>
|
3791
|
+
</li>
|
3792
|
+
</ul></div>
|
3793
|
+
</div>
|
3794
|
+
<h2 id="_version_1_0_2002_11_25">Version 1.0 (2002-11-25)</h2>
|
3795
|
+
<div class="sectionbody">
|
3796
|
+
<div class="para"><p>First <em>AsciiDoc</em> public release along with <em>AsciiDoc</em> web site
|
3797
|
+
(<a href="http://www.methods.co.nz/asciidoc/">http://www.methods.co.nz/asciidoc/</a>) and SourceForge.net project registration
|
3798
|
+
(<a href="https://sourceforge.net/projects/asciidoc/">https://sourceforge.net/projects/asciidoc/</a>).</p></div>
|
3799
|
+
</div>
|
3800
|
+
<div id="footer">
|
3801
|
+
<div id="footer-text">
|
3802
|
+
Version 8.2.7<br />
|
3803
|
+
Last updated 2008-07-04 23:29:18 NZDT
|
3804
|
+
</div>
|
3805
|
+
<div id="footer-badges">
|
3806
|
+
<a href="http://validator.w3.org/check?uri=referer">
|
3807
|
+
<img style="border:none; width:88px; height:31px;"
|
3808
|
+
src="http://www.w3.org/Icons/valid-xhtml11"
|
3809
|
+
alt="Valid XHTML 1.1!" />
|
3810
|
+
</a>
|
3811
|
+
<a href="http://jigsaw.w3.org/css-validator/check/referer">
|
3812
|
+
<img style="border:none; width:88px; height:31px;"
|
3813
|
+
src="http://jigsaw.w3.org/css-validator/images/vcss"
|
3814
|
+
alt="Valid CSS!" />
|
3815
|
+
</a>
|
3816
|
+
<a href="http://www.mozilla.org/products/firefox/">
|
3817
|
+
<img style="border:none; width:110px; height:32px;"
|
3818
|
+
src="http://www.spreadfirefox.com/community/images/affiliates/Buttons/110x32/safer.gif"
|
3819
|
+
alt="Get Firefox!" />
|
3820
|
+
</a>
|
3821
|
+
</div>
|
3822
|
+
</div>
|
3823
|
+
</div>
|
3824
|
+
</td>
|
3825
|
+
</tr>
|
3826
|
+
</table>
|
3827
|
+
</body>
|
3828
|
+
</html>
|