docgenerator 2.0.0 → 2.1.0

Sign up to get free protection for your applications and to get access to all the features.
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