relaton-render 3.0.0.pre.alpha.12 → 3.0.0.pre.alpha.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6940d659b738ee1c15dc46b7ee7be2bfb3f3bf322fd6cb8ae5fe70e19a2ab7ce
-  data.tar.gz: 060007b9cd392e9bf4b84cac3961aa8f0881849e74195c4ca6eb3f5f6dcf64f6
+  metadata.gz: ead90c5cd3e6ad47098edb1a67c40811de053b49d723dc64d85e8413f5197334
+  data.tar.gz: 6b8edcc93cc0d005a94552af4621af0cfbad5ae32fdf5b5e7ba5f8681dea3900
 SHA512:
-  metadata.gz: 4a989f5e702e6e27afbad1fab8dc59c7bd092355eab5dbfb1cedf0b99c2373e71c99c3ed418e033f6638f00addcf68d983006213206a4200b7ef6e45c9907682
-  data.tar.gz: 56ac7f18bd13de8324a8ac118d68c7c9d98b6b3eb49b455a32cbca194802097b2e5123e725427ff84d16fd8fe1bd4fe952de7e90c610bf27e39cd94d105a76c2
+  metadata.gz: 97e932d38d5f754bbec369ac6218592121ba1214811defbf553ac260c4b4de6fb8f4b0a24fb56e25d0bba75be8b8dbb79aa56b5375f54a4862dbfb05172e3d90
+  data.tar.gz: '088c9aeb8e944ede167697eee2ce60d3c8952c457a8ae8e3ce35e517f942ee167ba69142b2df52ab9873c104b361c76eb95e9a108df49f2855500adba95176e9'

data/lib/relaton/render/general.rb

@@ -55,9 +55,10 @@ module Relaton
       # presentation_function/refs.rb).
       def render_all(bib, type: "author-date")
         items = facade_bibitems(bib) or return nil
+        disambiguators = date_disambiguators(items)
         items.each_with_object({}).with_index do |(item, m), i|
           ref = begin
-            @renderer.render(item)
+            @renderer.render(item, disambiguator: disambiguators[item.id])
           rescue ::Relaton::Render::Unrenderable
             next
           end
@@ -82,6 +83,31 @@ module Relaton
       # render_all feeds the bibliography list: a reference not ending
       # in the biblio terminator takes one (the 1.x render1 behaviour;
       # single-item render stays verbatim)
+      # The batch disambiguation suffixes ("2022a"): items sharing a
+      # principal-creator surname and a date take alphabetical
+      # suffixes in bibliography order (the 1.x
+      # disambig_author_date_citations)
+      def date_disambiguators(items)
+        keys = items.filter_map do |item|
+          begin
+            [item.id, @renderer.author_key(item),
+             @renderer.citation(item)]
+          rescue ::Relaton::Render::Unrenderable
+            nil
+          end
+        end
+        groups = keys.group_by { |_, author, cite| [author, cite] }
+        suffixes = {}
+        groups.each_value do |group|
+          next if group.size < 2
+
+          group.each_with_index do |(id, _author, _cite), i|
+            suffixes[id] = ("a".ord + i).chr
+          end
+        end
+        suffixes
+      end
+
       # The bibliography terminator; flavors override to suppress it
       # (1.x use_terminator?), receiving the item it terminates
       def terminate_reference(ref, _item = nil)

data/lib/relaton/render/iso690/elements/authorizer.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Relaton
+  module Render
+    module Iso690
+      module Elements
+        # The authorizing body of a standard (the IETF RFC Series, the
+        # W3C Recommendation process): the organization carrying the
+        # authorizer role, cited after the status
+        class Authorizer < Element
+          def present?
+            !authorizer_name.empty?
+          end
+
+          def render
+            authorizer_name
+          end
+
+          private
+
+          def authorizer_name
+            contributors("authorizer").map do |c|
+              Array(c.organization&.name).map { |n| localized(n) }.join(", ")
+            end.reject(&:empty?).first.to_s
+          end
+        end
+      end
+    end
+  end
+end

data/lib/relaton/render/iso690/elements/creator.rb

@@ -59,18 +59,27 @@ module Relaton
           end
 
           def marked?
-            creators.size > 1 || name_form.lone_editor_marked
+            name_form.editors_marked &&
+              (creators.size > 1 || name_form.lone_editor_marked)
           end
 
           def role_word
             @i18n.label(creators.one? ? "ed" : "eds")
           end
 
-          # In-text (name-and-date) form: the principal creator only
+          # In-text (name-and-date) form: the principal creator only;
+          # at the style's et-al threshold the cite truncates
+          # ("Aluffi <em>et al.</em>")
           def in_text
             principal = creators.first or return ""
             person = principal.person or return org_name(principal)
-            completename(person) || surname(person)&.upcase || ""
+            name = completename(person) || surname(person)&.upcase || ""
+            etal? ? "#{name} <em>et al.</em>" : name
+          end
+
+          def etal?
+            count = name_form.etal_count
+            count.positive? && creators.size >= count
           end
 
           # The principal creator's given names, as the name form declares
@@ -141,7 +150,11 @@ module Relaton
             if (first || name_form.inverted_all) && !name_form.given_name_first
               @style.render_name(surname: surname, given: given)
             else
-              [given, surname.upcase].reject(&:empty?).join(" ")
+              # the direct form initializes per the style's initials
+              # knob ("S. Payne" over "Sam Payne")
+              shown = name_form.subsequent_surname_upcase ? surname.upcase :
+                        surname
+              [person_given(person), shown].reject(&:empty?).join(" ")
             end
           end
 

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

@@ -21,6 +21,7 @@ module Relaton
         autoload :Access, "relaton/render/iso690/elements/access"
         autoload :Stddoc, "relaton/render/iso690/elements/stddoc"
         autoload :Status, "relaton/render/iso690/elements/status"
+        autoload :Authorizer, "relaton/render/iso690/elements/authorizer"
         autoload :Citeid, "relaton/render/iso690/elements/citeid"
         autoload :Updated, "relaton/render/iso690/elements/updated"
 
@@ -41,6 +42,7 @@ module Relaton
           access: Access,
           stddoc: Stddoc,
           status: Status,
+          authorizer: Authorizer,
           citeid: Citeid,
           updated: Updated,
         }.freeze

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

@@ -11,7 +11,7 @@ module Relaton
         ELEMENT_SLOTS = %i[
           creator title edition medium series production
           date numeration component_part identifier location size
-          extent access stddoc status citeid updated
+          extent access stddoc status citeid authorizer updated
         ].freeze
 
         def initialize(model, style:, i18n:, disambiguator: nil,
@@ -31,12 +31,21 @@ module Relaton
             table[key] = element_field(slot)
           end
           table["dategroup"] = dategroup_field
+          table["disambiguateddate"] = disambiguated_date_field(table["date"])
           unless table["dategroup"].present?
             table["dategroup"] = fallback_field(:dategroup)
           end
           table.merge(name_fields)
         end
 
+        # The date carrying the batch disambiguation suffix ("2022a"):
+        # identity when the caller passes none
+        def disambiguated_date_field(date)
+          return date if @disambiguator.empty? || !date.present?
+
+          Template::Field[true, "#{date.text}#{@disambiguator}"]
+        end
+
         def fallback_field(slot)
           fallback = @style.fallback_for(item_kind, slot)
           fallback ? Template::Field[true, fallback] :

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

@@ -34,11 +34,12 @@ module Relaton
           @script = script
         end
 
-        def render(model)
+        def render(model, disambiguator: nil)
           kind = @style.kind_for(model.type)
           template = @style.template_for(kind, home: home_docid?(model))
           out = Template.new(template).evaluate(
             Fields.new(model, style: @style, i18n: @i18n,
+                       disambiguator: disambiguator,
                        elements: @elements).to_h,
           )
           raise ::Relaton::Render::Unrenderable,
@@ -74,6 +75,14 @@ module Relaton
           ""
         end
 
+        # The in-text author key (the principal creator's surname, as
+        # the citation renders it): the batch disambiguation groups by
+        # it
+        def author_key(model)
+          Fields.new(model, style: @style, i18n: @i18n,
+                     elements: @elements).to_h["surname"].text
+        end
+
         # In-text form: SURNAME, year + disambiguator (name-and-date)
         def citation(model, disambiguator: nil)
           Template.new(@style.templates.citation).evaluate(

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

@@ -38,6 +38,15 @@ module Relaton
           attribute :surname_upcase, :boolean, default: -> { true }
           # Initials are a list; this separates them ("J. K." vs "J.K.")
           attribute :initials_separator, :string, default: " "
+          # The direct-order surname casing after the first creator:
+          # the name-date convention upcases
+          attribute :subsequent_surname_upcase, :boolean,
+                    default: -> { true }
+          # At this many creators the in-text cite truncates to the
+          # first surname with "et al." (0 disables)
+          attribute :etal_count, :integer, default: 0
+          # Editor lists carry the role marker ("(Eds.)")
+          attribute :editors_marked, :boolean, default: -> { true }
 
           key_value do
             map "initials", to: :initials
@@ -52,6 +61,9 @@ module Relaton
             map "initialsPeriod", to: :initials_period
             map "surnameUpcase", to: :surname_upcase
             map "initialsSeparator", to: :initials_separator
+            map "subsequentSurnameUpcase", to: :subsequent_surname_upcase
+            map "etalCount", to: :etal_count
+            map "editorsMarked", to: :editors_marked
           end
         end
       end

data/lib/relaton/render/version.rb

@@ -1,5 +1,5 @@
 module Relaton
   module Render
-    VERSION = "3.0.0.pre.alpha.12".freeze
+    VERSION = "3.0.0.pre.alpha.14".freeze
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: relaton-render
 version: !ruby/object:Gem::Version
-  version: 3.0.0.pre.alpha.12
+  version: 3.0.0.pre.alpha.14
 platform: ruby
 authors:
 - Ribose Inc.
@@ -121,6 +121,7 @@ files:
 - lib/relaton/render/iso690/element.rb
 - lib/relaton/render/iso690/elements.rb
 - lib/relaton/render/iso690/elements/access.rb
+- lib/relaton/render/iso690/elements/authorizer.rb
 - lib/relaton/render/iso690/elements/citeid.rb
 - lib/relaton/render/iso690/elements/component_part.rb
 - lib/relaton/render/iso690/elements/creator.rb