relaton-render 1.4.0.pre.alpha.3 → 3.0.0.pre.alpha.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f944c1a5f1a26e1ec5c4d1cceae37ea7420257034c87b31eaa6ea0c8e46269e6
-  data.tar.gz: 5bcd504fbf58c890f778d4f492d70bbabe9b8a974837c838752fbf367129c67c
+  metadata.gz: f301bc95c707486b2546c988eb50acef801327df7ec89b53f319045fba834e25
+  data.tar.gz: 0c16ff123fddd608086af6d9a4b3577bfe0f828df4304be9e0a031e4afff86e2
 SHA512:
-  metadata.gz: 0032e8464f6d1731e4aef47a69dfca0e646df0d6c52d85dfa16b72194357f5a5b01f513ffe65498b08e5b6ae4f3e83ef8f6819c6e87e6d1b5a361787a1ce7495
-  data.tar.gz: ab3af5ef2028428f712fca4727fe126cf56cccfb33fac0d523190536b237616d0207d2363aa2f422fc48e2c3fa78e4a9922ade6f7ad6df6c5738e1be8dc02098
+  metadata.gz: 251ca7594d0e52edd0a42f6bfc840f6fed7a383a9e0f46cc34a20daa720e3c0c455b184169f4448d73aee6cd737d2dd6431a7ff5e05f37b3f3be4eca0584feaa
+  data.tar.gz: 15a48d602d48b469197df9472d0fd7c3304507f50edb5bfdddb4299f6eadafe6d0a1ceb9bf65b706d4f111b379be980e94b12a6c089e2f836f8f8da6aa16251a

data/lib/relaton/render/fields/date.rb

@@ -0,0 +1,48 @@
+module Relaton
+  module Render
+    class Date
+      def initialize(date, options)
+        @date = date
+        @r = options[:renderer]
+        @type = options[:type]
+        @bibitem = options[:bibitem]
+      end
+
+      def render
+        return @date if @date.nil? || /^\d+$/.match?(@date)
+
+        render1(granularity)
+      end
+
+      # @r.date is using document language setting, not citation-specific
+      def render1(format)
+        datef = dateparse(format, @r.lang.to_sym)
+        case @r.date[format]
+        when "to_full_s", "to_long_s", "to_medium_s", "to_short_s"
+          datef.send @r.date[format]
+        else
+          datef.to_additional_s(@r.date[format])
+        end
+      end
+
+      def granularity
+        case @date
+        when /^\d+-\d+$/ then "month_year"
+        when /^\d+-\d+-\d+$/ then "day_month_year"
+        else "date_time"
+        end
+      end
+
+      def dateparse(format, lang)
+        case format
+        when "date_time"
+          DateTime.parse(@date).localize(lang, timezone: "Zulu")
+        when "day_month_year"
+          DateTime.parse(@date).localize(lang, timezone: "Zulu").to_date
+        when "month_year"
+          DateTime.parse("#{@date}-01").localize(lang, timezone: "Zulu").to_date
+        end
+      end
+    end
+  end
+end

data/lib/relaton/render/fields/fields.rb

@@ -0,0 +1,266 @@
+require_relative "date"
+
+module Relaton
+  module Render
+    class Fields
+      def initialize(options)
+        @r = options[:renderer]
+      end
+
+      # the @i18n.select choices here need to rely on
+      # fields already present, they can't rely on fields they are yet to build
+      def compound_fields_format(hash)
+        name_fields_format(hash)
+        role_fields_format(hash)
+        date_fields_format(hash)
+        edition_fields_format(hash)
+        place_fields_format(hash)
+        series_fields_format(hash)
+        misc_fields_format(hash)
+      end
+
+      def comma(hash)
+        "#{@r.i18n.select(hash).get.dig('punct', 'comma') || ','} "
+      end
+
+      def place_fields_format(hash)
+        hash[:place_raw]&.map! do |p|
+          # TODO use enum-comma?
+          if p.is_a?(Array)
+            p.join(comma(hash))
+          else p
+          end
+        end
+        hash[:place] =
+          nameformat(hash[:place_raw].map { |x| { nonpersonal: x } }, hash)
+      end
+
+      def name_fields_format(hash)
+        [%i(creatornames creators), %i(host_creatornames host_creators),
+         %i(publisher publisher_raw), %i(distributor distributor_raw),
+         %i(authorizer authorizer_raw)]
+          .each do |k|
+          hash[k[0]] = nameformat(hash[k[1]], hash)
+        end
+        hash[:publisher_abbrev] = hash[:publisher_abbrev_raw]&.join(comma(hash))
+        hash[:authorcite] = authorciteformat(hash[:creators], hash)
+      end
+
+      def role_fields_format(hash)
+        hash[:role] = role_inflect(hash[:creators], hash[:role_raw], hash)
+        hash[:host_role] =
+          role_inflect(hash[:host_creators], hash[:host_role_raw], hash)
+      end
+
+      def edition_fields_format(hash)
+        hash[:edition] =
+          editionformat(hash[:edition_raw], hash[:edition_num], hash)
+        hash[:draft] = draftformat(hash[:draft_raw], hash)
+      end
+
+      def misc_fields_format(hash)
+        hash[:medium] = mediumformat(hash[:medium_raw], hash)
+        hash[:extent] = extentformat(hash[:extent_raw], hash)
+        hash[:size] = sizeformat(hash[:size_raw], hash)
+        hash[:uri] = uriformat(hash[:uri_raw])
+        hash[:status] = statusformat(hash[:status_raw], hash)
+        hash[:other_identifier] =
+          otheridentifierformat(hash[:other_identifier_raw], hash)
+        hash
+      end
+
+      def otheridentifierformat(otherids, _hash)
+        otherids&.map do |i|
+          # ret = "#{i[0]}: <esc>#{i[1]}</esc>"
+          # @r.i18n.select(hash).l10n(ret) # no i18n!
+          "#{i[0]}: #{i[1]}"
+        end
+      end
+
+      def statusformat(status, hash)
+        status.nil? and return
+        @r.i18n.select(hash).get.dig("stage", status) || status
+      end
+
+      # date => disambiguated_date, the disambiguation happens in citations/
+      def date_fields_format(hash)
+        [%i(date date), %i(disambiguated_date date),
+         %i(date_updated date_updated),
+         %i(date_accessed date_accessed)].each do |k|
+          hash[k[0]] = dateformat(hash[k[1]], hash, k)
+          k[1] == :date &&
+            !%w(standard webresource website).include?(hash[:type]) and
+            hash[k[0]] ||= @r.i18n.select(nil).get["no_date"]
+        end
+      end
+
+      def mediumformat(medium, hash)
+        medium.nil? and return nil
+        ret = %w(content genre form carrier size
+                 scale).each_with_object([]) do |i, m|
+          m << "<esc>#{medium[i]}</esc>" if medium[i]
+          m
+        end.compact
+        i = @r.i18n.select(hash)
+        i.l10n(ret.join(comma(hash)))
+      end
+
+      def series_fields_format(hash)
+        parts =
+          %i(series_title series_abbr series_num series_partnumber
+             series_run series_formatted series_dates series_place series_org)
+        series_out = parts.each_with_object({}) do |i, m|
+          m[i] = hash[i]
+        end
+        t = hash[:type] == "article" ? @r.journaltemplate : @r.seriestemplate
+        hash[:series] = t.render(series_out, hash)
+      end
+
+      def nameformat(names, hash)
+        names.nil? and return names
+        parts = %i(surname initials given middle nonpersonal)
+        names_out = names.each_with_object({}) do |n, m|
+          parts.each do |i|
+            m[i] ||= []
+            m[i] << n[i]
+          end
+        end
+        @r.nametemplate.render(names_out, hash)
+      end
+
+      def authorciteformat(names, hash)
+        names.nil? || @r.authorcitetemplate.nil? and return names
+        parts = %i(surname initials given middle nonpersonal)
+        names_out = names.each_with_object({}) do |n, m|
+          parts.each do |i|
+            m[i] ||= []
+            m[i] << n[i]
+          end
+        end
+        @r.authorcitetemplate.render(names_out, hash)
+      end
+
+      def role_inflect(contribs, role, hash)
+        role.nil? || contribs.empty? ||
+          %w(author publisher distributor
+             authorizer).include?(role) and return nil
+        number = contribs.size > 1 ? "pl" : "sg"
+        x = @r.i18n.select(hash).get[role]
+        x.is_a?(Hash) or return role
+        x[number] || role
+      end
+
+      def editionformat(edn, num, hash)
+        num || edn && !edn.empty? or return
+        edn_num = edn&.gsub(/<\/?esc>/, "")
+        num || /^\d+$/.match?(edn_num) and
+          return @r.i18n.select(hash)
+              .populate("edition_ordinal", { "var1" => num || edn_num.to_i })
+        @r.i18n.select(hash).populate("edition_cardinal", { "var1" => edn })
+      end
+
+      def draftformat(num, hash)
+        num.nil? ||
+          (num.is_a?(Hash) && num[:status].nil? &&
+            num[:iteration].nil?) and return nil
+        @r.i18n.select(hash).draft.sub("%", num)
+      end
+
+      def extentformat(extent, hash)
+        extent.map do |stack|
+          stack.map do |e|
+            e1 = e.transform_values { |v| v.is_a?(Hash) ? range(v) : v }
+            ret = e.each_with_object({}) do |(k, v), m|
+              extentformat1(k, v, m, e1, hash)
+              m
+            end
+            @r.extenttemplate.render(hash.merge(ret), hash)
+          end.join(" ")
+        end.join("; ")
+      end
+
+      def extentformat1(key, val, hash, norm_hash, context)
+        if %i(volume issue page).include?(key)
+          hash["#{key}_raw".to_sym] = norm_hash[key]
+          hash[key] =
+            pagevolformat(norm_hash[key], val, key.to_s, false, context)
+        end
+      end
+
+      def range(hash)
+        hash[:on] and return hash[:on]
+        hash.has_key?(:from) && hash[:from].nil? and return nil
+        !hash[:from] and return hash
+        hash[:to] && hash[:to] != hash[:from] and
+          return "#{hash[:from]}&#x2013;#{hash[:to]}"
+        hash[:from]
+      end
+
+      def sizeformat(size, hash)
+        return nil unless size
+
+        ret = size.transform_values do |v|
+          @r.i18n.select(hash).l10n(v.join(" + "))
+        end
+          .each_with_object({}) do |(k, v), m|
+            sizeformat1(k, v, m, hash)
+            m
+          end
+        @r.sizetemplate.render(ret.merge(type: hash[:type]), hash)
+      end
+
+      def sizeformat1(key, val, hash, context)
+        case key
+        when "volume", "issue", "page"
+          hash["#{key}_raw".to_sym] = val
+          hash[key.to_sym] = pagevolformat(val, nil, key, true, context)
+        when "data" then hash[:data] = val
+        when "duration" then hash[:duration] = val
+        end
+      end
+
+      def pagevolformat(value, value_raw, type, is_size, hash)
+        value.nil? and return nil
+        num = "pl"
+        if is_size
+          value == "1" and num = "sg"
+        else
+          value_raw[:to] or num = "sg"
+        end
+        i = @r.i18n.select(hash)
+        i.l10n(i.get[is_size ? "size" : "extent"][type][num]
+        .sub("%", value))
+      end
+
+      def date_range(hash)
+        hash[:from] && !hash[:to] and return "#{hash[:from]}&#x2013;"
+        range(hash)
+      end
+
+      def dateformat(date, hash, type)
+        date.nil? and return nil
+        date.is_a?(String) and return date
+        %i(from to on).each do |k|
+          date[k] = @r.dateklass
+            .new(date[k], renderer: @r, bibitem: hash, type: type).render
+        end
+        date_range(date)
+      end
+
+      def uriformat(uri)
+        uri.nil? || uri.empty? and return nil
+        # do not process uri contents in l10n
+        "<fmt-link target='#{uri}'><esc>#{uri}</esc></fmt-link>"
+      end
+
+      private
+
+      def tw_cldr_lang
+        if @r.lang != "zh" then @r.lang.to_sym
+        elsif @r.script == "Hant" then :"zh-tw"
+        else :"zh-cn"
+        end
+      end
+    end
+  end
+end

data/lib/relaton/render/general.rb

@@ -95,6 +95,15 @@ module Relaton
         Relaton::Bib::Item
       end
 
+      # 1.x Parse#authoritative_identifier semantics: the
+      # primary/language cascade, the excluded types (URN, DOI, ISBN...)
+      # dropped, and scoped ids (biblio-tag duplicates, IEEE trademark)
+      # demoted within their type group. isodoc hands the live bibitem
+      # node with the document's default namespace still attached, so the
+      # element queries must be namespace-agnostic.
+      EXCLUDED_ID_TYPES = %w(METANORMA METANORMA-ORDINAL AUTHOR-DATE TITLE
+                             URN ISO-REFERENCE ISSN ISBN DOI).freeze
+
       def facade_docids(doc)
         node = doc
         unless node.respond_to?(:xpath)
@@ -103,7 +112,37 @@ module Relaton
         end
         return [] unless node
 
-        node.xpath("./docidentifier").map(&:text)
+        ids = node.xpath("./*[local-name() = 'docidentifier']")
+        ids = facade_scope_filter(ids)
+        out = nil
+        [
+          ->(x) { x["language"] == @lang && x["primary"] },
+          ->(x) { x["primary"] },
+          ->(x) { x["language"] == @lang },
+          ->(_x) { true },
+        ].each do |p|
+          out = ids.select do |x|
+            p.call(x) && !EXCLUDED_ID_TYPES.include?(facade_id_type(x))
+          end
+          out.empty? or break
+        end
+        out.map { |x| x.text.strip }
+      end
+
+      def facade_id_type(id)
+        t = id["type"] or return nil
+        m = /\A(ISBN|ISSN)\..*/i.match(t) or return t.upcase
+        m[1].upcase
+      end
+
+      def facade_scope_filter(ids)
+        ids.detect { |i| i["scope"] } or return ids
+        ids.group_by { |i| i["type"] }.flat_map do |type, group|
+          grouped = group.group_by { |i| i["scope"] }
+          if type == "IEEE" then grouped["trademark"] || grouped[nil] || []
+          else grouped[nil] || []
+          end
+        end
       end
 
       def warn_general_config

data/lib/relaton/render/legacy/citations.rb

@@ -0,0 +1,178 @@
+module Relaton
+  module Render
+    class Citations
+      def initialize(opt = {})
+        # invoking i18n hash, but we preference the specific renderer's i18n
+        @i18n = opt[:i18n]
+        @lang = opt[:lang] # document lang and script
+        @script = opt[:script]
+        # hash of renderers, to be applied to specific citation by selector
+        @renderer = opt[:renderer]
+      end
+
+      def renderer(_cite)
+        @renderer[:default]
+      end
+
+      # takes array of { id, type, author, date, ord, data }
+      def render(ret)
+        cites = citations(ret)
+        enhance_data(cites)
+        cites.each_key do |k|
+          cites[k] = render1(cites[k])
+        end
+        cites
+      end
+
+      def enhance_data(cites)
+        ret = extract_uris_for_lookup(cites)
+        ret.empty? and return
+        # functionality removed: date needs to be given explicitly
+        # @renderer.urls_exist_concurrent(ret.keys).each do |k, v|
+        # ret[k].each { |u| add_date_accessed(cites[u], k, v) }
+        # end
+      end
+
+      def extract_uris_for_lookup(cites)
+        cites.each_with_object({}) do |(k, v), m|
+          u = extract_uri_for_lookup(v) or next
+          m[u] ||= []
+          m[u] << k
+        end
+      end
+
+      def extract_uri_for_lookup(cite)
+        t = renderer(cite).renderer(cite[:type] || "misc").template_raw
+        c = cite[:data]
+        t.is_a?(String) or return
+        (/\{\{\s*date_accessed\s*\}\}/.match?(t) &&
+        /\{\{\s*uri\s*\}\}/.match?(t) &&
+        c[:uri_raw] && !c[:date_accessed]) or return
+        c[:uri_raw]
+      end
+
+      def add_date_accessed(cite, uri, status)
+        r = renderer(cite)
+        if status
+          cite[:data][:date_accessed] = { on: ::Date.today.to_s }
+          cite[:data] = r.fieldsklass.new(renderer: r)
+            .compound_fields_format(cite[:data])
+        else
+          r.url_warn(uri)
+        end
+      end
+
+      def render1(cit)
+        ref, ref1, r = render1_prep(cit)
+        i = @i18n.select(cit[:data])
+        cit[:formattedref] =
+          r.valid_parse(i.l10n(ref1))
+        cit[:citation][:full] = r.valid_parse(i.l10n(ref))
+        %i(type data renderer).each { |x| cit.delete(x) }
+        cit
+      end
+
+      def use_terminator?(ref, final, _cit)
+        !ref || ref.empty? and return false
+        !ref.end_with?(final)
+      end
+
+      def render1_prep(cit)
+        r = renderer(cit)
+        ref = r.renderer(cit[:type] || "misc").render(cit[:data], cit[:data])
+        final = @i18n.select(cit[:data]).get
+          .dig("punct", "biblio-terminator") || "."
+        ref1 = ref
+        use_terminator?(ref, final, cit) and ref1 += final
+        [ref, ref1, r]
+      end
+
+      # TODO: configure how multiple ids are joined, from template?
+      def citations(ret)
+        ret = disambig_author_date_citations(ret)
+        ret.each_value do |b|
+          i = @i18n.select(b[:data])
+          b[:citation][:default] =
+            i.l10n(b[:data][:authoritative_identifier]&.first || "")
+          d = b[:data].merge(citestyle: "short")
+          b[:citation][:short] = i.l10n(renderer(b).citeshorttemplate.render(d, d))
+          citations_iterate_cite_styles(b, i)
+        end
+        ret
+      end
+
+      def citations_iterate_cite_styles(bib, i18n)
+        r = renderer(bib)
+        r.citetemplate.citation_styles.each do |style|
+          bib[:citation][style] =
+            i18n.l10n(r.citetemplate
+            .render(bib.merge(citestyle: style)
+            .merge(bib[:data]), bib[:data]))
+        end
+      end
+
+      # takes array of { id, type, author, date, ord, data }
+      def disambig_author_date_citations(ret)
+        author_date_to_hash(suffix_date(sort_ord(author_date_breakdown(ret))))
+      end
+
+      def author_date_breakdown(ret)
+        ret.each_with_object({}) do |b, m|
+          m[b[:author]] ||= {}
+          m[b[:author]][b[:date]] ||= []
+          m[b[:author]][b[:date]] << b
+        end
+      end
+
+      def sort_ord(ret)
+        ret.each do |author, v|
+          v.each_key do |date|
+            ret[author][date].sort_by! { |a| a[:ord] }
+          end
+        end
+      end
+
+      def suffix_date(ret)
+        ret.each do |k, v|
+          v.each do |k1, v1|
+            s =  v1.reject { |b| b[:date].nil? }.size
+            s.zero? || k.nil? and next
+            suffix_date1(ret, k, k1, s)
+            copy_date_fields(ret, k, k1)
+          end
+        end
+        ret
+      end
+
+      def suffix_date1(ret, key1, key2, size)
+        size > 1 or return
+        ret[key1][key2].each_with_index do |b, i|
+          b[:date].nil? and next
+          b[:disambiguated_date] = b[:date] + ("a".ord + i).chr.to_s
+        end
+      end
+
+      def copy_date_fields(ret, key1, key2)
+        ret[key1][key2].each do |b|
+          b[:date].nil? and next
+          b[:data][:date] = b[:date]
+          b[:disambiguated_date] ||= b[:date]
+          b[:data][:disambiguated_date] = b[:disambiguated_date]
+        end
+      end
+
+      def author_date_to_hash(ret)
+        ret.each_with_object({}) do |(_k, v), m|
+          v.each_value do |v1|
+            v1.each do |b|
+              m[b[:id]] = { author: @i18n.select(b[:data]).l10n(b[:author]),
+                            date: b[:disambiguated_date] || b[:date],
+                            citation: {},
+                            data: b[:data], type: b[:type] }
+            end
+          end
+        end
+      end
+    end
+  end
+end