Module: Asciidoctor::Standoc::Blocks
- Included in:
- Converter
- Defined in:
- lib/asciidoctor/standoc/reqt.rb,
lib/asciidoctor/standoc/blocks.rb
Instance Method Summary collapse
- #admonition(node) ⇒ Object
- #admonition_attrs(node) ⇒ Object
- #example(node) ⇒ Object
- #example_attrs(node) ⇒ Object
- #example_proper(node) ⇒ Object
- #figure_attrs(node) ⇒ Object
- #figure_title(node, f) ⇒ Object
- #formula_attr(node) ⇒ Object
- #id_attr(node = nil) ⇒ Object
- #id_unnum_attr(node) ⇒ Object
- #image(node) ⇒ Object
-
#listing(node) ⇒ Object
NOTE: html escaping is performed by Nokogiri.
- #listing_attrs(node) ⇒ Object
- #literal(node) ⇒ Object
- #literal_attrs(node) ⇒ Object
- #note(n) ⇒ Object
-
#open(node) ⇒ Object
We append each contained block to its parent.
- #para_attrs(node) ⇒ Object
- #paragraph(node) ⇒ Object
- #pass(node) ⇒ Object
- #pseudocode_example(node) ⇒ Object
- #quote(node) ⇒ Object
- #quote_attribution(node, out) ⇒ Object
- #quote_attrs(node) ⇒ Object
- #req_classif_parse(classif) ⇒ Object
- #reqt_attributes(node) ⇒ Object
- #requirement(node, obligation) ⇒ Object
- #requirement_classification(classif, ex) ⇒ Object
- #requirement_subpart(node) ⇒ Object
- #sidebar(node) ⇒ Object
- #sidebar_attrs(node) ⇒ Object
-
#stem(node) ⇒ Object
NOTE: html escaping is performed by Nokogiri.
- #term_example(node) ⇒ Object
- #termnote(n) ⇒ Object
- #todo(node) ⇒ Object
- #todo_attrs(node) ⇒ Object
Instance Method Details
#admonition(node) ⇒ Object
118 119 120 121 122 123 124 125 126 127 128 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 118 def admonition(node) return termnote(node) if in_terms? return note(node) if node.attr("name") == "note" return todo(node) if node.attr("name") == "todo" noko do |xml| xml.admonition **admonition_attrs(node) do |a| node.title.nil? or a.name { |name| name << node.title } wrap_in_para(node, a) end end.join("\n") end |
#admonition_attrs(node) ⇒ Object
108 109 110 111 112 113 114 115 116 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 108 def admonition_attrs(node) name = node.attr("name") if type = node.attr("type") ["danger", "safety precautions"].each do |t| name = t if type.casecmp(t).zero? end end attr_code(id: Utils::anchor_or_uuid(node), type: name) end |
#example(node) ⇒ Object
138 139 140 141 142 143 144 145 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 138 def example(node) return term_example(node) if in_terms? role = node.role || node.attr("style") %w(recommendation requirement permission).include?(role) and return requirement(node, role) return pseudocode_example(node) if role == "pseudocode" example_proper(node) end |
#example_attrs(node) ⇒ Object
157 158 159 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 157 def example_attrs(node) attr_code(id_unnum_attr(node)) end |
#example_proper(node) ⇒ Object
161 162 163 164 165 166 167 168 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 161 def example_proper(node) noko do |xml| xml.example **example_attrs(node) do |ex| node.title.nil? or ex.name { |name| name << node.title } wrap_in_para(node, ex) end end.join("\n") end |
#figure_attrs(node) ⇒ Object
175 176 177 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 175 def figure_attrs(node) attr_code(id_unnum_attr(node)) end |
#figure_title(node, f) ⇒ Object
170 171 172 173 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 170 def figure_title(node, f) return if node.title.nil? f.name { |name| name << node.title } end |
#formula_attr(node) ⇒ Object
17 18 19 20 21 22 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 17 def formula_attr(node) attr_code( id: Utils::anchor_or_uuid(node), inequality: node.option?("inequality") ? "true" : nil, unnumbered: node.option?("unnumbered") ? "true" : nil, subsequence: node.attr("subsequence") ) end |
#id_attr(node = nil) ⇒ Object
7 8 9 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 7 def id_attr(node = nil) { id: Utils::anchor_or_uuid(node) } end |
#id_unnum_attr(node) ⇒ Object
11 12 13 14 15 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 11 def id_unnum_attr(node) attr_code( id: Utils::anchor_or_uuid(node), unnumbered: node.option?("unnumbered") ? "true" : nil, subsequence: node.attr("subsequence") ) end |
#image(node) ⇒ Object
179 180 181 182 183 184 185 186 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 179 def image(node) noko do |xml| xml.figure **figure_attrs(node) do |f| figure_title(node, f) f.image **(image_attributes(node)) end end end |
#listing(node) ⇒ Object
NOTE: html escaping is performed by Nokogiri
234 235 236 237 238 239 240 241 242 243 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 234 def listing(node) fragment = ::Nokogiri::XML::Builder.new do |xml| xml.sourcecode **(listing_attrs(node)) do |s| figure_title(node, s) s << node.content end end fragment.to_xml(encoding: "US-ASCII", save_with: Nokogiri::XML::Node::SaveOptions::NO_DECLARATION) end |
#listing_attrs(node) ⇒ Object
226 227 228 229 230 231 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 226 def listing_attrs(node) attr_code(lang: node.attr("language"), id: Utils::anchor_or_uuid(node), unnumbered: node.option?("unnumbered") ? "true" : nil, filename: node.attr("filename")) end |
#literal(node) ⇒ Object
40 41 42 43 44 45 46 47 48 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 40 def literal(node) noko do |xml| xml.figure **literal_attrs(node) do |f| figure_title(node, f) f.pre node.lines.join("\n"), **attr_code(id: Utils::anchor_or_uuid, alt: node.attr("alt")) end end end |
#literal_attrs(node) ⇒ Object
36 37 38 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 36 def literal_attrs(node) attr_code(id_attr(node)) end |
#note(n) ⇒ Object
100 101 102 103 104 105 106 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 100 def note(n) noko do |xml| xml.note **id_attr(n) do |c| wrap_in_para(n, c) end end.join("\n") end |
#open(node) ⇒ Object
We append each contained block to its parent
25 26 27 28 29 30 31 32 33 34 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 25 def open(node) role = node.role || node.attr("style") Utils::reqt_subpart(role) and return requirement_subpart(node) result = [] node.blocks.each do |b| result << send(b.context, b) end result end |
#para_attrs(node) ⇒ Object
188 189 190 191 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 188 def para_attrs(node) attr_code(align: node.attr("align"), id: Utils::anchor_or_uuid(node)) end |
#paragraph(node) ⇒ Object
193 194 195 196 197 198 199 200 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 193 def paragraph(node) return termsource(node) if node.role == "source" noko do |xml| xml.p **para_attrs(node) do |xml_t| xml_t << node.content end end.join("\n") end |
#pass(node) ⇒ Object
245 246 247 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 245 def pass(node) node.content end |
#pseudocode_example(node) ⇒ Object
147 148 149 150 151 152 153 154 155 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 147 def pseudocode_example(node) noko do |xml| xml.figure **{id: Asciidoctor::Standoc::Utils::anchor_or_uuid(node), class: "pseudocode"} do |ex| figure_title(node, ex) wrap_in_para(node, ex) end end.join("\n") end |
#quote(node) ⇒ Object
217 218 219 220 221 222 223 224 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 217 def quote(node) noko do |xml| xml.quote **(quote_attrs(node)) do |q| quote_attribution(node, q) wrap_in_para(node, q) end end.join("\n") end |
#quote_attribution(node, out) ⇒ Object
206 207 208 209 210 211 212 213 214 215 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 206 def quote_attribution(node, out) if node.attr("citetitle") m = /^(?<cite>[^,]+)(,(?<text>.*$))?$/m.match node.attr("citetitle") out.source m[:text], **attr_code(target: m[:cite], type: "inline") end if node.attr("attribution") out. { |a| a << node.attr("attribution") } end end |
#quote_attrs(node) ⇒ Object
202 203 204 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 202 def quote_attrs(node) attr_code(id: Utils::anchor_or_uuid(node), align: node.attr("align")) end |
#req_classif_parse(classif) ⇒ Object
19 20 21 22 23 24 25 26 27 |
# File 'lib/asciidoctor/standoc/reqt.rb', line 19 def req_classif_parse(classif) ret = [] classif.split(/;\s*/).each do |c| c1 = c.split(/:\s*/) next unless c1.size == 2 c1[1].split(/,\s*/).each { |v| ret << [ c1[0], v ] } end ret end |
#reqt_attributes(node) ⇒ Object
38 39 40 41 42 43 44 45 46 47 48 |
# File 'lib/asciidoctor/standoc/reqt.rb', line 38 def reqt_attributes(node) { id: Utils::anchor_or_uuid, unnumbered: node.option?("unnumbered") ? "true" : nil, subsequence: node.attr("subsequence"), obligation: node.attr("obligation"), filename: node.attr("filename"), type: node.attr("type"), model: node.attr("model"), } end |
#requirement(node, obligation) ⇒ Object
50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 |
# File 'lib/asciidoctor/standoc/reqt.rb', line 50 def requirement(node, obligation) classif = node.attr("classification") noko do |xml| xml.send obligation, **attr_code(reqt_attributes(node)) do |ex| ex.title node.title if node.title ex.label node.attr("label") if node.attr("label") ex.subject node.attr("subject") if node.attr("subject") node&.attr("inherit")&.split(/;\s*/)&.each do |i| ex.inherit i end requirement_classification(classif, ex) if classif wrap_in_para(node, ex) end end.join("\n") end |
#requirement_classification(classif, ex) ⇒ Object
29 30 31 32 33 34 35 36 |
# File 'lib/asciidoctor/standoc/reqt.rb', line 29 def requirement_classification(classif, ex) req_classif_parse(classif).each do |r| ex.classification do |c| c.tag r[0] c.value r[1] end end end |
#requirement_subpart(node) ⇒ Object
9 10 11 12 13 14 15 16 17 |
# File 'lib/asciidoctor/standoc/reqt.rb', line 9 def requirement_subpart(node) name = node.role || node.attr("style") noko do |xml| xml.send name, **attr_code(exclude: node.option?("exclude"), type: node.attr("type")) do |o| o << node.content end end end |
#sidebar(node) ⇒ Object
66 67 68 69 70 71 72 73 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 66 def (node) return unless draft? noko do |xml| xml.review **((node)) do |r| wrap_in_para(node, r) end end end |
#sidebar_attrs(node) ⇒ Object
60 61 62 63 64 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 60 def (node) todo_attrs(node).merge(attr_code( from: node.attr("from"), to: node.attr("to") || node.attr("from") )) end |
#stem(node) ⇒ Object
NOTE: html escaping is performed by Nokogiri
51 52 53 54 55 56 57 58 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 51 def stem(node) stem_content = node.lines.join("\n") noko do |xml| xml.formula **formula_attr(node) do |s| stem_parse(stem_content, s, node.style.to_sym) end end end |
#term_example(node) ⇒ Object
130 131 132 133 134 135 136 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 130 def term_example(node) noko do |xml| xml.termexample **id_attr(node) do |ex| wrap_in_para(node, ex) end end.join("\n") end |
#termnote(n) ⇒ Object
92 93 94 95 96 97 98 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 92 def termnote(n) noko do |xml| xml.termnote **id_attr(n) do |ex| wrap_in_para(n, ex) end end.join("\n") end |
#todo(node) ⇒ Object
84 85 86 87 88 89 90 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 84 def todo(node) noko do |xml| xml.review **(todo_attrs(node)) do |r| wrap_in_para(node, r) end end end |
#todo_attrs(node) ⇒ Object
75 76 77 78 79 80 81 82 |
# File 'lib/asciidoctor/standoc/blocks.rb', line 75 def todo_attrs(node) date = node.attr("date") || Date.today.iso8601.gsub(/\+.*$/, "") date += "T00:00:00Z" unless /T/.match date attr_code( id: Utils::anchor_or_uuid(node), reviewer: node.attr("reviewer") || node.attr("source") || "(Unknown)", date: date ) end |