FooBarWidget-mizuho 0.9.3 → 0.9.4

Sign up to get free protection for your applications and to get access to all the features.
Files changed (73) hide show
  1. data/asciidoc/BUGS +3 -3
  2. data/asciidoc/CHANGELOG +112 -63
  3. data/asciidoc/CHANGELOG.txt +50 -0
  4. data/asciidoc/INSTALL +6 -6
  5. data/asciidoc/Makefile.in +21 -5
  6. data/asciidoc/README +3 -3
  7. data/asciidoc/asciidoc.conf +9 -12
  8. data/asciidoc/asciidoc.py +204 -151
  9. data/asciidoc/common.aap +2 -2
  10. data/asciidoc/doc/a2x.1 +4 -3
  11. data/asciidoc/doc/a2x.1.txt +1 -1
  12. data/asciidoc/doc/article.css-embedded.html +13 -12
  13. data/asciidoc/doc/article.html +46 -644
  14. data/asciidoc/doc/article.pdf +0 -0
  15. data/asciidoc/doc/asciidoc.1 +2 -2
  16. data/asciidoc/doc/asciidoc.1.css-embedded.html +14 -13
  17. data/asciidoc/doc/asciidoc.1.css.html +3 -3
  18. data/asciidoc/doc/asciidoc.1.html +3 -3
  19. data/asciidoc/doc/asciidoc.css-embedded.html +238 -225
  20. data/asciidoc/doc/asciidoc.css.html +227 -215
  21. data/asciidoc/doc/asciidoc.dict +10 -1
  22. data/asciidoc/doc/asciidoc.html +181 -164
  23. data/asciidoc/doc/asciidoc.txt +167 -148
  24. data/asciidoc/doc/asciimathml.txt +5 -4
  25. data/asciidoc/doc/book.css-embedded.html +13 -12
  26. data/asciidoc/doc/faq.txt +60 -3
  27. data/asciidoc/doc/music-filter.html +94 -41
  28. data/asciidoc/doc/music-filter.pdf +0 -0
  29. data/asciidoc/doc/source-highlight-filter.html +125 -465
  30. data/asciidoc/doc/source-highlight-filter.pdf +0 -0
  31. data/asciidoc/docbook.conf +8 -2
  32. data/asciidoc/examples/website/CHANGELOG.html +129 -4
  33. data/asciidoc/examples/website/INSTALL.html +6 -6
  34. data/asciidoc/examples/website/README-website.html +3 -3
  35. data/asciidoc/examples/website/README.html +3 -3
  36. data/asciidoc/examples/website/a2x.1.html +4 -4
  37. data/asciidoc/examples/website/asciidoc-docbook-xsl.html +3 -3
  38. data/asciidoc/examples/website/asciidoc-graphviz-sample.txt +1 -0
  39. data/asciidoc/examples/website/downloads.html +7 -7
  40. data/asciidoc/examples/website/faq.html +95 -40
  41. data/asciidoc/examples/website/index.html +34 -13
  42. data/asciidoc/examples/website/index.txt +25 -9
  43. data/asciidoc/examples/website/latex-backend.html +4 -4
  44. data/asciidoc/examples/website/manpage.html +3 -3
  45. data/asciidoc/examples/website/music-filter.html +3 -3
  46. data/asciidoc/examples/website/sample1.png +0 -0
  47. data/asciidoc/examples/website/sample3.png +0 -0
  48. data/asciidoc/examples/website/sample4.png +0 -0
  49. data/asciidoc/examples/website/source-highlight-filter.html +5 -5
  50. data/asciidoc/examples/website/support.html +3 -3
  51. data/asciidoc/examples/website/userguide.html +227 -215
  52. data/asciidoc/examples/website/version9.html +3 -3
  53. data/asciidoc/filters/{code-filter-readme.txt → code/code-filter-readme.txt} +0 -0
  54. data/asciidoc/filters/{code-filter-test.txt → code/code-filter-test.txt} +0 -0
  55. data/asciidoc/filters/{code-filter.conf → code/code-filter.conf} +1 -1
  56. data/asciidoc/filters/{code-filter.py → code/code-filter.py} +0 -0
  57. data/asciidoc/filters/graphviz/asciidoc-graphviz-sample.txt +130 -0
  58. data/asciidoc/filters/graphviz/graphviz-filter.conf +39 -0
  59. data/asciidoc/filters/graphviz/graphviz2png.py +154 -0
  60. data/asciidoc/filters/{music-filter-test.txt → music/music-filter-test.txt} +0 -0
  61. data/asciidoc/filters/{music-filter.conf → music/music-filter.conf} +0 -0
  62. data/asciidoc/filters/{music2png.py → music/music2png.py} +0 -0
  63. data/asciidoc/filters/{source-highlight-filter-test.txt → source/source-highlight-filter-test.txt} +0 -0
  64. data/asciidoc/filters/{source-highlight-filter.conf → source/source-highlight-filter.conf} +2 -1
  65. data/asciidoc/html4.conf +5 -2
  66. data/asciidoc/stylesheets/xhtml11-quirks.css +0 -8
  67. data/asciidoc/stylesheets/xhtml11.css +11 -2
  68. data/asciidoc/vim/syntax/asciidoc.vim +1 -1
  69. data/asciidoc/xhtml11.conf +5 -2
  70. data/lib/mizuho/parser.rb +5 -1
  71. data/mizuho.gemspec +5 -16
  72. data/test/parser_spec.rb +49 -0
  73. metadata +22 -10
@@ -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="loweralpha"{compact-option? spacing="compact"}>|</orderedlist>
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.1" />
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&#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>
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.1<br />
4239
- Last updated 2008-12-13 09:59:39 NZDT
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.1" />
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.1.tar.gz
83
- $ cd asciidoc-8.3.1
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.1.zip</tt></pre>
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.1<br />
136
- Last updated 2008-12-13 10:52:08 NZDT
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.1" />
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.1<br />
93
- Last updated 2008-12-13 09:59:48 NZDT
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.1" />
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.1<br />
100
- Last updated 2008-12-13 09:59:48 NZDT
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.1" />
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 --format*=<em>text</em>.
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.1<br />
394
- Last updated 2008-12-13 09:59:38 NZDT
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.1" />
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.1<br />
105
- Last updated 2008-12-13 09:59:38 NZDT
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.1" />
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.1.tar.gz">asciidoc-8.3.1.tar.gz</a>
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.1.zip">asciidoc-8.3.1.zip</a>
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.1 tagged release:
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.1 http://hg.sharesource.org/asciidoc asciidoc.hg</tt></pre>
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.1<br />
232
- Last updated 2008-12-13 09:59:43 NZDT
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.1" />
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="_how_can_i_render_indented_paragraphs">1. How can I render indented paragraphs?</h2>
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&#8217;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">2. Is there a way to set default image height and width attributes?</h2>
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">3. How can I place a backslash character in front of an attribute reference without escaping the reference?</h2>
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">4. How can I escape AsciiDoc markup?</h2>
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
- <em>URLs</em>, <em>image</em> and <em>link</em> macros.
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&#8201;&#8212;&#8201;see the next question.</p></div>
164
227
  </div>
165
- <h2 id="_some_elements_can_8217_t_be_escaped_with_a_single_backslash">5. Some elements can&#8217;t be escaped with a single backslash</h2>
228
+ <h2 id="_some_elements_can_8217_t_be_escaped_with_a_single_backslash">6. Some elements can&#8217;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&#8201;&#8212;&#8201;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&#8201;&#8212;&#8201;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">6. How can I set default list and tables styles?</h2>
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&#8217;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">7. Why do I get a filter non-zero exit code error?</h2>
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">8. Are there any DocBook viewers?</h2>
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">9. Can you create ODF documents using AsciiDoc?</h2>
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&#8217;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&#8217;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">10. How can I supress cell separators in included table data files?</h2>
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">11. How can I preserve paragraph line boundaries?</h2>
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">12. How can I include non-breaking space characters?</h2>
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>&amp;#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">13. Can I include HTML and XML character entity references in my document?</h2>
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>&amp;#946;</tt>
334
389
  will print a Greek small beta character &#946;</p></div>
335
390
  </div>
336
- <h2 id="X1">14. How do I include spaces in URLs?</h2>
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">15. How can I get AsciiDoc to assign the correct DocBook language attribute?</h2>
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">16. Why does AsciiDoc give me a &#8220;malformed author&#8221; error?</h2>
414
+ <h2 id="_why_does_asciidoc_give_me_a_8220_malformed_author_8221_error">17. Why does AsciiDoc give me a &#8220;malformed author&#8221; 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">17. How can I assign multiple author names?</h2>
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">18. How can I escape a labeled list entry?</h2>
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">19. How can I selectively disable a quoted text substitution?</h2>
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&#8217;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">20. How can I customize the {localdate} format?</h2>
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&#8217;s set using an executable attribute you&#8217;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">21. Why doesn&#8217;t AsciiDoc support strike through text?</h2>
518
+ <h2 id="_why_doesn_8217_t_asciidoc_support_strike_through_text">22. Why doesn&#8217;t AsciiDoc support strike through text?</h2>
464
519
  <div class="sectionbody">
465
520
  <div class="paragraph"><p>The reason it&#8217;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">22. Where can I find examples of commands used to build output documents?</h2>
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&#8217;t use A-A-P you&#8217;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">23. Why have you used the DocBook &lt;simpara&gt; element instead of &lt;para&gt;?</h2>
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 &lt;simpara&gt; element instead of &lt;para&gt;?</h2>
497
552
  <div class="sectionbody">
498
553
  <div class="paragraph"><p><tt>&lt;simpara&gt;</tt> is really the same as <tt>&lt;para&gt;</tt> except it can&#8217;t contain
499
554
  block elements&#8201;&#8212;&#8201;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">24. How can I format text inside a listing block?</h2>
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">25. Why doesn&#8217;t the include1::[] macro work?</h2>
590
+ <h2 id="_why_doesn_8217_t_the_include1_macro_work">26. Why doesn&#8217;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">26. How can I customize PDF files generated by dblatex?</h2>
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">27. How can I make the mailto macro work with multiple email addresses?</h2>
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">28. How can a replacement have a trailing backslash?</h2>
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&#8201;&#8212;&#8201;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.1<br />
593
- Last updated 2008-12-13 09:59:43 NZDT
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">