isodoc 2.12.1 → 2.12.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1936cca0c61f789903af805b809d73c8dbae298e4bc6569c533274dbf5d8eac5
-  data.tar.gz: 3bc62ddb747526969bf2c36d10ffab8e0b0008e827ee7b6634f566c925d5db8c
+  metadata.gz: 4eb3b494f63d18c01a41db1113867423729b62912dc89c002bccf7bd5b5e10e9
+  data.tar.gz: 665fa84ece67866381fa3c71c41a04e57f231de95143fee235f157ffbe61daf8
 SHA512:
-  metadata.gz: a3f526f015973c666f70749ee97708d992c455d9d0d8273cb8389f73090a9926f66cdb616d1d2b13f2737ab53248103674cf34bec46ab5cff42f3bd678bb43b9
-  data.tar.gz: cf3c0a4afbc963c4ab579bf36ab252030f882f794b8b27e734b58f8e8d4c99a6e9b40b283e8dd1d089cb1b9d16aeb9d47e3040cbfb84014e2f60a1a4150b4c15
+  metadata.gz: f1837352724ea2d81646db5a1f499f19ec1f6c84eace5906cd7ae795e6be9fa156e6de43bfa7ecef4ecc4149e7ec4c30c052e64687b1d5f3d8b2ef1b0dfa292e
+  data.tar.gz: 5996acc46b47b24285d1d696d203a16255a69e67a8c25690213afa41d7fe65b02464e26e4db6516b5b3edf020a5222fc342691f0c13b1861d4a436390ea93655

data/isodoc.gemspec

@@ -37,7 +37,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency "mn2pdf", ">= 2.08"
   spec.add_dependency "mn-requirements", "~> 0.4.0"
 
-  spec.add_dependency "relaton-render", "~> 0.7.1"
+  spec.add_dependency "relaton-render", "~> 0.8.0"
   spec.add_dependency "roman-numerals"
   spec.add_dependency "rouge", "~> 4.0"
   spec.add_dependency "thread_safe"

data/lib/isodoc/convert.rb

@@ -115,31 +115,10 @@ module IsoDoc
       metadata_init(@lang, @script, @locale, @i18n)
       xref_init(@lang, @script, self, @i18n,
                 { locale: @locale, bibrender: @bibrender })
-      docxml = preprocess_xslt(docxml)
       toc_init(docxml)
       [docxml, filename, dir]
     end
 
-    def preprocess_xslt(docxml)
-      sheets = extract_preprocess_xslt(docxml)
-      sheets.each do |x|
-        docxml = Nokogiri::XSLT(x).transform(docxml)
-      end
-      docxml
-    rescue ::Error => e
-      require "debug"
-      binding.b
-    end
-
-    def extract_preprocess_xslt(docxml)
-      docxml.xpath(ns("//metanorma-extension/render/preprocess-xslt"))
-        .each_with_object([]) do |x, m|
-          formats = x["format"]&.split(",") || []
-          !formats.empty? && !formats.include?(@format.to_s) and next
-          m << x.children.to_xml
-        end
-    end
-
     def convert_i18n_init(docxml)
       convert_i18n_init1(docxml)
       i18n_init(@lang, @script, @locale)

data/lib/isodoc/function/blocks.rb

@@ -25,9 +25,9 @@ module IsoDoc
       def figure_parse1(node, out)
         out.div **figure_attrs(node) do |div|
           node.children.each do |n|
-            parse(n, div) unless n.name == "name"
+            parse(n, div) unless n.name == "fmt-name"
           end
-          figure_name_parse(node, div, node.at(ns("./name")))
+          figure_name_parse(node, div, node.at(ns("./fmt-name")))
         end
       end
 
@@ -37,9 +37,9 @@ module IsoDoc
 
       def pseudocode_parse(node, out)
         @in_figure = true
-        name = node.at(ns("./name"))
+        name = node.at(ns("./fmt-name"))
         out.div **pseudocode_attrs(node) do |div|
-          node.children.each { |n| parse(n, div) unless n.name == "name" }
+          node.children.each { |n| parse(n, div) unless n.name == "fmt-name" }
           sourcecode_name_parse(node, div, name)
         end
         @in_figure = false
@@ -57,7 +57,7 @@ module IsoDoc
       end
 
       def sourcecode_parse(node, out)
-        name = node.at(ns("./name"))
+        name = node.at(ns("./fmt-name"))
         out.p **sourcecode_attrs(node) do |div|
           sourcecode_parse1(node, div)
         end
@@ -71,7 +71,7 @@ module IsoDoc
           node.at("./ancestor::xmlns:table[@class = 'rouge-line-table']") and
           @sourcecode = "table"
         node.children.each do |n|
-          %w(name dl).include?(n.name) and next
+          %w(fmt-name dl).include?(n.name) and next
           parse(n, div)
         end
         @sourcecode = false
@@ -93,7 +93,7 @@ module IsoDoc
         out.div **attr_code(class: "formula") do |div|
           div.p do |_p|
             parse(node.at(ns("./stem")), div)
-            if lbl = node&.at(ns("./name"))&.text
+            if lbl = node&.at(ns("./fmt-name"))&.text
               insert_tab(div, 1)
               div << lbl
             end
@@ -109,7 +109,7 @@ module IsoDoc
         out.div **formula_attrs(node) do |div|
           formula_parse1(node, div)
           node.children.each do |n|
-            %w(stem name).include? n.name and next
+            %w(stem fmt-name).include? n.name and next
             parse(n, div)
           end
         end

data/lib/isodoc/function/blocks_example_note.rb

@@ -19,9 +19,9 @@ module IsoDoc
       # used if we are boxing examples
       def example_div_parse(node, out)
         out.div **example_div_attr(node) do |div|
-          example_label(node, div, node.at(ns("./name")))
+          example_label(node, div, node.at(ns("./fmt-name")))
           node.children.each do |n|
-            parse(n, div) unless n.name == "name"
+            parse(n, div) unless n.name == "fmt-name"
           end
         end
       end
@@ -39,10 +39,12 @@ module IsoDoc
         out.table **example_table_attr(node) do |t|
           t.tr do |tr|
             tr.td **EXAMPLE_TBL_ATTR do |td|
-              example_label(node, td, node.at(ns("./name")))
+              example_label(node, td, node.at(ns("./fmt-name")))
             end
             tr.td **EXAMPLE_TD_ATTR do |td|
-              node.children.each { |n| parse(n, td) unless n.name == "name" }
+              node.children.each do |n|
+                parse(n, td) unless n.name == "fmt-name"
+              end
             end
           end
         end
@@ -52,26 +54,45 @@ module IsoDoc
         example_div_parse(node, out)
       end
 
+      def block_body_first_elem(node)
+        node.elements.each do |n|
+          %w(title fmt-title fmt-xref-label fmt-name name)
+            .include?(n.name) and next
+          return n
+        end
+        nil
+      end
+
+      def starts_with_para?(node)
+        block_body_first_elem(node)&.name == "p"
+      end
+
+      def note_p_class
+        nil
+      end
+
       def note_p_parse(node, div)
-        name = node.at(ns("./name"))&.remove
-        div.p do |p|
+        name = node.at(ns("./fmt-name"))
+        para = node.at(ns("./p"))
+        div.p **attr_code(class: note_p_class) do |p|
           name and p.span class: "note_label" do |s|
             name.children.each { |n| parse(n, s) }
           end
-          insert_tab(p, 1)
-          node.first_element_child.children.each { |n| parse(n, p) }
+          #insert_tab(p, 1) # TODO to Presentation XML
+          children_parse(para, p)
         end
-        node.element_children[1..].each { |n| parse(n, div) }
+        para.xpath("./following-sibling::*").each { |n| parse(n, div) }
       end
 
       def note_parse1(node, div)
-        name = node.at(ns("./name")) and div.p do |p|
-          p.span class: "note_label" do |s|
-            name.remove.children.each { |n| parse(n, s) }
+        name = node.at(ns("./fmt-name")) and
+          div.p **attr_code(class: note_p_class) do |p|
+            p.span class: "note_label" do |s|
+              name.remove.children.each { |n| parse(n, s) }
+            end
+            #insert_tab(p, 1) # TODO to Presentation XML
           end
-          insert_tab(p, 1)
-        end
-        node.children.each { |n| parse(n, div) }
+        children_parse(node, div)
       end
 
       def keep_style(node)
@@ -94,7 +115,7 @@ module IsoDoc
       def note_parse(node, out)
         @note = true
         out.div **note_attrs(node) do |div|
-          if node&.at(ns("./*[local-name() != 'name'][1]"))&.name == "p"
+          if starts_with_para?(node)
             note_p_parse(node, div)
           else
             note_parse1(node, div)
@@ -105,7 +126,7 @@ module IsoDoc
 
       def admonition_name_parse(_node, div, name)
         div.p class: "AdmonitionTitle", style: "text-align:center;" do |p|
-          name.children.each { |n| parse(n, p) }
+          children_parse(name, p)
         end
       end
 
@@ -114,7 +135,7 @@ module IsoDoc
       end
 
       def admonition_name(node, _type)
-        node&.at(ns("./name"))
+        node&.at(ns("./fmt-name"))
       end
 
       def admonition_attrs(node)
@@ -124,7 +145,7 @@ module IsoDoc
 
       def admonition_parse(node, out)
         out.div **admonition_attrs(node) do |div|
-          if node&.at(ns("./*[local-name() != 'name'][1]"))&.name == "p"
+          if starts_with_para?(node)
             admonition_p_parse(node, div)
           else
             admonition_parse1(node, div)
@@ -139,14 +160,16 @@ module IsoDoc
 
       # code to allow name and first paragraph to be rendered in same block
       def admonition_name_in_first_para(node, div)
+        name = node.at(ns("./fmt-name"))
+        para = node.at(ns("./p"))
         div.p do |p|
           if name = admonition_name(node, node["type"])&.remove
             name.children.each { |n| parse(n, p) }
-            admonition_name_para_delim(p)
+            admonition_name_para_delim(p) # TODO to Presentation XML
           end
-          node.first_element_child.children.each { |n| parse(n, p) }
+          para.children.each { |n| parse(n, p) }
         end
-        node.element_children[1..].each { |n| parse(n, div) }
+        para.xpath("./following-sibling::*").each { |n| parse(n, div) }
       end
 
       def admonition_name_para_delim(para)
@@ -158,7 +181,7 @@ module IsoDoc
         if name
           admonition_name_parse(node, div, name)
         end
-        node.children.each { |n| parse(n, div) unless n.name == "name" }
+        node.children.each { |n| parse(n, div) unless n.name == "fmt-name" }
       end
     end
   end

data/lib/isodoc/function/inline.rb

@@ -17,13 +17,20 @@ module IsoDoc
 
       def location_parse(node, out); end
 
+      # Presentation XML classes which we need not pass on to HTML or DOC
+      SPAN_UNWRAP_CLASSES =
+        %w[fmt-caption-label fmt-label-delim fmt-caption-delim fmt-autonum-delim
+           fmt-element-name fmt-conn fmt-comma fmt-enum-comma fmt-obligation
+           fmt-xref-container].freeze
+
       def span_parse(node, out)
-        if node["style"] || node["class"]
+        klass = node["style"] || node["class"]
+        if klass && !SPAN_UNWRAP_CLASSES.include?(klass)
           out.span **attr_code(style: node["style"],
                                class: node["class"]) do |s|
-            node.children.each { |n| parse(n, s) }
+            children_parse(node, s)
           end
-        else node.children.each { |n| parse(n, out) }
+        else children_parse(node, out)
         end
       end
 
@@ -48,9 +55,8 @@ module IsoDoc
       end
 
       def suffix_url(url)
-        return url if url.nil? || %r{^https?://|^#}.match?(url)
-        return url unless File.extname(url).empty?
-
+        url.nil? || %r{^https?://|^#}.match?(url) and return url
+        File.extname(url).empty? or return url
         url.sub(/#{File.extname(url)}$/, ".html")
       end
 
@@ -136,8 +142,7 @@ module IsoDoc
       end
 
       def text_parse(node, out)
-        return if node.nil? || node.text.nil?
-
+        node.nil? || node.text.nil? and return
         text = node.to_s
         @sourcecode == "pre" and
           text = text.gsub("\n", "<br/>").gsub("<br/> ", "<br/>&#xa0;")
@@ -184,8 +189,26 @@ module IsoDoc
       end
 
       def author_parse(node, out)
+        children_parse(node, out)
+      end
+
+      def semx_parse(node, out)
+        children_parse(node, out)
+      end
+
+      def children_parse(node, out)
         node.children.each { |n| parse(n, out) }
       end
+
+      def xref_label_parse(node, out); end
+
+      def name_parse(node, out); end
+
+      def floating_title_parse(node, out); end
+
+      def fmt_name_parse(node, out)
+        children_parse(node, out)
+      end
     end
   end
 end

data/lib/isodoc/function/lists.rb

@@ -2,7 +2,7 @@ module IsoDoc
   module Function
     module Lists
       def list_title_parse(node, out)
-        name = node.at(ns("./name")) or return
+        name = node.at(ns("./fmt-name")) or return
         out.p class: "ListTitle" do |p|
           name.children&.each { |n| parse(n, p) }
         end
@@ -16,7 +16,7 @@ module IsoDoc
         out.div **attr_code(class: "ul_wrap") do |div|
           list_title_parse(node, div)
           div.ul **attr_code(ul_attrs(node)) do |ul|
-            node.children.each { |n| n.name == "name" or parse(n, ul) }
+            node.children.each { |n| n.name == "fmt-name" or parse(n, ul) }
           end
         end
       end
@@ -57,7 +57,7 @@ module IsoDoc
         out.div **attr_code(class: "ol_wrap") do |div|
           list_title_parse(node, div)
           div.ol **attr_code(ol_attrs(node)) do |ol|
-            node.children.each { |n| n.name == "name" or parse(n, ol) }
+            node.children.each { |n| n.name == "fmt-name" or parse(n, ol) }
           end
         end
       end
@@ -106,7 +106,7 @@ module IsoDoc
       end
 
       def dl_parse_notes(node, out)
-        node.elements.reject { |n| dt_dd?(n) || n.name == "name" }
+        node.elements.reject { |n| dt_dd?(n) || n.name == "fmt-name" }
           .each { |n| parse(n, out) }
       end
 

data/lib/isodoc/function/references.rb

@@ -26,7 +26,7 @@ module IsoDoc
             i += 1
             bibitem_entry(div, b, i, biblio)
           else
-            parse(b, div) unless %w(title).include? b.name
+            parse(b, div) unless %w(fmt-title).include? b.name
           end
         end
       end
@@ -41,9 +41,9 @@ module IsoDoc
       def norm_ref(node, out)
         node["hidden"] != "true" or return
         out.div do |div|
-          clause_name(node, node.at(ns("./title")), div, nil)
+          clause_name(node, node.at(ns("./fmt-title")), div, nil)
           if node.name == "clause"
-            node.elements.each { |e| parse(e, div) unless e.name == "title" }
+            node.elements.each { |e| parse(e, div) unless e.name == "fmt-title" }
           else biblio_list(node, div, false)
           end
         end
@@ -60,7 +60,7 @@ module IsoDoc
         page_break(out)
         out.div do |div|
           div.h1 class: "Section3" do |h1|
-            node.at(ns("./title"))&.children&.each { |c2| parse(c2, h1) }
+            node.at(ns("./fmt-title"))&.children&.each { |c2| parse(c2, h1) }
           end
           biblio_list(node, div, true)
         end
@@ -69,7 +69,7 @@ module IsoDoc
       def bibliography_parse(node, out)
         node["hidden"] != true or return
         out.div do |div|
-          clause_parse_title(node, div, node.at(ns("./title")), out,
+          clause_parse_title(node, div, node.at(ns("./fmt-title")), out,
                              { class: "Section3" })
           biblio_list(node, div, true)
         end

data/lib/isodoc/function/reqt.rb

@@ -20,9 +20,9 @@ module IsoDoc
       end
 
       def recommendation_parse1(node, out)
-        recommendation_name(node.at(ns("./name")), out)
+        recommendation_name(node.at(ns("./fmt-name")), out)
         node.children.each do |n|
-          parse(n, out) unless n.name == "name"
+          parse(n, out) unless n.name == "fmt-name"
         end
       end
 

data/lib/isodoc/function/section.rb

@@ -10,8 +10,8 @@ module IsoDoc
       # used for subclauses
       def clause_parse(node, out)
         out.div **attr_code(clause_attrs(node)) do |div|
-          clause_parse_title(node, div, node.at(ns("./title")), out)
-          node.children.reject { |c1| c1.name == "title" }.each do |c1|
+          clause_parse_title(node, div, node.at(ns("./fmt-title")), out)
+          node.children.reject { |c1| c1.name == "fmt-title" }.each do |c1|
             parse(c1, div)
           end
         end
@@ -19,8 +19,8 @@ module IsoDoc
 
       def clause(node, out)
         out.div **attr_code(clause_attrs(node)) do |s|
-          clause_name(node, node.at(ns("./title")), s, nil)
-          node.elements.reject { |c1| c1.name == "title" }.each do |c1|
+          clause_name(node, node.at(ns("./fmt-title")), s, nil)
+          node.elements.reject { |c1| c1.name == "fmt-title" }.each do |c1|
             parse(c1, s)
           end
         end
@@ -34,7 +34,7 @@ module IsoDoc
         page_break(out)
         out.div **attr_code(annex_attrs(node)) do |s|
           node.elements.each do |c1|
-            if c1.name == "title" then annex_name(node, c1, s)
+            if c1.name == "fmt-title" then annex_name(node, c1, s)
             else parse(c1, s)
             end
           end
@@ -47,9 +47,9 @@ module IsoDoc
 
       def scope(node, out)
         out.div **attr_code(id: node["id"]) do |div|
-          clause_name(node, node.at(ns("./title")), div, nil)
+          clause_name(node, node.at(ns("./fmt-title")), div, nil)
           node.elements.each do |e|
-            parse(e, div) unless e.name == "title"
+            parse(e, div) unless e.name == "fmt-title"
           end
         end
       end
@@ -59,9 +59,9 @@ module IsoDoc
 
       def terms_defs(node, out)
         out.div **attr_code(id: node["id"]) do |div|
-          clause_name(node, node.at(ns("./title")), div, nil)
+          clause_name(node, node.at(ns("./fmt-title")), div, nil)
           node.elements.each do |e|
-            parse(e, div) unless %w{title source}.include? e.name
+            parse(e, div) unless %w{fmt-title source}.include? e.name
           end
         end
       end
@@ -73,9 +73,9 @@ module IsoDoc
 
       def symbols_abbrevs(node, out)
         out.div **attr_code(id: node["id"], class: "Symbols") do |div|
-          clause_name(node, node.at(ns("./title")), div, nil)
+          clause_name(node, node.at(ns("./fmt-title")), div, nil)
           node.elements.each do |e|
-            parse(e, div) unless e.name == "title"
+            parse(e, div) unless e.name == "fmt-title"
           end
         end
       end
@@ -88,10 +88,10 @@ module IsoDoc
       def introduction(clause, out)
         page_break(out)
         out.div class: "Section3", id: clause["id"] do |div|
-          clause_name(clause, clause.at(ns("./title")), div,
+          clause_name(clause, clause.at(ns("./fmt-title")), div,
                       { class: "IntroTitle" })
           clause.elements.each do |e|
-            parse(e, div) unless e.name == "title"
+            parse(e, div) unless e.name == "fmt-title"
           end
         end
       end
@@ -99,9 +99,9 @@ module IsoDoc
       def foreword(clause, out)
         page_break(out)
         out.div **attr_code(id: clause["id"]) do |s|
-          clause_name(clause, clause.at(ns("./title")), s,
+          clause_name(clause, clause.at(ns("./fmt-title")), s,
                       { class: "ForewordTitle" })
-          clause.elements.each { |e| parse(e, s) unless e.name == "title" }
+          clause.elements.each { |e| parse(e, s) unless e.name == "fmt-title" }
         end
       end
 
@@ -109,9 +109,9 @@ module IsoDoc
         title_attr = { class: "IntroTitle" }
         page_break(out)
         out.div class: "Section3", id: clause["id"] do |div|
-          clause_name(clause, clause.at(ns("./title")), div, title_attr)
+          clause_name(clause, clause.at(ns("./fmt-title")), div, title_attr)
           clause.elements.each do |e|
-            parse(e, div) unless e.name == "title"
+            parse(e, div) unless e.name == "fmt-title"
           end
         end
       end
@@ -119,9 +119,9 @@ module IsoDoc
       def abstract(clause, out)
         page_break(out)
         out.div **attr_code(id: clause["id"]) do |s|
-          clause_name(clause, clause.at(ns("./title")), s,
+          clause_name(clause, clause.at(ns("./fmt-title")), s,
                       { class: "AbstractTitle" })
-          clause.elements.each { |e| parse(e, s) unless e.name == "title" }
+          clause.elements.each { |e| parse(e, s) unless e.name == "fmt-title" }
         end
       end
 
@@ -141,10 +141,10 @@ module IsoDoc
       def preface_normal(clause, out)
         page_break(out)
         out.div **attr_code(preface_attrs(clause)) do |div|
-          clause_name(clause, clause.at(ns("./title")), div,
+          clause_name(clause, clause.at(ns("./fmt-title")), div,
                       { class: "IntroTitle" })
           clause.elements.each do |e|
-            parse(e, div) unless e.name == "title"
+            parse(e, div) unless e.name == "fmt-title"
           end
         end
       end
@@ -153,10 +153,10 @@ module IsoDoc
         @bare and return
         page_break(out)
         out.div **attr_code(preface_attrs(clause)) do |div|
-          clause_name(clause, clause.at(ns("./title")), div,
+          clause_name(clause, clause.at(ns("./fmt-title")), div,
                       { class: "IntroTitle" })
           clause.elements.each do |e|
-            parse(e, div) unless e.name == "title"
+            parse(e, div) unless e.name == "fmt-title"
           end
         end
       end
@@ -165,10 +165,10 @@ module IsoDoc
         @seen_colophon or page_break(out)
         @seen_colophon = true
         out.div class: "Section3", id: node["id"] do |div|
-          clause_name(node, node.at(ns("./title")), div,
+          clause_name(node, node.at(ns("./fmt-title")), div,
                       { class: "IntroTitle" })
           node.elements.each do |e|
-            parse(e, div) unless e.name == "title"
+            parse(e, div) unless e.name == "fmt-title"
           end
         end
       end

data/lib/isodoc/function/section_titles.rb

@@ -18,18 +18,24 @@ module IsoDoc
         end
       end
 
+      def sections_names
+        %w[clause annex terms references definitions
+           acknowledgements introduction abstract foreword appendix]
+      end
+
       def freestanding_title(node, out)
-        parents = node.ancestors("clause, annex, terms, references, " \
-                               "definitions, acknowledgements, introduction, " \
-                               "foreword")
+        # node.parent.at(ns("./fmt-title[@source = '#{node['id']}']")) and
+        # return # this title is already being rendered as fmt-title
+        # For testing convenience, let's just go by parent
+        sections_names.include?(node.parent.name) and return
+        parents = node.ancestors(sections_names.join(", "))
         clause_parse_title(parents.empty? ? node : parents.first,
                            out, node, out)
       end
 
       # used for subclauses
       def clause_parse_title(node, div, title, out, header_class = {})
-        return if title.nil?
-
+        title.nil? and return
         if node["inline-header"] == "true"
           inline_header_title(out, node, title)
         else
@@ -46,9 +52,7 @@ module IsoDoc
       end
 
       def clause_title_depth(node, title)
-        depth = node.ancestors("clause, annex, terms, references, " \
-                               "definitions, acknowledgements, introduction, " \
-                               "foreword").size + 1
+        depth = node.ancestors(sections_names.join(", ")).size + 1
         depth = title["depth"] if title && title["depth"]
         depth
       end
@@ -67,8 +71,8 @@ module IsoDoc
         header_class = {} if header_class.nil?
         div.h1 **attr_code(header_class) do |h1|
           if title.is_a?(String) then h1 << title
-          else
-            title&.children&.each { |c2| parse(c2, h1) }
+          elsif title
+            children_parse(title, h1)
             clause_parse_subtitle(title, h1)
           end
         end
@@ -76,8 +80,7 @@ module IsoDoc
       end
 
       def annex_name(_annex, name, div)
-        return if name.nil?
-
+        name.nil? and return
         div.h1 class: "Annex" do |t|
           name.children.each { |c2| parse(c2, t) }
           clause_parse_subtitle(name, t)

data/lib/isodoc/function/table.rb

@@ -2,7 +2,7 @@ module IsoDoc
   module Function
     module Table
       def table_title_parse(node, out)
-        name = node.at(ns("./name")) or return
+        name = node.at(ns("./fmt-name")) or return
         out.p class: "TableTitle", style: "text-align:center;" do |p|
           name&.children&.each { |n| parse(n, p) }
         end