erbook 6.1.0 → 7.0.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (121) hide show
  1. data/bin/erbook +29 -25
  2. data/doc/HelloWorld.spec +3 -1
  3. data/doc/api/classes/ERBook.html +86 -0
  4. data/doc/api/classes/ERBook/Document.html +399 -0
  5. data/doc/api/classes/ERBook/Document/Node.html +110 -0
  6. data/doc/api/classes/ERBook/Template.html +309 -0
  7. data/doc/api/classes/ERBook/Template/Sandbox.html +134 -0
  8. data/doc/api/classes/RDoc.html +69 -0
  9. data/doc/api/classes/RDoc/AnyMethod.html +249 -0
  10. data/doc/api/classes/RDoc/DummyMarkup.html +60 -0
  11. data/doc/api/classes/RDoc/DummyMixin.html +54 -0
  12. data/doc/api/classes/RDoc/DummyOptions.html +60 -0
  13. data/doc/api/classes/RDoc/TopLevel.html +344 -0
  14. data/doc/api/classes/String.html +212 -0
  15. data/doc/api/created.rid +1 -0
  16. data/doc/api/css/main.css +263 -0
  17. data/doc/api/css/panel.css +383 -0
  18. data/doc/api/css/reset.css +53 -0
  19. data/doc/api/files/ANN_eml.html +276 -0
  20. data/doc/api/files/ANN_html.html +407 -0
  21. data/doc/api/files/ANN_txt.html +271 -0
  22. data/doc/api/files/LICENSE.html +76 -0
  23. data/doc/api/files/lib/erbook/document_rb.html +74 -0
  24. data/doc/api/files/lib/erbook/rdoc_rb.html +77 -0
  25. data/doc/api/files/lib/erbook/template_rb.html +66 -0
  26. data/doc/api/files/lib/erbook/to_xhtml_rb.html +89 -0
  27. data/doc/api/files/lib/erbook_rb.html +70 -0
  28. data/doc/api/i/arrows.png +0 -0
  29. data/doc/api/i/results_bg.png +0 -0
  30. data/doc/api/i/tree_bg.png +0 -0
  31. data/doc/api/index.html +14 -18
  32. data/doc/api/js/jquery-1.3.2.min.js +19 -0
  33. data/doc/api/js/jquery-effect.js +593 -0
  34. data/doc/api/js/main.js +22 -0
  35. data/doc/api/js/searchdoc.js +605 -0
  36. data/doc/api/panel/index.html +63 -0
  37. data/doc/api/panel/search_index.js +1 -0
  38. data/doc/api/panel/tree.js +1 -0
  39. data/doc/formats.erb +63 -115
  40. data/doc/history.erb +125 -92
  41. data/doc/index.erb +12 -7
  42. data/doc/index.xhtml +1020 -1347
  43. data/doc/intro.erb +42 -40
  44. data/doc/setup.erb +18 -18
  45. data/doc/theory.erb +24 -31
  46. data/doc/usage.erb +14 -24
  47. data/fmt/xhtml.icons/index.yaml +16 -14
  48. data/fmt/xhtml.icons/rakefile +33 -0
  49. data/fmt/xhtml.icons/tango-icon-theme-0.8.90/16x16/places/start-here.png +0 -0
  50. data/fmt/xhtml.icons/tango-icon-theme-0.8.90/32x32/actions/go-down.png +0 -0
  51. data/fmt/xhtml.icons/tango-icon-theme-0.8.90/32x32/actions/go-up.png +0 -0
  52. data/fmt/xhtml.icons/tango-icon-theme-0.8.90/32x32/places/start-here.png +0 -0
  53. data/fmt/xhtml.icons/tango-icon-theme-0.8.90/32x32/status/software-update-available.png +0 -0
  54. data/fmt/xhtml.icons/{tango-icon-theme-0.8.1 → tango-icon-theme-0.8.90}/48x48/apps/accessories-text-editor.png +0 -0
  55. data/fmt/xhtml.icons/tango-icon-theme-0.8.90/48x48/apps/internet-group-chat.png +0 -0
  56. data/fmt/xhtml.icons/{tango-icon-theme-0.8.1 → tango-icon-theme-0.8.90}/48x48/emblems/emblem-important.png +0 -0
  57. data/fmt/xhtml.icons/{tango-icon-theme-0.8.1 → tango-icon-theme-0.8.90}/48x48/status/dialog-error.png +0 -0
  58. data/fmt/xhtml.icons/{tango-icon-theme-0.8.1 → tango-icon-theme-0.8.90}/48x48/status/dialog-information.png +0 -0
  59. data/fmt/xhtml.icons/{tango-icon-theme-0.8.1 → tango-icon-theme-0.8.90}/48x48/status/dialog-warning.png +0 -0
  60. data/fmt/xhtml.icons/tango-icon-theme-0.8.90/COPYING +1 -0
  61. data/fmt/xhtml.icons/{tango-icon-theme-0.8.1 → tango-icon-theme-0.8.90}/README +0 -0
  62. data/fmt/xhtml.icons/tango-icon-theme-0.8.90/scalable/actions/bookmark-new.svg +672 -0
  63. data/fmt/xhtml.icons/tango-icon-theme-0.8.90/scalable/actions/go-down.svg +200 -0
  64. data/fmt/xhtml.icons/tango-icon-theme-0.8.90/scalable/actions/go-home.svg +445 -0
  65. data/fmt/xhtml.icons/tango-icon-theme-0.8.90/scalable/actions/go-up.svg +196 -0
  66. data/fmt/xhtml.icons/tango-icon-theme-0.8.90/scalable/actions/view-refresh.svg +393 -0
  67. data/fmt/xhtml.icons/tango-icon-theme-0.8.90/scalable/apps/accessories-text-editor.svg +554 -0
  68. data/fmt/xhtml.icons/tango-icon-theme-0.8.90/scalable/apps/internet-group-chat.svg +312 -0
  69. data/fmt/xhtml.icons/tango-icon-theme-0.8.90/scalable/emblems/emblem-favorite.svg +242 -0
  70. data/fmt/xhtml.icons/tango-icon-theme-0.8.90/scalable/emblems/emblem-important.svg +164 -0
  71. data/fmt/xhtml.icons/tango-icon-theme-0.8.90/scalable/mimetypes/application-certificate.svg +443 -0
  72. data/fmt/xhtml.icons/tango-icon-theme-0.8.90/scalable/places/start-here.svg +492 -0
  73. data/fmt/xhtml.icons/tango-icon-theme-0.8.90/scalable/status/dialog-error.svg +330 -0
  74. data/fmt/xhtml.icons/tango-icon-theme-0.8.90/scalable/status/dialog-information.svg +1159 -0
  75. data/fmt/xhtml.icons/tango-icon-theme-0.8.90/scalable/status/dialog-warning.svg +373 -0
  76. data/fmt/xhtml.icons/tango-icon-theme-0.8.90/scalable/status/software-update-available.svg +209 -0
  77. data/fmt/xhtml.scripts/jquery-1.3.2.min.js +19 -0
  78. data/fmt/xhtml.scripts/jquery.localscroll-1.2.7-min.js +9 -0
  79. data/fmt/xhtml.scripts/jquery.scrollTo-1.4.1-min.js +11 -0
  80. data/fmt/xhtml.yaml +470 -454
  81. data/lang/de.yaml +5 -5
  82. data/lang/el.yaml +4 -4
  83. data/lang/es.yaml +5 -5
  84. data/lang/fr.yaml +5 -5
  85. data/lang/it.yaml +5 -5
  86. data/lang/ja.yaml +4 -4
  87. data/lang/ko.yaml +4 -4
  88. data/lang/nl.yaml +4 -4
  89. data/lang/phrases.yaml +4 -4
  90. data/lang/pt.yaml +5 -5
  91. data/lang/ru.yaml +5 -5
  92. data/lang/zh.yaml +5 -5
  93. data/lang/zt.yaml +5 -5
  94. data/lib/erbook.rb +12 -5
  95. data/lib/erbook/document.rb +127 -107
  96. data/lib/erbook/rdoc.rb +18 -11
  97. data/lib/erbook/template.rb +86 -176
  98. data/lib/erbook/to_xhtml.rb +98 -25
  99. data/{Rakefile → rakefile} +1 -0
  100. metadata +106 -53
  101. data/doc/api/ERBook.html +0 -35
  102. data/doc/api/ERBook/Document.html +0 -669
  103. data/doc/api/ERBook/Document/Node.html +0 -102
  104. data/doc/api/ERBook/Template.html +0 -670
  105. data/doc/api/RDoc.html +0 -23
  106. data/doc/api/RDoc/AnyMethod.html +0 -302
  107. data/doc/api/RDoc/DummyMarkup.html +0 -73
  108. data/doc/api/RDoc/DummyMixin.html +0 -23
  109. data/doc/api/RDoc/DummyOptions.html +0 -140
  110. data/doc/api/RDoc/TopLevel.html +0 -465
  111. data/doc/api/String.html +0 -372
  112. data/doc/api/all-methods.html +0 -253
  113. data/doc/api/all-namespaces.html +0 -42
  114. data/doc/api/app.js +0 -18
  115. data/doc/api/jquery.js +0 -11
  116. data/doc/api/readme.html +0 -38
  117. data/doc/api/style.css +0 -68
  118. data/doc/api/syntax_highlight.css +0 -21
  119. data/fmt/xhtml.icons/tango-icon-theme-0.8.1/48x48/README +0 -2
  120. data/fmt/xhtml.icons/tango-icon-theme-0.8.1/48x48/apps/internet-group-chat.png +0 -0
  121. data/fmt/xhtml.icons/tango-icon-theme-0.8.1/COPYING +0 -67
@@ -0,0 +1,53 @@
1
+ /* http://meyerweb.com/eric/tools/css/reset/ */
2
+ /* v1.0 | 20080212 */
3
+
4
+ html, body, div, span, applet, object, iframe,
5
+ h1, h2, h3, h4, h5, h6, p, blockquote, pre,
6
+ a, abbr, acronym, address, big, cite, code,
7
+ del, dfn, em, font, img, ins, kbd, q, s, samp,
8
+ small, strike, strong, sub, sup, tt, var,
9
+ b, u, i, center,
10
+ dl, dt, dd, ol, ul, li,
11
+ fieldset, form, label, legend,
12
+ table, caption, tbody, tfoot, thead, tr, th, td {
13
+ margin: 0;
14
+ padding: 0;
15
+ border: 0;
16
+ outline: 0;
17
+ font-size: 100%;
18
+ vertical-align: baseline;
19
+ background: transparent;
20
+ }
21
+ body {
22
+ line-height: 1;
23
+ }
24
+ ol, ul {
25
+ list-style: none;
26
+ }
27
+ blockquote, q {
28
+ quotes: none;
29
+ }
30
+ blockquote:before, blockquote:after,
31
+ q:before, q:after {
32
+ content: '';
33
+ content: none;
34
+ }
35
+
36
+ /* remember to define focus styles! */
37
+ :focus {
38
+ outline: 0;
39
+ }
40
+
41
+ /* remember to highlight inserts somehow! */
42
+ ins {
43
+ text-decoration: none;
44
+ }
45
+ del {
46
+ text-decoration: line-through;
47
+ }
48
+
49
+ /* tables still need 'cellspacing="0"' in the markup */
50
+ table {
51
+ border-collapse: collapse;
52
+ border-spacing: 0;
53
+ }
@@ -0,0 +1,276 @@
1
+ <?xml version="1.0" encoding="utf-8"?>
2
+ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4
+ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
5
+ <head>
6
+ <title>ANN.eml</title>
7
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
8
+ <link rel="stylesheet" href="../css/reset.css" type="text/css" media="screen" />
9
+ <link rel="stylesheet" href="../css/main.css" type="text/css" media="screen" />
10
+ <script src="../js/jquery-1.3.2.min.js" type="text/javascript" charset="utf-8"></script>
11
+ <script src="../js/jquery-effect.js" type="text/javascript" charset="utf-8"></script>
12
+ <script src="../js/main.js" type="text/javascript" charset="utf-8"></script>
13
+ </head>
14
+
15
+ <body>
16
+ <div class="banner">
17
+ <h1>
18
+ ANN.eml
19
+ </h1>
20
+ <ul class="files">
21
+ <li>ANN.eml</li>
22
+ <li>Last modified: Mon May 04 01:18:29 -0700 2009</li>
23
+ </ul>
24
+ </div>
25
+
26
+ <div id="bodyContent">
27
+ <div id="content">
28
+
29
+ <div class="description">
30
+ <p>
31
+ Date: Mon, 04 May 2009 01:18:22 -0700 To: ruby-talk@ruby-lang.org From:
32
+ &#8220;Suraj N. Kurapati&#8221; <sunaku@gmail.com> Subject: [ANN] <a
33
+ href="../classes/ERBook.html">ERBook</a> 7.0.0
34
+ </p>
35
+ <pre>
36
+ ERBook 7.0.0
37
+
38
+ Extensible document processor based on eRuby
39
+
40
+ http://snk.tuxfamily.org/lib/erbook/
41
+
42
+ ERBook is an extensible document processor that emits [1]any
43
+ document you can imagine from [2]eRuby templates that allow
44
+ scripting and dynamic content generation.
45
+
46
+ A working [3]XHTML (web page) format is provided, while
47
+ [4]LaTeX (PDF), [5]UNIX manual page, and [6]plain text
48
+ formats are planned... [7]patches are welcome!
49
+
50
+ ERBook is exciting because:
51
+
52
+ * Its documents are scriptable [8]eRuby templates.
53
+
54
+ * It lets you [9]define your own document formats.
55
+
56
+ * Its core contains less than 300 lines of code.
57
+
58
+ These features distinguish ERBook from the competition, which
59
+ offers neither scriptable documents nor definable document
60
+ formats:
61
+
62
+ * [10]DocBook
63
+
64
+ * [11]Deplate
65
+
66
+ * [12]SiSU
67
+
68
+ * [13]AsciiDoc
69
+
70
+ * [14]txt2tags
71
+
72
+ * [15]Grutatxt
73
+ </pre>
74
+ <p>
75
+ Logistics
76
+ </p>
77
+ <pre>
78
+ * [16]Release notes -- history of project releases.
79
+
80
+ * [17]Source code -- obtain via [18]Git or browse online.
81
+
82
+ * [19]API reference -- documentation for source code.
83
+
84
+ * [20]Project home -- the ERBook project home page.
85
+
86
+ To get help or provide feedback, simply [21]contact the
87
+ authors.
88
+
89
+ Version numbers
90
+
91
+ ERBook releases are numbered in major.minor.patch form
92
+ according to the [22]RubyGems rational versioning policy,
93
+ which can be summarized thus:
94
+ What increased in the version number? The increase indicates
95
+ that the release:
96
+ Is backward compatible? Has new features? Has bug fixes?
97
+ major No Yes Yes
98
+ minor Yes Yes Yes
99
+ patch Yes No Yes
100
+ </pre>
101
+ <p>
102
+ Version 7.0.0 (2009-05-03)
103
+ </p>
104
+ <pre>
105
+ This release improves the appearance, usability, and validity
106
+ of [23]XHTML (web page) output, upgrades to a new eRuby
107
+ templating system, adds new processing options to node
108
+ definitions, and fixes some bugs.
109
+
110
+ Incompatible changes
111
+
112
+ * If you add methods to the ERBook::Template class, in
113
+ order to provide them to eRuby templates, you must now
114
+ add those methods to the ERBook::Template::Sandbox class
115
+ instead.
116
+
117
+ * The [24]Ember template processor is now used to render
118
+ eRuby templates instead of the ERB library that is
119
+ shipped with Ruby.
120
+ + The file inclusion directive has been removed:
121
+ </pre>
122
+ <p>
123
+ <%# include YOUR_FILE #%>
124
+ </p>
125
+ <pre>
126
+ Ember provides equivalent functionality:
127
+ </pre>
128
+ <p>
129
+ %< &#8220;YOUR_FILE&#8220;
130
+ </p>
131
+ <pre>
132
+ * The erbook/to_xhtml library now annotates &lt;code&gt; elements
133
+ with a &quot;line&quot; or &quot;para&quot; class indicating whether they
134
+ span a single or mulitple lines respectively.
135
+ The &quot;pre.code&quot; CSS class is no longer emitted.
136
+
137
+ * The erbook/rdoc library has been updated to work with
138
+ RDoc 2.4.3. It no longer supports the old RDoc that is
139
+ shipped with Ruby 1.8.
140
+
141
+ * Just a reminder from the [25]Version 5.0.0 (2008-11-22)
142
+ release notes:
143
+
144
+ Internet Explorer 6 and 7 [26]do not support the
145
+ application/xhtml+xml mime type, so the output generated
146
+ by the [27]XHTML (web page) format cannot be viewed in
147
+ those browsers.
148
+
149
+ New features
150
+
151
+ * Replace dark background theme with a &quot;wide open spaces&quot;
152
+ theme.
153
+ + Use icons instead of unicode glyphs for mini
154
+ navigation menus.
155
+ + Put mini navigation menus on right-hand side of
156
+ headings
157
+ + Use [28]scrolling animation when local links (URI
158
+ fragments) are visited, instead of instantly
159
+ teleporting to the destination. This gives a sense
160
+ of spatial existence to the web page, making it feel
161
+ almost tangible!
162
+
163
+ * XHTML output is now valid XHTML 1.0 Transitional! And the
164
+ embedded CSS it contains is now valid CSS 3!
165
+ + Minify CSS in XHTML output using the [29]Rainpress
166
+ library.
167
+ + Add CSS style for HTML definition lists.
168
+
169
+ * Omit target type and index (&quot;Section X.Y.Z&quot;) in output of
170
+ xref() nodes in the screen-version (CSS stylesheet) of
171
+ the generated output document.
172
+ This information is still present in the print-version
173
+ (CSS stylesheet) of the generated output document, where
174
+ it is truly helpful to the reader.
175
+
176
+ * Add &quot;bypass&quot; option to node definitions to properly
177
+ support the generic &quot;node&quot; node. Invalid XHTML was being
178
+ generated because the `node' node was marked as simply
179
+ &quot;inline&quot;, so it was not pulled out of the &lt;p&gt; tag created
180
+ by Maruku.
181
+
182
+ Bug fixes
183
+
184
+ * The &quot;silent&quot; property in node definitions was not being
185
+ honored.
186
+
187
+ * Fix error when inserting reference nodes (they are not
188
+ inline!).
189
+
190
+ * Add workaround for Maruku treating first line of input as
191
+ parameter definition, and thereby omitting it from the
192
+ output!
193
+
194
+ * Array#to_s is equivalent to Array#inspect in Ruby 1.9.
195
+
196
+ * [30]HelloWorld format specification file added methods to
197
+ the nonexistent ERBook::Node class instead of adding them
198
+ to the ERBook::Document::Node class.
199
+
200
+ Housekeeping
201
+
202
+ * Simplify language phrases used in mini navigation menus.
203
+
204
+ * Remove CSS hacks for supporting IE6; it cannot render
205
+ XHTML anyway.
206
+
207
+ * Render italics and boldface equally in serif font. Bold
208
+ is truly bold now and italic is distinctive.
209
+
210
+ * Adjust spacing between document title, author, and date
211
+ headings.
212
+
213
+ * Add copyright notice at the top of every file.
214
+ </pre>
215
+ <p>
216
+ References
217
+ </p>
218
+ <pre>
219
+ 1. http://snk.tuxfamily.org/lib/erbook/#HelloWorld
220
+ 2. http://en.wikipedia.org/wiki/ERuby
221
+ 3. http://snk.tuxfamily.org/lib/erbook/#xhtml
222
+ 4. http://snk.tuxfamily.org/lib/erbook/#latex
223
+ 5. http://snk.tuxfamily.org/lib/erbook/#man
224
+ 6. http://snk.tuxfamily.org/lib/erbook/#text
225
+ 7. http://snk.tuxfamily.org/lib/erbook/#License
226
+ 8. http://en.wikipedia.org/wiki/ERuby
227
+ 9. http://snk.tuxfamily.org/lib/erbook/#HelloWorld
228
+ 10. http://www.docbook.org/
229
+ 11. http://deplate.sourceforge.net/
230
+ 12. http://www.jus.uio.no/sisu/SiSU/
231
+ 13. http://www.methods.co.nz/asciidoc/
232
+ 14. http://txt2tags.sourceforge.net/
233
+ 15. http://www.triptico.com/software/grutatxt.html
234
+ 16. http://snk.tuxfamily.org/lib/erbook/#History
235
+ 17. http://github.com/sunaku/erbook
236
+ 18. http://git-scm.com/
237
+ 19. http://snk.tuxfamily.org/lib/erbook/./api/index.html
238
+ 20. http://snk.tuxfamily.org/lib/erbook/
239
+ 21. http://snk.tuxfamily.org/lib/erbook/#License
240
+ 22. http://www.rubygems.org/read/chapter/7
241
+ 23. http://snk.tuxfamily.org/lib/erbook/#xhtml
242
+ 24. http://snk.tuxfamily.org/lib/ember
243
+ 25. http://snk.tuxfamily.org/lib/erbook/#Version-5.0.0-2008-11-22
244
+ 26. http://www.w3.org/MarkUp/2004/xhtml-faq#ie
245
+ 27. http://snk.tuxfamily.org/lib/erbook/#xhtml
246
+ 28. http://demos.flesler.com/jquery/scrollTo/
247
+ 29. http://github.com/sprsquish/rainpress/tree/master
248
+ 30. http://snk.tuxfamily.org/lib/erbook/#HelloWorld.spec
249
+ </pre>
250
+
251
+ </div>
252
+
253
+
254
+
255
+
256
+
257
+
258
+
259
+
260
+
261
+
262
+
263
+
264
+
265
+
266
+
267
+
268
+
269
+
270
+
271
+
272
+
273
+ </div>
274
+ </div>
275
+ </body>
276
+ </html>
@@ -0,0 +1,407 @@
1
+ <?xml version="1.0" encoding="utf-8"?>
2
+ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4
+ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
5
+ <head>
6
+ <title>ANN.html</title>
7
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
8
+ <link rel="stylesheet" href="../css/reset.css" type="text/css" media="screen" />
9
+ <link rel="stylesheet" href="../css/main.css" type="text/css" media="screen" />
10
+ <script src="../js/jquery-1.3.2.min.js" type="text/javascript" charset="utf-8"></script>
11
+ <script src="../js/jquery-effect.js" type="text/javascript" charset="utf-8"></script>
12
+ <script src="../js/main.js" type="text/javascript" charset="utf-8"></script>
13
+ </head>
14
+
15
+ <body>
16
+ <div class="banner">
17
+ <h1>
18
+ ANN.html
19
+ </h1>
20
+ <ul class="files">
21
+ <li>ANN.html</li>
22
+ <li>Last modified: Mon May 04 01:18:29 -0700 2009</li>
23
+ </ul>
24
+ </div>
25
+
26
+ <div id="bodyContent">
27
+ <div id="content">
28
+
29
+ <div class="description">
30
+ <pre>
31
+ &lt;center&gt;
32
+ &lt;h1&gt;ERBook 7.0.0&lt;/h1&gt;
33
+ &lt;p&gt;Extensible document processor based on eRuby&lt;/p&gt;
34
+ &lt;p&gt;http://snk.tuxfamily.org/lib/erbook/&lt;/p&gt;
35
+ &lt;/center&gt;
36
+ &lt;p&gt;ERBook is an extensible document processor that emits &lt;a class=&quot;xref&quot; href=&quot;http://snk.tuxfamily.org/lib/erbook/#HelloWorld&quot; title=&quot;Section 3.2.3. &amp;quot;Creating your own document format&amp;quot;&quot;&gt;any document you can imagine&lt;/a&gt; from &lt;a href='http://en.wikipedia.org/wiki/ERuby'&gt;eRuby templates&lt;/a&gt; that allow scripting and dynamic content generation.&lt;/p&gt;
37
+ </pre>
38
+ <p>
39
+ <p>A working <a class=&#8220;xref&#8221; href=&#8220;<a
40
+ href="http://snk.tuxfamily.org/lib/erbook/#xhtml">snk.tuxfamily.org/lib/erbook/#xhtml</a>&#8220;
41
+ title=&#8220;Chapter 5.1. &amp;quot;XHTML (web page)&amp;quot;&#8221;>XHTML
42
+ (web page)</a> format is provided, while <a class=&#8220;xref&#8221;
43
+ href=&#8220;<a
44
+ href="http://snk.tuxfamily.org/lib/erbook/#latex">snk.tuxfamily.org/lib/erbook/#latex</a>&#8220;
45
+ title=&#8220;Chapter 5.3. &amp;quot;LaTeX (PDF)&amp;quot;&#8221;>LaTeX
46
+ (PDF)</a>, <a class=&#8220;xref&#8221; href=&#8220;<a
47
+ href="http://snk.tuxfamily.org/lib/erbook/#man">snk.tuxfamily.org/lib/erbook/#man</a>&#8220;
48
+ title=&#8220;Chapter 5.4. &amp;quot;UNIX manual page&amp;quot;&#8221;>UNIX
49
+ manual page</a>, and <a class=&#8220;xref&#8221; href=&#8220;<a
50
+ href="http://snk.tuxfamily.org/lib/erbook/#text">snk.tuxfamily.org/lib/erbook/#text</a>&#8220;
51
+ title=&#8220;Chapter 5.2. &amp;quot;Plain text&amp;quot;&#8221;>plain
52
+ text</a> formats are planned&amp;8230; <a class=&#8220;xref&#8221;
53
+ href=&#8220;<a
54
+ href="http://snk.tuxfamily.org/lib/erbook/#License">snk.tuxfamily.org/lib/erbook/#License</a>&#8220;
55
+ title=&#8220;Section 1.1. &amp;quot;License&amp;quot;&#8221;>patches are
56
+ welcome</a>!</p>
57
+ </p>
58
+ <p>
59
+ <p><a href="../classes/ERBook.html">ERBook</a> is exciting because:</p>
60
+ </p>
61
+ <p>
62
+ <ul> <li>Its documents are scriptable <a href=&#8217;<a
63
+ href="http://en.wikipedia.org/wiki/ERuby'>eRuby">en.wikipedia.org/wiki/ERuby'>eRuby</a>
64
+ templates</a>.</li>
65
+ </p>
66
+ <p>
67
+ <li>It lets you <a class=&#8220;xref&#8221; href=&#8220;<a
68
+ href="http://snk.tuxfamily.org/lib/erbook/#HelloWorld">snk.tuxfamily.org/lib/erbook/#HelloWorld</a>&#8220;
69
+ title=&#8220;Section 3.2.3. &amp;quot;Creating your own document
70
+ format&amp;quot;&#8221;>define your own document formats</a>.</li>
71
+ </p>
72
+ <p>
73
+ <li>Its core contains less than 300 lines of code.</li> </ul>
74
+ </p>
75
+ <p>
76
+ <p>These features distinguish <a href="../classes/ERBook.html">ERBook</a>
77
+ from the competition, which offers neither scriptable documents nor
78
+ definable document formats:</p>
79
+ </p>
80
+ <p>
81
+ <ul> <li><a href=&#8217;<a
82
+ href="http://www.docbook.org'>DocBook</a></li">www.docbook.org'>DocBook</a></li</a>>
83
+ </p>
84
+ <p>
85
+ <li><a href=&#8217;<a
86
+ href="http://deplate.sourceforge.net'>Deplate</a></li">deplate.sourceforge.net'>Deplate</a></li</a>>
87
+ </p>
88
+ <p>
89
+ <li><a href=&#8217;<a
90
+ href="http://www.jus.uio.no/sisu/SiSU/'>SiSU</a></li">www.jus.uio.no/sisu/SiSU/'>SiSU</a></li</a>>
91
+ </p>
92
+ <p>
93
+ <li><a href=&#8217;<a
94
+ href="http://www.methods.co.nz/asciidoc/'>AsciiDoc</a></li">www.methods.co.nz/asciidoc/'>AsciiDoc</a></li</a>>
95
+ </p>
96
+ <p>
97
+ <li><a href=&#8217;<a
98
+ href="http://txt2tags.sourceforge.net'>txt2tags</a></li">txt2tags.sourceforge.net'>txt2tags</a></li</a>>
99
+ </p>
100
+ <p>
101
+ <li><a href=&#8217;<a
102
+ href="http://www.triptico.com/software/grutatxt.html'>Grutatxt</a></li">www.triptico.com/software/grutatxt.html'>Grutatxt</a></li</a>>
103
+ </ul>
104
+ </p>
105
+ <p>
106
+ <div class=&#8220;section&#8221;>
107
+ </p>
108
+ <pre>
109
+ &lt;a name=&quot;Logistics&quot;/&gt;
110
+ &lt;h2 class=&quot;title&quot;&gt;Logistics
111
+ &lt;/h2&gt;
112
+ &lt;div class=&quot;content&quot;&gt;&lt;ul&gt;
113
+ </pre>
114
+ <p>
115
+ <li><a class=&#8220;xref&#8221; href=&#8220;<a
116
+ href="http://snk.tuxfamily.org/lib/erbook/#History">snk.tuxfamily.org/lib/erbook/#History</a>&#8220;
117
+ title=&#8220;Chapter 6. &amp;quot;History&amp;quot;&#8221;>Release
118
+ notes</a> &amp;8212; history of project releases.</li>
119
+ </p>
120
+ <p>
121
+ <li><a href=&#8217;<a
122
+ href="http://github.com/sunaku/erbook'>Source">github.com/sunaku/erbook'>Source</a>
123
+ code</a> &amp;8212; obtain via <a href=&#8217;<a
124
+ href="http://git-scm.com'>Git</a">git-scm.com'>Git</a</a>> or browse
125
+ online.</li>
126
+ </p>
127
+ <p>
128
+ <li><a href=&#8217;<a
129
+ href="http://snk.tuxfamily.org/lib/erbook/./api/index.html'>API">snk.tuxfamily.org/lib/erbook/./api/index.html'>API</a>
130
+ reference</a> &amp;8212; documentation for source code.</li>
131
+ </p>
132
+ <p>
133
+ <li><a href=&#8217;<a
134
+ href="http://snk.tuxfamily.org/lib/erbook/'>Project">snk.tuxfamily.org/lib/erbook/'>Project</a>
135
+ home</a> &amp;8212; the <a href="../classes/ERBook.html">ERBook</a> project
136
+ home page.</li> </ul></div> </div><p> To get help or provide feedback,
137
+ simply <a class=&#8220;xref&#8221; href=&#8220;<a
138
+ href="http://snk.tuxfamily.org/lib/erbook/#License">snk.tuxfamily.org/lib/erbook/#License</a>&#8220;
139
+ title=&#8220;Section 1.1. &amp;quot;License&amp;quot;&#8221;>contact the
140
+ authors</a>.</p>
141
+ </p>
142
+ <p>
143
+ <div class=&#8220;paragraph&#8221;>
144
+ </p>
145
+ <pre>
146
+ &lt;a name=&quot;Version-numbers&quot;/&gt;
147
+ &lt;p class=&quot;title&quot;&gt;Version numbers&lt;/p&gt;
148
+ &lt;div class=&quot;content&quot;&gt;&lt;p&gt;ERBook releases are numbered in &lt;em&gt;major.minor.patch&lt;/em&gt; form according to the &lt;a href='http://www.rubygems.org/read/chapter/7'&gt;RubyGems rational versioning policy&lt;/a&gt;, which can be summarized thus:&lt;/p&gt;
149
+ </pre>
150
+ <p>
151
+ <table border=&#8220;1&#8221;>
152
+ </p>
153
+ <pre>
154
+ &lt;thead&gt;
155
+ &lt;tr&gt;
156
+ &lt;td rowspan='2'&gt;What increased in the version number?&lt;/td&gt;
157
+ &lt;td colspan='3'&gt;The increase indicates that the release:&lt;/td&gt;
158
+ &lt;/tr&gt;
159
+ &lt;tr&gt;
160
+ &lt;th&gt;Is backward compatible?&lt;/th&gt;
161
+ &lt;th&gt;Has new features?&lt;/th&gt;
162
+ &lt;th&gt;Has bug fixes?&lt;/th&gt;
163
+ &lt;/tr&gt;
164
+ &lt;/thead&gt;
165
+ &lt;tbody&gt;
166
+ &lt;tr&gt;
167
+ &lt;th&gt;major&lt;/th&gt;
168
+ &lt;td style='background-color: #FFE4E1;'&gt;No&lt;/td&gt;
169
+ &lt;td&gt;Yes&lt;/td&gt;
170
+ &lt;td&gt;Yes&lt;/td&gt;
171
+ &lt;/tr&gt;
172
+ &lt;tr&gt;
173
+ &lt;th&gt;minor&lt;/th&gt;
174
+ &lt;td&gt;Yes&lt;/td&gt;
175
+ &lt;td&gt;Yes&lt;/td&gt;
176
+ &lt;td&gt;Yes&lt;/td&gt;
177
+ &lt;/tr&gt;
178
+ &lt;tr&gt;
179
+ &lt;th&gt;patch&lt;/th&gt;
180
+ &lt;td&gt;Yes&lt;/td&gt;
181
+ &lt;td style='background-color: #FFE4E1;'&gt;No&lt;/td&gt;
182
+ &lt;td&gt;Yes&lt;/td&gt;
183
+ &lt;/tr&gt;
184
+ &lt;/tbody&gt;
185
+ </pre>
186
+ <p>
187
+ </table></div> </div><p></p>
188
+ </p>
189
+ <pre>
190
+ &lt;div class=&quot;section&quot;&gt;
191
+ &lt;a name=&quot;Version-7.0.0-2009-05-03&quot;/&gt;
192
+ &lt;h2 class=&quot;title&quot;&gt;Version 7.0.0 (2009-05-03)
193
+ &lt;/h2&gt;
194
+ &lt;div class=&quot;content&quot;&gt;&lt;p&gt;This release improves the appearance, usability, and validity of &lt;a class=&quot;xref&quot; href=&quot;http://snk.tuxfamily.org/lib/erbook/#xhtml&quot; title=&quot;Chapter 5.1&quot;&gt;XHTML (web page)&lt;/a&gt; output, upgrades to a new eRuby templating system, adds new processing options to node definitions, and fixes some bugs.&lt;/p&gt;
195
+ </pre>
196
+ <p>
197
+ <div class=&#8220;paragraph&#8221;>
198
+ </p>
199
+ <pre>
200
+ &lt;a name=&quot;Incompatible-changes&quot;/&gt;
201
+ &lt;p class=&quot;title&quot;&gt;Incompatible changes&lt;/p&gt;
202
+ &lt;div class=&quot;content&quot;&gt;&lt;ul&gt;
203
+ </pre>
204
+ <p>
205
+ <li> <p>If you add methods to the <code class=&#8220;line&#8221;><span
206
+ style=&#8220;color:036;font-weight:bold&#8221;>ERBook</span>::<span
207
+ style=&#8220;color:036;font-weight:bold&#8221;>Template</span></code>
208
+ class, in order to provide them to eRuby templates, you must now add those
209
+ methods to the <code class=&#8220;line&#8221;><span
210
+ style=&#8220;color:036;font-weight:bold&#8221;>ERBook</span>::<span
211
+ style=&#8220;color:036;font-weight:bold&#8221;>Template</span>::<span
212
+ style=&#8220;color:036;font-weight:bold&#8221;>Sandbox</span></code> class
213
+ instead.</p> </li>
214
+ </p>
215
+ <p>
216
+ <li> <p>The <a href=&#8217;<a
217
+ href="http://snk.tuxfamily.org/lib/ember'>Ember</a">snk.tuxfamily.org/lib/ember'>Ember</a</a>>
218
+ template processor is now used to render eRuby templates instead of the ERB
219
+ library that is shipped with Ruby.</p>
220
+ </p>
221
+ <p>
222
+ <ul> <li> <p>The file inclusion directive has been removed:</p>
223
+ </p>
224
+ <p>
225
+ <pre>&amp;lt;%# include YOUR_FILE #%&amp;gt;</pre>
226
+ </p>
227
+ <p>
228
+ <p>Ember provides equivalent functionality:</p>
229
+ </p>
230
+ <p>
231
+ <pre>%&amp;lt; &amp;quot;YOUR_FILE&amp;quot;</pre> </li> </ul> </li>
232
+ </p>
233
+ <p>
234
+ <li> <p>The <tt>erbook/to_xhtml</tt> library now annotates
235
+ &amp;60;code&amp;62; elements with a &amp;8220;line&amp;8221; or
236
+ &amp;8220;para&amp;8221; class indicating whether they span a single or
237
+ mulitple lines respectively.</p>
238
+ </p>
239
+ <p>
240
+ <p>The &amp;8220;pre.code&amp;8221; CSS class is no longer emitted.</p>
241
+ </li>
242
+ </p>
243
+ <p>
244
+ <li> <p>The <tt>erbook/rdoc</tt> library has been updated to work with <a
245
+ href="../classes/RDoc.html">RDoc</a> 2.4.3. It no longer supports the old
246
+ <a href="../classes/RDoc.html">RDoc</a> that is shipped with Ruby 1.8.</p>
247
+ </li>
248
+ </p>
249
+ <p>
250
+ <li> <p>Just a reminder from the <a class=&#8220;xref&#8221; href=&#8220;<a
251
+ href="http://snk.tuxfamily.org/lib/erbook/#Version-5.0.0-2008-11-22">snk.tuxfamily.org/lib/erbook/#Version-5.0.0-2008-11-22</a>&#8220;
252
+ title=&#8220;Section 6.5&#8220;>Version 5.0.0 (2008-11-22)</a> release
253
+ notes:</p>
254
+ </p>
255
+ <p>
256
+ <blockquote> <p>Internet Explorer 6 and 7 <a href=&#8217;<a
257
+ href="http://www.w3.org/MarkUp/2004/xhtml-faq#ie'>do">www.w3.org/MarkUp/2004/xhtml-faq#ie'>do</a><em>
258
+ not</em> support</a> the application/xhtml+xml mime type, so the output
259
+ generated by the <a class=&#8220;xref&#8221; href=&#8220;<a
260
+ href="http://snk.tuxfamily.org/lib/erbook/#xhtml">snk.tuxfamily.org/lib/erbook/#xhtml</a>&#8220;
261
+ title=&#8220;Chapter 5.1&#8220;>XHTML (web page)</a> format cannot be
262
+ viewed in those browsers.</p> </blockquote> </li> </ul></div> </div><div
263
+ class=&#8220;paragraph&#8221;>
264
+ </p>
265
+ <pre>
266
+ &lt;a name=&quot;New-features&quot;/&gt;
267
+ &lt;p class=&quot;title&quot;&gt;New features&lt;/p&gt;
268
+ &lt;div class=&quot;content&quot;&gt;&lt;ul&gt;
269
+ </pre>
270
+ <p>
271
+ <li> <p>Replace dark background theme with a &amp;8220;wide open
272
+ spaces&amp;8221; theme.</p>
273
+ </p>
274
+ <p>
275
+ <ul> <li> <p>Use icons instead of unicode glyphs for mini navigation
276
+ menus.</p> </li>
277
+ </p>
278
+ <p>
279
+ <li> <p>Put mini navigation menus on right-hand side of headings</p> </li>
280
+ </p>
281
+ <p>
282
+ <li> <p>Use <a href=&#8217;<a
283
+ href="http://demos.flesler.com/jquery/scrollTo/'>scrolling">demos.flesler.com/jquery/scrollTo/'>scrolling</a>
284
+ animation</a> when local links (URI fragments) are visited, instead of
285
+ instantly teleporting to the destination. This gives a sense of spatial
286
+ existence to the web page, making it feel almost tangible!</p> </li> </ul>
287
+ </li>
288
+ </p>
289
+ <p>
290
+ <li> <p>XHTML output is now valid XHTML 1.0 Transitional! And the embedded
291
+ CSS it contains is now valid CSS 3!</p>
292
+ </p>
293
+ <p>
294
+ <ul> <li> <p>Minify CSS in XHTML output using the <a href=&#8217;<a
295
+ href="http://github.com/sprsquish/rainpress/tree/master'>Rainpress">github.com/sprsquish/rainpress/tree/master'>Rainpress</a>
296
+ library</a>.</p> </li>
297
+ </p>
298
+ <p>
299
+ <li> <p>Add CSS style for HTML definition lists.</p> </li> </ul> </li>
300
+ </p>
301
+ <p>
302
+ <li> <p>Omit target type and index (&amp;8220;Section X.Y.Z&amp;8221;) in
303
+ output of <code class=&#8220;line&#8221;>xref()</code> nodes in the
304
+ screen-version (CSS stylesheet) of the generated output document.</p>
305
+ </p>
306
+ <p>
307
+ <p>This information is still present in the print-version (CSS stylesheet)
308
+ of the generated output document, where it is truly helpful to the
309
+ reader.</p> </li>
310
+ </p>
311
+ <p>
312
+ <li> <p>Add &amp;8220;bypass&amp;8221; option to node definitions to
313
+ properly support the generic &amp;8220;node&amp;8221; node. Invalid XHTML
314
+ was being generated because the &amp;8216;node&amp;8217; node was marked as
315
+ simply &amp;8220;inline&amp;8221;, so it was not pulled out of the
316
+ &amp;60;p&amp;62; tag created by Maruku.</p> </li> </ul></div> </div><div
317
+ class=&#8220;paragraph&#8221;>
318
+ </p>
319
+ <pre>
320
+ &lt;a name=&quot;Bug-fixes&quot;/&gt;
321
+ &lt;p class=&quot;title&quot;&gt;Bug fixes&lt;/p&gt;
322
+ &lt;div class=&quot;content&quot;&gt;&lt;ul&gt;
323
+ </pre>
324
+ <p>
325
+ <li> <p>The &amp;8220;silent&amp;8221; property in node definitions was not
326
+ being honored.</p> </li>
327
+ </p>
328
+ <p>
329
+ <li> <p>Fix error when inserting reference nodes (they are not
330
+ inline!).</p> </li>
331
+ </p>
332
+ <p>
333
+ <li> <p>Add workaround for Maruku treating first line of input as parameter
334
+ definition, and thereby omitting it from the output!</p> </li>
335
+ </p>
336
+ <p>
337
+ <li> <p><code class=&#8220;line&#8221;><span
338
+ style=&#8220;color:036;font-weight:bold&#8221;>Array</span><span
339
+ style=&#8220;color:888&#8220;>to_s</span></code> is equivalent to <code
340
+ class=&#8220;line&#8221;><span
341
+ style=&#8220;color:036;font-weight:bold&#8221;>Array</span><span
342
+ style=&#8220;color:888&#8220;>inspect</span></code> in Ruby 1.9.</p> </li>
343
+ </p>
344
+ <p>
345
+ <li> <p><a class=&#8220;xref&#8221; href=&#8220;<a
346
+ href="http://snk.tuxfamily.org/lib/erbook/#HelloWorld.spec">snk.tuxfamily.org/lib/erbook/#HelloWorld.spec</a>&#8220;
347
+ title=&#8220;Example 1&#8221;>HelloWorld format specification file</a>
348
+ added methods to the nonexistent <code class=&#8220;line&#8221;><span
349
+ style=&#8220;color:036;font-weight:bold&#8221;>ERBook</span>::<span
350
+ style=&#8220;color:036;font-weight:bold&#8221;>Node</span></code> class
351
+ instead of adding them to the <code class=&#8220;line&#8221;><span
352
+ style=&#8220;color:036;font-weight:bold&#8221;>ERBook</span>::<span
353
+ style=&#8220;color:036;font-weight:bold&#8221;>Document</span>::<span
354
+ style=&#8220;color:036;font-weight:bold&#8221;>Node</span></code>
355
+ class.</p> </li> </ul></div> </div><div class=&#8220;paragraph&#8221;>
356
+ </p>
357
+ <pre>
358
+ &lt;a name=&quot;Housekeeping&quot;/&gt;
359
+ &lt;p class=&quot;title&quot;&gt;Housekeeping&lt;/p&gt;
360
+ &lt;div class=&quot;content&quot;&gt;&lt;ul&gt;
361
+ </pre>
362
+ <p>
363
+ <li> <p>Simplify language phrases used in mini navigation menus.</p> </li>
364
+ </p>
365
+ <p>
366
+ <li> <p>Remove CSS hacks for supporting IE6; it cannot render XHTML
367
+ anyway.</p> </li>
368
+ </p>
369
+ <p>
370
+ <li> <p>Render italics and boldface equally in serif font. Bold is truly
371
+ <strong>bold</strong> now and italic is <em>distinctive</em>.</p> </li>
372
+ </p>
373
+ <p>
374
+ <li> <p>Adjust spacing between document title, author, and date
375
+ headings.</p> </li>
376
+ </p>
377
+ <p>
378
+ <li> <p>Add copyright notice at the top of every file.</p> </li>
379
+ </ul></div> </div><p> </p></div> </div>
380
+ </p>
381
+
382
+ </div>
383
+
384
+
385
+
386
+
387
+
388
+
389
+
390
+
391
+
392
+
393
+
394
+
395
+
396
+
397
+
398
+
399
+
400
+
401
+
402
+
403
+
404
+ </div>
405
+ </div>
406
+ </body>
407
+ </html>