relaton-render 3.0.0.pre.alpha.8 → 3.0.0.pre.alpha.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 22dc4e39ee6744154270c700e9b80ff7e72e90929b19275e1705b4f0ab898d6b
-  data.tar.gz: 7f3482bab07cbcc5034ed2e282854caa0d87bcfae05a1185558ab1ec787cff78
+  metadata.gz: 1b2cc7ff33eb9f42dda9093ce14cfe39a2495d4499d93150e50783da711e8087
+  data.tar.gz: 8be8a9bea072cd0e69307b5ea8fe3674429e302dd8751f1f399b81a5a154c08f
 SHA512:
-  metadata.gz: 7349c542f2a79dfb2328d9a285ec36feaebfbba45307314dd7524b00e5c7a464c4fe21ff9f12204d9c3e5ca9e739dfd781a0d6fb4c3d43bde70e2c57b6e4c121
-  data.tar.gz: 0c6c6dca299f1870afa8c38b752b4206185441a6315cf7cab2d6ab141b71fc6a4cd4f1e740001556166cab2282db9f8da975c3163fe2f08c1e97c1998e388599
+  metadata.gz: 1101c3d3781e1c51f78728e74a5ea7c3897e2d52407d896057952d6eb0461f7f6dab1344ef7141e0d37bf77348cc203019420e6e4ea9753986746e2261ef344b
+  data.tar.gz: 4be1e8b804b46e08494db403d5bb9100760415af858dc0a96e2d0db30f82cd00d8d53cdd8447a06d434847d6316389b6b3346e7307a5f5630717105b6a3dab06

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

@@ -82,17 +82,24 @@ module Relaton
             ""
           end.reject(&:empty?)
           sep = @style.scheme.name_form.initials_separator.to_s
-          return reinitials(localized(person.name&.formatted_initials),
-                            sep) if parts.empty?
-          return parts.map { |p| "#{p[0]}." }.join(sep) if initials?
+          return reinitials(localized(person.name&.formatted_initials)) if
+            parts.empty?
+          return parts.map(&method(:initial)).join(sep) if initials?
 
           parts.join(" ")
         end
 
         # Declared initials are a list in string form; rejoin them with
         # the style's separator
-        def reinitials(raw, sep)
-          raw.split(/\s+/).reject(&:empty?).join(sep)
+        def reinitials(raw)
+          sep = @style.scheme.name_form.initials_separator.to_s
+          dots = @style.scheme.name_form.initials_period
+          raw.split(/\s+/).reject(&:empty?).map { |i| dots ? i : i.delete(".") }
+            .join(sep)
+        end
+
+        def initial(name)
+          @style.scheme.name_form.initials_period ? "#{name[0]}." : name[0]
         end
 
         def initials?
@@ -100,6 +107,11 @@ module Relaton
         end
 
         def join_names(names)
+          # A style with no join word renders a plain serial list
+          if @i18n.label("and").empty? && names.size > 1
+            return names.join(", ")
+          end
+
           oxford = @i18n.label("oxford_comma")
           if serial_list? && names.size > 1 && !oxford.empty?
             return "#{names[0..-2].join(', ')}#{oxford} " \

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

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Relaton
+  module Render
+    module Iso690
+      module Elements
+        # The cited identifier with the item's status beside it and the
+        # list comma ("OGC 05-020r27 (Draft)," / "ISO 712,"): the comma
+        # stays with the identifier whichever side of the status it
+        # follows
+        class Citeid < Element
+          def present?
+            identifier_element.present?
+          end
+
+          def render
+            text = identifier_element.render
+            stage = status_element.present? ? status_element.render : ""
+            stage.empty? ? "#{text}," : "#{text}#{stage},"
+          end
+
+          private
+
+          def identifier_element
+            @identifier_element ||=
+              Identifier.new(@model, style: @style, i18n: @i18n, kind: @kind,
+                                    short: @short)
+          end
+
+          def status_element
+            @status_element ||=
+              Status.new(@model, style: @style, i18n: @i18n, kind: @kind,
+                                 short: @short)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -11,13 +11,15 @@ module Relaton
         # rendered string.
         class Creator < Element
           def present?
-            !creators.empty?
+            !creators.empty? || !fallback_name.empty?
           end
 
           def render
             return plain_render if @short
 
-            joined = if (form = @style.templates.creators) && !form.empty?
+            joined = if creators.empty?
+                       fallback_name
+                     elsif (form = @style.templates.creators) && !form.empty?
                        ::Relaton::Render::Iso690::Template.new(form).evaluate(
                          "names" => Template::Field[true, join(names)],
                        )
@@ -28,14 +30,14 @@ module Relaton
             when "afterPeriod"
               # the in-slot trailing space separates the (eds.) marker
               # from the next element, which follows directly in the
-              # template; a lone editor is unmarked
-              if editors? && creators.size > 1
+              # template; a lone editor is unmarked unless declared
+              if editors? && marked?
                 "#{period(joined)} (#{role_word}) "
               else
                 "#{period(joined)} "
               end
             else
-              marker = editors? && creators.size > 1 ? " (#{role_word})" : ''
+              marker = editors? && marked? ? " (#{role_word})" : ''
               "#{joined}#{marker}"
             end
           end
@@ -56,6 +58,10 @@ module Relaton
             text.end_with?(".") ? text : "#{text}."
           end
 
+          def marked?
+            creators.size > 1 || name_form.lone_editor_marked
+          end
+
           def role_word
             @i18n.label(creators.one? ? "ed" : "eds")
           end
@@ -87,6 +93,16 @@ module Relaton
             end
           end
 
+          # The declared creator fallback (e.g. the publisher's
+          # abbreviation for standards with no personal creators)
+          def fallback_name
+            return "" unless name_form.creator_fallback == "publisher_abbrev"
+
+            contributors("publisher").map do |c|
+              localized(c.organization&.abbreviation)
+            end.reject(&:empty?).first.to_s
+          end
+
           def names
             creators.each_with_index
               .map do |contributor, index|

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

@@ -13,16 +13,21 @@ module Relaton
             !identifiers.empty?
           end
 
+
           def render
-            identifiers.map { |d| IdentifierKinds.render(d) }
-              .join(@i18n.punct_fetch("identifier_join", ". "))
+            d = identifiers.first or return ""
+
+            IdentifierKinds.render(d)
           end
 
           private
 
+          # Scoped identifiers (anchor, biblio-tag) are pipeline
+          # artefacts, not cited identifiers
           def identifiers
             Array(@model.docidentifier).reject do |d|
-              INTERNAL_TYPES.include?(d.type) || d.content.to_s.strip.empty?
+              INTERNAL_TYPES.include?(d.type) ||
+                !d.scope.to_s.empty? || d.content.to_s.strip.empty?
             end
           end
         end

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

@@ -52,7 +52,8 @@ module Relaton
             end
             # the citation uri outranks the rest (1.x uri extraction)
             preferred = uris.find { |u| u.type == "citation" } ||
-              uris.find { |u| u.type == "attachment" } || uris.first
+              uris.find { |u| u.type == "attachment" } ||
+              uris.find { |u| u.type == "src" } || uris.first
             preferred&.content.to_s
           end
         end

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

@@ -13,10 +13,34 @@ module Relaton
           end
 
           def render
+            if publisher_first?
+              return no_place_production_publisher_first if places.empty? &&
+                no_place_declared?
+
+              return [publishers.join("; "), places.join("; ")]
+                .reject(&:empty?).join(production_sep)
+            end
+
             return no_place_production if places.empty? && no_place_declared?
 
             [places.join("; "), publishers.join("; ")]
-              .reject(&:empty?).join(@i18n.punct_fetch("production_sep", ": "))
+              .reject(&:empty?).join(production_sep)
+          end
+
+          def publisher_first?
+            @i18n.punct_fetch("production_order", "") == "publisher_first"
+          end
+
+          def production_sep
+            @i18n.punct_fetch("production_sep", ": ")
+          end
+
+          def no_place_production_publisher_first
+            label = @i18n.label("no_place")
+            return "" if label.empty? || label == "no_place"
+
+            pubs = publishers.join("; ")
+            pubs.empty? ? label : "#{pubs}, #{label}"
           end
 
           # The no-place placeholder keeps the production separator even

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

@@ -14,7 +14,12 @@ module Relaton
           end
 
           def render
-            range || year&.to_s
+            text = range || year&.to_s
+            return text if (form = @style.templates.date_form).empty?
+
+            ::Relaton::Render::Iso690::Template.new(form).evaluate(
+              "date" => Template::Field[!text.to_s.empty?, text.to_s],
+            )
           end
 
           private

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

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Relaton
+  module Render
+    module Iso690
+      module Elements
+        # The item's status stage, capitalized, parenthesized beside
+        # the identifier ("OGC 05-020r27 (Draft)"); published statuses
+        # are not cited
+        class Status < Element
+          def present?
+            !stage.empty? &&
+              !%w[published retired].include?(stage.downcase)
+          end
+
+          def render
+            " (#{stage})"
+          end
+
+          private
+
+          def stage
+            raw = @model.status&.stage&.content.to_s
+            raw.empty? ? "" : raw.sub(/^\w/) { |c| c.upcase }
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -20,6 +20,8 @@ module Relaton
         autoload :Extent, "relaton/render/iso690/elements/extent"
         autoload :Access, "relaton/render/iso690/elements/access"
         autoload :Stddoc, "relaton/render/iso690/elements/stddoc"
+        autoload :Status, "relaton/render/iso690/elements/status"
+        autoload :Citeid, "relaton/render/iso690/elements/citeid"
 
         CLASSES = {
           creator: Creator,
@@ -37,6 +39,8 @@ module Relaton
           extent: Extent,
           access: Access,
           stddoc: Stddoc,
+          status: Status,
+          citeid: Citeid,
         }.freeze
 
         def self.build(name, model, style:, i18n:, short: false)

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
+          extent access stddoc status citeid
         ].freeze
 
         def initialize(model, style:, i18n:, disambiguator: nil,

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

@@ -33,6 +33,7 @@ module Relaton
         # Style-instance localized strings win over the language pack.
         def overlay!(locale)
           labels.merge!(locale.label_map)
+          punct.merge!(locale.punct || {})
           self
         end
 

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

@@ -17,6 +17,9 @@ module Relaton
           # Arbitrary label overrides (edition words, join punctuation,
           # size units): merged over the language pack verbatim.
           attribute :labels, :hash, default: -> { {} }
+          # Typographic punctuation overrides (production order and
+          # separator), declared as in the language packs
+          attribute :punct, :hash, default: -> { {} }
 
           key_value do
             map "and", to: :conj
@@ -27,6 +30,7 @@ module Relaton
             map "at", to: :at
             map "availableAt", to: :available_at
             map "labels", to: :labels
+            map "punct", to: :punct
           end
 
           LABEL_FOR = {

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

@@ -26,6 +26,13 @@ module Relaton
           # Organization names take the inverted form's casing; small-cap
           # styles keep the declared case
           attribute :org_upcase, :boolean, default: -> { true }
+          # When no personal creator exists, the creator slot falls back
+          # to the publisher's abbreviation ("ISO: ISO 712, ...")
+          attribute :creator_fallback, :string
+          # A lone editor still carries the role marker ("(ed.)")
+          attribute :lone_editor_marked, :boolean, default: -> { false }
+          # Initials without their trailing periods ("Nixon RM")
+          attribute :initials_period, :boolean, default: -> { true }
           # The inverted form's surname casing: the name-date convention
           # upcases; small-cap styles keep the declared case
           attribute :surname_upcase, :boolean, default: -> { true }
@@ -40,6 +47,9 @@ module Relaton
             map "invertedAll", to: :inverted_all
             map "listStyle", to: :list_style
             map "orgUpcase", to: :org_upcase
+            map "creatorFallback", to: :creator_fallback
+            map "loneEditorMarked", to: :lone_editor_marked
+            map "initialsPeriod", to: :initials_period
             map "surnameUpcase", to: :surname_upcase
             map "initialsSeparator", to: :initials_separator
           end

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

@@ -17,6 +17,7 @@ module Relaton
           attribute :uri, :string, default: ""
           attribute :creators, :string, default: ""
           attribute :uri_short, :string, default: ""
+          attribute :date_form, :string, default: ""
 
           key_value do
             map "titleOpen", to: :title_open
@@ -28,6 +29,7 @@ module Relaton
           map "uri", to: :uri
           map "creators", to: :creators
           map "uriShort", to: :uri_short
+          map "dateForm", to: :date_form
           end
         end
       end

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

@@ -85,9 +85,11 @@ module Relaton
         end
 
         def terminate(body)
-          # An element ending in a colon carries its own separator: the
-          # following sentence period collapses (1.x punctuation cleanup)
+          # 1.x punctuation cleanup: an element ending in a colon
+          # carries its own separator (the following sentence period
+          # collapses), and spaces collapse before a comma
           body = body.gsub(/:\s*\.\s*/, ": ")
+          body = body.gsub(/ +/, " ").gsub(" ,", ",")
           return body if @terminator.strip.empty?
           return body if body.rstrip.end_with?(@terminator.strip)
 

data/lib/relaton/render/version.rb

@@ -1,5 +1,5 @@
 module Relaton
   module Render
-    VERSION = "3.0.0.pre.alpha.8".freeze
+    VERSION = "3.0.0.pre.alpha.9".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.8
+  version: 3.0.0.pre.alpha.9
 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/citeid.rb
 - lib/relaton/render/iso690/elements/component_part.rb
 - lib/relaton/render/iso690/elements/creator.rb
 - lib/relaton/render/iso690/elements/edition.rb
@@ -133,6 +134,7 @@ files:
 - lib/relaton/render/iso690/elements/pub_date.rb
 - lib/relaton/render/iso690/elements/series.rb
 - lib/relaton/render/iso690/elements/size.rb
+- lib/relaton/render/iso690/elements/status.rb
 - lib/relaton/render/iso690/elements/stddoc.rb
 - lib/relaton/render/iso690/elements/title.rb
 - lib/relaton/render/iso690/fields.rb