erbook 6.1.0 → 7.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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>