relaton-render 3.0.0.pre.alpha.18 → 3.0.0.pre.alpha.20

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 366d6cbb3430291c42f1c8b836002276120a5f0f8abfc9d3d7a1591b9818d9b9
-  data.tar.gz: 3e785f025a4d72001ba9e496321c78826b8a689b21a71419f76d59c5ae596ec0
+  metadata.gz: f5eb2f65434b6e8671e8050f7c6bab11ebba834e4139563ee32b501cc3a370a4
+  data.tar.gz: 918148498a5f6fbba2d4e45102c49b0625a6ab28dc4826376e9649ceb1101e17
 SHA512:
-  metadata.gz: 659c808e1247309ee2255bd7932aa55d0b43a95996812af583d454225066a5f0e12829b96765da631c370c6baebb9baf9be067655e87e3c9000a8b737b582859
-  data.tar.gz: d920c054fdaf325061155b411a5dc9834f8970c900e658b3d0b5d37d655e1ff8541cc360c3872f8fb8dcac26c6eb2de3428862817eaaba243a118f1ba80ae12a
+  metadata.gz: 7b1cc9b2c76c9397c32cc3cc3a77b2bc5e455d9d7012f503de94e7937c4174006a39391cfd3fe9ea2190682f8c1bf441a5ddfc2d2c1c15c5b973f9b14722b784
+  data.tar.gz: e9ac5313838027bffd9ca98bd2650e067ec4fc5d8bbf1d9dda5b3219b32173afced90b585a4566c8b1fb83b2a337ba4ad94170d4736d21cba1700c97e9364c17

data/lib/relaton/render/general.rb

@@ -32,9 +32,24 @@ module Relaton
         # A flavor names its own CitationStyle instance (name or YAML path)
         options[:style] and renderer_opts[:style] = options[:style]
         @renderer = Iso690::Renderer.new(**renderer_opts)
+        @renderer_opts = renderer_opts
+        @renderers_by_lang = {}
         warn_general_config if options[:config]
       end
 
+      # A collection's items may each declare their own language; the
+      # renderer localizes by language, so a reference renders in its
+      # own language within a document of another (the 1.x plateau
+      # per-reference behaviour)
+      def renderer_for(lang)
+        return @renderer if lang.nil? || lang == @lang
+
+        @renderers_by_lang[lang] ||= Iso690::Renderer.new(
+          **@renderer_opts.merge(lang: lang,
+                                 script: %w(ja ko zh).include?(lang) ? nil : "Latn")
+        )
+      end
+
       def render(model, embedded: false, **opts)
         model = to_model(model)
         text =
@@ -57,15 +72,20 @@ module Relaton
         items = facade_bibitems(bib) or return nil
         disambiguators = date_disambiguators(items)
         items.each_with_object({}).with_index do |(item, m), i|
+          renderer = renderer_for(Array(item.language).first)
           ref = begin
-            @renderer.render(item, disambiguator: disambiguators[item.id])
+            renderer.render(item, disambiguator: disambiguators[item.id])
           rescue ::Relaton::Render::Unrenderable
             next
           end
           m[item.id] = {
             id: item.id, ord: i,
+            author: renderer.in_text_author(item),
             formattedref: terminate_reference(ref, item),
-            citation: citation_renderings(item, ref),
+            citation: citation_renderings(item, ref, renderer,
+                                          type: type,
+                                          disambiguator:
+                                            disambiguators[item.id]),
           }
         end
       end
@@ -116,10 +136,14 @@ module Relaton
         "#{ref}."
       end
 
-      def citation_renderings(item, ref)
-        short = @renderer.citation(item)
+      # The style-keyed capsule ("citation" => { author_date: "..." })
+      # is what isodoc's styled erefs consume (their style attribute
+      # names the key)
+      def citation_renderings(item, ref, renderer, type: "author-date",
+                              disambiguator: nil)
+        short = renderer.citation(item)
         short = if short.empty?
-                  @renderer.render_short(item, FIRST_DELIM)
+                  renderer.render_short(item, FIRST_DELIM)
                 else
                   short
                 end
@@ -128,6 +152,11 @@ module Relaton
           full: ref,
           default: item.docidentifier.first&.content.to_s,
           short: short,
+          author_date: renderer.author_date_citation(
+            item, disambiguator: disambiguator,
+          ),
+          author: renderer.in_text_author(item),
+          title: renderer.title_citation(item),
         }
       end
 

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

@@ -73,14 +73,37 @@ module Relaton
           # 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)
-            raw = surname(person).to_s
-            surname = name_form.surname_upcase ? raw.upcase : raw
-            name = completename(person) || surname || ""
+            return in_text_etal if in_text_etal?
+
+            name = creators.first ? in_text_name(creators.first) : ""
             etal? ? "#{name} <em>et al.</em>" : name
           end
 
+          # The in-text cite truncates at its own threshold: at
+          # inTextEtalCount creators it shows the first
+          # inTextEtalDisplay surnames ("Aluffi <em>et al.</em>")
+          def in_text_etal
+            names = creators.first(name_form.in_text_etal_display)
+              .map { |c| in_text_name(c) }
+            "#{join(names)} <em>et al.</em>"
+          end
+
+          # The in-text cite names by surname alone (the 1.x
+          # authorcitetemplate), never by initials
+          def in_text_name(contributor)
+            person = contributor.person or return org_name(contributor)
+            complete = completename(person)
+            return complete unless complete.nil?
+
+            raw = surname(person).to_s
+            name_form.surname_upcase ? raw.upcase : raw
+          end
+
+          def in_text_etal?
+            count = name_form.in_text_etal_count
+            count.positive? && creators.size >= count
+          end
+
           def etal?
             count = name_form.etal_count
             count.positive? && creators.size >= count

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

@@ -11,6 +11,12 @@ module Relaton
             !main_title.empty?
           end
 
+          # The citation capsule's plain title (the 1.x citetemplate's
+          # "{{ title }}"): the same resolution, no style markers
+          def plain
+            main_title
+          end
+
           def render
             text = main_title
             return text if analytic? && @short

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

@@ -82,6 +82,23 @@ module Relaton
                          elements: @elements).in_text
         end
 
+        # The author-date in-text capsule ("Aluffi <em>et al.</em>
+        # 2022a"): the in-text creator and the disambiguated date
+        def author_date_citation(model, disambiguator: nil)
+          f = Fields.new(model, style: @style, i18n: @i18n,
+                         disambiguator: disambiguator,
+                         elements: @elements).to_h
+          [in_text_author(model), f["disambiguateddate"].text]
+            .reject(&:empty?).join(" ")
+        end
+
+        # The title citation ("{{ title }}" in the 1.x citetemplate):
+        # the title element's plain form, no style markers
+        def title_citation(model)
+          Elements.build(:title, model, style: @style, i18n: @i18n,
+                         elements: @elements).plain
+        end
+
         # The in-text author key (the principal creator's surname, as
         # the citation renders it): the batch disambiguation groups by
         # it

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

@@ -46,6 +46,13 @@ module Relaton
           # first etalDisplay names with "et al." (0 disables)
           attribute :etal_count, :integer, default: 0
           attribute :etal_display, :integer, default: 0
+          # The in-text cite truncates separately from the creator
+          # list: at this many creators it shows the first
+          # inTextEtalDisplay names with "et al." (0 disables; IEEE
+          # cites 3+ as "Aluffi et al." while listing 6 in the
+          # bibliography)
+          attribute :in_text_etal_count, :integer, default: 0
+          attribute :in_text_etal_display, :integer, default: 1
           # Editor lists carry the role marker ("(Eds.)")
           attribute :editors_marked, :boolean, default: -> { true }
 
@@ -65,6 +72,8 @@ module Relaton
             map "subsequentSurnameUpcase", to: :subsequent_surname_upcase
             map "etalCount", to: :etal_count
             map "etalDisplay", to: :etal_display
+            map "inTextEtalCount", to: :in_text_etal_count
+            map "inTextEtalDisplay", to: :in_text_etal_display
             map "editorsMarked", to: :editors_marked
           end
         end

data/lib/relaton/render/iso690/styles/author-date.yml

@@ -9,6 +9,9 @@ scheme:
   nameForm:
     initials: false
     givenNameFirst: false
+    # ISO 690 marks an editor list's role ("(éd.)") also when the list
+    # holds a single editor; flavors opt out per their own style
+    loneEditorMarked: true
 templates:
   titleOpen: "_"
   titleClose: "_"

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

@@ -102,15 +102,25 @@ module Relaton
           end
         end
 
-        # A literal bridges two present elements when at least one
-        # present element stands on each side of it; a leading literal
-        # (no slot precedes it) attaches to the first slot, emitting
-        # only when that slot is present
+        # A literal is the trailing separator of the element that
+        # precedes it: it renders when that element renders and a
+        # later element renders, and it is the FIRST literal of its
+        # gap (the 1.x segment join — absent elements between two
+        # present ones leave the single separator that follows the
+        # earlier present element; an absent slot directly before a
+        # present one, as "{{date}}{{disambiguator}}, {{access}}",
+        # does not swallow it). A leading literal (no slot precedes
+        # it) attaches to the first slot, emitting only when that
+        # slot is present.
         def bridged?(index, present)
           first_slot = @chunks.index { |(kind, _)| kind == :slot }
           return present.include?(first_slot) if index < first_slot
 
-          present.any? { |i| i < index } && present.any? { |i| i > index }
+          left = present.select { |i| i < index }.max
+          left && present.any? { |i| i > index } &&
+            !@chunks[(left + 1)...index].any? do |(kind, _)|
+              kind == :text
+            end
         end
 
         # A template's paired literal ("({{production}})") closes even

data/lib/relaton/render/version.rb

@@ -1,5 +1,5 @@
 module Relaton
   module Render
-    VERSION = "3.0.0.pre.alpha.18".freeze
+    VERSION = "3.0.0.pre.alpha.20".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.18
+  version: 3.0.0.pre.alpha.20
 platform: ruby
 authors:
 - Ribose Inc.