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