relaton-render 1.4.0.pre.alpha.1 → 1.4.0.pre.alpha.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d8d567a54651ce75901eeb043077a17b840e9a9d9d00e95d3afcde793bfc6795
-  data.tar.gz: 3b6019abeef370c32db6e855238b4500c1be2a785eb726eb6577b6e454588d4b
+  metadata.gz: 51375c04860a0856ea38e357f01398a65e2b8d32b8d2626e014d46110ae710fe
+  data.tar.gz: e684c82bd7d48d1a2763adf42c692b8a980c9f80c1cb35334bf6f40fcd4324b4
 SHA512:
-  metadata.gz: c75141af4b07759f64a7c12ed491509ddfc2cd88595ea6484587a0bb753e333b633906188bf03e765912a06c4fd6e7a1812e0a886486c3c1b3f8435488f376b6
-  data.tar.gz: 2d8b040b077067944c76dd2149af2272bb536811fe228c940d91e5e79c0b42de0f3c4360b9586f0c6a369507eddf01e96246f334b169e4c1e2c5ea1df3507ee5
+  metadata.gz: c3c7fb5f5ffc57913d83f8f99ceb01d50e234059a68731a5e32ab84e22e47c69cb1c7faf4f1248cdaf9954dcca2295bf7843cb47a55a63b940d361cad87673f0
+  data.tar.gz: a3c8a7e0127f3d1dddaad363802a2f882ce7cffa51beccd3fd7e72724ef0ff894b746b86d08386c75644b812f95c666f09d41b821ea7e10d6ebb9f8cf9517f4c

data/lib/relaton/render/general.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Relaton
+  module Render
+    # Compatibility entry point (relaton-render#90).
+    #
+    # The v2 engine replaced the liquid/config/i18n machinery with the
+    # template evaluator over CitationStyle instances
+    # (Relaton::Render::Iso690). isodoc main's render-isodoc subclasses
+    # this constant, so it must exist for all-git-main stacks to boot.
+    # This facade delegates rendering to the v2 engine; the retired
+    # options (config:, template overrides in liquid syntax) are ignored
+    # with one warning — migrate to a CitationStyle instance, which
+    # expresses everything the old config.yml did (see the citation
+    # module in relaton-models).
+    class General
+      def initialize(options = {})
+        @renderer = Iso690::Renderer.new(
+          lang: options[:language] || options[:lang] || "en",
+          script: options[:script] || "Latn",
+          labels: options[:i18nhash] || {},
+        )
+        warn_general_config if options[:config]
+      end
+
+      def render(model, **opts)
+        @renderer.render(model, **opts)
+      end
+
+      def citation(model, **opts)
+        @renderer.citation(model, **opts)
+      end
+
+      private
+
+      def warn_general_config
+        return if General.config_warned
+
+        General.config_warned = true
+        warn "relaton-render: Relaton::Render::General is a compatibility " \
+             "facade over the v2 engine; the liquid config option is " \
+             "retired and ignored. Author a CitationStyle instance " \
+             "(relaton-models citation module) for custom rendering."
+      end
+
+      class << self
+        attr_accessor :config_warned
+      end
+    end
+  end
+end

data/lib/relaton/render/iso690/i18n.rb

@@ -36,6 +36,19 @@ module Relaton
           self
         end
 
+        # Runtime label overrides (a caller's i18n hash): the pack's label
+        # names win as the key mapping; unknown keys are ignored.
+        def overlay_hash!(hash)
+          known = %w[
+            edition series_no report_no available_from in and oxford_comma
+            ed eds date_range others no_date no_author at
+          ]
+          hash.each do |key, value|
+            labels[key.to_s] = value if known.include?(key.to_s) && !value.nil?
+          end
+          self
+        end
+
         class << self
           def load(lang = "en")
             code = lang.to_s.empty? ? "en" : lang

data/lib/relaton/render/iso690/renderer.rb

@@ -24,9 +24,11 @@ module Relaton
           end
         end
 
-        def initialize(style: DEFAULT_STYLE, lang: "en", script: "Latn")
+        def initialize(style: DEFAULT_STYLE, lang: "en", script: "Latn",
+                       labels: {})
           @style = Style.load(style)
           @i18n = I18n.load(lang).overlay!(@style.scheme.locale)
+          @i18n.overlay_hash!(labels) unless labels.empty?
           @script = script
         end
 

data/lib/relaton/render/iso690/style.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "lutaml/model"
+
 module Relaton
   module Render
     module Iso690

data/lib/relaton/render/iso690.rb

@@ -6,6 +6,10 @@ module Relaton
     # places the inventory's data elements (clause 7) in each resource
     # kind's order (clause 8); the engine is a template evaluator over a
     # field resolver and holds no styles, no vocabularies, no i18n.
+    # The v1 compatibility facade (relaton-render#90): isodoc's
+    # render-isodoc subclasses Relaton::Render::General.
+    autoload :General, "relaton/render/general"
+
     module Iso690
       autoload :Element, "relaton/render/iso690/element"
       autoload :Elements, "relaton/render/iso690/elements"

data/lib/relaton/render/version.rb

@@ -1,5 +1,5 @@
 module Relaton
   module Render
-    VERSION = "1.4.0.pre.alpha.1".freeze
+    VERSION = "1.4.0.pre.alpha.2".freeze
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: relaton-render
 version: !ruby/object:Gem::Version
-  version: 1.4.0.pre.alpha.1
+  version: 1.4.0.pre.alpha.2
 platform: ruby
 authors:
 - Ribose Inc.
@@ -54,6 +54,7 @@ files:
 - lib/isodoc-yaml/i18n-zh-Hant.yaml
 - lib/isodoc/i18n.rb
 - lib/relaton-render.rb
+- lib/relaton/render/general.rb
 - lib/relaton/render/iso690.rb
 - lib/relaton/render/iso690/element.rb
 - lib/relaton/render/iso690/elements.rb