mizuho 0.9.6 → 0.9.8

Sign up to get free protection for your applications and to get access to all the features.
Files changed (222) hide show
  1. data/README.markdown +4 -2
  2. data/Rakefile +0 -37
  3. data/asciidoc/BUGS +9 -18
  4. data/asciidoc/BUGS.txt +5 -14
  5. data/asciidoc/CHANGELOG +1433 -266
  6. data/asciidoc/CHANGELOG.txt +2821 -1810
  7. data/asciidoc/COPYING +339 -339
  8. data/asciidoc/COPYRIGHT +18 -18
  9. data/asciidoc/INSTALL +189 -30
  10. data/asciidoc/INSTALL.txt +175 -19
  11. data/asciidoc/MANIFEST +88 -0
  12. data/asciidoc/Makefile.in +29 -13
  13. data/asciidoc/README +16 -17
  14. data/asciidoc/README.txt +35 -36
  15. data/asciidoc/a2x.py +902 -0
  16. data/asciidoc/asciidoc.conf +610 -455
  17. data/asciidoc/asciidoc.py +1965 -1061
  18. data/asciidoc/asciidocapi.py +257 -0
  19. data/asciidoc/common.aap +2 -2
  20. data/asciidoc/configure +1170 -1023
  21. data/asciidoc/configure.ac +1 -1
  22. data/asciidoc/dblatex/asciidoc-dblatex.xsl +42 -0
  23. data/asciidoc/doc/a2x.1 +559 -102
  24. data/asciidoc/doc/a2x.1.txt +233 -91
  25. data/asciidoc/doc/article-docinfo.xml +87 -0
  26. data/asciidoc/doc/article.pdf +0 -0
  27. data/asciidoc/doc/article.txt +139 -122
  28. data/asciidoc/doc/asciidoc.1 +157 -46
  29. data/asciidoc/doc/asciidoc.1.txt +171 -118
  30. data/asciidoc/doc/asciidoc.conf +7 -8
  31. data/asciidoc/doc/asciidoc.dict +960 -635
  32. data/asciidoc/doc/asciidoc.txt +2335 -1464
  33. data/asciidoc/doc/asciidocapi.txt +189 -0
  34. data/asciidoc/doc/asciimathml.txt +14 -17
  35. data/asciidoc/doc/book-multi.txt +181 -155
  36. data/asciidoc/doc/book.epub +0 -0
  37. data/asciidoc/doc/book.txt +156 -131
  38. data/asciidoc/doc/customers.csv +18 -18
  39. data/asciidoc/doc/epub-notes.txt +210 -0
  40. data/asciidoc/doc/faq.txt +1122 -547
  41. data/asciidoc/doc/latex-backend.txt +192 -191
  42. data/asciidoc/doc/latex-bugs.txt +134 -0
  43. data/asciidoc/doc/latex-filter.pdf +0 -0
  44. data/asciidoc/doc/latex-filter.txt +196 -0
  45. data/asciidoc/doc/latexmath.txt +13 -136
  46. data/asciidoc/doc/latexmathml.txt +2 -2
  47. data/asciidoc/doc/main.aap +233 -297
  48. data/asciidoc/doc/music-filter.pdf +0 -0
  49. data/asciidoc/doc/music-filter.txt +55 -65
  50. data/asciidoc/doc/publishing-ebooks-with-asciidoc.txt +398 -0
  51. data/asciidoc/doc/slidy-example.txt +167 -0
  52. data/asciidoc/doc/slidy.txt +113 -0
  53. data/asciidoc/doc/source-highlight-filter.pdf +0 -0
  54. data/asciidoc/doc/source-highlight-filter.txt +45 -20
  55. data/asciidoc/doc/testasciidoc.txt +231 -0
  56. data/asciidoc/docbook-xsl/asciidoc-docbook-xsl.txt +30 -8
  57. data/asciidoc/docbook-xsl/chunked.xsl +17 -19
  58. data/asciidoc/docbook-xsl/common.xsl +106 -67
  59. data/asciidoc/docbook-xsl/epub.xsl +35 -0
  60. data/asciidoc/docbook-xsl/fo.xsl +3 -0
  61. data/asciidoc/docbook-xsl/htmlhelp.xsl +16 -17
  62. data/asciidoc/docbook-xsl/manpage.xsl +31 -31
  63. data/asciidoc/docbook-xsl/text.xsl +6 -1
  64. data/asciidoc/docbook-xsl/xhtml.xsl +14 -14
  65. data/asciidoc/docbook45.conf +759 -0
  66. data/asciidoc/filters/code/code-filter-readme.txt +37 -37
  67. data/asciidoc/filters/code/code-filter-test.txt +15 -15
  68. data/asciidoc/filters/code/code-filter.conf +8 -8
  69. data/asciidoc/filters/graphviz/asciidoc-graphviz-sample.txt +104 -64
  70. data/asciidoc/filters/graphviz/graphviz-filter.conf +20 -16
  71. data/asciidoc/filters/graphviz/graphviz2png.py +54 -39
  72. data/asciidoc/filters/latex/latex-filter.conf +18 -0
  73. data/asciidoc/filters/latex/latex2png.py +216 -0
  74. data/asciidoc/filters/music/music-filter.conf +8 -17
  75. data/asciidoc/filters/music/music2png.py +40 -32
  76. data/asciidoc/filters/source/source-highlight-filter.conf +40 -34
  77. data/asciidoc/help.conf +261 -96
  78. data/asciidoc/html4.conf +505 -460
  79. data/asciidoc/html5.conf +686 -0
  80. data/asciidoc/images/highlighter.png +0 -0
  81. data/asciidoc/images/icons/caution.png +0 -0
  82. data/asciidoc/images/icons/example.png +0 -0
  83. data/asciidoc/images/icons/important.png +0 -0
  84. data/asciidoc/images/icons/note.png +0 -0
  85. data/asciidoc/images/icons/tip.png +0 -0
  86. data/asciidoc/images/icons/warning.png +0 -0
  87. data/asciidoc/images/smallnew.png +0 -0
  88. data/asciidoc/javascripts/asciidoc.js +189 -0
  89. data/asciidoc/javascripts/slidy.js +2845 -0
  90. data/asciidoc/javascripts/toc.js +8 -0
  91. data/asciidoc/lang-de.conf +57 -0
  92. data/asciidoc/lang-en.conf +54 -0
  93. data/asciidoc/lang-es.conf +49 -9
  94. data/asciidoc/lang-fr.conf +59 -0
  95. data/asciidoc/lang-hu.conf +55 -0
  96. data/asciidoc/lang-it.conf +55 -0
  97. data/asciidoc/lang-nl.conf +57 -0
  98. data/asciidoc/lang-pt-BR.conf +56 -0
  99. data/asciidoc/lang-ru.conf +60 -0
  100. data/asciidoc/lang-uk.conf +60 -0
  101. data/asciidoc/latex.conf +700 -663
  102. data/asciidoc/main.aap +77 -0
  103. data/asciidoc/slidy.conf +136 -0
  104. data/asciidoc/{examples/website/xhtml11-manpage.css → stylesheets/asciidoc-manpage.css} +1 -1
  105. data/asciidoc/stylesheets/asciidoc.css +508 -0
  106. data/asciidoc/stylesheets/docbook-xsl.css +322 -272
  107. data/asciidoc/stylesheets/flask-manpage.css +1 -0
  108. data/asciidoc/stylesheets/flask.css +584 -0
  109. data/asciidoc/stylesheets/pygments.css +66 -0
  110. data/asciidoc/stylesheets/slidy.css +445 -0
  111. data/asciidoc/stylesheets/toc2.css +33 -0
  112. data/asciidoc/stylesheets/volnitsky-manpage.css +1 -0
  113. data/asciidoc/stylesheets/volnitsky.css +435 -0
  114. data/asciidoc/stylesheets/xhtml11-quirks.css +5 -3
  115. data/asciidoc/tests/asciidocapi.py +257 -0
  116. data/asciidoc/tests/data/deprecated-quotes.txt +12 -0
  117. data/asciidoc/tests/data/filters-test.txt +90 -0
  118. data/asciidoc/tests/data/lang-de-test.txt +106 -0
  119. data/asciidoc/tests/data/lang-en-test.txt +114 -0
  120. data/asciidoc/tests/data/lang-es-test.txt +106 -0
  121. data/asciidoc/tests/data/lang-fr-test.txt +106 -0
  122. data/asciidoc/tests/data/lang-hu-test.txt +106 -0
  123. data/asciidoc/tests/data/lang-nl-test.txt +94 -0
  124. data/asciidoc/tests/data/lang-pt-BR-test.txt +106 -0
  125. data/asciidoc/tests/data/lang-ru-test.txt +106 -0
  126. data/asciidoc/tests/data/lang-uk-test.txt +106 -0
  127. data/asciidoc/tests/data/oldtables.txt +64 -0
  128. data/asciidoc/tests/data/rcs-id-marker-test.txt +6 -0
  129. data/asciidoc/tests/data/testcases.conf +2 -0
  130. data/asciidoc/tests/data/testcases.txt +740 -0
  131. data/asciidoc/tests/data/utf8-bom-test.txt +9 -0
  132. data/asciidoc/tests/data/utf8-examples.txt +217 -0
  133. data/asciidoc/tests/testasciidoc.conf +520 -0
  134. data/asciidoc/tests/testasciidoc.py +411 -0
  135. data/asciidoc/text.conf +16 -16
  136. data/asciidoc/vim/syntax/asciidoc.vim +99 -91
  137. data/asciidoc/wordpress.conf +43 -3
  138. data/asciidoc/xhtml11-quirks.conf +61 -57
  139. data/asciidoc/xhtml11.conf +684 -645
  140. data/lib/mizuho.rb +2 -0
  141. data/lib/mizuho/generator.rb +2 -2
  142. data/test/generator_spec.rb +1 -1
  143. data/test/parser_spec.rb +1 -1
  144. data/test/spec_helper.rb +3 -4
  145. metadata +87 -88
  146. data/asciidoc/a2x +0 -674
  147. data/asciidoc/doc/article.css-embedded.html +0 -602
  148. data/asciidoc/doc/article.html +0 -46
  149. data/asciidoc/doc/asciidoc-revhistory.xml +0 -27
  150. data/asciidoc/doc/asciidoc.1.css-embedded.html +0 -598
  151. data/asciidoc/doc/asciidoc.1.css.html +0 -212
  152. data/asciidoc/doc/asciidoc.1.html +0 -190
  153. data/asciidoc/doc/asciidoc.css-embedded.html +0 -7853
  154. data/asciidoc/doc/asciidoc.css.html +0 -7416
  155. data/asciidoc/doc/asciidoc.html +0 -3339
  156. data/asciidoc/doc/book-multi.css-embedded.html +0 -575
  157. data/asciidoc/doc/book-multi.html +0 -55
  158. data/asciidoc/doc/book.css-embedded.html +0 -607
  159. data/asciidoc/doc/book.html +0 -43
  160. data/asciidoc/doc/docbook-xsl.css +0 -272
  161. data/asciidoc/doc/latex-backend.html +0 -117
  162. data/asciidoc/doc/music-filter.html +0 -566
  163. data/asciidoc/doc/source-highlight-filter.html +0 -214
  164. data/asciidoc/docbook.conf +0 -721
  165. data/asciidoc/examples/website/ASCIIMathML.js +0 -938
  166. data/asciidoc/examples/website/CHANGELOG.html +0 -4389
  167. data/asciidoc/examples/website/CHANGELOG.txt +0 -1810
  168. data/asciidoc/examples/website/INSTALL.html +0 -161
  169. data/asciidoc/examples/website/INSTALL.txt +0 -71
  170. data/asciidoc/examples/website/LaTeXMathML.js +0 -1223
  171. data/asciidoc/examples/website/README-website.html +0 -118
  172. data/asciidoc/examples/website/README-website.txt +0 -29
  173. data/asciidoc/examples/website/README.html +0 -125
  174. data/asciidoc/examples/website/README.txt +0 -36
  175. data/asciidoc/examples/website/a2x.1.html +0 -419
  176. data/asciidoc/examples/website/a2x.1.txt +0 -204
  177. data/asciidoc/examples/website/asciidoc-docbook-xsl.html +0 -130
  178. data/asciidoc/examples/website/asciidoc-docbook-xsl.txt +0 -43
  179. data/asciidoc/examples/website/asciidoc-graphviz-sample.txt +0 -130
  180. data/asciidoc/examples/website/asciimathml.txt +0 -64
  181. data/asciidoc/examples/website/build-website.sh +0 -25
  182. data/asciidoc/examples/website/customers.csv +0 -18
  183. data/asciidoc/examples/website/downloads.html +0 -257
  184. data/asciidoc/examples/website/downloads.txt +0 -121
  185. data/asciidoc/examples/website/faq.html +0 -673
  186. data/asciidoc/examples/website/faq.txt +0 -547
  187. data/asciidoc/examples/website/index.html +0 -419
  188. data/asciidoc/examples/website/index.txt +0 -245
  189. data/asciidoc/examples/website/latex-backend.html +0 -535
  190. data/asciidoc/examples/website/latex-backend.txt +0 -191
  191. data/asciidoc/examples/website/latexmathml.txt +0 -41
  192. data/asciidoc/examples/website/layout1.conf +0 -161
  193. data/asciidoc/examples/website/layout1.css +0 -65
  194. data/asciidoc/examples/website/layout2.conf +0 -158
  195. data/asciidoc/examples/website/layout2.css +0 -93
  196. data/asciidoc/examples/website/manpage.html +0 -266
  197. data/asciidoc/examples/website/manpage.txt +0 -118
  198. data/asciidoc/examples/website/music-filter.html +0 -242
  199. data/asciidoc/examples/website/music-filter.txt +0 -158
  200. data/asciidoc/examples/website/music1.abc +0 -12
  201. data/asciidoc/examples/website/music1.png +0 -0
  202. data/asciidoc/examples/website/music2.ly +0 -9
  203. data/asciidoc/examples/website/music2.png +0 -0
  204. data/asciidoc/examples/website/newlists.txt +0 -40
  205. data/asciidoc/examples/website/newtables.txt +0 -397
  206. data/asciidoc/examples/website/sample1.png +0 -0
  207. data/asciidoc/examples/website/sample3.png +0 -0
  208. data/asciidoc/examples/website/sample4.png +0 -0
  209. data/asciidoc/examples/website/source-highlight-filter.html +0 -286
  210. data/asciidoc/examples/website/source-highlight-filter.txt +0 -203
  211. data/asciidoc/examples/website/support.html +0 -78
  212. data/asciidoc/examples/website/support.txt +0 -5
  213. data/asciidoc/examples/website/toc.js +0 -69
  214. data/asciidoc/examples/website/userguide.html +0 -7460
  215. data/asciidoc/examples/website/userguide.txt +0 -4979
  216. data/asciidoc/examples/website/version83.txt +0 -37
  217. data/asciidoc/examples/website/version9.html +0 -143
  218. data/asciidoc/examples/website/version9.txt +0 -48
  219. data/asciidoc/examples/website/xhtml11-quirks.css +0 -41
  220. data/asciidoc/examples/website/xhtml11.css +0 -328
  221. data/asciidoc/stylesheets/xhtml11-manpage.css +0 -18
  222. 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>&#187;<a href="index.html">Home</a></div>
21
- <div>&#187;<a href="manpage.html">Man&nbsp;Page</a></div>
22
- <div>&#187;<a href="userguide.html">User&nbsp;Guide</a></div>
23
- <div>&#187;<a href="http://powerman.name/doc/asciidoc">Cheatsheet</a></div>
24
- <div>&#187;<a href="a2x.1.html">a2x</a></div>
25
- <div>&#187;<a href="README.html">README</a></div>
26
- <div>&#187;<a href="CHANGELOG.html">ChangeLog</a></div>
27
- <div>&#187;<a href="INSTALL.html">Installation</a></div>
28
- <div>&#187;<a href="downloads.html">Downloads</a></div>
29
- <div>&#187;<a href="faq.html">FAQ</a></div>
30
- <div>&#187;<a href="support.html">Support</a></div>
31
- <div id="page-source">&#187;<a href="CHANGELOG.txt">Page&nbsp;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&#8217;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&#8201;&#8212;&#8201;they are included in the element&#8217;s text
126
- and we don&#8217;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>&lt;&gt;</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&#8217;s updated autoconf
173
- scripts&#8201;&#8212;&#8201;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>&amp;&#8230;;</tt> was sometimes mistaken for an entity
209
- reference&#8201;&#8212;&#8201;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 &#8216;single quoted&#8217; element.
313
- </p>
314
- </li>
315
- <li>
316
- <p>
317
- Spaces on both sides of a&#8201;&#8212;&#8201;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>&lt;optionname&gt;-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&#8217;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&#8201;&#8212;&#8201;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&#8217;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&#8201;&#8212;&#8201;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&#8201;&#8212;&#8201;it&#8217;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&#8201;&#8212;&#8201;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&#8201;&#8212;&#8201;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&#8217;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>&lt;programlisting&gt;</tt> elements rather than GNU Highlighter&#8201;&#8212;&#8201;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&#8217;s FOP 0.95 patch which fixes a long-standing
699
- <tt>fo.xsl</tt> problem and allows PDF&#8217;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&#8217;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 &#8594; &#8592; &#8658; &#8656; arrow replacements from the Arrows block of
777
- Unicode.
778
- </p>
779
- </li>
780
- <li>
781
- <p>
782
- Added DocBook refentry lang attribute&#8201;&#8212;&#8201;patch contributed by
783
- VMiklos.
784
- </p>
785
- </li>
786
- <li>
787
- <p>
788
- AttributeEntry names can now be numeric (&#8220;named macro targets&#8221;).
789
- </p>
790
- </li>
791
- <li>
792
- <p>
793
- Hide Table of Contents title if Table of Contents empty&#8201;&#8212;&#8201;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&#8201;&#8212;&#8201;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&#8201;&#8212;&#8201;it was
885
- incompatible with Python &lt;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-&lt;lang&gt;.conf</tt> will be loaded automatically.
908
- </p>
909
- </li>
910
- <li>
911
- <p>
912
- The help file name <tt>help-&lt;lang&gt;.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&#8217;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&#8217;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>&lt;a&gt;</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&#8201;&#8212;&#8201;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&#8201;&#8212;&#8201;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&#8201;&#8212;&#8201;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&#8201;&#8212;&#8201;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&#8201;&#8212;&#8201;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&#8217;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&#8201;&#8212;&#8201;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>&lt;attribution&gt;</tt> element is not generated (previously generated empty
1174
- <tt>&lt;attribution&gt;</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&#8217;ve simplified things
1226
- somewhat to match Docbook XSL Stylesheets style, see Troy&#8217;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&#8217;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>+&#8230;+</tt> and <tt><tt>+&#8230;</tt>+</tt> to <tt>((&#8230;))</tt> and <tt>(((&#8230;)))</tt> respectively.
1346
- Rationale:
1347
- </p>
1348
- <div class="ulist"><ul>
1349
- <li>
1350
- <p>
1351
- Bracketing is consistent other with <tt>[[&#8230;]]</tt> and <tt>&lt;&lt;&#8230;&gt;&gt;</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&#8201;&#8212;&#8201;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>&#8201;&#8212;&#8201; 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>&#8201;&#8212;&#8201;here&#8217;s his description of the
1480
- problem:
1481
- </p>
1482
- <div class="paragraph"><p>&#8220;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>.&#8221;</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>#&#8230;\#</tt> quoting&#8201;&#8212;&#8201;it does nothing&#8201;&#8212;&#8201;it&#8217;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&#8201;&#8212;&#8201; 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&#8201;&#8212;&#8201;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&#8217;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&#160;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>{&lt;name&gt;@&lt;regexp&gt;:&lt;value1&gt;[:&lt;value2&gt;]}</tt> and
1774
- <tt>{&lt;name&gt;$&lt;regexp&gt;:&lt;value1&gt;[:&lt;value2&gt;]}</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&#8217;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&#8201;&#8212;&#8201;if your application configurations can be
1803
- compromised you&#8217;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&#8217;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&#8201;&#8212;&#8201;<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&#8201;&#8212;&#8201;they&#8217;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&#8201;&#8212;&#8201;it&#8217;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&#8201;&#8212;&#8201;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&#8217;s role.
2203
- </p>
2204
- </li>
2205
- <li>
2206
- <p>
2207
- Added a List Continuation block&#8201;&#8212;&#8201;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>&lt;u&gt;</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&#8201;&#8212;&#8201;<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&#8201;&#8212;&#8201;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&#8201;&#8212;&#8201;established
2315
- a unified notion of document attributes. Attempted to introduce a
2316
- consistent vocabulary&#8201;&#8212;&#8201;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&#8217;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
- &#8216;`double backtick / apostrophe&#8217;' quotes generate &#8220;curly quotes&#8221;.
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>&lt;hr/&gt;</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&#8217;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&#8217;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>[[[&lt;id&gt;]]]</tt> is available, it
2448
- displays <tt>[&lt;id&gt;]</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&#8201;&#8212;&#8201;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&#8201;&#8212;&#8201;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 &#174; 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&#8217;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&#8217;s only a naming convention&#8201;&#8212;&#8201;you don&#8217;t have to
2617
- switch if you don&#8217;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>&lt;primary&gt;,&lt;secondary&gt;,&lt;tertiary&gt;</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>&lt;primary&gt;</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&#8201;&#8212;&#8201;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&#8217;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>&mdash;</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>&#35;NEW&#35;</tt>.
2887
- </p>
2888
- </li>
2889
- <li>
2890
- <p>
2891
- <tt>&amp;35;NEW&#35;</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-&lt;filetype&gt;</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&#8217;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>{&lt;name&gt;%&lt;value&gt;}</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:&lt;expr&gt;}</tt> glossary references drop the containing line if
3245
- <tt>&lt;expr&gt;</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>{&lt;name&gt;!&lt;value&gt;}</tt>
3354
- and <tt>{&lt;name&gt;#&lt;value&gt;}</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>{&lt;name&gt;?&lt;value&gt;}</tt>.
3451
- <tt>&lt;name&gt;</tt> is the glossary entry name and <tt>&lt;value&gt;</tt> is the text
3452
- substituted if the glossary entry is defined. <tt>&lt;value&gt;</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&#8217;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&#8217;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&#8217;ve symlinked or aliased to <tt>asciidoc</tt> you&#8217;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>