relaton-render 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 900cfb8e591fbbd83ee48c2dfa762a317a15c590fb89844b3ce7a759125d4f94
+  data.tar.gz: 29c15ba8cfe1e2dcfafc8d6a4d9985ed298c4515d4c734e3505dfcca9cb11189
+SHA512:
+  metadata.gz: ebd7be4d34144997dcee8593266b75eefca1781341b4f081df290a9df64cbb7d665985c1bd0807c1036b190f68d6877b2bf822281bdc6e7c3a332fce349ac612
+  data.tar.gz: 8392d3b4d8c836b74cbf7a05435f55b274f24ae1004b247151481a34d86c104818926f3452c68f776a0adb521e9404b908f0d0fde25494014958bfd2c28005ac

data/.github/workflows/rake.yml

@@ -0,0 +1,15 @@
+# Auto-generated by Cimas: Do not edit it manually!
+# See https://github.com/metanorma/cimas
+name: rake
+
+on:
+  push:
+    branches: [ master, main ]
+    tags: [ v* ]
+  pull_request:
+
+jobs:
+  rake:
+    uses: metanorma/metanorma-build-scripts/.github/workflows/generic-rake.yml@main
+    secrets:
+      pat_token: ${{ secrets.METANORMA_CI_PAT_TOKEN }}

data/.hound.yml

@@ -0,0 +1,5 @@
+# Auto-generated by Cimas: Do not edit it manually!
+# See https://github.com/metanorma/cimas
+ruby:
+  enabled: true
+  config_file: .rubocop.yml

data/.rubocop.yml

@@ -0,0 +1,10 @@
+# Auto-generated by Cimas: Do not edit it manually!
+# See https://github.com/metanorma/cimas
+inherit_from:
+  - https://raw.githubusercontent.com/riboseinc/oss-guides/master/ci/rubocop.yml
+
+# local repo-specific modifications
+# ...
+
+AllCops:
+  TargetRubyVersion: 2.5

data/Gemfile

@@ -0,0 +1,8 @@
+Encoding.default_external = Encoding::UTF_8
+Encoding.default_internal = Encoding::UTF_8
+
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,25 @@
+BSD 2-Clause License
+
+Copyright (c) 2018, Ribose
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.adoc

@@ -0,0 +1,241 @@
+= Relaton Render
+
+image:https://img.shields.io/gem/v/iso690render.svg["Gem Version", link="https://rubygems.org/gems/iso690render"]
+image:https://github.com/metanorma/iso690render/workflows/rake/badge.svg["Build Status", link="https://github.com/metanorma/iso690render/actions?workflow=rake"]
+image:https://codeclimate.com/github/metanorma/iso690render/badges/gpa.svg["Code Climate", link="https://codeclimate.com/github/metanorma/iso690render"]
+
+Gem that takes a https://github.com/relaton/relaton[Relaton] bibliographic description and 
+a configuration, and generates a https://www.metanorma.org[Metanorma] XML rendering of that description.
+
+== Calling
+
+[source,ruby]
+----
+input = "<bibitem type='...'>....</bibitem>"
+
+Relaton::Render::General.new(template: ..., nametemplate: ..., seriestemplate: ..., language: "en", script: "Latn").render(input)
+----
+
+The gem is intended to be inherited from by Metanorma flavours, which may specialise it with their own
+code. The templates are however intended to determine much of the rendering.
+
+Gems can provide their configurations in YAML files, and parse them before passing them to the call to Iso690Render.
+The built-in values for Iso690Render are given in `/lib/iso690render/config.yml`, and can be overridden by
+the parameters of initialising Iso690Render.
+
+The parameters are:
+
+`language`:: in ISO-639
+`script`:: in ISO-15124
+`template`:: templates for rendering different bibliographic types
+`nametemplate`:: templates for rendering personal names
+`seriestemplate`:: template for rendering series
+`journaltemplate`:: template for rendering journals in article citations
+`extenttemplate`:: templates for rendering extents
+`edition_number`:: override formatting of edition number
+`edition`:: override formatting of edition 
+`date`:: default date format (from Twitter CLDR)
+
+== Configuration
+
+=== Templates
+
+There is one template provided for each of the bibliographic types recognised by Relaton (`/bibitem/@type`), and a default template:
+
+Currently supported:
+
+* article 
+* book 
+* booklet 
+* manual 
+* proceedings 
+* presentation 
+* thesis 
+* techreport 
+* standard 
+* unpublished 
+* electronic resource 
+* inbook 
+* incollection 
+* inproceedings 
+* journal 
+* website
+* webresource
+* dataset
+
+Not currently supported:
+
+* map 
+* audiovisual 
+* film 
+* video 
+* broadcast 
+* software 
+* graphic_work 
+* music 
+* performance 
+* patent 
+* archival 
+* social_media 
+* alert 
+* message 
+* conversation 
+* misc (default)
+
+
+In Metanorma, not all types are used, but there are exemplars for all of these given on this site, following
+the human-readable style used in ISO 690. These can be overridden by supplying corresponding paramerers in the call
+to initialise Iso690Render.
+
+Each `template` is a string marked up with https://shopify.github.io/liquid/[Liquid Markup], with the following fields
+drawn from the bibliographic item:
+
+|===
+| Field   | Relaton XPath | Multiple | Can come from host | Note
+
+| title   | ./title | | |
+| edition | ./edition | | Y | If numeric value, is given internationalised rendering of "nth edition", as set in edition_numbering. Otherwise, the textual content of the tag is given.
+| edition_raw | ./edition | | Y | The strict textual content of the tag is given.
+| medium  | ./medium | | Y |
+| place   | ./place | | Y |
+| publisher | ./contributor[role/@type = 'publisher']/organization/name | | Y | 
+| distributor | ./contributor[role/@type = 'distributor']/organization/name | | Y | 
+| standardidentifier | ./docidentifier[not(@type = 'metanorma' or @type = 'ordinal')] | Y | |
+| status | ./status | | | Rendering varies by flavour
+| uri | ./uri[@type = 'doi' or @type = 'uri' or @type = 'src' or true] | | |
+| access_location | ./accessLocation | | Y |
+| extent | ./extent | Y | | Render with standard abbreviations for pp, vols, with n-dash, with delimiting of multiple locations
+| creatornames | ./contributor[role/@type = 'author'] \| ./contributor[role/@type = 'performer'] \| ./contributor[role/@type = 'adapter'] \| ./contributor[role/@type = 'translator'] \| ./contributor[role/@type = 'editor'] \| ./contributor[role/@type = 'publisher'] \| ./contributor[role/@type = 'distributor'] \| ./contributor | Y | | <<nametemplate,`nametemplate`>> applied to each name; joining template from internationalisation applied to multiple names
+| role | ./contributor[role/description] \| ./contributor[role/@type] | | | 
+| date | ./date[@type = 'issued'] \| ./date[@type = 'circulated'] \| ./date | | Y |
+| date_updated | ./date[@type = 'updated'] | | Y | 
+| date_accessed | ./date[@type = 'accessed'] | | Y | 
+| series | ./series[@type = 'main' or not(@type) or true] | | Y | <<seriestemplate,`seriestemplate`>> applies to series
+| host_creatornames | ./relation[@type = 'includedIn']/ bibitem/contributor[role/@type = 'author'] | |  Y | Follows options for `creatornames`
+| host_title | ./relation[@type = 'includedIn']/ bibitem/title | Y | Y | Follows options for `creatornames`
+| host_role | ./relation[@type = 'includedIn']/ bibitem/contributor[role/description] \| ./relation[@type = 'includedIn']/ bibitem/contributor[role/@type] | | Y | 
+| type | ./@type | |
+| labels | | | text to be looked up in internationalisation configuration files: "edition", "In", "At", "Vol", "Vols", "p.", "pp" 
+|===
+
+Many fields are populated either by the description of the bibliographic item itself, or by the description of the item containing it (the _host_ item: `./relation[@type = 'includedIn']/bibitem`). For example, in a paper included in an edited volume, the edition will typically be given for the editor volume, rather than for the paper. Those fields are indicated by "Can come from host" in the table.
+
+The Liquid template surrounds each field by preceding and following punctuation.
+
+* Fields are space-delimited. So `<em>{{ title }}</em> [{{medium}}]` are two separate fields.
+* If fields are not space-delimited, this is indicated by inserting `|`. So `{{ title }}|{{ medium}}` is two fields, rendered with no space separation.
+* If the field is empty, its surrounding markup is also removed. So if there is no medium, then `[{{medium}}]` is not rendered, and the brackets will be stripped.
+* Underscore is treated as space, attaching to the preceding or following field. So `,_{{ edition }}_{{ labels['edition'] }}` is treated as the one field.
+* If punctuation is space delimited, it is inserted regardless of preceding content. So `{{ creatornames }} ({{date}}) .` will insert the full stop whether or not the date is present.
+* Space between punctuation and before punctuation is automatically removed.
+
+For example:
+
+....
+"{{ creatornames }} ({{date}}) . <em>{{ title }}</em> [{{medium}}] ,_{{ edition }}_{{ labels['edition'] }} ."
+....
+
+If a type uses another type's template, the type is mapped to the other type's name; e.g.
+
+....
+template:
+  book: ...
+  booklet:  book
+....
+
+[[nametemplate]]
+=== Name templates
+
+The `nametemplate` is a hash of Liquid templates for the formatting of contributor names in particular positions. It
+draws on the following fields drawn from the bibliographic item:
+
+|===
+| Field  | Relaton XPath | Multiple | Note
+
+| surname[0] | ./contributor[1]/person/name/surname \| ./contributor[1]/person/name/completename \| ./contributor[1]/organization/name | | i.e. surname is the name default
+| surname[1] | ./contributor[2]/name/surname | |
+| surname[2] | ./contributor[3]/name/surname | |
+| initials[0] | ./contributor[1]/name/initial | | If not supplied, the first letter of each given name is used instead
+| initials[1] | ./contributor[2]/name/initial | |
+| given[0] | ./contributor[1]/name/forename[1] | | If not supplied, initials are used instead
+| given[1] |  ./contributor[2]/name/forename[1] | |
+| middle[0] | ./contributor[1]/name/forename[not(first())] | Y |
+| middle[1] | ./contributor[2]/name/forename[not(first())] | Y |
+|===
+
+There are at least three distinct `nametemplate` instances that need to be provided, one for a single contributor (`one:`), one for two contributors (`two:`), one for three or more (`more:`), and optionally one for "et al." (`etal:`). The number of contributors for which "et al." starts being used is indicated by `etal_count`.
+
+For example:
+....
+{
+  one: "{{ surname[0] }}, {{ given[0] }} {{ middle[0] | slice : 0 }}",
+  two: "{{ surname[0] }}, {{ given[0] }} {{ middle[0] | slice : 0 }} &amp; {{ given[1] }} {{ middle[1] | slice : 0 }} {{ surname[1] }}",
+  more: "{{ surname[0] }}, {{ given[0] }} {{ middle[0] | slice : 0 }}, {{ given[1] }} {{ middle[1] | slice : 0 }} {{ surname[1] }} &amp; {{ given[2] }} {{ middle[2] | slice : 0 }} {{ surname[2] }}",
+  etal: "{{ surname[0] }}, {{ given[0] }} {{ middle[0] | slice : 0 }}, {{ given[1] }} {{ middle[1] | slice : 0 }} {{ surname[1] }} <em>et al.</em>",
+  etal_count: 6
+}
+....
+
+In the case of `more`, the `(name)[1]` entries are repeated for all additional authors above 2 and before the final author.
+
+[[seriestemplate]]
+=== Series template
+
+The `seriestemplate` is a template for the rendering of series information. It draws on the following fields drawn from the bibliographic item:
+
+|===
+| Field  | Relaton XPath | Multiple | Can come from host | Note
+
+| series_title  | ./series[@type = 'main' or not(@type) or true]/name | | Y |
+| series_abbr  | ./series[@type = 'main' or not(@type) or true]/abbreviation | | Y |
+| series_num  | ./series[@type = 'main' or not(@type) or true]/number | | Y |
+| series_partnumber  | ./series[@type = 'main' or not(@type) or true]/partnumber | | Y |
+| series_run  | ./series[@type = 'main' or not(@type) or true]/run | | Y |
+|===
+
+For example: `{% if series_abbr %}{{series_abbr}}{% else %}{{series_title}}{% endif %} ,_({{series_run}}) {{series_num}}|({{series_partnumber}})`
+
+=== Journal template
+
+The `journaltemplate` is a template for the rendering of series information, when they relate to articles in a journal. The template is distinct because of longstanding practice of rendering journal information differently from monograph series information. The template draws on the same fields as the `seriestemplate`, but because the journal title is typically italicised and the numeration is not, any italicisation needs to occur within the template.
+
+For example, the recommended practice in the current edition of ISO 690 is to give explicit volume labels:
+
+`<em>{% if series_abbr %}{{series_abbr}}{% else %}{{series_title}}{% endif %}</em> {{ labels['volume'] }}_{{series_num}} {{ labels['part'] }}_{{series_partnumber}}`
+
+A common template that drops those labels is:
+
+`<em>{% if series_abbr %}{{series_abbr}}{% else %}{{series_title}}{% endif %}</em> {{series_num}}|({{series_partnumber}})`
+
+=== Extent template
+
+The extent of a reference can be expressed differently depending on the type of bibliographic item. For example, the extent of a book is its page count, and is typically expressed as something like _59 pp._ On the other hand, the extent of an article is expressed as _pp. 9–20_, or just _9–20_. 
+
+To capture this, a separate template is supplied under `extenttemplate` for each bibliographic item type. For those types where none is supplied, the template given for `misc` is used as the default. 
+
+The template draws on the defined types of locality of extents; the most common of these is `page` and `volume`. Locality types are the fields used in the Liquid templates; for example:
+
+....
+{
+  book: "{{ volume }}_{{ label['extent']['volume'] }}, {{ page }}_{{ label['extent']['page'] }}"
+  inbook: "{{ volume }}: {{ page }}"
+  misc: "{{ label['extent']['volume'] }}_{{ volume }}, {{ label['extent']['page'] }}_{{ page }}"
+}
+....
+
+The internationalisation files define a singular and a plural version of the locality types, under `labels['extent']`
+
+* The plural is always used if the extent is a range (with a `<from>` and `<to>`). 
+* In a host type of bibliographic item, the extent is singular only if the value is `1`, else it is plural (_1 p._, _2 pp._)
+* In an included item (`inbook`, `incollection`, `inproceedings`, `article`, or any item with an `includedIn` relation), 
+the singular is used if the extent is not a range (_pp. 2–4_ vs. _p. 3_)..
+
+=== Other
+
+In addition, the configuration includes different configuration options for rendering:
+
+The internationalisation file sets the following variables, which can be overridden in configuration parameters:
+`edition_number`:: has following values corresponding to the rule-based number rules defined in https://github.com/twitter/twitter-cldr-rb[Twitter CLDR]
+for a language. For example, English _4th_ is defined as `["OrdinalRules", "digits-ordinal"]`, because under twitter-cldr, `4th` is generated as `4.localize(:en).to_rbnf_s("OrdinalRules", "digits-ordinal")`.
+`edition`:: is the localised expression for edition, with the edition number given as %. So _4th ed.` is generated with `edition` as `% ed.`.
+`date`:: date format default, taken from https://github.com/twitter/twitter-cldr-rb[Twitter CLDR]: `to_full_s`, `to_long_s`, `to_medium_s`, `to_short_s`, or one of the `to_additional_s` formats. One value is given for each of "month_year", "day_month_year", and "date_time"; e.g. `{ month_year: to_long_s, day_month_year: to_long_s, date_time: to_long_s }`.

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "cnccs"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/rspec

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+  
+# This file was generated by Bundler.
+#
+# The application 'rspec' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path(
+  "../../Gemfile", Pathname.new(__FILE__).realpath
+)
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rspec-core", "rspec")
+

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/isodoc/i18n.rb

@@ -0,0 +1,24 @@
+require "yaml"
+require "isodoc-i18n"
+
+module IsoDoc
+  class I18n
+    def load_yaml1(lang, script)
+      case lang
+      when "en", "fr", "ru", "de", "es", "ar"
+        load_yaml2(lang)
+      when "zh"
+        if script == "Hans" then load_yaml2("zh-Hans")
+        else load_yaml2("en")
+        end
+      else
+        load_yaml2("en")
+      end
+    end
+
+    def load_yaml2(str)
+      YAML.load_file(File.join(File.dirname(__FILE__),
+                               "../isodoc-yaml/i18n-#{str}.yaml"))
+    end
+  end
+end

data/lib/isodoc-yaml/i18n-ar.yaml

@@ -0,0 +1,2 @@
+in:  في
+at: في

data/lib/isodoc-yaml/i18n-de.yaml

@@ -0,0 +1,2 @@
+in: in
+at: bei

data/lib/isodoc-yaml/i18n-en.yaml

@@ -0,0 +1,22 @@
+in: in
+at: at
+and: and
+updated: updated
+viewed: viewed
+version: version
+date:
+  month_year: to_long_s
+  day_month_year: to_long_s
+  date_time: to_long_s
+edition_number: ["OrdinalRules", "digits-ordinal"]
+edition: "% edition"
+editor:
+  sg: ed.
+  pl: eds.
+extent:
+  page:
+    sg: p.
+    pl: pp.
+  volume:
+    sg: vol.
+    pl: vols.

data/lib/isodoc-yaml/i18n-es.yaml

@@ -0,0 +1,2 @@
+in: en
+at: en

data/lib/isodoc-yaml/i18n-fr.yaml

@@ -0,0 +1,2 @@
+in: dans
+at: à

data/lib/isodoc-yaml/i18n-ru.yaml

@@ -0,0 +1,23 @@
+in: в
+at: в
+and: и
+updated: обновлен
+viewed: просмотрено
+version: версия
+date:
+  month_year: to_long_s
+  day_month_year: to_long_s
+  date_time: to_long_s
+edition_number: ["SpelloutRules", "spellout-ordinal-neuter"]
+edition: "% издание"
+editor:
+  sg: изд.
+  pl: изд.
+extent:
+  page:
+    sg: стр.
+    pl: стр.
+  volume:
+    sg: т.
+    pl: тт.
+

data/lib/isodoc-yaml/i18n-zh-Hans.yaml

@@ -0,0 +1,2 @@
+in: 在
+at: 在

data/lib/parse/parse.rb

@@ -0,0 +1,54 @@
+require "nokogiri"
+require "twitter_cldr"
+require_relative "parse_contributors"
+require_relative "parse_extract"
+
+class Iso690Parse
+  def initialize; end
+
+  def extract(doc)
+    host = doc.at("./relation[@type = 'includedIn']/bibitem")
+    simple_xml2hash(doc).merge(simple_or_host_xml2hash(doc, host))
+      .merge(host_xml2hash(host))
+      .merge(series_xml2hash(doc, host))
+  end
+
+  def simple_xml2hash(doc)
+    creators, role = creatornames(doc)
+    { type: type(doc), title: title(doc), extent_raw: extent(doc),
+      standardidentifier: standardidentifier(doc), uri: uri(doc),
+      status: status(doc), creators: creators, role_raw: role }
+  end
+
+  def simple_or_host_xml2hash(doc, host)
+    { edition_raw: edition(doc, host), medium: medium(doc, host),
+      place: place(doc, host), publisher: publisher(doc, host),
+      distributor: distributor(doc, host),
+      access_location: access_location(doc, host),
+      date: date(doc, host), date_updated: date_updated(doc, host),
+      date_accessed: date_accessed(doc, host) }
+  end
+
+  def host_xml2hash(host)
+    creators, role = creatornames(host)
+    { host_creators: creators, host_role_raw: role, host_title: title(host) }
+  end
+
+  def series_xml2hash(doc, host)
+    series = doc.at("./series[@type = 'main']") ||
+      doc.at("./series[not(@type)]") || doc.at("./series")
+    host and series ||=
+               host.at("./series[@type = 'main']") ||
+               host.at("./series[not(@type)]") || host.at("./series")
+
+    series_xml2hash1(series)
+  end
+
+  def series_xml2hash1(series)
+    return {} unless series
+
+    { series_title: series_title(series), series_abbr: series_abbr(series),
+      series_run: series_run(series), series_num: series_num(series),
+      series_partnumber: series_partnumber(series) }
+  end
+end

data/lib/parse/parse_contributors.rb

@@ -0,0 +1,96 @@
+class Iso690Parse
+  def extract_orgname(org)
+    name = org.at("./name")
+    name&.text
+  end
+
+  def extract_personname(person)
+    surname = person.at("./name/surname") || person.at("./name/completename")
+    given, middle, initials = given_and_middle_name(person)
+    { surname: surname&.text,
+      given: given,
+      middle: middle,
+      initials: initials }
+  end
+
+  def given_and_middle_name(person)
+    forenames = person.xpath("./name/forename")&.map(&:text)
+    initials = person.xpath("./name/initial")&.map(&:text)
+    forenames.empty? and initials.empty? and return [nil, nil, nil]
+    forenames.empty? and forenames = initials.dup
+    initials.empty? and initials = forenames.map { |x| x[0] }
+    [forenames.first, forenames[1..-1], initials]
+  end
+
+  def extractname(contributor)
+    org = contributor.at("./organization")
+    person = contributor.at("./person")
+    return { surname: extract_orgname(org) } if org
+    return extract_personname(person) if person
+
+    nil
+  end
+
+  def contributor_role(contributors)
+    return nil unless contributors.length.positive?
+
+    desc = contributors[0].at("role/description")&.text
+    type = contributors[0].at("role/@type")&.text
+    return nil if %w(author publisher).include?(type) && desc.nil?
+
+    type
+  end
+
+  def creatornames(doc)
+    cr = creatornames1(doc)
+    cr.empty? and return [nil, nil]
+    [cr.map { |x| extractname(x) }, contributor_role(cr)]
+  end
+
+  def creatornames1(doc)
+    cr = []
+    return cr if doc.nil?
+
+    %w(author performer adapter translator editor publisher distributor)
+      .each do |r|
+        add = doc.xpath("./contributor[role/@type = '#{r}']")
+        next if add.empty?
+
+        cr = add and break
+      end
+    cr.empty? and cr = doc.xpath("./contributor")
+    cr
+  end
+
+  def date1(date)
+    on = date.at("./on")
+    from = date.at("./from")
+    to = date.at("./to")
+    return { on: on.text } if on
+    return { from: from.text, to: to&.text } if from
+
+    nil
+  end
+
+  def date(doc, host)
+    x = doc.at("./date[@type = 'issued']") ||
+      doc.at("./date[@type = 'circulated']") ||
+      doc.at("./date") ||
+      host&.at("./date[@type = 'issued']") ||
+      host&.at("./date[@type = 'circulated']") ||
+      host&.at("./date") or return nil
+    date1(x)
+  end
+
+  def date_updated(doc, host)
+    x = doc.at("./date[@type = 'updated']") ||
+      host&.at("./date[@type = 'updated']") or return nil
+    date1(x)
+  end
+
+  def date_accessed(doc, host)
+    x = doc.at("./date[@type = 'accessed']") ||
+      host&.at("./date[@type = 'accessed']") or return nil
+    date1(x)
+  end
+end