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
data/asciidoc/doc/asciimathml.txt CHANGED
@@ -2,10 +2,11 @@ ASCIIMathML Formulae
2
2
  ====================
3
3
 
4
4
  http://www1.chapman.edu/~jipsen/mathml/asciimath.html[ASCIIMathML] is
5
- a clever JavaScript written by Peter Jipsen that transforms
6
- mathematical formulae written in plain text to standard mathematical
7
- notation on an HTML page. See 'Appendix E' in the AsciiDoc User Guide
8
- for more details.
5
+ a clever JavaScript written by Peter Jipsen that dynamically
6
+ transforms mathematical formulae written in a wiki-like plain text
7
+ markup to http://www.w3.org/Math/[MathML] markup which is displayed as
8
+ standard mathematical notation by the Web Browser. See 'Appendix E'
9
+ in the AsciiDoc User Guide for more details.
9
10
 
10
11
  The AsciiDoc `xhtml11` backend supports ASCIIMathML -- it links the
11
12
  ASCIIMathML script and escapes ASCIIMathML delimiters and special
data/asciidoc/doc/book.css-embedded.html CHANGED
@@ -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
  <title>Book Title Goes Here</title>
8
8
  <style type="text/css">
9
9
  /* Debug borders */
@@ -228,12 +228,21 @@ dd > *:first-child {
228
228
  ul, ol {
229
229
  list-style-position: outside;
230
230
  }
231
- div.olist > ol {
231
+ ol.arabic {
232
232
  list-style-type: decimal;
233
233
  }
234
- div.olist2 > ol {
234
+ ol.loweralpha {
235
235
  list-style-type: lower-alpha;
236
236
  }
237
+ ol.upperalpha {
238
+ list-style-type: upper-alpha;
239
+ }
240
+ ol.lowerroman {
241
+ list-style-type: lower-roman;
242
+ }
243
+ ol.upperroman {
244
+ list-style-type: upper-roman;
245
+ }
237
246
 
238
247
  div.compact ul, div.compact ol,
239
248
  div.compact p, div.compact p,
@@ -366,14 +375,6 @@ div.exampleblock-content {
366
375
 
367
376
  /* IE6 sets dynamically generated links as visited. */
368
377
  div#toc a:visited { color: blue; }
369
-
370
- /* Because IE6 child selector is broken. */
371
- div.olist2 ol {
372
- list-style-type: lower-alpha;
373
- }
374
- div.olist2 div.olist ol {
375
- list-style-type: decimal;
376
- }
377
378
  </style>
378
379
  <script type="text/javascript">
379
380
  /*<![CDATA[*/
@@ -599,7 +600,7 @@ A second glossary term
599
600
  <div id="footer">
600
601
  <div id="footer-text">
601
602
  Version 1.0<br />
602
- Last updated 2008-12-13 09:56:50 NZDT
603
+ Last updated 2009-01-02 12:43:47 NZDT
603
604
  </div>
604
605
  </div>
605
606
  </body>
data/asciidoc/doc/faq.txt CHANGED
@@ -4,6 +4,65 @@ AsciiDoc Frequently Asked Questions
4
4
  An embryonic AsciiDoc FAQ.
5
5
 
6
6
 
7
+ == Is it possible to include charts in AsciiDoc documents?
8
+
9
+ There are a number of programs available that generate presentation
10
+ charts from textual specification, for example
11
+ http://home.gna.org/pychart/[Pychart] is a library for writing chart
12
+ scripts in Python. Here's an example from the 'Pychart' documentation:
13
+
14
+ .barchart.py
15
+ ---------------------------------------------------------------------
16
+ #
17
+ # Example bar chart (from Pychart documentation http://home.gna.org/pychart/).
18
+ #
19
+ from pychart import *
20
+ theme.get_options()
21
+
22
+ data = [(10, 20, 30, 5), (20, 65, 33, 5), (30, 55, 30, 5), (40, 45, 51, 7),
23
+ (50, 25, 27, 3), (60, 75, 30, 5), (70, 80, 42, 5), (80, 62, 32, 5),
24
+ (90, 42, 39, 5), (100, 32, 39, 4)]
25
+
26
+ # The attribute y_coord=... tells that the Y axis values
27
+ # should be taken from samples.
28
+ # In this example, Y values will be [40,50,60,70,80].
29
+ ar = area.T(y_coord = category_coord.T(data[3:8], 0),
30
+ x_grid_style=line_style.gray50_dash1,
31
+ x_grid_interval=20, x_range = (0,100),
32
+ x_axis=axis.X(label="X label"),
33
+ y_axis=axis.Y(label="Y label"),
34
+ bg_style = fill_style.gray90,
35
+ border_line_style = line_style.default,
36
+ legend = legend.T(loc=(80,10)))
37
+
38
+ # Below call sets the default attributes for all bar plots.
39
+ chart_object.set_defaults(bar_plot.T, direction="horizontal", data=data)
40
+
41
+ # Attribute cluster=(0,3) tells that you are going to draw three bar
42
+ # plots side by side. The plot labeled "foo" will the leftmost (i.e.,
43
+ # 0th out of 3). Attribute hcol tells the column from which to
44
+ # retrive sample values from. It defaults to one.
45
+ ar.add_plot(bar_plot.T(label="foo", cluster=(0,3)))
46
+ ar.add_plot(bar_plot.T(label="bar", hcol=2, cluster=(1,3)))
47
+ ar.add_plot(bar_plot.T(label="baz", hcol=3, cluster=(2,3)))
48
+ ar.draw()
49
+ ---------------------------------------------------------------------
50
+
51
+ To execute the script and include the generated chart image in your
52
+ document add the following lines to the AsciiDoc source:
53
+
54
+ ---------------------------------------------------------------------
55
+ // Generate chart image file.
56
+ \sys2::[python barchart.py --format=png --output=barchart.png --scale=2]
57
+
58
+ // Display chart image file.
59
+ image::barchart.png[]
60
+ ---------------------------------------------------------------------
61
+
62
+ NOTE: You need to run asciidoc(1) with the `--unsafe` command-line
63
+ option to execute the `sys2` system macro.
64
+
65
+
7
66
  == How can I render indented paragraphs?
8
67
 
9
68
  To unconditionally indent all paragraphs add the following line to the
@@ -77,7 +136,7 @@ a backslash character. These elements include:
77
136
  - Attribute references.
78
137
  - Text formatting.
79
138
  - Quoting,
80
- - 'URLs', 'image' and 'link' macros.
139
+ - Macros.
81
140
  - Replacements.
82
141
  - Special words.
83
142
  - Table cell separators.
@@ -115,8 +174,6 @@ the first match unescapes allowing the second to substitute. A
115
174
  work-around for difficult cases is to side-step the problem using the
116
175
  `\pass:[]` passthrough inline macro.
117
176
 
118
- NOTE: System macros cannot be escaped.
119
-
120
177
 
121
178
  == How can I set default list and tables styles?
122
179
 
data/asciidoc/doc/music-filter.html CHANGED
@@ -3,7 +3,8 @@
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.2.7" />
6
+ <meta name="generator" content="AsciiDoc 8.3.1" />
7
+ <title>Music Filter</title>
7
8
  <style type="text/css">
8
9
  /* Debug borders */
9
10
  p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
@@ -165,13 +166,25 @@ div.listingblock > div.content {
165
166
  padding: 0.5em;
166
167
  }
167
168
 
168
- div.quoteblock > div.content {
169
+ div.quoteblock {
169
170
  padding-left: 2.0em;
170
171
  }
171
-
172
- div.attribution {
172
+ div.quoteblock > div.attribution {
173
+ padding-top: 0.5em;
173
174
  text-align: right;
174
175
  }
176
+
177
+ div.verseblock {
178
+ padding-left: 2.0em;
179
+ }
180
+ div.verseblock > div.content {
181
+ white-space: pre;
182
+ }
183
+ div.verseblock > div.attribution {
184
+ padding-top: 0.75em;
185
+ text-align: left;
186
+ }
187
+ /* DEPRECATED: Pre version 8.2.7 verse style literal block. */
175
188
  div.verseblock + div.attribution {
176
189
  text-align: left;
177
190
  }
@@ -194,10 +207,6 @@ div.exampleblock > div.content {
194
207
  padding: 0.5em;
195
208
  }
196
209
 
197
- div.verseblock div.content {
198
- white-space: pre;
199
- }
200
-
201
210
  div.imageblock div.content { padding-left: 0; }
202
211
  div.imageblock img { border: 1px solid silver; }
203
212
  span.image img { border-style: none; }
@@ -210,6 +219,7 @@ dt {
210
219
  margin-top: 0.5em;
211
220
  margin-bottom: 0;
212
221
  font-style: normal;
222
+ color: navy;
213
223
  }
214
224
  dd > *:first-child {
215
225
  margin-top: 0.1em;
@@ -218,12 +228,28 @@ dd > *:first-child {
218
228
  ul, ol {
219
229
  list-style-position: outside;
220
230
  }
221
- div.olist > ol {
231
+ ol.arabic {
222
232
  list-style-type: decimal;
223
233
  }
224
- div.olist2 > ol {
234
+ ol.loweralpha {
225
235
  list-style-type: lower-alpha;
226
236
  }
237
+ ol.upperalpha {
238
+ list-style-type: upper-alpha;
239
+ }
240
+ ol.lowerroman {
241
+ list-style-type: lower-roman;
242
+ }
243
+ ol.upperroman {
244
+ list-style-type: upper-roman;
245
+ }
246
+
247
+ div.compact ul, div.compact ol,
248
+ div.compact p, div.compact p,
249
+ div.compact div, div.compact div {
250
+ margin-top: 0.1em;
251
+ margin-bottom: 0.1em;
252
+ }
227
253
 
228
254
  div.tableblock > table {
229
255
  border: 3px solid #527bbd;
@@ -235,22 +261,49 @@ thead {
235
261
  tfoot {
236
262
  font-weight: bold;
237
263
  }
264
+ td > div.verse {
265
+ white-space: pre;
266
+ }
267
+ p.table {
268
+ margin-top: 0;
269
+ }
270
+ /* Because the table frame attribute is overriden by CSS in most browsers. */
271
+ div.tableblock > table[frame="void"] {
272
+ border-style: none;
273
+ }
274
+ div.tableblock > table[frame="hsides"] {
275
+ border-left-style: none;
276
+ border-right-style: none;
277
+ }
278
+ div.tableblock > table[frame="vsides"] {
279
+ border-top-style: none;
280
+ border-bottom-style: none;
281
+ }
282
+
238
283
 
239
- div.hlist {
284
+ div.hdlist {
240
285
  margin-top: 0.8em;
241
286
  margin-bottom: 0.8em;
242
287
  }
243
- div.hlist td {
288
+ div.hdlist tr {
244
289
  padding-bottom: 15px;
245
290
  }
246
- td.hlist1 {
291
+ dt.hdlist1.strong, td.hdlist1.strong {
292
+ font-weight: bold;
293
+ }
294
+ td.hdlist1 {
247
295
  vertical-align: top;
248
296
  font-style: normal;
249
297
  padding-right: 0.8em;
298
+ color: navy;
250
299
  }
251
- td.hlist2 {
300
+ td.hdlist2 {
252
301
  vertical-align: top;
253
302
  }
303
+ div.hdlist.compact tr {
304
+ margin: 0;
305
+ padding-bottom: 0;
306
+ }
254
307
 
255
308
  @media print {
256
309
  div#footer-badges { display: none; }
@@ -302,8 +355,17 @@ div.listingblock div.content {
302
355
  padding: 0.5em;
303
356
  }
304
357
 
305
- div.quoteblock-content {
306
- padding-left: 2.0em;
358
+ div.quoteblock-attribution {
359
+ padding-top: 0.5em;
360
+ text-align: right;
361
+ }
362
+
363
+ div.verseblock-content {
364
+ white-space: pre;
365
+ }
366
+ div.verseblock-attribution {
367
+ padding-top: 0.75em;
368
+ text-align: left;
307
369
  }
308
370
 
309
371
  div.exampleblock-content {
@@ -313,16 +375,7 @@ div.exampleblock-content {
313
375
 
314
376
  /* IE6 sets dynamically generated links as visited. */
315
377
  div#toc a:visited { color: blue; }
316
-
317
- /* Because IE6 child selector is broken. */
318
- div.olist2 ol {
319
- list-style-type: lower-alpha;
320
- }
321
- div.olist2 div.olist ol {
322
- list-style-type: decimal;
323
- }
324
378
  </style>
325
- <title>Music Filter</title>
326
379
  </head>
327
380
  <body>
328
381
  <div id="header">
@@ -330,28 +383,28 @@ div.olist2 div.olist ol {
330
383
  </div>
331
384
  <div id="preamble">
332
385
  <div class="sectionbody">
333
- <div class="para"><p>The <em>AsciiDoc</em> distribution includes a Music Block filter that
386
+ <div class="paragraph"><p>The <em>AsciiDoc</em> distribution includes a Music Block filter that
334
387
  translates music in <a href="http://lilypond.org/">LilyPond</a> or
335
388
  <a href="http://abcnotation.org.uk/">ABC</a> notation to standard classical
336
389
  notation in the form of a trimmed PNG image which is automatically
337
390
  inserted into the <em>AsciiDoc</em> output document (see the <a href="#X1">examples below</a>).</p></div>
338
- <div class="para"><p>Actually the filter (<tt>./filters/music2png.py</tt>) can be used outside
391
+ <div class="paragraph"><p>Actually the filter (<tt>./filters/music2png.py</tt>) can be used outside
339
392
  <em>AsciiDoc</em> to convert LilyPond or ABC music files to PNG images.
340
393
  Execute the following command to see how to use it:</p></div>
341
394
  <div class="literalblock">
342
395
  <div class="content">
343
396
  <pre><tt>$ ./filters/music2png.py --help</tt></pre>
344
397
  </div></div>
345
- <div class="para"><p>The Music Filter can be used as a model for filters that convert a
398
+ <div class="paragraph"><p>The Music Filter can be used as a model for filters that convert a
346
399
  block of text into a file that is linked or embedded into the <em>AsciiDoc</em>
347
400
  output document.</p></div>
348
401
  <div class="exampleblock" id="X1">
349
402
  <div class="title">Example 1: Music Block containing ABC notation</div>
350
403
  <div class="exampleblock-content">
351
- <div class="para"><p>This Music Block:</p></div>
404
+ <div class="paragraph"><p>This Music Block:</p></div>
352
405
  <div class="listingblock">
353
406
  <div class="content">
354
- <pre><tt> [music,music1.png]
407
+ <pre><tt> ["music","music1.png",scaledwidth="100%"]
355
408
  ---------------------------------------------------------------------
356
409
  T:The Butterfly
357
410
  R:slip jig
@@ -367,7 +420,7 @@ output document.</p></div>
367
420
  |:~B3 (B2A) G2A|~B3 BA(uB d)BA|~B3 (B2A) G2(A|B2d) (g2e) (dBA):|
368
421
  ---------------------------------------------------------------------</tt></pre>
369
422
  </div></div>
370
- <div class="para"><p>Renders:</p></div>
423
+ <div class="paragraph"><p>Renders:</p></div>
371
424
  <div class="musicblock">
372
425
  <div class="content">
373
426
  <img style="border-width: 0;" src="music1.png" alt="music1.png" />
@@ -376,7 +429,7 @@ output document.</p></div>
376
429
  <div class="exampleblock" id="X2">
377
430
  <div class="title">Example 2: Music Block containing LilyPond notation</div>
378
431
  <div class="exampleblock-content">
379
- <div class="para"><p>This example contains LilyPond musical markup, it uses the <em>link</em>
432
+ <div class="paragraph"><p>This example contains LilyPond musical markup, it uses the <em>link</em>
380
433
  attribute so you can click on the music image to display the source
381
434
  notation. The <tt>music2.ly</tt> source file is automatically created and
382
435
  retained by the <tt>music2png.py</tt> filter when the <tt>-m</tt> option is used.</p></div>
@@ -395,7 +448,7 @@ retained by the <tt>music2png.py</tt> filter when the <tt>-m</tt> option is used
395
448
  }
396
449
  ---------------------------------------------------------------------</tt></pre>
397
450
  </div></div>
398
- <div class="para"><p>Renders:</p></div>
451
+ <div class="paragraph"><p>Renders:</p></div>
399
452
  <div class="musicblock">
400
453
  <div class="content">
401
454
  <a href="music2.ly">
@@ -418,9 +471,9 @@ are using.</td>
418
471
  </div>
419
472
  <h2 id="_using_the_filter">Using the Filter</h2>
420
473
  <div class="sectionbody">
421
- <div class="para"><p>Insert a delimited Music Block containing valid ABC notation into your
474
+ <div class="paragraph"><p>Insert a delimited Music Block containing valid ABC notation into your
422
475
  <em>AsciiDoc</em> document:</p></div>
423
- <div class="ilist"><ul>
476
+ <div class="ulist"><ul>
424
477
  <li>
425
478
  <p>
426
479
  The Music Block delimiter is the word <tt>music</tt> followed by four or
@@ -452,7 +505,7 @@ The optional named block attributes <em>link</em>, <em>width</em> and <em>height
452
505
  </div>
453
506
  <h2 id="_limitations">Limitations</h2>
454
507
  <div class="sectionbody">
455
- <div class="ilist"><ul>
508
+ <div class="ulist"><ul>
456
509
  <li>
457
510
  <p>
458
511
  The <tt><tt>asciidoc(1)</tt></tt> output file cannot be <tt>-</tt> (stdout), you must
@@ -470,8 +523,8 @@ If the music image file is linked to the output document then the
470
523
  </div>
471
524
  <h2 id="_installation">Installation</h2>
472
525
  <div class="sectionbody">
473
- <div class="para"><p>In addition to <em>AsciiDoc</em> you will need to have installed:</p></div>
474
- <div class="ilist"><ul>
526
+ <div class="paragraph"><p>In addition to <em>AsciiDoc</em> you will need to have installed:</p></div>
527
+ <div class="ulist"><ul>
475
528
  <li>
476
529
  <p>
477
530
  <a href="http://lilypond.org/web/">LilyPond</a> (most Linux distributions include
@@ -485,13 +538,13 @@ If the music image file is linked to the output document then the
485
538
  </p>
486
539
  </li>
487
540
  </ul></div>
488
- <div class="para"><p>Test the music filter it by converting the test file to HTML with <em>AsciiDoc</em>:</p></div>
541
+ <div class="paragraph"><p>Test the music filter it by converting the test file to HTML with <em>AsciiDoc</em>:</p></div>
489
542
  <div class="literalblock">
490
543
  <div class="content">
491
544
  <pre><tt>$ asciidoc -v ./filters/music-filter-test.txt
492
545
  $ firefox ./filters/music-filter-test.html &amp;</tt></pre>
493
546
  </div></div>
494
- <div class="para"><p>The filter was developed and tested on Xubuntu Linux using LilyPond
547
+ <div class="paragraph"><p>The filter was developed and tested on Xubuntu Linux using LilyPond
495
548
  2.10.5 and ImageMagick 6.2.4.</p></div>
496
549
  <div class="admonitionblock">
497
550
  <table><tr>
@@ -506,7 +559,7 @@ a problem).</td>
506
559
  </div>
507
560
  <div id="footer">
508
561
  <div id="footer-text">
509
- Last updated 2008-07-02 21:36:40 NZDT
562
+ Last updated 2008-12-31 14:47:04 NZDT
510
563
  </div>
511
564
  </div>
512
565
  </body>
data/asciidoc/doc/music-filter.pdf CHANGED
Binary file
data/asciidoc/doc/source-highlight-filter.html CHANGED
@@ -1,378 +1,30 @@
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">
1
+ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
+ <html>
4
3
  <head>
5
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
6
- <meta name="generator" content="AsciiDoc 8.2.7" />
7
- <style type="text/css">
8
- /* Debug borders */
9
- p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
10
- /*
11
- border: 1px solid red;
12
- */
13
- }
14
-
15
- body {
16
- margin: 1em 5% 1em 5%;
17
- }
18
-
19
- a {
20
- color: blue;
21
- text-decoration: underline;
22
- }
23
- a:visited {
24
- color: fuchsia;
25
- }
26
-
27
- em {
28
- font-style: italic;
29
- color: navy;
30
- }
31
-
32
- strong {
33
- font-weight: bold;
34
- color: #083194;
35
- }
36
-
37
- tt {
38
- color: navy;
39
- }
40
-
41
- h1, h2, h3, h4, h5, h6 {
42
- color: #527bbd;
43
- font-family: sans-serif;
44
- margin-top: 1.2em;
45
- margin-bottom: 0.5em;
46
- line-height: 1.3;
47
- }
48
-
49
- h1, h2, h3 {
50
- border-bottom: 2px solid silver;
51
- }
52
- h2 {
53
- padding-top: 0.5em;
54
- }
55
- h3 {
56
- float: left;
57
- }
58
- h3 + * {
59
- clear: left;
60
- }
61
-
62
- div.sectionbody {
63
- font-family: serif;
64
- margin-left: 0;
65
- }
66
-
67
- hr {
68
- border: 1px solid silver;
69
- }
70
-
71
- p {
72
- margin-top: 0.5em;
73
- margin-bottom: 0.5em;
74
- }
75
-
76
- ul, ol, li > p {
77
- margin-top: 0;
78
- }
79
-
80
- pre {
81
- padding: 0;
82
- margin: 0;
83
- }
84
-
85
- span#author {
86
- color: #527bbd;
87
- font-family: sans-serif;
88
- font-weight: bold;
89
- font-size: 1.1em;
90
- }
91
- span#email {
92
- }
93
- span#revision {
94
- font-family: sans-serif;
95
- }
96
-
97
- div#footer {
98
- font-family: sans-serif;
99
- font-size: small;
100
- border-top: 2px solid silver;
101
- padding-top: 0.5em;
102
- margin-top: 4.0em;
103
- }
104
- div#footer-text {
105
- float: left;
106
- padding-bottom: 0.5em;
107
- }
108
- div#footer-badges {
109
- float: right;
110
- padding-bottom: 0.5em;
111
- }
112
-
113
- div#preamble,
114
- div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
115
- div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
116
- div.admonitionblock {
117
- margin-right: 10%;
118
- margin-top: 1.5em;
119
- margin-bottom: 1.5em;
120
- }
121
- div.admonitionblock {
122
- margin-top: 2.5em;
123
- margin-bottom: 2.5em;
124
- }
125
-
126
- div.content { /* Block element content. */
127
- padding: 0;
128
- }
129
-
130
- /* Block element titles. */
131
- div.title, caption.title {
132
- color: #527bbd;
133
- font-family: sans-serif;
134
- font-weight: bold;
135
- text-align: left;
136
- margin-top: 1.0em;
137
- margin-bottom: 0.5em;
138
- }
139
- div.title + * {
140
- margin-top: 0;
141
- }
142
-
143
- td div.title:first-child {
144
- margin-top: 0.0em;
145
- }
146
- div.content div.title:first-child {
147
- margin-top: 0.0em;
148
- }
149
- div.content + div.title {
150
- margin-top: 0.0em;
151
- }
152
-
153
- div.sidebarblock > div.content {
154
- background: #ffffee;
155
- border: 1px solid silver;
156
- padding: 0.5em;
157
- }
158
-
159
- div.listingblock {
160
- margin-right: 0%;
161
- }
162
- div.listingblock > div.content {
163
- border: 1px solid silver;
164
- background: #f4f4f4;
165
- padding: 0.5em;
166
- }
167
-
168
- div.quoteblock {
169
- padding-left: 2.0em;
170
- }
171
- div.quoteblock > div.attribution {
172
- padding-top: 0.5em;
173
- text-align: right;
174
- }
175
-
176
- div.verseblock {
177
- padding-left: 2.0em;
178
- }
179
- div.verseblock > div.content {
180
- white-space: pre;
181
- }
182
- div.verseblock > div.attribution {
183
- padding-top: 0.75em;
184
- text-align: left;
185
- }
186
- /* DEPRECATED: Pre version 8.2.7 verse style literal block. */
187
- div.verseblock + div.attribution {
188
- text-align: left;
189
- }
190
-
191
- div.admonitionblock .icon {
192
- vertical-align: top;
193
- font-size: 1.1em;
194
- font-weight: bold;
195
- text-decoration: underline;
196
- color: #527bbd;
197
- padding-right: 0.5em;
198
- }
199
- div.admonitionblock td.content {
200
- padding-left: 0.5em;
201
- border-left: 2px solid silver;
202
- }
203
-
204
- div.exampleblock > div.content {
205
- border-left: 2px solid silver;
206
- padding: 0.5em;
207
- }
208
-
209
- div.imageblock div.content { padding-left: 0; }
210
- div.imageblock img { border: 1px solid silver; }
211
- span.image img { border-style: none; }
212
-
213
- dl {
214
- margin-top: 0.8em;
215
- margin-bottom: 0.8em;
216
- }
217
- dt {
218
- margin-top: 0.5em;
219
- margin-bottom: 0;
220
- font-style: normal;
221
- }
222
- dd > *:first-child {
223
- margin-top: 0.1em;
224
- }
225
-
226
- ul, ol {
227
- list-style-position: outside;
228
- }
229
- div.olist > ol {
230
- list-style-type: decimal;
231
- }
232
- div.olist2 > ol {
233
- list-style-type: lower-alpha;
234
- }
235
-
236
- div.tableblock > table {
237
- border: 3px solid #527bbd;
238
- }
239
- thead {
240
- font-family: sans-serif;
241
- font-weight: bold;
242
- }
243
- tfoot {
244
- font-weight: bold;
245
- }
246
-
247
- div.hlist {
248
- margin-top: 0.8em;
249
- margin-bottom: 0.8em;
250
- }
251
- div.hlist td {
252
- padding-bottom: 15px;
253
- }
254
- td.hlist1 {
255
- vertical-align: top;
256
- font-style: normal;
257
- padding-right: 0.8em;
258
- }
259
- td.hlist2 {
260
- vertical-align: top;
261
- }
262
-
263
- @media print {
264
- div#footer-badges { display: none; }
265
- }
266
-
267
- div#toctitle {
268
- color: #527bbd;
269
- font-family: sans-serif;
270
- font-size: 1.1em;
271
- font-weight: bold;
272
- margin-top: 1.0em;
273
- margin-bottom: 0.1em;
274
- }
275
-
276
- div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
277
- margin-top: 0;
278
- margin-bottom: 0;
279
- }
280
- div.toclevel2 {
281
- margin-left: 2em;
282
- font-size: 0.9em;
283
- }
284
- div.toclevel3 {
285
- margin-left: 4em;
286
- font-size: 0.9em;
287
- }
288
- div.toclevel4 {
289
- margin-left: 6em;
290
- font-size: 0.9em;
291
- }
292
- /* Workarounds for IE6's broken and incomplete CSS2. */
293
-
294
- div.sidebar-content {
295
- background: #ffffee;
296
- border: 1px solid silver;
297
- padding: 0.5em;
298
- }
299
- div.sidebar-title, div.image-title {
300
- color: #527bbd;
301
- font-family: sans-serif;
302
- font-weight: bold;
303
- margin-top: 0.0em;
304
- margin-bottom: 0.5em;
305
- }
306
-
307
- div.listingblock div.content {
308
- border: 1px solid silver;
309
- background: #f4f4f4;
310
- padding: 0.5em;
311
- }
312
-
313
- div.quoteblock-attribution {
314
- padding-top: 0.5em;
315
- text-align: right;
316
- }
317
-
318
- div.verseblock-content {
319
- white-space: pre;
320
- }
321
- div.verseblock-attribution {
322
- padding-top: 0.75em;
323
- text-align: left;
324
- }
325
-
326
- div.exampleblock-content {
327
- border-left: 2px solid silver;
328
- padding-left: 0.5em;
329
- }
330
-
331
- /* IE6 sets dynamically generated links as visited. */
332
- div#toc a:visited { color: blue; }
333
-
334
- /* Because IE6 child selector is broken. */
335
- div.olist2 ol {
336
- list-style-type: lower-alpha;
337
- }
338
- div.olist2 div.olist ol {
339
- list-style-type: decimal;
340
- }
341
- </style>
4
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
+ <meta name="generator" content="AsciiDoc 8.3.2">
342
6
  <title>Source Code Highlight Filter</title>
343
7
  </head>
344
8
  <body>
345
- <div id="header">
346
9
  <h1>Source Code Highlight Filter</h1>
347
- </div>
348
- <div id="preamble">
349
- <div class="sectionbody">
350
- <div class="para"><p>The <em>AsciiDoc</em> distribution includes a source code syntax highlight
10
+ <p>
11
+ </p>
12
+ <p>The <em>AsciiDoc</em> distribution includes a source code syntax highlight
351
13
  filter (<tt>source-highlight-filter.conf</tt>). It uses
352
14
  <a href="http://www.gnu.org/software/src-highlite/">GNU source-highlight</a> to
353
15
  highlight HTML outputs; DocBook outputs are highlighted by toolchains
354
16
  that have <tt>programlisting</tt> element highlight support, for example
355
- <em>dblatex</em>.</p></div>
356
- <div class="admonitionblock">
357
- <table><tr>
358
- <td class="icon">
359
- <div class="title">Tip</div>
360
- </td>
361
- <td class="content">If the source <em>language</em> attribute has been set (using an
362
- <em>AttributeEntry</em> or from the command-line) you don't have to specify
363
- it in each source code block.</td>
364
- </tr></table>
365
- </div>
366
- </div>
367
- </div>
368
- <h2 id="_examples">Examples</h2>
369
- <div class="sectionbody">
370
- <h3 id="_source_code_paragraphs">Source code paragraphs</h3><div style="clear:left"></div>
371
- <div class="para"><p>The <tt>source</tt> paragraph style will highlight a paragraph of source
372
- code. These three code paragraphs:</p></div>
373
- <div class="listingblock">
374
- <div class="content">
375
- <pre><tt>[source,python]
17
+ <em>dblatex</em>.</p>
18
+ <p><b>Tip:</b> If the source <em>language</em> attribute has been set (using an
19
+ <em>AttributeEntry</em> or from the command-line) you don&#8217;t have to specify
20
+ it in each source code block.</p>
21
+ <hr />
22
+ <h2><a name="_examples"></a>Examples</h2>
23
+ <h3><a name="_source_code_paragraphs"></a>Source code paragraphs</h3>
24
+ <p>The <tt>source</tt> paragraph style will highlight a paragraph of source
25
+ code. These three code paragraphs:</p>
26
+ <table border="0" bgcolor="#e8e8e8" width="100%" cellpadding="10"><tr><td>
27
+ <pre>[source,python]
376
28
  if n &lt; 0: print 'Hello World!'
377
29
 
378
30
  :language: python
@@ -382,36 +34,29 @@ if n &lt; 0: print 'Hello World!'
382
34
 
383
35
  [source,ruby,numbered]
384
36
  [true, false].cycle([0, 1, 2, 3, 4]) do |a, b|
385
- puts "#{a.inspect} =&gt; #{b.inspect}"</tt></pre>
386
- </div></div>
387
- <div class="para"><p>Render this highlighted source code:</p></div>
388
- <div class="exampleblock">
389
- <div class="exampleblock-content"><!-- Generator: GNU source-highlight 2.4
37
+ puts "#{a.inspect} =&gt; #{b.inspect}"</pre>
38
+ </td></tr></table>
39
+ <p>Render this highlighted source code:</p>
40
+ <!-- Generator: GNU source-highlight 2.4
390
41
  by Lorenzo Bettini
391
42
  http://www.lorenzobettini.it
392
43
  http://www.gnu.org/software/src-highlite -->
393
- <pre><tt><span style="font-weight: bold"><span style="color: #0000FF">if</span></span> n <span style="color: #990000">&lt;</span> <span style="color: #993399">0</span><span style="color: #990000">:</span> <span style="font-weight: bold"><span style="color: #0000FF">print</span></span> <span style="color: #FF0000">'Hello World!'</span>
394
- </tt></pre></div></div>
395
- <div class="exampleblock">
396
- <div class="exampleblock-content"><!-- Generator: GNU source-highlight 2.4
44
+ <pre><tt><b><font color="#0000FF">if</font></b> n <font color="#990000">&lt;</font> <font color="#993399">0</font><font color="#990000">:</font> <b><font color="#0000FF">print</font></b> <font color="#FF0000">'Hello World!'</font></tt></pre>
45
+ <!-- Generator: GNU source-highlight 2.4
397
46
  by Lorenzo Bettini
398
47
  http://www.lorenzobettini.it
399
48
  http://www.gnu.org/software/src-highlite -->
400
- <pre><tt><span style="font-weight: bold"><span style="color: #0000FF">if</span></span> n <span style="color: #990000">&lt;</span> <span style="color: #993399">0</span><span style="color: #990000">:</span> <span style="font-weight: bold"><span style="color: #0000FF">print</span></span> <span style="color: #FF0000">'Hello World!'</span>
401
- </tt></pre></div></div>
402
- <div class="exampleblock">
403
- <div class="exampleblock-content"><!-- Generator: GNU source-highlight 2.4
49
+ <pre><tt><b><font color="#0000FF">if</font></b> n <font color="#990000">&lt;</font> <font color="#993399">0</font><font color="#990000">:</font> <b><font color="#0000FF">print</font></b> <font color="#FF0000">'Hello World!'</font></tt></pre>
50
+ <!-- Generator: GNU source-highlight 2.4
404
51
  by Lorenzo Bettini
405
52
  http://www.lorenzobettini.it
406
53
  http://www.gnu.org/software/src-highlite -->
407
- <pre><tt><span style="color: #000000">00001:</span> <span style="color: #990000">[</span><span style="font-weight: bold"><span style="color: #0000FF">true</span></span><span style="color: #990000">,</span> <span style="font-weight: bold"><span style="color: #0000FF">false</span></span><span style="color: #990000">].</span><span style="font-weight: bold"><span style="color: #000000">cycle</span></span><span style="color: #990000">([</span><span style="color: #993399">0</span><span style="color: #990000">,</span> <span style="color: #993399">1</span><span style="color: #990000">,</span> <span style="color: #993399">2</span><span style="color: #990000">,</span> <span style="color: #993399">3</span><span style="color: #990000">,</span> <span style="color: #993399">4</span><span style="color: #990000">])</span> <span style="font-weight: bold"><span style="color: #0000FF">do</span></span> <span style="color: #990000">|</span>a<span style="color: #990000">,</span> b<span style="color: #990000">|</span>
408
- <span style="color: #000000">00002:</span> puts <span style="color: #FF0000">"#{a.inspect} =&gt; #{b.inspect}"</span>
409
- </tt></pre></div></div>
410
- <h3 id="_unnumbered_source_code_listing">Unnumbered source code listing</h3><div style="clear:left"></div>
411
- <div class="para"><p>This source-highlight filtered block:</p></div>
412
- <div class="listingblock">
413
- <div class="content">
414
- <pre><tt> [source,python]
54
+ <pre><tt><font color="#000000">00001:</font> <font color="#990000">[</font><b><font color="#0000FF">true</font></b><font color="#990000">,</font> <b><font color="#0000FF">false</font></b><font color="#990000">].</font><b><font color="#000000">cycle</font></b><font color="#990000">([</font><font color="#993399">0</font><font color="#990000">,</font> <font color="#993399">1</font><font color="#990000">,</font> <font color="#993399">2</font><font color="#990000">,</font> <font color="#993399">3</font><font color="#990000">,</font> <font color="#993399">4</font><font color="#990000">])</font> <b><font color="#0000FF">do</font></b> <font color="#990000">|</font>a<font color="#990000">,</font> b<font color="#990000">|</font>
55
+ <font color="#000000">00002:</font> puts <font color="#FF0000">"#{a.inspect} =&gt; #{b.inspect}"</font></tt></pre>
56
+ <h3><a name="_unnumbered_source_code_listing"></a>Unnumbered source code listing</h3>
57
+ <p>This source-highlight filtered block:</p>
58
+ <table border="0" bgcolor="#e8e8e8" width="100%" cellpadding="10"><tr><td>
59
+ <pre> [source,python]
415
60
  ---------------------------------------------------------------------
416
61
  ''' A multi-line
417
62
  comment.'''
@@ -422,29 +67,26 @@ http://www.gnu.org/software/src-highlite -->
422
67
  return quote + word + quote
423
68
  else:
424
69
  return word
425
- ---------------------------------------------------------------------</tt></pre>
426
- </div></div>
427
- <div class="para"><p>Renders this highlighted source code:</p></div>
428
- <div class="listingblock">
429
- <div class="content"><!-- Generator: GNU source-highlight 2.4
70
+ ---------------------------------------------------------------------</pre>
71
+ </td></tr></table>
72
+ <p>Renders this highlighted source code:</p>
73
+ <table border="0" bgcolor="#e8e8e8" width="100%" cellpadding="10"><tr><td><!-- Generator: GNU source-highlight 2.4
430
74
  by Lorenzo Bettini
431
75
  http://www.lorenzobettini.it
432
76
  http://www.gnu.org/software/src-highlite -->
433
- <pre><tt><span style="font-style: italic"><span style="color: #9A1900">''' A multi-line</span></span>
434
- <span style="font-style: italic"><span style="color: #9A1900"> comment.'''</span></span>
435
- <span style="font-weight: bold"><span style="color: #0000FF">def</span></span> <span style="font-weight: bold"><span style="color: #000000">sub_word</span></span><span style="color: #990000">(</span>mo<span style="color: #990000">):</span>
436
- <span style="font-style: italic"><span style="color: #9A1900"> ''' Single line comment.'''</span></span>
437
- word <span style="color: #990000">=</span> mo<span style="color: #990000">.</span><span style="font-weight: bold"><span style="color: #000000">group</span></span><span style="color: #990000">(</span><span style="color: #FF0000">'word'</span><span style="color: #990000">)</span> <span style="font-style: italic"><span style="color: #9A1900"># Inline comment</span></span>
438
- <span style="font-weight: bold"><span style="color: #0000FF">if</span></span> word <span style="font-weight: bold"><span style="color: #0000FF">in</span></span> keywords<span style="color: #990000">[</span>language<span style="color: #990000">]:</span>
439
- <span style="font-weight: bold"><span style="color: #0000FF">return</span></span> quote <span style="color: #990000">+</span> word <span style="color: #990000">+</span> quote
440
- <span style="font-weight: bold"><span style="color: #0000FF">else</span></span><span style="color: #990000">:</span>
441
- <span style="font-weight: bold"><span style="color: #0000FF">return</span></span> word
442
- </tt></pre></div></div>
443
- <h3 id="_numbered_source_code_listing_with_callouts">Numbered source code listing with callouts</h3><div style="clear:left"></div>
444
- <div class="para"><p>This source-highlight filtered block:</p></div>
445
- <div class="listingblock">
446
- <div class="content">
447
- <pre><tt> [source,ruby,numbered]
77
+ <pre><tt><i><font color="#9A1900">''' A multi-line</font></i>
78
+ <i><font color="#9A1900"> comment.'''</font></i>
79
+ <b><font color="#0000FF">def</font></b> <b><font color="#000000">sub_word</font></b><font color="#990000">(</font>mo<font color="#990000">):</font>
80
+ <i><font color="#9A1900"> ''' Single line comment.'''</font></i>
81
+ word <font color="#990000">=</font> mo<font color="#990000">.</font><b><font color="#000000">group</font></b><font color="#990000">(</font><font color="#FF0000">'word'</font><font color="#990000">)</font> <i><font color="#9A1900"># Inline comment</font></i>
82
+ <b><font color="#0000FF">if</font></b> word <b><font color="#0000FF">in</font></b> keywords<font color="#990000">[</font>language<font color="#990000">]:</font>
83
+ <b><font color="#0000FF">return</font></b> quote <font color="#990000">+</font> word <font color="#990000">+</font> quote
84
+ <b><font color="#0000FF">else</font></b><font color="#990000">:</font>
85
+ <b><font color="#0000FF">return</font></b> word</tt></pre></td></tr></table>
86
+ <h3><a name="_numbered_source_code_listing_with_callouts"></a>Numbered source code listing with callouts</h3>
87
+ <p>This source-highlight filtered block:</p>
88
+ <table border="0" bgcolor="#e8e8e8" width="100%" cellpadding="10"><tr><td>
89
+ <pre> [source,ruby,numbered]
448
90
  ---------------------------------------------------------------------
449
91
  #
450
92
  # Useful Ruby base class extensions.
@@ -479,46 +121,44 @@ http://www.gnu.org/software/src-highlite -->
479
121
  ---------------------------------------------------------------------
480
122
 
481
123
  &lt;1&gt; First callout.
482
- &lt;2&gt; Second call out.</tt></pre>
483
- </div></div>
484
- <div class="para"><p>Renders this highlighted source code:</p></div>
485
- <div class="listingblock">
486
- <div class="content"><!-- Generator: GNU source-highlight 2.4
124
+ &lt;2&gt; Second callout.</pre>
125
+ </td></tr></table>
126
+ <p>Renders this highlighted source code:</p>
127
+ <table border="0" bgcolor="#e8e8e8" width="100%" cellpadding="10"><tr><td><!-- Generator: GNU source-highlight 2.4
487
128
  by Lorenzo Bettini
488
129
  http://www.lorenzobettini.it
489
130
  http://www.gnu.org/software/src-highlite -->
490
- <pre><tt><span style="color: #000000">00001:</span> <span style="font-style: italic"><span style="color: #9A1900">#</span></span>
491
- <span style="color: #000000">00002:</span> <span style="font-style: italic"><span style="color: #9A1900"># Useful Ruby base class extensions.</span></span>
492
- <span style="color: #000000">00003:</span> <span style="font-style: italic"><span style="color: #9A1900">#</span></span>
493
- <span style="color: #000000">00004:</span>
494
- <span style="color: #000000">00005:</span> <span style="font-weight: bold"><span style="color: #0000FF">class</span></span> Array
495
- <span style="color: #000000">00006:</span>
496
- <span style="color: #000000">00007:</span> <span style="font-style: italic"><span style="color: #9A1900"># Execute a block passing it corresponding items in</span></span>
497
- <span style="color: #000000">00008:</span> <span style="font-style: italic"><span style="color: #9A1900"># +self+ and +other_array+.</span></span>
498
- <span style="color: #000000">00009:</span> <span style="font-style: italic"><span style="color: #9A1900"># If self has less items than other_array it is repeated.</span></span>
499
- <span style="color: #000000">00010:</span>
500
- <span style="color: #000000">00011:</span> <span style="font-weight: bold"><span style="color: #0000FF">def</span></span> <span style="font-weight: bold"><span style="color: #000000">cycle</span></span><span style="color: #990000">(</span>other_array<span style="color: #990000">)</span> <span style="font-style: italic"><span style="color: #9A1900"># :yields: item, other_item</span></span>
501
- <span style="color: #000000">00012:</span> other_array<span style="color: #990000">.</span>each_with_index <span style="font-weight: bold"><span style="color: #0000FF">do</span></span> <span style="color: #990000">|</span>item<span style="color: #990000">,</span> index<span style="color: #990000">|</span>
502
- <span style="color: #000000">00013:</span> <span style="font-weight: bold"><span style="color: #0000FF">yield</span></span><span style="color: #990000">(</span><span style="font-weight: bold"><span style="color: #0000FF">self</span></span><span style="color: #990000">[</span>index <span style="color: #990000">%</span> <span style="font-weight: bold"><span style="color: #0000FF">self</span></span><span style="color: #990000">.</span>length<span style="color: #990000">],</span> item<span style="color: #990000">)</span>
503
- <span style="color: #000000">00014:</span> <span style="font-weight: bold"><span style="color: #0000FF">end</span></span>
504
- <span style="color: #000000">00015:</span> <span style="font-weight: bold"><span style="color: #0000FF">end</span></span>
505
- <span style="color: #000000">00016:</span>
506
- <span style="color: #000000">00017:</span> <span style="font-weight: bold"><span style="color: #0000FF">end</span></span>
507
- <span style="color: #000000">00018:</span>
508
- <span style="color: #000000">00019:</span> <span style="font-weight: bold"><span style="color: #0000FF">if</span></span> <span style="color: #009900">$0</span> <span style="color: #990000">==</span> <span style="font-weight: bold"><span style="color: #0000FF">__FILE__</span></span> <span style="color: #FF0000"><b>&lt;1&gt;</b></span>
509
- <span style="color: #000000">00020:</span> <span style="font-style: italic"><span style="color: #9A1900"># Array#cycle test</span></span>
510
- <span style="color: #000000">00021:</span> <span style="font-style: italic"><span style="color: #9A1900"># true =&gt; 0</span></span>
511
- <span style="color: #000000">00022:</span> <span style="font-style: italic"><span style="color: #9A1900"># false =&gt; 1</span></span>
512
- <span style="color: #000000">00023:</span> <span style="font-style: italic"><span style="color: #9A1900"># true =&gt; 2</span></span>
513
- <span style="color: #000000">00024:</span> <span style="font-style: italic"><span style="color: #9A1900"># false =&gt; 3</span></span>
514
- <span style="color: #000000">00025:</span> <span style="font-style: italic"><span style="color: #9A1900"># true =&gt; 4</span></span>
515
- <span style="color: #000000">00026:</span> puts <span style="color: #FF0000">'Array#cycle test'</span> <span style="color: #FF0000"><b>&lt;2&gt;</b></span>
516
- <span style="color: #000000">00027:</span> <span style="color: #990000">[</span><span style="font-weight: bold"><span style="color: #0000FF">true</span></span><span style="color: #990000">,</span> <span style="font-weight: bold"><span style="color: #0000FF">false</span></span><span style="color: #990000">].</span><span style="font-weight: bold"><span style="color: #000000">cycle</span></span><span style="color: #990000">([</span><span style="color: #993399">0</span><span style="color: #990000">,</span> <span style="color: #993399">1</span><span style="color: #990000">,</span> <span style="color: #993399">2</span><span style="color: #990000">,</span> <span style="color: #993399">3</span><span style="color: #990000">,</span> <span style="color: #993399">4</span><span style="color: #990000">])</span> <span style="font-weight: bold"><span style="color: #0000FF">do</span></span> <span style="color: #990000">|</span>a<span style="color: #990000">,</span> b<span style="color: #990000">|</span>
517
- <span style="color: #000000">00028:</span> puts <span style="color: #FF0000">"#{a.inspect} =&gt; #{b.inspect}"</span>
518
- <span style="color: #000000">00029:</span> <span style="font-weight: bold"><span style="color: #0000FF">end</span></span>
519
- <span style="color: #000000">00030:</span> <span style="font-weight: bold"><span style="color: #0000FF">end</span></span>
520
- </tt></pre></div></div>
521
- <div class="colist"><ol>
131
+ <pre><tt><font color="#000000">00001:</font> <i><font color="#9A1900">#</font></i>
132
+ <font color="#000000">00002:</font> <i><font color="#9A1900"># Useful Ruby base class extensions.</font></i>
133
+ <font color="#000000">00003:</font> <i><font color="#9A1900">#</font></i>
134
+ <font color="#000000">00004:</font>
135
+ <font color="#000000">00005:</font> <b><font color="#0000FF">class</font></b> Array
136
+ <font color="#000000">00006:</font>
137
+ <font color="#000000">00007:</font> <i><font color="#9A1900"># Execute a block passing it corresponding items in</font></i>
138
+ <font color="#000000">00008:</font> <i><font color="#9A1900"># +self+ and +other_array+.</font></i>
139
+ <font color="#000000">00009:</font> <i><font color="#9A1900"># If self has less items than other_array it is repeated.</font></i>
140
+ <font color="#000000">00010:</font>
141
+ <font color="#000000">00011:</font> <b><font color="#0000FF">def</font></b> <b><font color="#000000">cycle</font></b><font color="#990000">(</font>other_array<font color="#990000">)</font> <i><font color="#9A1900"># :yields: item, other_item</font></i>
142
+ <font color="#000000">00012:</font> other_array<font color="#990000">.</font>each_with_index <b><font color="#0000FF">do</font></b> <font color="#990000">|</font>item<font color="#990000">,</font> index<font color="#990000">|</font>
143
+ <font color="#000000">00013:</font> <b><font color="#0000FF">yield</font></b><font color="#990000">(</font><b><font color="#0000FF">self</font></b><font color="#990000">[</font>index <font color="#990000">%</font> <b><font color="#0000FF">self</font></b><font color="#990000">.</font>length<font color="#990000">],</font> item<font color="#990000">)</font>
144
+ <font color="#000000">00014:</font> <b><font color="#0000FF">end</font></b>
145
+ <font color="#000000">00015:</font> <b><font color="#0000FF">end</font></b>
146
+ <font color="#000000">00016:</font>
147
+ <font color="#000000">00017:</font> <b><font color="#0000FF">end</font></b>
148
+ <font color="#000000">00018:</font>
149
+ <font color="#000000">00019:</font> <b><font color="#0000FF">if</font></b> <font color="#009900">$0</font> <font color="#990000">==</font> <b><font color="#0000FF">__FILE__</font></b> <font color="#FF0000"><b>&lt;1&gt;</b></font>
150
+ <font color="#000000">00020:</font> <i><font color="#9A1900"># Array#cycle test</font></i>
151
+ <font color="#000000">00021:</font> <i><font color="#9A1900"># true =&gt; 0</font></i>
152
+ <font color="#000000">00022:</font> <i><font color="#9A1900"># false =&gt; 1</font></i>
153
+ <font color="#000000">00023:</font> <i><font color="#9A1900"># true =&gt; 2</font></i>
154
+ <font color="#000000">00024:</font> <i><font color="#9A1900"># false =&gt; 3</font></i>
155
+ <font color="#000000">00025:</font> <i><font color="#9A1900"># true =&gt; 4</font></i>
156
+ <font color="#000000">00026:</font> puts <font color="#FF0000">'Array#cycle test'</font> <font color="#FF0000"><b>&lt;2&gt;</b></font>
157
+ <font color="#000000">00027:</font> <font color="#990000">[</font><b><font color="#0000FF">true</font></b><font color="#990000">,</font> <b><font color="#0000FF">false</font></b><font color="#990000">].</font><b><font color="#000000">cycle</font></b><font color="#990000">([</font><font color="#993399">0</font><font color="#990000">,</font> <font color="#993399">1</font><font color="#990000">,</font> <font color="#993399">2</font><font color="#990000">,</font> <font color="#993399">3</font><font color="#990000">,</font> <font color="#993399">4</font><font color="#990000">])</font> <b><font color="#0000FF">do</font></b> <font color="#990000">|</font>a<font color="#990000">,</font> b<font color="#990000">|</font>
158
+ <font color="#000000">00028:</font> puts <font color="#FF0000">"#{a.inspect} =&gt; #{b.inspect}"</font>
159
+ <font color="#000000">00029:</font> <b><font color="#0000FF">end</font></b>
160
+ <font color="#000000">00030:</font> <b><font color="#0000FF">end</font></b></tt></pre></td></tr></table>
161
+ <ol>
522
162
  <li>
523
163
  <p>
524
164
  First callout.
@@ -526,29 +166,49 @@ First callout.
526
166
  </li>
527
167
  <li>
528
168
  <p>
529
- Second call out.
169
+ Second callout.
530
170
  </p>
531
171
  </li>
532
- </ol></div>
533
- </div>
534
- <h2 id="_installation">Installation</h2>
535
- <div class="sectionbody">
536
- <div class="para"><p>If you want to syntax highlight <em>AsciiDoc</em> HTML outputs you need to
172
+ </ol>
173
+ <hr />
174
+ <h2><a name="_installation"></a>Installation</h2>
175
+ <h3><a name="_html"></a>HTML</h3>
176
+ <p>If you want to syntax highlight <em>AsciiDoc</em> HTML outputs (<tt>html4</tt> and
177
+ <tt>xhtml11</tt> backends) you need to
537
178
  install <a href="http://www.gnu.org/software/src-highlite/">GNU
538
- source-highlight</a> (most distributions have this package). It's not
539
- required if you are generating DocBook output (DocBook syntax
540
- highlighting is handled by the DocBook toolchain).</p></div>
541
- <div class="para"><p>Test the filter by converting the test file to HTML with <em>AsciiDoc</em>:</p></div>
542
- <div class="literalblock">
543
- <div class="content">
544
- <pre><tt>$ asciidoc -v ./filters/source-highlight-filter-test.txt
545
- $ firefox ./filters/source-highlight-filter-test.html &amp;</tt></pre>
546
- </div></div>
547
- </div>
548
- <div id="footer">
549
- <div id="footer-text">
550
- Last updated 2008-07-06 13:37:16 NZDT
551
- </div>
552
- </div>
179
+ source-highlight</a> (most distributions have this package).</p>
180
+ <h3><a name="_docbook"></a>DocBook</h3>
181
+ <p><em>AsciiDoc</em> encloses the source code in a DocBook <em>programlisting</em>
182
+ element and leaves source code highlighting to the DocBook toolchain
183
+ (dblatex has a particularly nice programlisting highlighter). The
184
+ DocBook programlisting element is assigned two attributes:</p>
185
+ <ol type="1">
186
+ <li>
187
+ <p>
188
+ The <em>language</em> attribute is set to the <em>AsciiDoc</em> <em>language</em>
189
+ attribute.
190
+ </p>
191
+ </li>
192
+ <li>
193
+ <p>
194
+ The <em>linenumbering</em> attribute is set to the <em>AsciiDoc</em> <em>src_numbered</em>
195
+ attribute (<em>numbered</em> or <em>unnumbered</em>).
196
+ </p>
197
+ </li>
198
+ </ol>
199
+ <p>If you use <tt><tt>a2x(1)</tt></tt> to generate PDF you need to include the
200
+ <tt>--no-xmllint</tt> option to suppress <tt>xmllint(1)</tt> checking&#8201;&#8212;&#8201;the
201
+ programlisting <em>language</em> attribute (required by the dblatex source
202
+ highlighter) is not part of the DocBook 4 specification (but it is in
203
+ the newer DocBook 5 specification).</p>
204
+ <h3><a name="_testing"></a>Testing</h3>
205
+ <p>Test the filter by converting the test file to HTML with <em>AsciiDoc</em>:</p>
206
+ <pre>$ asciidoc -v ./filters/source-highlight-filter-test.txt
207
+ $ firefox ./filters/source-highlight-filter-test.html &amp;</pre>
208
+ <p></p>
209
+ <p></p>
210
+ <hr /><p><small>
211
+ Last updated 2009-01-01 12:22:58 NZDT
212
+ </small></p>
553
213
  </body>
554
214
  </html>