FooBarWidget-mizuho 0.9.3 → 0.9.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/asciidoc/BUGS +3 -3
- data/asciidoc/CHANGELOG +112 -63
- data/asciidoc/CHANGELOG.txt +50 -0
- data/asciidoc/INSTALL +6 -6
- data/asciidoc/Makefile.in +21 -5
- data/asciidoc/README +3 -3
- data/asciidoc/asciidoc.conf +9 -12
- data/asciidoc/asciidoc.py +204 -151
- data/asciidoc/common.aap +2 -2
- data/asciidoc/doc/a2x.1 +4 -3
- data/asciidoc/doc/a2x.1.txt +1 -1
- data/asciidoc/doc/article.css-embedded.html +13 -12
- data/asciidoc/doc/article.html +46 -644
- data/asciidoc/doc/article.pdf +0 -0
- data/asciidoc/doc/asciidoc.1 +2 -2
- data/asciidoc/doc/asciidoc.1.css-embedded.html +14 -13
- data/asciidoc/doc/asciidoc.1.css.html +3 -3
- data/asciidoc/doc/asciidoc.1.html +3 -3
- data/asciidoc/doc/asciidoc.css-embedded.html +238 -225
- data/asciidoc/doc/asciidoc.css.html +227 -215
- data/asciidoc/doc/asciidoc.dict +10 -1
- data/asciidoc/doc/asciidoc.html +181 -164
- data/asciidoc/doc/asciidoc.txt +167 -148
- data/asciidoc/doc/asciimathml.txt +5 -4
- data/asciidoc/doc/book.css-embedded.html +13 -12
- data/asciidoc/doc/faq.txt +60 -3
- data/asciidoc/doc/music-filter.html +94 -41
- data/asciidoc/doc/music-filter.pdf +0 -0
- data/asciidoc/doc/source-highlight-filter.html +125 -465
- data/asciidoc/doc/source-highlight-filter.pdf +0 -0
- data/asciidoc/docbook.conf +8 -2
- data/asciidoc/examples/website/CHANGELOG.html +129 -4
- data/asciidoc/examples/website/INSTALL.html +6 -6
- data/asciidoc/examples/website/README-website.html +3 -3
- data/asciidoc/examples/website/README.html +3 -3
- data/asciidoc/examples/website/a2x.1.html +4 -4
- data/asciidoc/examples/website/asciidoc-docbook-xsl.html +3 -3
- data/asciidoc/examples/website/asciidoc-graphviz-sample.txt +1 -0
- data/asciidoc/examples/website/downloads.html +7 -7
- data/asciidoc/examples/website/faq.html +95 -40
- data/asciidoc/examples/website/index.html +34 -13
- data/asciidoc/examples/website/index.txt +25 -9
- data/asciidoc/examples/website/latex-backend.html +4 -4
- data/asciidoc/examples/website/manpage.html +3 -3
- data/asciidoc/examples/website/music-filter.html +3 -3
- data/asciidoc/examples/website/sample1.png +0 -0
- data/asciidoc/examples/website/sample3.png +0 -0
- data/asciidoc/examples/website/sample4.png +0 -0
- data/asciidoc/examples/website/source-highlight-filter.html +5 -5
- data/asciidoc/examples/website/support.html +3 -3
- data/asciidoc/examples/website/userguide.html +227 -215
- data/asciidoc/examples/website/version9.html +3 -3
- data/asciidoc/filters/{code-filter-readme.txt → code/code-filter-readme.txt} +0 -0
- data/asciidoc/filters/{code-filter-test.txt → code/code-filter-test.txt} +0 -0
- data/asciidoc/filters/{code-filter.conf → code/code-filter.conf} +1 -1
- data/asciidoc/filters/{code-filter.py → code/code-filter.py} +0 -0
- data/asciidoc/filters/graphviz/asciidoc-graphviz-sample.txt +130 -0
- data/asciidoc/filters/graphviz/graphviz-filter.conf +39 -0
- data/asciidoc/filters/graphviz/graphviz2png.py +154 -0
- data/asciidoc/filters/{music-filter-test.txt → music/music-filter-test.txt} +0 -0
- data/asciidoc/filters/{music-filter.conf → music/music-filter.conf} +0 -0
- data/asciidoc/filters/{music2png.py → music/music2png.py} +0 -0
- data/asciidoc/filters/{source-highlight-filter-test.txt → source/source-highlight-filter-test.txt} +0 -0
- data/asciidoc/filters/{source-highlight-filter.conf → source/source-highlight-filter.conf} +2 -1
- data/asciidoc/html4.conf +5 -2
- data/asciidoc/stylesheets/xhtml11-quirks.css +0 -8
- data/asciidoc/stylesheets/xhtml11.css +11 -2
- data/asciidoc/vim/syntax/asciidoc.vim +1 -1
- data/asciidoc/xhtml11.conf +5 -2
- data/lib/mizuho/parser.rb +5 -1
- data/mizuho.gemspec +5 -16
- data/test/parser_spec.rb +49 -0
- metadata +22 -10
Binary file
|
data/asciidoc/docbook.conf
CHANGED
@@ -132,12 +132,12 @@ item=<listitem>|</listitem>
|
|
132
132
|
text=<simpara>|</simpara>
|
133
133
|
|
134
134
|
[listtags-numbered]
|
135
|
-
list=<orderedlist{id? id="{id}"}{compact-option? spacing="compact"}>{title?<title>{title}</title>}|</orderedlist>
|
135
|
+
list=<orderedlist{id? id="{id}"} numeration="{style}"{compact-option? spacing="compact"}>{title?<title>{title}</title>}|</orderedlist>
|
136
136
|
item=<listitem>|</listitem>
|
137
137
|
text=<simpara>|</simpara>
|
138
138
|
|
139
139
|
[listtags-numbered2]
|
140
|
-
list=<orderedlist{id? id="{id}"} numeration="
|
140
|
+
list=<orderedlist{id? id="{id}"} numeration="{style}"{compact-option? spacing="compact"}>{title?<title>{title}</title>}|</orderedlist>
|
141
141
|
item=<listitem>|</listitem>
|
142
142
|
text=<simpara>|</simpara>
|
143
143
|
|
@@ -283,6 +283,12 @@ template::[verseblock]
|
|
283
283
|
|
|
284
284
|
</sidebar>
|
285
285
|
|
286
|
+
[abstractblock]
|
287
|
+
<abstract{id? id="{id}"}>
|
288
|
+
<title>{title}</title>
|
289
|
+
|
|
290
|
+
</abstract>
|
291
|
+
|
286
292
|
[quoteblock]
|
287
293
|
<blockquote{id? id="{id}"}>
|
288
294
|
<title>{title}</title>
|
@@ -3,7 +3,7 @@
|
|
3
3
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
|
4
4
|
<head>
|
5
5
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
6
|
-
<meta name="generator" content="AsciiDoc 8.3.
|
6
|
+
<meta name="generator" content="AsciiDoc 8.3.3" />
|
7
7
|
<link rel="stylesheet" href="./xhtml11.css" type="text/css" />
|
8
8
|
<link rel="stylesheet" href="./xhtml11-quirks.css" type="text/css" />
|
9
9
|
<link rel="stylesheet" href="./layout1.css" type="text/css" />
|
@@ -39,6 +39,131 @@
|
|
39
39
|
<div class="sectionbody">
|
40
40
|
</div>
|
41
41
|
</div>
|
42
|
+
<h2 id="_version_8_3_3_2009_01_02">Version 8.3.3 (2009-01-02)</h2>
|
43
|
+
<div class="sectionbody">
|
44
|
+
<div class="paragraph"><p>This release supercedes 8.3.2.</p></div>
|
45
|
+
<div class="ulist"><div class="title">Bug fixes</div><ul>
|
46
|
+
<li>
|
47
|
+
<p>
|
48
|
+
The broken and confusing numeration and numeration2 numbered list
|
49
|
+
attributes have been dropped, use the style attribute instead.
|
50
|
+
</p>
|
51
|
+
</li>
|
52
|
+
</ul></div>
|
53
|
+
</div>
|
54
|
+
<h2 id="_version_8_3_2_2009_01_01">Version 8.3.2 (2009-01-01)</h2>
|
55
|
+
<div class="sectionbody">
|
56
|
+
<div class="ulist"><div class="title">Additions and changes</div><ul>
|
57
|
+
<li>
|
58
|
+
<p>
|
59
|
+
Added Gouichi Iisaka’s Graphviz filter to distribution.
|
60
|
+
</p>
|
61
|
+
</li>
|
62
|
+
<li>
|
63
|
+
<p>
|
64
|
+
The <em>SidebarBlock</em> element can now be rendered with an <em>abstract</em>
|
65
|
+
style.
|
66
|
+
</p>
|
67
|
+
</li>
|
68
|
+
<li>
|
69
|
+
<p>
|
70
|
+
Reorganized filters into a separate subdirectory for each filter.
|
71
|
+
</p>
|
72
|
+
</li>
|
73
|
+
<li>
|
74
|
+
<p>
|
75
|
+
Updated <tt>Makefile.in</tt> and <tt>MANIFEST</tt> files to reflect new filters
|
76
|
+
organization.
|
77
|
+
</p>
|
78
|
+
</li>
|
79
|
+
<li>
|
80
|
+
<p>
|
81
|
+
Added <em>listing</em> style to <em>LiteralBlock</em> element so listings with
|
82
|
+
nested listing blocks can be rendered as a listing block.
|
83
|
+
</p>
|
84
|
+
</li>
|
85
|
+
<li>
|
86
|
+
<p>
|
87
|
+
Changed example <em>code</em> filter to use preferred <em>ListingBlock</em> syntax
|
88
|
+
(the old <tt>~</tt> delimited filter syntax is no longer used).
|
89
|
+
</p>
|
90
|
+
</li>
|
91
|
+
<li>
|
92
|
+
<p>
|
93
|
+
Implemented <em>enumeration</em> and <em>enumeration2</em> numbered list
|
94
|
+
attributes for specifying the list numbering style (<em>arabic</em>,
|
95
|
+
<em>loweralpha</em>, <em>upperalpha</em>, <em>lowerroman</em> and <em>upperroman</em>).
|
96
|
+
</p>
|
97
|
+
</li>
|
98
|
+
<li>
|
99
|
+
<p>
|
100
|
+
<em>AsciiDoc</em> now recognizes <em>upperalpha</em>, <em>lowerroman</em> and <em>upperroman</em>
|
101
|
+
numbers in <tt>listdef-numbered2</tt> numbered lists and sets the number
|
102
|
+
style based on the style of the first numbered list item
|
103
|
+
(alternative to setting <em>enumeration2</em> attribute).
|
104
|
+
</p>
|
105
|
+
</li>
|
106
|
+
<li>
|
107
|
+
<p>
|
108
|
+
Updated <tt>formatlistpat</tt> definition in <tt>.vimrc</tt> example in User
|
109
|
+
Guide.
|
110
|
+
</p>
|
111
|
+
</li>
|
112
|
+
<li>
|
113
|
+
<p>
|
114
|
+
You can now backslash escape system block macros.
|
115
|
+
</p>
|
116
|
+
</li>
|
117
|
+
<li>
|
118
|
+
<p>
|
119
|
+
Added <em>Pychart</em> FAQ.
|
120
|
+
</p>
|
121
|
+
</li>
|
122
|
+
<li>
|
123
|
+
<p>
|
124
|
+
Drop paragraph <em>text</em> and list <em>text</em>, <em>index</em> and <em>label</em> match
|
125
|
+
groups from attributes — they are included in the element’s text
|
126
|
+
and we don’t want them processed a second time as attributes.
|
127
|
+
</p>
|
128
|
+
</li>
|
129
|
+
<li>
|
130
|
+
<p>
|
131
|
+
Changed comment line block macro to a passthrough block macro to
|
132
|
+
ensure no substitutions.
|
133
|
+
</p>
|
134
|
+
</li>
|
135
|
+
<li>
|
136
|
+
<p>
|
137
|
+
A <em>subslist</em> no longer has to be appended to a <em>PassthroughBlock</em>
|
138
|
+
macro definition, if omitted no substitutions are performed.
|
139
|
+
</p>
|
140
|
+
</li>
|
141
|
+
<li>
|
142
|
+
<p>
|
143
|
+
Code tidy up: replaced deprecated <tt><></tt> operator with <tt>!=</tt>.
|
144
|
+
</p>
|
145
|
+
</li>
|
146
|
+
<li>
|
147
|
+
<p>
|
148
|
+
Removed unused linuxdoc code.
|
149
|
+
</p>
|
150
|
+
</li>
|
151
|
+
<li>
|
152
|
+
<p>
|
153
|
+
Code tidy ups: dropped old types module reference; replaced
|
154
|
+
<tt>has_key()</tt> with preferred <tt>in</tt> operator.
|
155
|
+
</p>
|
156
|
+
</li>
|
157
|
+
</ul></div>
|
158
|
+
<div class="ulist"><div class="title">Bug fixes</div><ul>
|
159
|
+
<li>
|
160
|
+
<p>
|
161
|
+
Old syntax source highlight filter regression: special characters
|
162
|
+
where not escaped in DocBook outputs.
|
163
|
+
</p>
|
164
|
+
</li>
|
165
|
+
</ul></div>
|
166
|
+
</div>
|
42
167
|
<h2 id="_version_8_3_1_2008_12_14">Version 8.3.1 (2008-12-14)</h2>
|
43
168
|
<div class="sectionbody">
|
44
169
|
<div class="ulist"><div class="title">Additions and changes</div><ul>
|
@@ -2996,7 +3121,7 @@ Fixed broken code-filter <tt>-b linuxdoc</tt> option. The asciidoc.asc User
|
|
2996
3121
|
</p>
|
2997
3122
|
</li>
|
2998
3123
|
</ul></div>
|
2999
|
-
<div class="olist"><div class="title">Compatibility issues:</div><ol>
|
3124
|
+
<div class="olist arabic"><div class="title">Compatibility issues:</div><ol class="arabic">
|
3000
3125
|
<li>
|
3001
3126
|
<p>
|
3002
3127
|
Table titles are no longer in the arguments line, use the new
|
@@ -4235,8 +4360,8 @@ Fixed error that occurred when <em>==</em> title underline was
|
|
4235
4360
|
</div>
|
4236
4361
|
<div id="footer">
|
4237
4362
|
<div id="footer-text">
|
4238
|
-
Version 8.3.
|
4239
|
-
Last updated
|
4363
|
+
Version 8.3.3<br />
|
4364
|
+
Last updated 2009-01-02 12:58:49 NZDT
|
4240
4365
|
</div>
|
4241
4366
|
<div id="footer-badges">
|
4242
4367
|
<a href="http://validator.w3.org/check?uri=referer">
|
@@ -3,7 +3,7 @@
|
|
3
3
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
|
4
4
|
<head>
|
5
5
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
6
|
-
<meta name="generator" content="AsciiDoc 8.3.
|
6
|
+
<meta name="generator" content="AsciiDoc 8.3.3" />
|
7
7
|
<link rel="stylesheet" href="./xhtml11.css" type="text/css" />
|
8
8
|
<link rel="stylesheet" href="./xhtml11-quirks.css" type="text/css" />
|
9
9
|
<link rel="stylesheet" href="./layout1.css" type="text/css" />
|
@@ -79,8 +79,8 @@ directory.</p></div>
|
|
79
79
|
that is tailored for your system. To install:</p></div>
|
80
80
|
<div class="literalblock">
|
81
81
|
<div class="content">
|
82
|
-
<pre><tt>$ tar -xzf asciidoc-8.3.
|
83
|
-
$ cd asciidoc-8.3.
|
82
|
+
<pre><tt>$ tar -xzf asciidoc-8.3.3.tar.gz
|
83
|
+
$ cd asciidoc-8.3.3
|
84
84
|
$ ./configure
|
85
85
|
$ make
|
86
86
|
$ sudo make install</tt></pre>
|
@@ -108,7 +108,7 @@ new folder:</p></div>
|
|
108
108
|
<div class="content">
|
109
109
|
<pre><tt>$ mkdir asciidoc
|
110
110
|
$ cd asciidoc
|
111
|
-
$ unzip ../asciidoc-8.3.
|
111
|
+
$ unzip ../asciidoc-8.3.3.zip</tt></pre>
|
112
112
|
</div></div>
|
113
113
|
</div>
|
114
114
|
<h2 id="_testing_your_installation">Testing your installation</h2>
|
@@ -132,8 +132,8 @@ directly or create a suitable <tt>asciidoc.bat</tt> file.</td>
|
|
132
132
|
</div>
|
133
133
|
<div id="footer">
|
134
134
|
<div id="footer-text">
|
135
|
-
Version 8.3.
|
136
|
-
Last updated
|
135
|
+
Version 8.3.3<br />
|
136
|
+
Last updated 2009-01-02 11:18:50 NZDT
|
137
137
|
</div>
|
138
138
|
<div id="footer-badges">
|
139
139
|
<a href="http://validator.w3.org/check?uri=referer">
|
@@ -3,7 +3,7 @@
|
|
3
3
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
|
4
4
|
<head>
|
5
5
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
6
|
-
<meta name="generator" content="AsciiDoc 8.3.
|
6
|
+
<meta name="generator" content="AsciiDoc 8.3.3" />
|
7
7
|
<link rel="stylesheet" href="./xhtml11.css" type="text/css" />
|
8
8
|
<link rel="stylesheet" href="./xhtml11-quirks.css" type="text/css" />
|
9
9
|
<link rel="stylesheet" href="./layout1.css" type="text/css" />
|
@@ -89,8 +89,8 @@ browsers.</p></div>
|
|
89
89
|
</div>
|
90
90
|
<div id="footer">
|
91
91
|
<div id="footer-text">
|
92
|
-
Version 8.3.
|
93
|
-
Last updated
|
92
|
+
Version 8.3.3<br />
|
93
|
+
Last updated 2009-01-02 11:18:54 NZDT
|
94
94
|
</div>
|
95
95
|
<div id="footer-badges">
|
96
96
|
<a href="http://validator.w3.org/check?uri=referer">
|
@@ -3,7 +3,7 @@
|
|
3
3
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
|
4
4
|
<head>
|
5
5
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
6
|
-
<meta name="generator" content="AsciiDoc 8.3.
|
6
|
+
<meta name="generator" content="AsciiDoc 8.3.3" />
|
7
7
|
<link rel="stylesheet" href="./xhtml11.css" type="text/css" />
|
8
8
|
<link rel="stylesheet" href="./xhtml11-quirks.css" type="text/css" />
|
9
9
|
<link rel="stylesheet" href="./layout1.css" type="text/css" />
|
@@ -96,8 +96,8 @@ is granted under the terms of the GNU General Public License (GPL).</p></div>
|
|
96
96
|
</div>
|
97
97
|
<div id="footer">
|
98
98
|
<div id="footer-text">
|
99
|
-
Version 8.3.
|
100
|
-
Last updated
|
99
|
+
Version 8.3.3<br />
|
100
|
+
Last updated 2009-01-02 11:18:53 NZDT
|
101
101
|
</div>
|
102
102
|
<div id="footer-badges">
|
103
103
|
<a href="http://validator.w3.org/check?uri=referer">
|
@@ -3,7 +3,7 @@
|
|
3
3
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
|
4
4
|
<head>
|
5
5
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
6
|
-
<meta name="generator" content="AsciiDoc 8.3.
|
6
|
+
<meta name="generator" content="AsciiDoc 8.3.3" />
|
7
7
|
<link rel="stylesheet" href="./xhtml11.css" type="text/css" />
|
8
8
|
<link rel="stylesheet" href="./xhtml11-manpage.css" type="text/css" />
|
9
9
|
<link rel="stylesheet" href="./xhtml11-quirks.css" type="text/css" />
|
@@ -177,7 +177,7 @@ files suitable for compilation to an HTML Help .chm file.</p></div>
|
|
177
177
|
<dd>
|
178
178
|
<p>
|
179
179
|
Skip asciidoc execution. This is useful for converting DocBook XML
|
180
|
-
files not derived from <em>AsciiDoc</em> sources. Ignored if
|
180
|
+
files not derived from <em>AsciiDoc</em> sources. Ignored if <em>--format=text</em>.
|
181
181
|
</p>
|
182
182
|
</dd>
|
183
183
|
<dt class="hdlist1">
|
@@ -390,8 +390,8 @@ granted under the terms of the GNU General Public License (GPL).</p></div>
|
|
390
390
|
</div>
|
391
391
|
<div id="footer">
|
392
392
|
<div id="footer-text">
|
393
|
-
Version 8.3.
|
394
|
-
Last updated
|
393
|
+
Version 8.3.3<br />
|
394
|
+
Last updated 2009-01-02 11:18:42 NZDT
|
395
395
|
</div>
|
396
396
|
<div id="footer-badges">
|
397
397
|
<a href="http://validator.w3.org/check?uri=referer">
|
@@ -3,7 +3,7 @@
|
|
3
3
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
|
4
4
|
<head>
|
5
5
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
6
|
-
<meta name="generator" content="AsciiDoc 8.3.
|
6
|
+
<meta name="generator" content="AsciiDoc 8.3.3" />
|
7
7
|
<link rel="stylesheet" href="./xhtml11.css" type="text/css" />
|
8
8
|
<link rel="stylesheet" href="./xhtml11-quirks.css" type="text/css" />
|
9
9
|
<link rel="stylesheet" href="./layout1.css" type="text/css" />
|
@@ -101,8 +101,8 @@ $ sudo vi docbook-xsl.xml</tt></pre>
|
|
101
101
|
</div>
|
102
102
|
<div id="footer">
|
103
103
|
<div id="footer-text">
|
104
|
-
Version 8.3.
|
105
|
-
Last updated
|
104
|
+
Version 8.3.3<br />
|
105
|
+
Last updated 2009-01-02 11:18:43 NZDT
|
106
106
|
</div>
|
107
107
|
<div id="footer-badges">
|
108
108
|
<a href="http://validator.w3.org/check?uri=referer">
|
@@ -0,0 +1 @@
|
|
1
|
+
../../filters/graphviz/asciidoc-graphviz-sample.txt
|
@@ -3,7 +3,7 @@
|
|
3
3
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
|
4
4
|
<head>
|
5
5
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
6
|
-
<meta name="generator" content="AsciiDoc 8.3.
|
6
|
+
<meta name="generator" content="AsciiDoc 8.3.3" />
|
7
7
|
<link rel="stylesheet" href="./xhtml11.css" type="text/css" />
|
8
8
|
<link rel="stylesheet" href="./xhtml11-quirks.css" type="text/css" />
|
9
9
|
<link rel="stylesheet" href="./layout1.css" type="text/css" />
|
@@ -58,7 +58,7 @@ for install prerequisites and procedures.</p></div>
|
|
58
58
|
<a href="http://sourceforge.net/projects/asciidoc/">http://sourceforge.net/projects/asciidoc/</a>.</p></div>
|
59
59
|
<div class="dlist"><dl>
|
60
60
|
<dt class="hdlist1">
|
61
|
-
<a href="asciidoc-8.3.
|
61
|
+
<a href="asciidoc-8.3.3.tar.gz">asciidoc-8.3.3.tar.gz</a>
|
62
62
|
</dt>
|
63
63
|
<dd>
|
64
64
|
<p>
|
@@ -67,7 +67,7 @@ for install prerequisites and procedures.</p></div>
|
|
67
67
|
</p>
|
68
68
|
</dd>
|
69
69
|
<dt class="hdlist1">
|
70
|
-
<a href="asciidoc-8.3.
|
70
|
+
<a href="asciidoc-8.3.3.zip">asciidoc-8.3.3.zip</a>
|
71
71
|
</dt>
|
72
72
|
<dd>
|
73
73
|
<p>
|
@@ -102,12 +102,12 @@ Make sure you have <a href="http://www.selenic.com/mercurial/">Mercurial</a>
|
|
102
102
|
<li>
|
103
103
|
<p>
|
104
104
|
Go to the directory you want to install <em>AsciiDoc</em> into and download
|
105
|
-
the repository. This example gets the 8.3.
|
105
|
+
the repository. This example gets the 8.3.3 tagged release:
|
106
106
|
</p>
|
107
107
|
<div class="literalblock">
|
108
108
|
<div class="content">
|
109
109
|
<pre><tt>$ cd ~/bin
|
110
|
-
$ hg clone -r 8.3.
|
110
|
+
$ hg clone -r 8.3.3 http://hg.sharesource.org/asciidoc asciidoc.hg</tt></pre>
|
111
111
|
</div></div>
|
112
112
|
</li>
|
113
113
|
<li>
|
@@ -228,8 +228,8 @@ granted under the terms of the GNU General Public License (GPL).</p></div>
|
|
228
228
|
</div>
|
229
229
|
<div id="footer">
|
230
230
|
<div id="footer-text">
|
231
|
-
Version 8.3.
|
232
|
-
Last updated
|
231
|
+
Version 8.3.3<br />
|
232
|
+
Last updated 2009-01-02 11:18:48 NZDT
|
233
233
|
</div>
|
234
234
|
<div id="footer-badges">
|
235
235
|
<a href="http://validator.w3.org/check?uri=referer">
|
@@ -3,7 +3,7 @@
|
|
3
3
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
|
4
4
|
<head>
|
5
5
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
6
|
-
<meta name="generator" content="AsciiDoc 8.3.
|
6
|
+
<meta name="generator" content="AsciiDoc 8.3.3" />
|
7
7
|
<link rel="stylesheet" href="./xhtml11.css" type="text/css" />
|
8
8
|
<link rel="stylesheet" href="./xhtml11-quirks.css" type="text/css" />
|
9
9
|
<link rel="stylesheet" href="./layout1.css" type="text/css" />
|
@@ -50,7 +50,70 @@ window.onload = function(){generateToc(2)}
|
|
50
50
|
<div class="paragraph"><p>An embryonic <em>AsciiDoc</em> FAQ.</p></div>
|
51
51
|
</div>
|
52
52
|
</div>
|
53
|
-
<h2 id="
|
53
|
+
<h2 id="_is_it_possible_to_include_charts_in_asciidoc_documents">1. Is it possible to include charts in AsciiDoc documents?</h2>
|
54
|
+
<div class="sectionbody">
|
55
|
+
<div class="paragraph"><p>There are a number of programs available that generate presentation
|
56
|
+
charts from textual specification, for example
|
57
|
+
<a href="http://home.gna.org/pychart/">Pychart</a> is a library for writing chart
|
58
|
+
scripts in Python. Here’s an example from the <em>Pychart</em> documentation:</p></div>
|
59
|
+
<div class="listingblock">
|
60
|
+
<div class="title">barchart.py</div>
|
61
|
+
<div class="content">
|
62
|
+
<pre><tt>#
|
63
|
+
# Example bar chart (from Pychart documentation http://home.gna.org/pychart/).
|
64
|
+
#
|
65
|
+
from pychart import *
|
66
|
+
theme.get_options()
|
67
|
+
|
68
|
+
data = [(10, 20, 30, 5), (20, 65, 33, 5), (30, 55, 30, 5), (40, 45, 51, 7),
|
69
|
+
(50, 25, 27, 3), (60, 75, 30, 5), (70, 80, 42, 5), (80, 62, 32, 5),
|
70
|
+
(90, 42, 39, 5), (100, 32, 39, 4)]
|
71
|
+
|
72
|
+
# The attribute y_coord=... tells that the Y axis values
|
73
|
+
# should be taken from samples.
|
74
|
+
# In this example, Y values will be [40,50,60,70,80].
|
75
|
+
ar = area.T(y_coord = category_coord.T(data[3:8], 0),
|
76
|
+
x_grid_style=line_style.gray50_dash1,
|
77
|
+
x_grid_interval=20, x_range = (0,100),
|
78
|
+
x_axis=axis.X(label="X label"),
|
79
|
+
y_axis=axis.Y(label="Y label"),
|
80
|
+
bg_style = fill_style.gray90,
|
81
|
+
border_line_style = line_style.default,
|
82
|
+
legend = legend.T(loc=(80,10)))
|
83
|
+
|
84
|
+
# Below call sets the default attributes for all bar plots.
|
85
|
+
chart_object.set_defaults(bar_plot.T, direction="horizontal", data=data)
|
86
|
+
|
87
|
+
# Attribute cluster=(0,3) tells that you are going to draw three bar
|
88
|
+
# plots side by side. The plot labeled "foo" will the leftmost (i.e.,
|
89
|
+
# 0th out of 3). Attribute hcol tells the column from which to
|
90
|
+
# retrive sample values from. It defaults to one.
|
91
|
+
ar.add_plot(bar_plot.T(label="foo", cluster=(0,3)))
|
92
|
+
ar.add_plot(bar_plot.T(label="bar", hcol=2, cluster=(1,3)))
|
93
|
+
ar.add_plot(bar_plot.T(label="baz", hcol=3, cluster=(2,3)))
|
94
|
+
ar.draw()</tt></pre>
|
95
|
+
</div></div>
|
96
|
+
<div class="paragraph"><p>To execute the script and include the generated chart image in your
|
97
|
+
document add the following lines to the <em>AsciiDoc</em> source:</p></div>
|
98
|
+
<div class="listingblock">
|
99
|
+
<div class="content">
|
100
|
+
<pre><tt>// Generate chart image file.
|
101
|
+
sys2::[python barchart.py --format=png --output=barchart.png --scale=2]
|
102
|
+
|
103
|
+
// Display chart image file.
|
104
|
+
image::barchart.png[]</tt></pre>
|
105
|
+
</div></div>
|
106
|
+
<div class="admonitionblock">
|
107
|
+
<table><tr>
|
108
|
+
<td class="icon">
|
109
|
+
<img src="./images/icons/note.png" alt="Note" />
|
110
|
+
</td>
|
111
|
+
<td class="content">You need to run <tt>asciidoc(1)</tt> with the <tt>--unsafe</tt> command-line
|
112
|
+
option to execute the <tt>sys2</tt> system macro.</td>
|
113
|
+
</tr></table>
|
114
|
+
</div>
|
115
|
+
</div>
|
116
|
+
<h2 id="_how_can_i_render_indented_paragraphs">2. How can I render indented paragraphs?</h2>
|
54
117
|
<div class="sectionbody">
|
55
118
|
<div class="paragraph"><p>To unconditionally indent all paragraphs add the following line to the
|
56
119
|
<tt>xhtml11.css</tt> stylesheet (or a custom stylesheet).</p></div>
|
@@ -89,7 +152,7 @@ stylesheets to indent paragraphs with the <tt>simpara</tt> element
|
|
89
152
|
</tr></table>
|
90
153
|
</div>
|
91
154
|
</div>
|
92
|
-
<h2 id="_is_there_a_way_to_set_default_image_height_and_width_attributes">
|
155
|
+
<h2 id="_is_there_a_way_to_set_default_image_height_and_width_attributes">3. Is there a way to set default image height and width attributes?</h2>
|
93
156
|
<div class="sectionbody">
|
94
157
|
<div class="paragraph"><p>You can set the <em>height</em> and <em>width</em> attributes globally in your
|
95
158
|
document with Attribute Entries or from the command-line using the
|
@@ -104,7 +167,7 @@ pixels.</p></div>
|
|
104
167
|
image:images/tiger.png[]</tt></pre>
|
105
168
|
</div></div>
|
106
169
|
</div>
|
107
|
-
<h2 id="_how_can_i_place_a_backslash_character_in_front_of_an_attribute_reference_without_escaping_the_reference">
|
170
|
+
<h2 id="_how_can_i_place_a_backslash_character_in_front_of_an_attribute_reference_without_escaping_the_reference">4. How can I place a backslash character in front of an attribute reference without escaping the reference?</h2>
|
108
171
|
<div class="sectionbody">
|
109
172
|
<div class="paragraph"><p>Use the predefined <tt>{backslash}</tt> attribute reference instead of an
|
110
173
|
actual backslash, for example if the <tt>{projectname}</tt> attribute has
|
@@ -119,7 +182,7 @@ the value <tt>foobar</tt> then:</p></div>
|
|
119
182
|
<pre><tt>d:\data\foobar</tt></pre>
|
120
183
|
</div></div>
|
121
184
|
</div>
|
122
|
-
<h2 id="_how_can_i_escape_asciidoc_markup">
|
185
|
+
<h2 id="_how_can_i_escape_asciidoc_markup">5. How can I escape AsciiDoc markup?</h2>
|
123
186
|
<div class="sectionbody">
|
124
187
|
<div class="paragraph"><p>Most <em>AsciiDoc</em> inline elements can be suppressed by preceding them with
|
125
188
|
a backslash character. These elements include:</p></div>
|
@@ -141,7 +204,7 @@ Quoting,
|
|
141
204
|
</li>
|
142
205
|
<li>
|
143
206
|
<p>
|
144
|
-
|
207
|
+
Macros.
|
145
208
|
</p>
|
146
209
|
</li>
|
147
210
|
<li>
|
@@ -162,7 +225,7 @@ Table cell separators.
|
|
162
225
|
</ul></div>
|
163
226
|
<div class="paragraph"><p>But there are exceptions — see the next question.</p></div>
|
164
227
|
</div>
|
165
|
-
<h2 id="_some_elements_can_8217_t_be_escaped_with_a_single_backslash">
|
228
|
+
<h2 id="_some_elements_can_8217_t_be_escaped_with_a_single_backslash">6. Some elements can’t be escaped with a single backslash</h2>
|
166
229
|
<div class="sectionbody">
|
167
230
|
<div class="paragraph"><p>There are a number of exceptions to the usual single backslash rule — mostly relating to URL macros that have two syntaxes or quoting
|
168
231
|
ambiguity. Here are some non-standard escape examples:</p></div>
|
@@ -199,16 +262,8 @@ A C+\+ Library for C+\+ \+++
|
|
199
262
|
<div class="paragraph"><p>The source of this problem is ambiguity across substitution types — the first match unescapes allowing the second to substitute. A
|
200
263
|
work-around for difficult cases is to side-step the problem using the
|
201
264
|
<tt>pass:[]</tt> passthrough inline macro.</p></div>
|
202
|
-
<div class="admonitionblock">
|
203
|
-
<table><tr>
|
204
|
-
<td class="icon">
|
205
|
-
<img src="./images/icons/note.png" alt="Note" />
|
206
|
-
</td>
|
207
|
-
<td class="content">System macros cannot be escaped.</td>
|
208
|
-
</tr></table>
|
209
|
-
</div>
|
210
265
|
</div>
|
211
|
-
<h2 id="_how_can_i_set_default_list_and_tables_styles">
|
266
|
+
<h2 id="_how_can_i_set_default_list_and_tables_styles">7. How can I set default list and tables styles?</h2>
|
212
267
|
<div class="sectionbody">
|
213
268
|
<div class="paragraph"><p>You can set the element’s <em>style</em> entry in a global or custom
|
214
269
|
configuration file.</p></div>
|
@@ -241,7 +296,7 @@ document, the above examples are equivalent to:</p></div>
|
|
241
296
|
:tabledef-default.style: topbot</tt></pre>
|
242
297
|
</div></div>
|
243
298
|
</div>
|
244
|
-
<h2 id="_why_do_i_get_a_filter_non_zero_exit_code_error">
|
299
|
+
<h2 id="_why_do_i_get_a_filter_non_zero_exit_code_error">8. Why do I get a filter non-zero exit code error?</h2>
|
245
300
|
<div class="sectionbody">
|
246
301
|
<div class="paragraph"><p>An error was returned when <em>AsciiDoc</em> tried to execute an external
|
247
302
|
filter command. The most common reason for this is that the filter
|
@@ -250,7 +305,7 @@ the problem is run <em>AsciiDoc</em> with the <tt>--verbose</tt> option to deter
|
|
250
305
|
the command that is failing and then try to run the command manually
|
251
306
|
from the command-line.</p></div>
|
252
307
|
</div>
|
253
|
-
<h2 id="_are_there_any_docbook_viewers">
|
308
|
+
<h2 id="_are_there_any_docbook_viewers">9. Are there any DocBook viewers?</h2>
|
254
309
|
<div class="sectionbody">
|
255
310
|
<div class="paragraph"><p><a href="http://live.gnome.org/Yelp">Yelp</a>, the GNOME help viewer, does a
|
256
311
|
creditable job of displaying DocBook files XML files directly. Just
|
@@ -272,7 +327,7 @@ yelp "file://$(pwd)/$1"</tt></pre>
|
|
272
327
|
</div></div>
|
273
328
|
<div class="paragraph"><p>This tip was submitted by Lionel Orry.</p></div>
|
274
329
|
</div>
|
275
|
-
<h2 id="_can_you_create_odf_documents_using_asciidoc">
|
330
|
+
<h2 id="_can_you_create_odf_documents_using_asciidoc">10. Can you create ODF documents using AsciiDoc?</h2>
|
276
331
|
<div class="sectionbody">
|
277
332
|
<div class="paragraph"><p>The easiest and highest fidelity methods I’ve seen is to generate
|
278
333
|
HTML from <em>AsciiDoc</em> then paste it from your browser (we use Firefox)
|
@@ -295,14 +350,14 @@ Don’t paste <em>AsciiDoc</em> tables of contents, OpenOffice Writer (I was
|
|
295
350
|
</ul></div>
|
296
351
|
<div class="paragraph"><p>This tip was contributed by Bernard Amade.</p></div>
|
297
352
|
</div>
|
298
|
-
<h2 id="_how_can_i_supress_cell_separators_in_included_table_data_files">
|
353
|
+
<h2 id="_how_can_i_supress_cell_separators_in_included_table_data_files">11. How can I supress cell separators in included table data files?</h2>
|
299
354
|
<div class="sectionbody">
|
300
355
|
<div class="paragraph"><p>Use the <tt>{include:}</tt> system attribute instead of the <tt>\include::[]</tt>
|
301
356
|
macro (the former is not expanded until after the table data has been
|
302
357
|
parsed into cells, whereas the latter is included before the table is
|
303
358
|
processed.</p></div>
|
304
359
|
</div>
|
305
|
-
<h2 id="_how_can_i_preserve_paragraph_line_boundaries">
|
360
|
+
<h2 id="_how_can_i_preserve_paragraph_line_boundaries">12. How can I preserve paragraph line boundaries?</h2>
|
306
361
|
<div class="sectionbody">
|
307
362
|
<div class="paragraph"><p>Apply the The <em>verse</em> paragraph style, the rendered text preserves
|
308
363
|
line boundaries and is useful for lyrics and poems. For example:</p></div>
|
@@ -322,18 +377,18 @@ consetetur, eu pro everti postulant +
|
|
322
377
|
homero verear ea mea, qui.</tt></pre>
|
323
378
|
</div></div>
|
324
379
|
</div>
|
325
|
-
<h2 id="_how_can_i_include_non_breaking_space_characters">
|
380
|
+
<h2 id="_how_can_i_include_non_breaking_space_characters">13. How can I include non-breaking space characters?</h2>
|
326
381
|
<div class="sectionbody">
|
327
382
|
<div class="paragraph"><p>The predefined <tt>{nbsp}</tt> attribute reference will be replaced by a
|
328
383
|
non-breaking space character. You could also use the non-breaking
|
329
384
|
space character entity reference <tt>&#160;</tt> (see the next question).</p></div>
|
330
385
|
</div>
|
331
|
-
<h2 id="_can_i_include_html_and_xml_character_entity_references_in_my_document">
|
386
|
+
<h2 id="_can_i_include_html_and_xml_character_entity_references_in_my_document">14. Can I include HTML and XML character entity references in my document?</h2>
|
332
387
|
<div class="sectionbody">
|
333
388
|
<div class="paragraph"><p>Yes, just enter the reference in your document. For example <tt>&#946;</tt>
|
334
389
|
will print a Greek small beta character β</p></div>
|
335
390
|
</div>
|
336
|
-
<h2 id="X1">
|
391
|
+
<h2 id="X1">15. How do I include spaces in URLs?</h2>
|
337
392
|
<div class="sectionbody">
|
338
393
|
<div class="paragraph"><p>URL inline macro targets (addresses) cannot contain white space
|
339
394
|
characters. If you need spaces encode them as <tt>%20</tt>. For example:</p></div>
|
@@ -343,7 +398,7 @@ characters. If you need spaces encode them as <tt>%20</tt>. For example:</p></di
|
|
343
398
|
http://www.foo.bar.com/an%20example%20document.html</tt></pre>
|
344
399
|
</div></div>
|
345
400
|
</div>
|
346
|
-
<h2 id="_how_can_i_get_asciidoc_to_assign_the_correct_docbook_language_attribute">
|
401
|
+
<h2 id="_how_can_i_get_asciidoc_to_assign_the_correct_docbook_language_attribute">16. How can I get AsciiDoc to assign the correct DocBook language attribute?</h2>
|
347
402
|
<div class="sectionbody">
|
348
403
|
<div class="paragraph"><p>Set the <em>AsciiDoc</em> <em>lang</em> attribute to the appropriate language code.
|
349
404
|
For example:</p></div>
|
@@ -356,7 +411,7 @@ correct language specific document headings (things like table of
|
|
356
411
|
contents, revision history, figure and table captions, admonition
|
357
412
|
captions).</p></div>
|
358
413
|
</div>
|
359
|
-
<h2 id="_why_does_asciidoc_give_me_a_8220_malformed_author_8221_error">
|
414
|
+
<h2 id="_why_does_asciidoc_give_me_a_8220_malformed_author_8221_error">17. Why does AsciiDoc give me a “malformed author” error?</h2>
|
360
415
|
<div class="sectionbody">
|
361
416
|
<div class="paragraph"><p>This is normally because there are more than three names (up to three
|
362
417
|
are expected: first name, middle name and last name). For example,
|
@@ -380,7 +435,7 @@ explicit attribute entries:</p></div>
|
|
380
435
|
:Last name: Van Gogh</tt></pre>
|
381
436
|
</div></div>
|
382
437
|
</div>
|
383
|
-
<h2 id="_how_can_i_assign_multiple_author_names">
|
438
|
+
<h2 id="_how_can_i_assign_multiple_author_names">18. How can I assign multiple author names?</h2>
|
384
439
|
<div class="sectionbody">
|
385
440
|
<div class="paragraph"><p>A quick way to do this is put both authors in a single first name, for
|
386
441
|
example:</p></div>
|
@@ -407,7 +462,7 @@ related markup:</p></div>
|
|
407
462
|
:</tt></pre>
|
408
463
|
</div></div>
|
409
464
|
</div>
|
410
|
-
<h2 id="_how_can_i_escape_a_labeled_list_entry">
|
465
|
+
<h2 id="_how_can_i_escape_a_labeled_list_entry">19. How can I escape a labeled list entry?</h2>
|
411
466
|
<div class="sectionbody">
|
412
467
|
<div class="paragraph"><p>Two colons or semicolons in a paragraph may be confused with a labeled
|
413
468
|
list entry. Use the predefined <tt>{two_colons}</tt> and <tt>{two_semicolons}</tt>
|
@@ -421,7 +476,7 @@ magna primis adolescens.</tt></pre>
|
|
421
476
|
<div class="paragraph"><p>Qui in magna commodo:: est labitur dolorum an. Est ne
|
422
477
|
magna primis adolescens.</p></div>
|
423
478
|
</div>
|
424
|
-
<h2 id="_how_can_i_selectively_disable_a_quoted_text_substitution">
|
479
|
+
<h2 id="_how_can_i_selectively_disable_a_quoted_text_substitution">20. How can I selectively disable a quoted text substitution?</h2>
|
425
480
|
<div class="sectionbody">
|
426
481
|
<div class="paragraph"><p>Omitting the tag name will disable quoting. For example, if you don’t
|
427
482
|
want superscripts or subscripts then put the following in a custom
|
@@ -441,7 +496,7 @@ document, the above examples are equivalent to:</p></div>
|
|
441
496
|
:quotes.~:</tt></pre>
|
442
497
|
</div></div>
|
443
498
|
</div>
|
444
|
-
<h2 id="_how_can_i_customize_the_localdate_format">
|
499
|
+
<h2 id="_how_can_i_customize_the_localdate_format">21. How can I customize the {localdate} format?</h2>
|
445
500
|
<div class="sectionbody">
|
446
501
|
<div class="paragraph"><p>The default format for the <tt>{localdate}</tt> attribute is the ISO 8601
|
447
502
|
<tt>yyyy-mm-dd</tt> format. You can change this format by explicitly setting
|
@@ -460,7 +515,7 @@ document, for example:</p></div>
|
|
460
515
|
<div class="paragraph"><p>Since it’s set using an executable attribute you’ll also need to
|
461
516
|
include the <tt>--unsafe</tt> option when you run asciidoc).</p></div>
|
462
517
|
</div>
|
463
|
-
<h2 id="_why_doesn_8217_t_asciidoc_support_strike_through_text">
|
518
|
+
<h2 id="_why_doesn_8217_t_asciidoc_support_strike_through_text">22. Why doesn’t AsciiDoc support strike through text?</h2>
|
464
519
|
<div class="sectionbody">
|
465
520
|
<div class="paragraph"><p>The reason it’s not in the distribution is that DocBook does not have
|
466
521
|
provision for strike through text and one of the <em>AsciiDoc</em> design goals
|
@@ -486,20 +541,20 @@ through text with hyphen characters:</p></div>
|
|
486
541
|
endif::basebackend-html[]</tt></pre>
|
487
542
|
</div></div>
|
488
543
|
</div>
|
489
|
-
<h2 id="_where_can_i_find_examples_of_commands_used_to_build_output_documents">
|
544
|
+
<h2 id="_where_can_i_find_examples_of_commands_used_to_build_output_documents">23. Where can I find examples of commands used to build output documents?</h2>
|
490
545
|
<div class="sectionbody">
|
491
546
|
<div class="paragraph"><p>The User Guide has some. You could also look at <tt>./doc/main.aap</tt> in
|
492
547
|
the <em>AsciiDoc</em> distribution, it has all the commands used to build the
|
493
548
|
<em>AsciiDoc</em> documentation (even if you don’t use A-A-P you’ll still find
|
494
549
|
it useful).</p></div>
|
495
550
|
</div>
|
496
|
-
<h2 id="_why_have_you_used_the_docbook_lt_simpara_gt_element_instead_of_lt_para_gt">
|
551
|
+
<h2 id="_why_have_you_used_the_docbook_lt_simpara_gt_element_instead_of_lt_para_gt">24. Why have you used the DocBook <simpara> element instead of <para>?</h2>
|
497
552
|
<div class="sectionbody">
|
498
553
|
<div class="paragraph"><p><tt><simpara></tt> is really the same as <tt><para></tt> except it can’t contain
|
499
554
|
block elements — this matched, more closely, the <em>AsciiDoc</em> paragraph
|
500
555
|
semantics.</p></div>
|
501
556
|
</div>
|
502
|
-
<h2 id="_how_can_i_format_text_inside_a_listing_block">
|
557
|
+
<h2 id="_how_can_i_format_text_inside_a_listing_block">25. How can I format text inside a listing block?</h2>
|
503
558
|
<div class="sectionbody">
|
504
559
|
<div class="paragraph"><p>By default only <em>specialcharacters</em> and <em>callouts</em> are substituted in
|
505
560
|
listing blocks; you can add quotes substitutions by explicitly setting
|
@@ -532,7 +587,7 @@ This only works if your DocBook processor recognizes DocBook
|
|
532
587
|
</li>
|
533
588
|
</ul></div>
|
534
589
|
</div>
|
535
|
-
<h2 id="_why_doesn_8217_t_the_include1_macro_work">
|
590
|
+
<h2 id="_why_doesn_8217_t_the_include1_macro_work">26. Why doesn’t the include1::[] macro work?</h2>
|
536
591
|
<div class="sectionbody">
|
537
592
|
<div class="paragraph"><p>Internally the <tt>include1</tt> macro is translated to the <tt>include1</tt> system
|
538
593
|
attribute which means it must be evaluated in a region where attribute
|
@@ -547,7 +602,7 @@ include::blogpost_media_processing.txt[depth=1]
|
|
547
602
|
-----------------------------------------------</tt></pre>
|
548
603
|
</div></div>
|
549
604
|
</div>
|
550
|
-
<h2 id="_how_can_i_customize_pdf_files_generated_by_dblatex">
|
605
|
+
<h2 id="_how_can_i_customize_pdf_files_generated_by_dblatex">27. How can I customize PDF files generated by dblatex?</h2>
|
551
606
|
<div class="sectionbody">
|
552
607
|
<div class="paragraph"><p>There are a number of dblatex XSL parameters that can be used to
|
553
608
|
customize PDF output. You can set them globally in the <em>AsciiDoc</em>
|
@@ -559,7 +614,7 @@ pass them on the <tt>a2x(1)</tt> command-line, for example:</p></div>
|
|
559
614
|
</div></div>
|
560
615
|
<div class="paragraph"><p>See also the <a href="http://dblatex.sourceforge.net/">dblatex</a> documentation.</p></div>
|
561
616
|
</div>
|
562
|
-
<h2 id="_how_can_i_make_the_mailto_macro_work_with_multiple_email_addresses">
|
617
|
+
<h2 id="_how_can_i_make_the_mailto_macro_work_with_multiple_email_addresses">28. How can I make the mailto macro work with multiple email addresses?</h2>
|
563
618
|
<div class="sectionbody">
|
564
619
|
<div class="paragraph"><p>For the <em>AsciiDoc</em> <em>mailto</em> macro to work with multiple email addresses
|
565
620
|
(as per RFC2368) you need to URL encode the <em>@</em> characters (replace
|
@@ -576,7 +631,7 @@ rendered as separate links. You also need to <a href="#X1">replace spaces with <
|
|
576
631
|
<pre><tt>mailto:jb%40foobar.com,jd%40acme.co.nz?subject=New%20foofoo%20release[New foofoo release]</tt></pre>
|
577
632
|
</div></div>
|
578
633
|
</div>
|
579
|
-
<h2 id="_how_can_a_replacement_have_a_trailing_backslash">
|
634
|
+
<h2 id="_how_can_a_replacement_have_a_trailing_backslash">29. How can a replacement have a trailing backslash?</h2>
|
580
635
|
<div class="sectionbody">
|
581
636
|
<div class="paragraph"><p>Quote the entry name — this nonsensical example replaces <tt>x\</tt> with
|
582
637
|
<tt>y</tt>:</p></div>
|
@@ -589,8 +644,8 @@ entry name <tt>x</tt> from the value <tt>y</tt>) would be escaped.</p></div>
|
|
589
644
|
</div>
|
590
645
|
<div id="footer">
|
591
646
|
<div id="footer-text">
|
592
|
-
Version 8.3.
|
593
|
-
Last updated
|
647
|
+
Version 8.3.3<br />
|
648
|
+
Last updated 2009-01-02 11:18:49 NZDT
|
594
649
|
</div>
|
595
650
|
<div id="footer-badges">
|
596
651
|
<a href="http://validator.w3.org/check?uri=referer">
|