metanorma-document 0.2.0 → 0.2.2

data/lib/metanorma/html/standard_renderer.rb

@@ -5,34 +5,34 @@ module Metanorma
     # Renders StandardDocument components to HTML.
     # Extends BaseRenderer with terms, bibliography, and standard sections.
     class StandardRenderer < BaseRenderer
-      def render(node, **opts)
+      def render(node, **)
         case node
         when Metanorma::StandardDocument::Root
-          render_standard_document(node, **opts)
+          render_standard_document(node, **)
         when Metanorma::StandardDocument::Terms::Term
-          render_term(node, **opts)
+          render_term(node, **)
         when Metanorma::StandardDocument::Sections::TermsSection
-          render_terms_section(node, **opts)
+          render_terms_section(node, **)
         when Metanorma::StandardDocument::Sections::StandardReferencesSection
-          render_references_section(node, **opts)
+          render_references_section(node, **)
         when Metanorma::StandardDocument::Sections::BibliographySection
-          render_bibliography(node, **opts)
+          render_bibliography(node, **)
         when Metanorma::StandardDocument::Sections::ClauseSection
-          render_clause_section(node, **opts)
+          render_clause_section(node, **)
         when Metanorma::StandardDocument::Sections::AnnexSection
-          render_annex_section(node, **opts)
+          render_annex_section(node, **)
         when Metanorma::StandardDocument::Sections::StandardSection
-          render_standard_section(node, **opts)
+          render_standard_section(node, **)
         when Metanorma::StandardDocument::Sections::Abstract
-          render_abstract_section(node, **opts)
+          render_abstract_section(node, **)
         when Metanorma::StandardDocument::Sections::Foreword
-          render_foreword_section(node, **opts)
+          render_foreword_section(node, **)
         when Metanorma::StandardDocument::Sections::Introduction
-          render_introduction_section(node, **opts)
+          render_introduction_section(node, **)
         when Metanorma::StandardDocument::Sections::FloatingTitle
-          render_floating_title(node, **opts)
+          render_floating_title(node, **)
         when Metanorma::StandardDocument::Blocks::AmendBlock
-          render_amend_block(node, **opts)
+          render_amend_block(node, **)
         else
           super
         end
@@ -86,8 +86,10 @@ module Metanorma
         cover_id = nil
         bibdata.doc_identifier&.each do |di|
           next unless safe_attr(di, :type) == "iso-reference"
+
           id = extract_text_value(di)
           next if id.to_s.empty?
+
           cover_id = id
           break
         end
@@ -105,9 +107,9 @@ module Metanorma
         end
 
         @output << render_liquid("_cover.html.liquid", {
-          "doc_id" => cover_id,
-          "title" => title_text,
-        })
+                                   "doc_id" => cover_id,
+                                   "title" => title_text,
+                                 })
       end
 
       def render_doc_title(doc)
@@ -120,77 +122,62 @@ module Metanorma
         elsif bibdata.is_a?(Metanorma::Document::Components::BibData::BibData)
           titles = bibdata.title
           return unless titles && !titles.empty?
+
           en_title = titles.find { |t| t.language == "en" }
           return unless en_title
+
           en_title = extract_text_value(en_title)
         else
           return
         end
 
         @output << render_liquid("_doc_title.html.liquid", {
-          "title" => en_title,
-        })
+                                   "title" => en_title,
+                                 })
       end
 
       # --- Section rendering ---
 
-      def render_clause_section(clause, level: 1, **_opts)
-        attrs = element_attrs(id: safe_attr(clause, :id), class: safe_attr(clause, :class_attr))
+      def render_section(section, level: 1, title_class: nil, with_subsections: false, with_terms: false)
+        attrs = element_attrs(id: safe_attr(section, :id))
         tag("div", attrs) do
-          render_standard_title(clause, level)
-          render_standard_section_blocks(clause, level)
-          render_subsections(clause, level)
+          if title_class
+            render_standard_title(section, level, default_class: title_class)
+          else
+            render_standard_title(section, level)
+          end
+          render_standard_section_blocks(section, level)
+          render_subsections(section, level) if with_subsections
+          section.terms&.each { |term| render_term(term) } if with_terms
         end
       end
 
-      def render_annex_section(annex, level: 1, **_opts)
-        attrs = element_attrs(id: safe_attr(annex, :id))
-        tag("div", attrs) do
-          render_standard_title(annex, level)
-          render_standard_section_blocks(annex, level)
-          render_subsections(annex, level)
-        end
+      def render_clause_section(section, level: 1, **)
+        render_section(section, level: level, with_subsections: true)
       end
 
-      def render_standard_section(section, level: 1, **_opts)
-        attrs = element_attrs(id: safe_attr(section, :id))
-        tag("div", attrs) do
-          render_standard_title(section, level)
-          render_standard_section_blocks(section, level)
-        end
+      def render_annex_section(section, level: 1, **)
+        render_section(section, level: level, with_subsections: true)
       end
 
-      def render_terms_section(terms, level: 1, **_opts)
-        attrs = element_attrs(id: safe_attr(terms, :id))
-        tag("div", attrs) do
-          render_standard_title(terms, level)
-          render_standard_section_blocks(terms, level)
-          terms.terms&.each { |term| render_term(term) }
-        end
+      def render_standard_section(section, level: 1, **)
+        render_section(section, level: level)
       end
 
-      def render_abstract_section(section, level: 1, **_opts)
-        attrs = element_attrs(id: safe_attr(section, :id))
-        tag("div", attrs) do
-          render_standard_title(section, level, default_class: "intro-title")
-          render_standard_section_blocks(section, level)
-        end
+      def render_terms_section(section, level: 1, **)
+        render_section(section, level: level, with_terms: true)
       end
 
-      def render_foreword_section(section, level: 1, **_opts)
-        attrs = element_attrs(id: safe_attr(section, :id))
-        tag("div", attrs) do
-          render_standard_title(section, level, default_class: "foreword-title")
-          render_standard_section_blocks(section, level)
-        end
+      def render_abstract_section(section, level: 1, **)
+        render_section(section, level: level, title_class: "intro-title")
       end
 
-      def render_introduction_section(section, level: 1, **_opts)
-        attrs = element_attrs(id: safe_attr(section, :id))
-        tag("div", attrs) do
-          render_standard_title(section, level, default_class: "intro-title")
-          render_standard_section_blocks(section, level)
-        end
+      def render_foreword_section(section, level: 1, **)
+        render_section(section, level: level, title_class: "foreword-title")
+      end
+
+      def render_introduction_section(section, level: 1, **)
+        render_section(section, level: level, title_class: "intro-title")
       end
 
       def render_floating_title(title_node, **_opts)
@@ -281,11 +268,7 @@ module Metanorma
         tag("div", attrs) do
           label = extract_termnote_label(note)
           @output << "<p><span class=\"term-note-label\">#{escape_html(label)}: </span>"
-          if note.p && !note.p.empty?
-            note.p.each do |para|
-              render_mixed_inline(para)
-            end
-          end
+          note.p&.each { |para| render_mixed_inline(para) }
           @output << "</p>"
           note.ul&.each { |ul| render_unordered_list(ul) }
           note.ol&.each { |ol| render_ordered_list(ol) }
@@ -298,11 +281,7 @@ module Metanorma
         tag("div", attrs) do
           label = extract_block_label(example, "EXAMPLE")
           @output << "<p><span class=\"example-label\">#{escape_html(label)}</span>&nbsp;"
-          if example.p && !example.p.empty?
-            example.p.each do |para|
-              render_mixed_inline(para)
-            end
-          end
+          example.p&.each { |para| render_mixed_inline(para) }
           @output << "</p>"
           example.ul&.each { |ul| render_unordered_list(ul) }
           example.ol&.each { |ol| render_ordered_list(ol) }
@@ -324,11 +303,11 @@ module Metanorma
           bibitemid = safe_attr(origin, :bibitemid)
 
           if citeas && !citeas.to_s.empty?
-            if bibitemid && !bibitemid.to_s.empty?
-              @output << "<a href=\"##{escape_html(bibitemid.to_s)}\" class=\"bibref\">#{escape_html(citeas.to_s)}</a>"
-            else
-              @output << escape_html(citeas.to_s)
-            end
+            @output << if bibitemid && !bibitemid.to_s.empty?
+                         "<a href=\"##{escape_html(bibitemid.to_s)}\" class=\"bibref\">#{escape_html(citeas.to_s)}</a>"
+                       else
+                         escape_html(citeas.to_s)
+                       end
           else
             render_mixed_inline(origin)
           end
@@ -401,9 +380,11 @@ module Metanorma
       def bibitem_url(item)
         links = Array(item.link)
         return nil if links.empty?
+
         # Prefer src or citation type, skip RSS feeds
-        preferred = links.find { |l| l.type == "src" || l.type == "citation" }
+        preferred = links.find { |l| ["src", "citation"].include?(l.type) }
         return preferred.content.to_s if preferred && !preferred.content.to_s.empty?
+
         # Fallback: first non-RSS link
         non_rss = links.find { |l| !l.content.to_s.include?(".rss") && !l.content.to_s.empty? }
         non_rss&.content&.to_s
@@ -421,13 +402,13 @@ module Metanorma
           docids = Array(item.docidentifier)
           # Skip bracket-number identifiers (e.g. "[1]") and iso-reference/URN variants;
           # render only the primary doc identifier
-          primary = docids.find { |di|
+          primary = docids.find do |di|
             val = extract_text_value(di).to_s
             val.match?(/\A\[?\d+\]?\z/) ? false : !val.match?(/\A(?:iso-reference|URN)\s/)
-          }
+          end
           if primary
             id_val = extract_text_value(primary)
-            @output << "<span class=\"std-doc-number\">#{escape_html(id_val)}</span>" unless id_val.to_s.empty?
+            @output << "<span class=\"ref-doc-number\">#{escape_html(id_val)}</span>" unless id_val.to_s.empty?
           end
         end
 
@@ -436,7 +417,7 @@ module Metanorma
             date_on = date.is_a?(Metanorma::Document::Relaton::BibliographicDate) ? date.on : nil
             date_val = extract_text_value(date_on || safe_attr(date, :text))
             if date_val && !date_val.to_s.empty?
-              @output << ":<span class=\"std-year\">#{escape_html(date_val.to_s)}</span>"
+              @output << ":<span class=\"ref-year\">#{escape_html(date_val.to_s)}</span>"
             end
           end
         end

data/lib/metanorma/html/templates/_admonition.html.liquid

@@ -0,0 +1,4 @@
+<div{% if block.id %} id="{{ block.id }}"{% endif %} class="{{ block.css_class }}">
+<p class="admonition-title">{{ block.label_html }}</p>
+{{ block.content_html }}
+</div>

data/lib/metanorma/html/templates/_doc_title.html.liquid

@@ -1,3 +1,3 @@
 <p class="doc-title">
-  <span class="bold-title">{{ title | escape }}</span>
+  <span class="title-text">{{ title | escape }}</span>
 </p>

data/lib/metanorma/html/templates/_example.html.liquid

@@ -0,0 +1,3 @@
+<div{% if block.id %} id="{{ block.id }}"{% endif %} class="{{ block.css_class }}">
+<span class="example-label">{{ block.label_html }}</span>&nbsp;{{ block.content_html }}
+</div>

data/lib/metanorma/html/templates/_figure.html.liquid

@@ -0,0 +1,6 @@
+<figure{% if block.id %} id="{{ block.id }}"{% endif %} class="{{ block.css_class }}">
+{{ block.image_html }}
+{{ block.sub_figures_html }}
+{% if block.caption_html %}<figcaption>{{ block.caption_html }}</figcaption>{% endif %}
+{{ block.key_html }}
+</figure>

data/lib/metanorma/html/templates/_formula.html.liquid

@@ -0,0 +1,6 @@
+<div{% if block.id %} id="{{ block.id }}"{% endif %} class="{{ block.css_class }}">
+{{ block.stem_html }}
+{% if block.where_html %}<p class="formula-where">where</p>{% endif %}
+{{ block.where_html }}
+{% if block.number_html %}<span class="formula-number">{{ block.number_html }}</span>{% endif %}
+</div>

data/lib/metanorma/html/templates/_iso_doc_title.html.liquid

@@ -1,3 +1,3 @@
-<p class="zzSTDTitle1">
-<span class="boldtitle">{{ title | escape }}</span>
+<p class="doc-title">
+<span class="title-text">{{ title | escape }}</span>
 </p>

data/lib/metanorma/html/templates/_note.html.liquid

@@ -0,0 +1,3 @@
+<div{% if block.id %} id="{{ block.id }}"{% endif %} class="{{ block.css_class }}">
+<span class="note-label">{{ block.label_html }}</span>&nbsp;{{ block.content_html }}
+</div>

data/lib/metanorma/html/templates/_sourcecode.html.liquid

@@ -0,0 +1,4 @@
+<div{% if block.id %} id="{{ block.id }}"{% endif %} class="{{ block.css_class }}">
+{% if block.name_html %}<p class="code-name">{{ block.name_html }}</p>{% endif %}
+<pre><code{% if block.lang %} lang="{{ block.lang }}"{% endif %}>{{ block.code_html }}</code></pre>
+</div>

data/lib/metanorma/html.rb

@@ -8,7 +8,6 @@ module Metanorma
     autoload :Generator, "metanorma/html/generator"
     autoload :Theme, "metanorma/html/theme"
     autoload :AssetPipeline, "metanorma/html/asset_pipeline"
-    autoload :ComponentRegistry, "metanorma/html/component_registry"
     autoload :Component, "metanorma/html/component"
     autoload :Drops, "metanorma/html/drops"
     autoload :StandardRenderer, "metanorma/html/standard_renderer"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: metanorma-document
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.2
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-04 00:00:00.000000000 Z
+date: 2026-05-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: lutaml-model
@@ -96,6 +96,7 @@ files:
 - data/stylesheets/components/table.css
 - data/stylesheets/components/term.css
 - data/stylesheets/components/toc.css
+- docs/html-renderer.adoc
 - lib/data/dist/iso_document/frontend/assets/index-mwzbzmnK.js
 - lib/data/dist/iso_document/frontend/assets/index-pGvKTNid.css
 - lib/data/dist/iso_document/frontend/assets/iso-red.svg
@@ -480,9 +481,15 @@ files:
 - lib/metanorma/html/component/footnote_collector.rb
 - lib/metanorma/html/component/index_section.rb
 - lib/metanorma/html/component/index_term_collector.rb
-- lib/metanorma/html/component_registry.rb
 - lib/metanorma/html/drops.rb
+- lib/metanorma/html/drops/admonition_drop.rb
+- lib/metanorma/html/drops/block_element_drop.rb
+- lib/metanorma/html/drops/example_drop.rb
+- lib/metanorma/html/drops/figure_drop.rb
 - lib/metanorma/html/drops/footnote_drop.rb
+- lib/metanorma/html/drops/formula_drop.rb
+- lib/metanorma/html/drops/note_drop.rb
+- lib/metanorma/html/drops/sourcecode_drop.rb
 - lib/metanorma/html/generator.rb
 - lib/metanorma/html/icc_renderer.rb
 - lib/metanorma/html/iec_renderer.rb
@@ -496,13 +503,19 @@ files:
 - lib/metanorma/html/pdfa_renderer.rb
 - lib/metanorma/html/ribose_renderer.rb
 - lib/metanorma/html/standard_renderer.rb
+- lib/metanorma/html/templates/_admonition.html.liquid
 - lib/metanorma/html/templates/_cover.html.liquid
 - lib/metanorma/html/templates/_doc_title.html.liquid
+- lib/metanorma/html/templates/_example.html.liquid
+- lib/metanorma/html/templates/_figure.html.liquid
 - lib/metanorma/html/templates/_footer.html.liquid
 - lib/metanorma/html/templates/_footnotes.html.liquid
+- lib/metanorma/html/templates/_formula.html.liquid
 - lib/metanorma/html/templates/_header.html.liquid
 - lib/metanorma/html/templates/_iso_cover.html.liquid
 - lib/metanorma/html/templates/_iso_doc_title.html.liquid
+- lib/metanorma/html/templates/_note.html.liquid
+- lib/metanorma/html/templates/_sourcecode.html.liquid
 - lib/metanorma/html/templates/document.html.liquid
 - lib/metanorma/html/theme.rb
 - lib/metanorma/html/whitespace_patch.rb

data/lib/metanorma/html/component_registry.rb

@@ -1,37 +0,0 @@
-# frozen_string_literal: true
-
-module Metanorma
-  module Html
-    class ComponentRegistry
-      def initialize
-        @map = {}
-      end
-
-      def register(model_class, component_class)
-        @map[model_class] = component_class
-      end
-
-      def lookup(model_class)
-        @map[model_class] ||
-          model_class.ancestors
-            .drop(1)
-            .filter_map { |a| @map[a] }
-            .first ||
-          nil
-      end
-
-      def component_for(renderer, model_class)
-        component_class = lookup(model_class)
-        component_class&.new(renderer)
-      end
-
-      def register_all(component_module)
-        component_module.constants.each do |const|
-          klass = component_module.const_get(const)
-          next unless klass.is_a?(Class) && klass < Component::Base
-          klass.register_in(self)
-        end
-      end
-    end
-  end
-end