docgenerator 2.0.0 → 2.1.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 (104) hide show
  1. data/examples/creole_example_tabular.rb +95 -0
  2. data/examples/docgenerator_example.rb +5 -5
  3. data/lib/creole/creole2doc.rb +28 -18
  4. data/lib/creole/creole_inclusions.rb +4 -4
  5. data/lib/creole/creole_placeholder.rb +4 -1
  6. data/lib/creole/creole_tabular.rb +173 -155
  7. data/lib/creole/plugins/rail.rb +118 -119
  8. data/lib/creole/plugins/struktex.rb +35 -35
  9. data/lib/creole/plugins/todonotes.rb +8 -1
  10. data/lib/docgenerator/attribute.rb +160 -160
  11. data/lib/docgenerator/characters.rb +343 -311
  12. data/lib/docgenerator/css.rb +167 -167
  13. data/lib/docgenerator/document.rb +525 -511
  14. data/lib/docgenerator/element.rb +316 -316
  15. data/lib/docgenerator/element_meta.rb +114 -114
  16. data/lib/docgenerator/elements.rb +19 -9
  17. data/lib/docgenerator/environments.rb +3 -1
  18. data/lib/docgenerator/lists.rb +177 -174
  19. data/lib/docgenerator/packages/hyperref.rb +74 -70
  20. data/lib/docgenerator/packages/multicol.rb +33 -0
  21. data/lib/docgenerator/packages/scrlettr2.rb +152 -151
  22. data/lib/docgenerator/packages/todonotes.rb +1 -1
  23. data/lib/docgenerator/tabular.rb +463 -400
  24. data/lib/docgenerator/templates/docgenerator_template.rb +94 -84
  25. data/lib/docgenerator/templates/docgenerator_template.yaml +75 -15
  26. data/lib/docgenerator.rb +1 -1
  27. data/lib/wiki2doc/wiki2docgenerator.rb +1 -1
  28. data/meta_test_and_doc/build__meta.rb +125 -0
  29. data/meta_test_and_doc/build_doc.rb +333 -0
  30. data/meta_test_and_doc/build_test.rb +251 -0
  31. data/meta_test_and_doc/manpages/attachfile.rb +389 -0
  32. data/meta_test_and_doc/manpages/caption.rb +133 -0
  33. data/meta_test_and_doc/manpages/characters.rb +3738 -0
  34. data/meta_test_and_doc/manpages/elements.rb +6851 -0
  35. data/meta_test_and_doc/manpages/environments.rb +985 -0
  36. data/meta_test_and_doc/manpages/footnote.rb +439 -0
  37. data/meta_test_and_doc/manpages/hyperref.rb +605 -0
  38. data/meta_test_and_doc/manpages/listings.rb +988 -0
  39. data/meta_test_and_doc/manpages/lists.rb +1463 -0
  40. data/meta_test_and_doc/manpages/others.rb +129 -0
  41. data/meta_test_and_doc/manpages/packages.rb +13 -0
  42. data/meta_test_and_doc/manpages/pdfpages.rb +108 -0
  43. data/meta_test_and_doc/manpages/readme.rdoc +9 -0
  44. data/meta_test_and_doc/manpages/scrlettr2.rb +362 -0
  45. data/meta_test_and_doc/manpages/scrpage2.rb +2028 -0
  46. data/meta_test_and_doc/manpages/sectioning.rb +2467 -0
  47. data/meta_test_and_doc/manpages/tables.rb +2088 -0
  48. data/meta_test_and_doc/manpages/todonotes.rb +235 -0
  49. data/meta_test_and_doc/manpages/wiki2docgenerator.rb +64 -0
  50. data/{readme.rd → readme.rdoc} +18 -1
  51. data/unittest/expected/test_tabular.creole +33 -0
  52. data/unittest/expected_creole/test_creole_creole1.0test.html +3 -3
  53. data/unittest/expected_creole/test_creole_creole1.0test.latex +3 -3
  54. data/unittest/expected_creole/test_creole_creole1.0test.text +3 -3
  55. data/unittest/expected_creole/test_creole_inline_apostroph.html +6 -0
  56. data/unittest/expected_creole/test_creole_inline_apostroph.latex +8 -0
  57. data/unittest/expected_creole/test_creole_inline_apostroph.text +4 -0
  58. data/unittest/expected_creole/test_creole_input.normsource +12 -12
  59. data/unittest/expected_creole/test_creole_input.normsource_1.8 +23 -0
  60. data/unittest/expected_creole/test_creole_links_external_implicit.html +2 -2
  61. data/unittest/expected_creole/test_creole_links_external_implicit.latex +2 -2
  62. data/unittest/expected_creole/test_creole_links_external_implicit.text +2 -2
  63. data/unittest/expected_creole/test_creole_links_implicit_end.html +1 -1
  64. data/unittest/expected_creole/test_creole_links_implicit_end.latex +1 -1
  65. data/unittest/expected_creole/test_creole_list_ul.normsource +42 -42
  66. data/unittest/expected_creole/test_creole_list_ul.normsource_1.8 +83 -0
  67. data/unittest/expected_creole/test_creole_paragraphs.normsource +15 -15
  68. data/unittest/expected_creole/test_creole_paragraphs.normsource_1.8 +27 -0
  69. data/unittest/expected_creole/test_creole_tabular.creole +22 -0
  70. data/unittest/expected_creole/test_creole_tabular_creole.creole +19 -0
  71. data/unittest/expected_creole/test_creole_tabular_css.creole +24 -0
  72. data/unittest/expected_creole/test_creole_tabular_multicols.creole +16 -0
  73. data/unittest/expected_creole/test_creole_tabular_multicols.html +14 -0
  74. data/unittest/expected_creole/test_creole_tabular_multicols.latex +16 -0
  75. data/unittest/expected_creole/test_creole_tabular_with_cell_option.creole +21 -0
  76. data/unittest/expected_creole/test_creole_toc_level_text.html +2 -2
  77. data/unittest/expected_creole/test_creole_toc_level_text.latex +2 -2
  78. data/unittest/expected_packages/test_multicol_3.tex +2 -0
  79. data/unittest/expected_packages/test_multicol_3_titleline.tex +2 -0
  80. data/unittest/expected_templates/test_article.tex +23 -0
  81. data/unittest/expected_templates/test_article_utf8.tex +34 -0
  82. data/unittest/expected_templates/test_context.miv +18 -0
  83. data/unittest/expected_templates/test_creole.creole +8 -0
  84. data/unittest/expected_templates/test_html.html +12 -0
  85. data/unittest/expected_templates/test_html401_strict.html +14 -0
  86. data/unittest/expected_templates/test_html401_trans.html +14 -0
  87. data/unittest/expected_templates/test_html_utf8.html +14 -0
  88. data/unittest/expected_templates/test_include.tex +17 -0
  89. data/unittest/expected_templates/test_include_utf8.tex +17 -0
  90. data/unittest/expected_templates/test_text.txt +6 -0
  91. data/unittest/expected_templates/test_wiki.wiki +6 -0
  92. data/unittest/expected_templates/test_xhtml_strict.html +14 -0
  93. data/unittest/expected_templates/test_xhtml_trans.html +14 -0
  94. data/unittest/unittest_creole.rb +27 -6
  95. data/unittest/unittest_creole_placeholders.rb +1 -123
  96. data/unittest/unittest_creole_tabular.rb +174 -0
  97. data/unittest/unittest_docgenerator.rb +4 -3
  98. data/unittest/unittest_docgenerator_characters.rb +4769 -615
  99. data/unittest/unittest_packages_multicol.rb +84 -0
  100. data/unittest/unittest_rubycode4doc.rb +0 -1
  101. data/unittest/unittest_templates.rb +64 -0
  102. metadata +163 -77
  103. data/build_test_and_doc.rb +0 -505
  104. data/manpage_elements.rb +0 -10411
@@ -0,0 +1,439 @@
1
+ #encoding utf-8
2
+ =begin rdoc
3
+ Generated manpages for elements.
4
+
5
+ This document does not contain the implementation or code documentation.
6
+
7
+ This document is the source for a manpage for usage of Docgenerator elements.
8
+
9
+ The following Element are documented in this document:
10
+
11
+ * Docgenerator::Elements::Footnotesize
12
+ * Docgenerator::Footnote
13
+ * Docgenerator::Footnotemark
14
+ =end
15
+
16
+ #
17
+ module Docgenerator
18
+ module Elements
19
+ =begin rdoc
20
+ =Docgenerator::Elements::Footnotesize
21
+
22
+ Docgenerator::Elements::Footnotesize does not contain attributes
23
+
24
+
25
+ Docgenerator::Elements::Footnotesize can contain content.
26
+
27
+ ==Generate an object
28
+ test = Docgenerator::Elements::Footnotesize.new( {}, 'content')
29
+
30
+ Alternative generation
31
+ test = element(:footnotesize, {}, 'content' )
32
+
33
+
34
+ ==Outputs
35
+ ===Docgenerator::Elements::Footnotesize#to_latex
36
+ {\footnotesize content}
37
+
38
+ ====:cr, :cR, :Cr, :CR for Docgenerator::Elements::Footnotesize#.to_latex
39
+ <<START>> and <<END>> are not part of the output, but needed to illustrate the line breaks.
40
+
41
+ Default:
42
+ <<START>>{\footnotesize content}<<END>>
43
+
44
+ * Result after Docgenerator::Elements::Footnotesize#cr:
45
+
46
+ <<START>>{\footnotesize content}
47
+ <<END>>
48
+
49
+ * Result after Docgenerator::Elements::Footnotesize#cR:
50
+
51
+ <<START>>{\footnotesize content}
52
+ <<END>>
53
+
54
+ * Result after Docgenerator::Elements::Footnotesize#Cr:
55
+
56
+ <<START>>
57
+ {\footnotesize content}
58
+ <<END>>
59
+
60
+ * Result after Docgenerator::Elements::Footnotesize#CR:
61
+
62
+ <<START>>
63
+ {\footnotesize content}
64
+ <<END>>
65
+
66
+ ===Docgenerator::Elements::Footnotesize#to_html
67
+ <span style="font-size:x-small">content</span>
68
+
69
+ ====:cr, :cR, :Cr, :CR for Docgenerator::Elements::Footnotesize#.to_html
70
+ <<START>> and <<END>> are not part of the output, but needed to illustrate the line breaks.
71
+
72
+ Default:
73
+ <<START>><span style="font-size:x-small">content</span><<END>>
74
+
75
+ * Docgenerator::Elements::Footnotesize#cr has no effect, same result as default
76
+ * Docgenerator::Elements::Footnotesize#cR has no effect, same result as default
77
+ * Docgenerator::Elements::Footnotesize#Cr has no effect, same result as default
78
+ * Docgenerator::Elements::Footnotesize#CR has no effect, same result as default
79
+ ===Docgenerator::Elements::Footnotesize#to_context
80
+ \footnotesize{content}
81
+
82
+ * No output routine defined for context - use a dummy
83
+ ===Docgenerator::Elements::Footnotesize#to_text
84
+ content
85
+
86
+ * No output routine defined for text - use a dummy
87
+ ===Docgenerator::Elements::Footnotesize#to_wiki
88
+ content
89
+
90
+
91
+ * No output routine defined for wiki - use a dummy
92
+ ===Docgenerator::Elements::Footnotesize#to_creole
93
+ content
94
+
95
+
96
+ * No output routine defined for creole - use a dummy
97
+ =end
98
+ class Footnotesize << Docgenerator::Element
99
+ #This coding is empty - this is the manpage definition, not the implementation
100
+ end #class Footnotesize
101
+ end #module Elements
102
+ end #module Docgenerator
103
+ module Docgenerator
104
+ =begin rdoc
105
+ =Docgenerator::Footnote
106
+
107
+ ==Attributes
108
+ Attribute required? HTML LaTeX ~keyval ConTeXt Text Wiki Creole Values
109
+ ====================================================================================================
110
+ lang : - X - - - - - -
111
+ id : - X - - - - - -
112
+ class : - X - - - - - -
113
+ style : - X - - - - - -
114
+ title : - X - - - - - -
115
+ dir : - X - - - - - -
116
+ onclick : - X - - - - - -
117
+ ondblclick : - X - - - - - -
118
+ onmousedown : - X - - - - - -
119
+ onmouseup : - X - - - - - -
120
+ onmouseover : - X - - - - - -
121
+ onmousemove : - X - - - - - -
122
+ onmouseout : - X - - - - - -
123
+ onkeypress : - X - - - - - -
124
+ onkeyup : - X - - - - - -
125
+ onkeydown : - X - - - - - -
126
+ label : - - - - - - - -
127
+ group : X - - - - - - -
128
+
129
+
130
+ Docgenerator::Footnote can contain content.
131
+
132
+ ==Generate an object
133
+ test = Docgenerator::Footnote.new( {
134
+ #:lang => <<value>>, % optional, values: ["en", "de"]
135
+ #:id => <<value>>, % optional
136
+ #:class => <<value>>, % optional
137
+ #:style => <<value>>, % optional, values: [Docgenerator::CSS, String]
138
+ #:title => <<value>>, % optional
139
+ #:dir => <<value>>, % optional, values: ["ltr", "rtl"]
140
+ #:onclick => <<value>>, % optional
141
+ #:ondblclick => <<value>>, % optional
142
+ #:onmousedown => <<value>>, % optional
143
+ #:onmouseup => <<value>>, % optional
144
+ #:onmouseover => <<value>>, % optional
145
+ #:onmousemove => <<value>>, % optional
146
+ #:onmouseout => <<value>>, % optional
147
+ #:onkeypress => <<value>>, % optional
148
+ #:onkeyup => <<value>>, % optional
149
+ #:onkeydown => <<value>>, % optional
150
+ #:label => <<value>>, % optional
151
+ :group => <<value>>, % required, values: [Docgenerator::Footnotegroup]
152
+ }, 'content')
153
+
154
+ Alternative generation
155
+ test = element(:footnote, {...Attributes...}, 'content' )
156
+
157
+
158
+ ==Outputs
159
+ ===Docgenerator::Footnote#to_latex
160
+ \footnote{content}
161
+
162
+ ====:cr, :cR, :Cr, :CR for Docgenerator::Footnote#.to_latex
163
+ <<START>> and <<END>> are not part of the output, but needed to illustrate the line breaks.
164
+
165
+ Default:
166
+ <<START>>\footnote{content}<<END>>
167
+
168
+ * Result after Docgenerator::Footnote#cr:
169
+
170
+ <<START>>\footnote{content}
171
+ <<END>>
172
+
173
+ * Result after Docgenerator::Footnote#cR:
174
+
175
+ <<START>>\footnote{content}
176
+ <<END>>
177
+
178
+ * Result after Docgenerator::Footnote#Cr:
179
+
180
+ <<START>>
181
+ \footnote{content}
182
+ <<END>>
183
+
184
+ * Result after Docgenerator::Footnote#CR:
185
+
186
+ <<START>>
187
+ \footnote{content}
188
+ <<END>>
189
+
190
+ ===Docgenerator::Footnote#to_html
191
+ <sup><a href="#footnote-1">1</a></sup>
192
+
193
+ ====:cr, :cR, :Cr, :CR for Docgenerator::Footnote#.to_html
194
+ <<START>> and <<END>> are not part of the output, but needed to illustrate the line breaks.
195
+
196
+ Default:
197
+ <<START>><sup><a href="#footnote-1">1</a></sup><<END>>
198
+
199
+ * Result after Docgenerator::Footnote#cr:
200
+
201
+ <<START>><sup><a href="#footnote-1">1</a></sup>
202
+ <<END>>
203
+
204
+ * Result after Docgenerator::Footnote#cR:
205
+
206
+ <<START>><sup><a href="#footnote-1">1</a></sup>
207
+ <<END>>
208
+
209
+ * Result after Docgenerator::Footnote#Cr:
210
+
211
+ <<START>>
212
+ <sup><a href="#footnote-1">1</a></sup>
213
+ <<END>>
214
+
215
+ * Result after Docgenerator::Footnote#CR:
216
+
217
+ <<START>>
218
+ <sup><a href="#footnote-1">1</a></sup>
219
+ <<END>>
220
+
221
+ ===Docgenerator::Footnote#to_context
222
+ \footnote{content}
223
+
224
+ * No output routine defined for context - use a dummy
225
+ ===Docgenerator::Footnote#to_text
226
+ (1)
227
+
228
+ ====:cr, :cR, :Cr, :CR for Docgenerator::Footnote#.to_text
229
+ <<START>> and <<END>> are not part of the output, but needed to illustrate the line breaks.
230
+
231
+ Default:
232
+ <<START>>(1)<<END>>
233
+
234
+ * Result after Docgenerator::Footnote#cr:
235
+
236
+ <<START>>(1)
237
+ <<END>>
238
+
239
+ * Result after Docgenerator::Footnote#cR:
240
+
241
+ <<START>>(1)
242
+ <<END>>
243
+
244
+ * Result after Docgenerator::Footnote#Cr:
245
+
246
+ <<START>>
247
+ (1)
248
+ <<END>>
249
+
250
+ * Result after Docgenerator::Footnote#CR:
251
+
252
+ <<START>>
253
+ (1)
254
+ <<END>>
255
+
256
+ ===Docgenerator::Footnote#to_wiki
257
+ (1)
258
+
259
+ ====:cr, :cR, :Cr, :CR for Docgenerator::Footnote#.to_wiki
260
+ <<START>> and <<END>> are not part of the output, but needed to illustrate the line breaks.
261
+
262
+ Default:
263
+ <<START>>(1)<<END>>
264
+
265
+ * Result after Docgenerator::Footnote#cr:
266
+
267
+ <<START>>(1)
268
+ <<END>>
269
+
270
+ * Result after Docgenerator::Footnote#cR:
271
+
272
+ <<START>>(1)
273
+ <<END>>
274
+
275
+ * Result after Docgenerator::Footnote#Cr:
276
+
277
+ <<START>>
278
+ (1)
279
+ <<END>>
280
+
281
+ * Result after Docgenerator::Footnote#CR:
282
+
283
+ <<START>>
284
+ (1)
285
+ <<END>>
286
+
287
+ ===Docgenerator::Footnote#to_creole
288
+ content
289
+
290
+
291
+ * No output routine defined for creole - use a dummy
292
+ =end
293
+ class Footnote << Docgenerator::Element
294
+ #This coding is empty - this is the manpage definition, not the implementation
295
+ end #class Footnote
296
+ end #module Docgenerator
297
+ module Docgenerator
298
+ =begin rdoc
299
+ =Docgenerator::Footnotemark
300
+
301
+ ==Attributes
302
+ Attribute required? HTML LaTeX ~keyval ConTeXt Text Wiki Creole Values
303
+ ====================================================================================================
304
+ lang : - X - - - - - -
305
+ id : - X - - - - - -
306
+ class : - X - - - - - -
307
+ style : - X - - - - - -
308
+ title : - X - - - - - -
309
+ dir : - X - - - - - -
310
+ onclick : - X - - - - - -
311
+ ondblclick : - X - - - - - -
312
+ onmousedown : - X - - - - - -
313
+ onmouseup : - X - - - - - -
314
+ onmouseover : - X - - - - - -
315
+ onmousemove : - X - - - - - -
316
+ onmouseout : - X - - - - - -
317
+ onkeypress : - X - - - - - -
318
+ onkeyup : - X - - - - - -
319
+ onkeydown : - X - - - - - -
320
+
321
+
322
+ Docgenerator::Footnotemark can contain content.
323
+
324
+ ==Generate an object
325
+ test = Docgenerator::Footnotemark.new( {
326
+ #:lang => <<value>>, % optional, values: ["en", "de"]
327
+ #:id => <<value>>, % optional
328
+ #:class => <<value>>, % optional
329
+ #:style => <<value>>, % optional, values: [Docgenerator::CSS, String]
330
+ #:title => <<value>>, % optional
331
+ #:dir => <<value>>, % optional, values: ["ltr", "rtl"]
332
+ #:onclick => <<value>>, % optional
333
+ #:ondblclick => <<value>>, % optional
334
+ #:onmousedown => <<value>>, % optional
335
+ #:onmouseup => <<value>>, % optional
336
+ #:onmouseover => <<value>>, % optional
337
+ #:onmousemove => <<value>>, % optional
338
+ #:onmouseout => <<value>>, % optional
339
+ #:onkeypress => <<value>>, % optional
340
+ #:onkeyup => <<value>>, % optional
341
+ #:onkeydown => <<value>>, % optional
342
+ }, 'content')
343
+
344
+ Alternative generation
345
+ test = element(:footnotemark, {...Attributes...}, 'content' )
346
+
347
+
348
+ ==Outputs
349
+ ===Docgenerator::Footnotemark#to_latex
350
+ \footnotemark[content]
351
+
352
+ ====:cr, :cR, :Cr, :CR for Docgenerator::Footnotemark#.to_latex
353
+ <<START>> and <<END>> are not part of the output, but needed to illustrate the line breaks.
354
+
355
+ Default:
356
+ <<START>>\footnotemark[content]<<END>>
357
+
358
+ * Result after Docgenerator::Footnotemark#cr:
359
+
360
+ <<START>>\footnotemark[content]
361
+ <<END>>
362
+
363
+ * Result after Docgenerator::Footnotemark#cR:
364
+
365
+ <<START>>\footnotemark[content]
366
+ <<END>>
367
+
368
+ * Result after Docgenerator::Footnotemark#Cr:
369
+
370
+ <<START>>
371
+ \footnotemark[content]
372
+ <<END>>
373
+
374
+ * Result after Docgenerator::Footnotemark#CR:
375
+
376
+ <<START>>
377
+ \footnotemark[content]
378
+ <<END>>
379
+
380
+ ===Docgenerator::Footnotemark#to_html
381
+ <sup >content</sup>
382
+
383
+ ====:cr, :cR, :Cr, :CR for Docgenerator::Footnotemark#.to_html
384
+ <<START>> and <<END>> are not part of the output, but needed to illustrate the line breaks.
385
+
386
+ Default:
387
+ <<START>><sup >content</sup><<END>>
388
+
389
+ * Result after Docgenerator::Footnotemark#cr:
390
+
391
+ <<START>><sup >content</sup>
392
+ <<END>>
393
+
394
+ * Result after Docgenerator::Footnotemark#cR:
395
+
396
+ <<START>><sup >
397
+ content
398
+ </sup>
399
+ <<END>>
400
+
401
+ * Result after Docgenerator::Footnotemark#Cr:
402
+
403
+ <<START>>
404
+ <sup >
405
+ content
406
+ </sup>
407
+ <<END>>
408
+
409
+ * Result after Docgenerator::Footnotemark#CR:
410
+
411
+ <<START>>
412
+ <sup >
413
+ content
414
+ </sup>
415
+ <<END>>
416
+
417
+ ===Docgenerator::Footnotemark#to_context
418
+ \footnotemark{content}
419
+
420
+ * No output routine defined for context - use a dummy
421
+ ===Docgenerator::Footnotemark#to_text
422
+ content
423
+
424
+ * No output routine defined for text - use a dummy
425
+ ===Docgenerator::Footnotemark#to_wiki
426
+ content
427
+
428
+
429
+ * No output routine defined for wiki - use a dummy
430
+ ===Docgenerator::Footnotemark#to_creole
431
+ content
432
+
433
+
434
+ * No output routine defined for creole - use a dummy
435
+ =end
436
+ class Footnotemark << Docgenerator::Element
437
+ #This coding is empty - this is the manpage definition, not the implementation
438
+ end #class Footnotemark
439
+ end #module Docgenerator