relaton-render 3.0.0.pre.alpha.35 → 3.0.0.pre.alpha.36

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 81c57319ba531b5c63b0adcad897b4abbefac37099990a625993dab5357c7a32
-  data.tar.gz: 1316576d47fdfccd9007c5ef98dfa3d40d0ca4ab5dca8a3de4cc822ebccdb657
+  metadata.gz: 8cc3d3010efcd83bdec9412ff02d171123404ca088993b6eed94b7480fe5e7a9
+  data.tar.gz: 4b88cbd036bdb0a4b4f35d3b5c290656225bb9360236219b0842269ad64cc327
 SHA512:
-  metadata.gz: 36b05f7515bddf6f44a728174a57f365398c0f28aa55b2e3228ea651eadbf0d8c7a7c02ddd70c2b4375b53df83aa13bb896b6be27298e4d8e675a394aeca3d23
-  data.tar.gz: a8d0e79f9349ccd80efb408c04789f791dea1b21e510ab3cfd2ce5cfd65d912ef1a5d6b42047d8ad60cec88c65c0a92e8a3c90981e5bb9739d622837ee02aa1f
+  metadata.gz: 5c397f214df631e40b4352209c4a45deabe77363eb7d1f8ede9f88e4e4245da3a21ae179f139b21a897fab353a5df369b91075314ba0a78955478467e573435e
+  data.tar.gz: 57d5c764a1307b5e620aa28ec875723d88d38b4f1d8e7acb01b9da7e2e4f6463f843ebcba4a30858f9f7bf68f291d02e9cba711eb664283d5ea61c0102a49bdc

data/docs/citation-style-pack.adoc

@@ -292,8 +292,8 @@ is a rule to promote:
 |`ItuIdentifier` |**[impl]** promoted: `identifier: itu_identifier`
 |`NistIdentifier`, `NistCreator`, `NistDate`, `SerialDate`, `NistSeries`, `NistComponentPart`, `NistPublisher`, `Draft` |**[impl]** promoted: `nist_identifier`, `nist_creator`, `nist_date`, `nist_serial_date`, `nist_series`, `nist_component_part`, `nist_publisher`, `nist_draft`
 |`IeeeIdentifier`, `IeeeComponentPart`, `IeeeAccess`, `IeeeMedium` |**[impl]** promoted: `ieee_identifier`, `ieee_component_part`, `ieee_access`, `ieee_medium`
-|`BipmCreator`, `BipmComponentPart`, `BipmProduction`, `BipmExtent`, `BipmMedium`, `BipmEdition`, `BipmVolume` |the BIPM rule set
-|`IhoEdition`, `IhoCreator` |affiliation-composite creators
+|`BipmCreator`, `BipmComponentPart`, `BipmProduction`, `BipmExtent`, `BipmMedium`, `BipmEdition`, `BipmVolume` |**[impl]** promoted: `bipm_creator`, `bipm_component_part`, `bipm_production`, `bipm_extent`, `bipm_medium`, `bipm_edition`, `bipm_volume` (slot `volsize`)
+|`IhoEdition`, `IhoCreator` |**[impl]** promoted: `iho_edition`, `iho_creator` (the %w publisher list could never match the multiword organization name — now a string array)
 |`JisComponentPart`, `JisSeries`, `JisExtent` |the JIS host-citation rules
 |`BsiStatus` |status presentation
 |===

data/lib/relaton/render/iso690/rules/bipm.rb

@@ -0,0 +1,183 @@
+# frozen_string_literal: true
+
+module Relaton
+  module Render
+    module Iso690
+      module Rules
+        # The BIPM rule set, moved verbatim from the metanorma-bipm
+        # flavor's BipmElements: the affiliation-free organization
+        # creator, the bold-volume journal numeration, the
+        # no-place-with-publisher production, the separator-carrying
+        # edition and medium, and the component-part host order.
+        # Select from pack data:
+        #   rules: { creator: bipm_creator, ... }
+        module Bipm
+          # The BIPM component-part order: the host editors before the
+          # host title, the host medium after it, and the production
+          # parenthesized with its own trailing period
+          class BipmComponentPart < Elements::ComponentPart
+            def render
+              h = host or return ""
+              out = +"#{lead}#{host_names(h)} (#{eds_label(h)})"
+              out += " #{host_title}" unless host_title_text.empty?
+              out += medium_text(h)
+              out += production_text(h)
+              out
+            end
+
+            private
+
+            def host_editors(h)
+              Array(h.contributor).select { |c| has_role?(c, "editor") }
+            end
+
+            def eds_label(h)
+              @i18n.label(host_editors(h).one? ? "ed" : "eds")
+            end
+
+            def host_names(h)
+              names = host_editors(h).map { |c|
+                person = c.person or next ""
+
+                [person_surname(person), person_given(person)].reject(&:empty?)
+                  .join(" ")
+              }.reject(&:empty?)
+              join_names(names)
+            end
+
+            def medium_text(h)
+              BipmMedium.new(h, style: @style, i18n: @i18n).render.to_s
+            end
+
+            def production_text(h)
+              production = Elements::Production
+                .new(h, style: @style, i18n: @i18n).render.to_s
+              production.empty? ? "" : " (#{production})."
+            end
+          end
+
+          # The BIPM journal numeration: the volume bold and the issue
+          # in parens, pages unlabelled. Separate extent elements join
+          # with semicolons, localities within one element with spaces
+          class BipmExtent < Elements::Extent
+            def render
+              groups = extent_locality_groups.map { |g| group_text(g) }
+                .reject(&:empty?)
+              groups.join("; ")
+            end
+
+            private
+
+            def extent_locality_groups
+              Array(@model.extent).map do |e|
+                Array(e.locality) +
+                  Array(e.locality_stack).flat_map { |s| Array(s.locality) }
+              end
+            end
+
+            def group_text(localities)
+              volume = plain_locality(localities, "volume")
+              volume = volume.empty? ? "" : "<strong>#{volume}</strong>"
+              issue = plain_locality(localities, "issue")
+              issue = issue.empty? ? "" : "(#{issue})"
+              [volume, issue, page_text(localities)].reject(&:empty?).join(" ")
+            end
+
+            def plain_locality(localities, type)
+              loc = localities.find { |l| l.type == type } or return ""
+              loc.reference_from.to_s
+            end
+
+            def page_text(localities)
+              loc = localities.find { |l| l.type == "page" } or return ""
+              from = loc.reference_from.to_s
+              to = loc.reference_to.to_s
+              text = to.empty? || to == from ? from :
+                "#{from}#{@i18n.label('date_range')}#{to}"
+              return text if item_kind == "serial_part"
+
+              "#{@i18n.label(to.empty? || to == from ? 'page' : 'pages')} #{text}"
+            end
+          end
+
+          # The BIPM production: the no-place placeholder stands only
+          # with a publisher ("(n.p.: Publisher)"); a nameless
+          # publisher drops the production entirely
+          class BipmProduction < Elements::Production
+            private
+
+            def no_place_production
+              return "" if publishers.empty?
+
+              super
+            end
+          end
+
+          # The serial volume, bold, from the size's volume value
+          class BipmVolume < Element
+            def present?
+              !render.empty?
+            end
+
+            def render
+              volume = Array(@model.size&.value).find do |v|
+                !v.is_a?(String) && !v.is_a?(Hash) && v.type == "volume"
+              end or return ""
+
+              "<strong>#{volume.content}</strong>"
+            end
+          end
+
+          # The BIPM medium, verbatim and bracketed with its leading
+          # separator (" [Online]", " [dataset]") — an absent medium
+          # attaches to nothing
+          class BipmMedium < Elements::Medium
+            private
+
+            def medium
+              m = @model.medium or return ""
+              text = m.carrier.to_s
+              text = m.genre.to_s if text.empty?
+              text = [m.form.to_s, m.size.to_s].reject(&:empty?)
+                .join(", ") if text.empty?
+              text.empty? ? "" : " [#{text}]"
+            end
+          end
+
+          # The BIPM edition carries its own leading separator (",
+          # First edition" for monographs, ". Version 2" online), so
+          # its absence drops the separator with it
+          class BipmEdition < Elements::Edition
+            def render
+              text = super.to_s
+              sep = item_kind == "monograph" ? ", " : ". "
+              text.empty? ? "" : "#{sep}#{text}"
+            end
+          end
+
+          # The BIPM organization creator: the name alone, no
+          # abbreviation suffix. Standards without personal creators
+          # cite their publisher's name; monographs cite nothing
+          class BipmCreator < Elements::Creator
+            private
+
+            def org_name(contributor)
+              Array(contributor.organization&.name).map { |n| localized(n) }
+                .join(", ")
+            end
+
+            def fallback_name
+              return "" if %w[monograph continuing component_part]
+                .include?(@style.kind_for(@model.type))
+
+              publishers = contributors("publisher").filter_map do |c|
+                localized(Array(c.organization&.name).first)
+              end
+              publishers.reject(&:empty?).first.to_s
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -106,8 +106,70 @@ module Relaton
           end
         end
 
-        # The NIST rule set lives in its own autoloaded section
+        # The IHO creator cites the affiliation's organization name
+        # after the creator list ("D. Balenson, Internet Engineering
+        # Task Force")
+        class IhoCreator < Elements::Creator
+          def render
+            out = super.to_s
+            aff = affiliation_names
+            out.empty? || aff.empty? ? out : "#{out}, #{aff}"
+          end
+
+          private
+
+          def affiliation_names
+            creators.filter_map do |c|
+              person = c.person or next ""
+
+              Array(person.affiliation).filter_map do |a|
+                Array(a.organization&.name).map(&:content).first.to_s
+              end.reject(&:empty?).first.to_s
+            end.reject(&:empty?).uniq.join(", ")
+          end
+        end
+
+        # The IHO edition cites only for IHO-published documents, as
+        # the raw numeric edition carrying its own label ("edition
+        # 3.1.0"); worded editions ("Revision 1") cite as nothing
+        class IhoEdition < Elements::Edition
+          def render
+            return "" unless iho_publisher?
+
+            text = edition_text
+            text.match?(/\A\d/) ? " edition #{text}" : ""
+          end
+
+          private
+
+          def edition_text
+            raw = @model.edition
+            raw.respond_to?(:content) ? raw.content.to_s : raw.to_s
+          end
+
+          def iho_publisher?
+            Array(@model.contributor).any? do |c|
+              next false unless Array(c.role).any? do |r|
+                r.is_a?(String) ? r == "publisher" : r.type == "publisher"
+              end
+
+              org = c.organization or next false
+              names = Array(org.name).map(&:content) +
+                      [org.abbreviation&.content.to_s]
+              # a string array: %w[] would split the organization's
+              # full name into words and never match it
+              names.any? do |n|
+                ["IHO", "International Hydrographic Organization"]
+                  .include?(n)
+              end
+            end
+          end
+        end
+
+        # The NIST and BIPM rule sets live in their own autoloaded
+        # sections
         autoload :Nist, "relaton/render/iso690/rules/nist"
+        autoload :Bipm, "relaton/render/iso690/rules/bipm"
 
         REGISTRY = {
           "status_bare" => BareStatus,
@@ -124,6 +186,15 @@ module Relaton
           "nist_identifier" => Nist::NistIdentifier,
           "nist_publisher" => Nist::NistPublisher,
           "nist_draft" => Nist::NistDraft,
+          "iho_creator" => IhoCreator,
+          "iho_edition" => IhoEdition,
+          "bipm_creator" => Bipm::BipmCreator,
+          "bipm_component_part" => Bipm::BipmComponentPart,
+          "bipm_production" => Bipm::BipmProduction,
+          "bipm_extent" => Bipm::BipmExtent,
+          "bipm_medium" => Bipm::BipmMedium,
+          "bipm_edition" => Bipm::BipmEdition,
+          "bipm_volume" => Bipm::BipmVolume,
         }.freeze
 
         class << self

data/lib/relaton/render/version.rb

@@ -1,5 +1,5 @@
 module Relaton
   module Render
-    VERSION = "3.0.0.pre.alpha.35".freeze
+    VERSION = "3.0.0.pre.alpha.36".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.35
+  version: 3.0.0.pre.alpha.36
 platform: ruby
 authors:
 - Ribose Inc.
@@ -148,6 +148,7 @@ files:
 - lib/relaton/render/iso690/kinds.rb
 - lib/relaton/render/iso690/renderer.rb
 - lib/relaton/render/iso690/rules.rb
+- lib/relaton/render/iso690/rules/bipm.rb
 - lib/relaton/render/iso690/rules/nist.rb
 - lib/relaton/render/iso690/style.rb
 - lib/relaton/render/iso690/style/locale.rb