relaton-render 3.0.0.pre.alpha.24 → 3.0.0.pre.alpha.26

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1f8e1bb4347d4eab41a00189b7040c378c6eaa59631eb52fa0e62de36cce9861
-  data.tar.gz: b6c530258baf6fdf30c70c1f56d17a5c4333fc6f68b6c466e72a18e7cbd7c06d
+  metadata.gz: e2d52f05f42c17071799e1cc19e71d0b84f84a0550430d287e4d8cf4dee389a6
+  data.tar.gz: 4170319d650b7d3de48553d5fcddb15857b24939e9a6e008d7f74c095f849f60
 SHA512:
-  metadata.gz: 45ef9145e49a975775ded3f52bdea26bd429f669adf3a1130524d9b84c60555114f4301a0aac4cb4944bf1126f81b36aa622d2268958e9a6fec357c8b82d4882
-  data.tar.gz: 7d34cfe2fc402a565bb07d530db022cd9e700a6081a96a8bf271fa19193755e8b1f1eaa5deef5767514ffb8c501b801a7da5c7cd128f005ca3e659a5ca7d7ce8
+  metadata.gz: 021e4859ac3ba1f2dda762db881d1322677578359dc0f9a7c319435d7692a36fb6dcc1b96b9b068ca3ed65f9a621648da698962e49d2d2b132adbf5ea2ee66ff
+  data.tar.gz: ad7e119b111cac93e1c70fd0af76431a33dc9e95a5508ca866ab556c7b7e3484e7ae31c1981778f2a86ad6c35ba5ecfdfee9799b2a8c1e21480184f81915bc98

data/README.adoc

@@ -100,3 +100,6 @@ Liquid templates described below for rendering: it is the hash of bibliographic
 
 For the configuation YAML used in relaton-render, refer to https://relaton.org/specs/relaton-render 
 
+== Documentation
+
+* link:docs/citation-style-pack.adoc[Defining a Citation Style: the pack format] — the authoritative spec for CitationStyle YAML packs: resource types, presentation patterns, model presentation templates, locale/punctuation, inheritance and conformance.

data/docs/citation-style-pack.adoc

@@ -0,0 +1,370 @@
+= Defining a Citation Style: the Pack Format
+
+This document is the authoritative authoring specification for a
+CitationStyle pack: the one file that fully describes a citation style.
+It is the contract between three parties — style authors, the rendering
+engine, and the relaton-models citation schema.
+
+Status markers: **[impl]** shipped on this engine line; **[spec]** the
+committed design this engine line converges to (tracked in the
+promotion backlog, section 12).
+
+== 1. The laws
+
+1. **Models are ISO 690.** The relaton-models citation module
+   (`Relaton::Bib::Item` and friends) is the single data substrate for
+   every style. There are no LNCS models, no Chicago models. A
+   bibliographic item is parsed, stored and exchanged once.
+2. **A citation style is one encapsulated data pack.** Everything a
+   style knows lives in the pack: the scheme (name forms, citation
+   system), the locale (labels, punctuation), the presentation
+   templates (citation, reference, per-type patterns), and the
+   presentation-of-models (how each 690 model element presents).
+   Nothing lives in flavor Ruby.
+3. **The pack's field vocabulary is a superset of CSL-JSON.** Every
+   CSL-JSON term has a home; the standards-specific extensions CSL
+   lacks (designations/docids, typed stages, host relations, ordinal
+   editions, bilingual and CJK forms) extend it. The same is true of
+   the logic vocabulary (section 8): it supersets CSL's condition
+   grammar, not a general template engine.
+4. **Engines hold zero styles.** The engine is a generic evaluator of
+   packs. Canonical packs (the ISO 690 default, LNCS, Chicago,
+   IEEE-SA) ship beside the engine while the vocabulary co-evolves and
+   extract to a data repository once it stabilises — the CSL precedent
+   being a separate styles distribution consumed by many processors.
+5. **No Liquid.** The template language is the chunk grammar
+   (section 8): declarative, schema-validated, sandboxed, identical in
+   Ruby and relaton-ts. A fenced `procedural:` escape may exist for
+   experimental packs; canonical styles never reference it.
+
+== 2. The pack file
+
+One YAML document. **[impl]** Loaded and validated by the
+CitationStyle model (`Relaton::Render::Iso690::Style.load` accepts a
+path or a hash; unknown keys are rejected). **[spec]** The model
+itself is owned by relaton-models' citation module; this engine loads
+it, and relaton-ts loads its mirror.
+
+Skeleton — every key, in order:
+
+....
+name: "ISO 690 (metanorma-iso flavour)"
+family: iso690                      # [spec] iso690 | lncs | chicago | ieee-sa
+extends: null                      # [spec] name of a base pack this deltas
+requires:                          # [spec] capability gates this pack needs
+  - extent_group_separator
+
+scheme:
+  system: name-date                # name-date | numeric | designation
+  shortFromReference: true
+  homeDocidType: [ISO, IEC]         # docid types that mark a "home" standard
+  defaultKind: ""                  # kind for types the taxonomy leaves unmapped
+  nameForm:  { ... }               # section 7
+  locale:     { ... }              # section 6
+
+templates:                         # style-wide templates, section 5
+  titleOpen: "_"
+  titleClose: "_"
+  citation: "{{surname}}, {{date}}"
+  reference: "{{creator}}. {{title}}. ..."
+  name: "{{surname}}, {{givenNames}}"
+  series: ""
+  creators: ""
+  uri: "<fmt-link target='{{uri}}'>{{uri}}</fmt-link>"
+  uriShort: ""
+  identifierMode: all              # all | first
+
+types:                             # [spec] section 4: the resource-type taxonomy
+  article-journal: { alias: continuing }
+  standard:      { alias: report }
+
+perType:                           # section 5: the presentation patterns
+  - type: report
+    home: true
+    template: "{{title}}"
+    title: "<span class='stddocTitle'>{{title}}</span>"
+    short: "{{title}}, {{extent}}"
+  - type: monograph
+    noPlace: true
+    fallbacks: { date: "n.d" }
+    template: "{{creator}}{{role}}. {{title}}. ..."
+
+sortKey:                           # index sorting
+  - attribute: creator
+  - attribute: date
+
+rules:                             # [spec] section 9: presentation-of-models
+  identifier: itu                  # named engine rule selections
+  creator: nist_series_publisher
+
+postProcess:                       # [spec] ordered gsub rule chain
+  - pattern: "。+"
+    replace: "。"
+....
+
+== 3. Lifecycle
+
+* **Adopt** — a flavor points its `bibrenderer` at a named canonical
+  pack. Zero code, zero YAML. The target state for new and generic
+  flavors.
+* **Inherit-and-override** — **[spec]** `extends: <pack>` plus a delta.
+  The merge semantics are part of this specification (section 11):
+  `perType`/`types` merge per type key (a delta re-declaring `article`
+  never drops the base's `monograph`); `labels`, `punct`, `fallbacks`
+  and rule selections merge per key; scheme scalars replace. The
+  merge is deterministic and identical in Ruby and TS.
+* **Own pack** — a fully self-contained instance. Last resort; the
+  existing flavor YAMLs are this, and most should collapse into deltas
+  over a canonical base.
+
+**[spec] `requires:`** names engine capabilities, so a resolver fails
+loudly (`pack requires extent_group_separator`) instead of silently
+mis-rendering. Capability names are frozen per engine minor line.
+
+== 4. Info-resource-types
+
+Different information resource types present with different patterns
+in nearly every citation style. The pack's type taxonomy is the axis
+those patterns hang on.
+
+**[impl]** The engine normalises a bibliographic item's wire `type`
+value to an ISO 690 clause-8 resource *kind* through the Kinds table;
+perType entries select on kinds. **[spec]** The taxonomy becomes pack
+data (`types:`), aligned name-for-name with the CSL resource types —
+the same superset law as the fields — with the standards extensions
+CSL lacks.
+
+.Kind taxonomy (ISO 690 clause 8) and its wire-type synonyms [impl]
+[cols="1,3"]
+|===
+|Kind |Wire types
+
+|`monograph` |book, booklet, manual, proceedings, thesis
+|`report` |standard, techreport, report *(the clause 8.11 fallback)*
+|`patent` |patent
+|`continuing` |journal, serial, article-journal, article-magazine
+|`component_part` |inbook, incollection, inproceedings
+|`serial_part` |article
+|`online` |software, unpublished, dataset, webpage, online
+|`webdoc` |website, webresource
+|===
+
+**[spec]** The full recommended taxonomy carries every CSL type
+(`article-journal`, `article-magazine`, `article-newspaper`, `bill`,
+`book`, `broadcast`, `chapter`, `classic`, `collection`, `dataset`,
+`document`, `entry`, `entry-dictionary`, `entry-encyclopedia`,
+`event`, `figure`, `graphic`, `hearing`, `interview`, `legal_case`,
+`legislation`, `manuscript`, `map`, `motion_picture`, `musical_score`,
+`pamphlet`, `paper-conference`, `patent`, `performance`, `periodical`,
+`personal_communication`, `post`, `post-weblog`, `regulation`,
+`report`, `review`, `review-book`, `software`, `song`, `speech`,
+`standard`, `statute`, `thesis`, `treaty`, `webpage`) plus the
+relaton extensions (`techreport`, `inbook`, `incollection`,
+`inproceedings`, `webresource`, `webdoc`, `online`). Rules of the
+taxonomy:
+
+* **Complete, explicit coverage.** Every type resolves to a declared
+  pattern — through an entry, an `alias`, or the declared `fallthrough`
+  (`report`). Nothing inherits silently.
+* **Aliasing is declared**, never engine-hardcoded: `booklet: book`.
+* **Home/external splits sit on top** — for standards-producing
+  bodies, the *same* type carries two patterns, selected by whether
+  the item bears one of `scheme.homeDocidType`'s designations.
+  IEEE-SA's `standard` pattern is *only* designation + title; a
+  Chicago `standard` is cited differently again — same type, different
+  packs, different patterns.
+
+== 5. Presentation patterns (`perType`)
+
+The pattern — not the template — is the unit. A journal-article
+pattern is not a reordered book template; it is its own arrangement
+(quoted title form, italic container, vol/no/pp placement,
+month-abbreviated dates) *plus* its own short cite, fallbacks and
+terminator behaviour. The perType entry carries all of it:
+
+[cols="1,3"]
+|===
+|Field |Meaning
+
+|`type` |the kind (or **[spec]** taxonomy type) this pattern serves
+|`template` |the reference (bibliography entry) arrangement
+|`title`, `series` |per-slot form overrides for this pattern
+|`short` |the short-cite template (falls back to the reference in short mode)
+|`home` |`true` marks the pattern serving items bearing a home docid; two entries of one type split on it
+|`fallbacks` |absent-slot replacement texts, per slot (`date: "n.d"`, `dategroup: "(n.d.)"`)
+|`noPlace` |render the locale's `no_place` label when production lacks a place
+|===
+
+Multiple entries of one `type` resolve: home-flagged variants split by
+the home test; otherwise the first match wins; unmatched kinds fall to
+`templates.reference`.
+
+== 6. Locale, labels and punctuation
+
+**[impl]** Packs overlay the engine language packs (`i18n/<lang>.yml`)
+per language; the pack wins. Adding a language is a new language pack,
+never code.
+
+* `locale.and|others|noDate|noAuthor|in|at|availableAt` — connective
+  strings.
+* `locale.labels` — arbitrary label overrides merged verbatim:
+  `and`, `oxford_comma`, `list_separator`, `series_no`, `no_place`,
+  `available_from`, `ed`/`eds`, `edition_ordinal`/`edition_cardinal`/
+  `version_cardinal` (locale templates, `{{ var1 }}` with the
+  `ordinal_word` filter), extent unit templates (`volume: "vol. %"`,
+  `page: "%頁"` — the `%` carries the value, so a CJK locale places
+  its unit after the number), `extent_group_separator`, month names.
+* `locale.punct` — typographic punctuation: `production_sep`,
+  `production_order` (`publisher_first` for LNCS-style orders),
+  `open-paren`/`close-paren` (ASCII vs fullwidth), `cjk-latin-separator`,
+  `size-join`, `marker-space`.
+* **[spec] `postProcess:`** — the CJK spacing rules that flavors
+  carry as Ruby today become ordered `pattern/replace` rule chains in
+  the pack, so bilingual typography travels with the style.
+
+== 7. Name forms (`scheme.nameForm`) [impl]
+
+Every knob of creator presentation:
+
+[cols="1,3"]
+|===
+|Knob |Effect
+
+|`initials`, `initialsSeparator`, `initialsPeriod` |initials vs given names, "A. B." vs "AB"
+|`invertedAll`, `givenNameFirst` |surname-first for all names / direct order
+|`surnameUpcase`, `subsequentSurnameUpcase`, `subsequentInitials` |caps and second-name forms
+|`completenameUpcase`, `orgUpcase` |verbatim names and organisations
+|`editorsMarked`, `loneEditorMarked`, `rolePlacement` |"(eds.)" markers and their placement
+|`listStyle`, `creatorFallback` |join style; fallback source when no personal creator (OGC: `publisher_abbrev`)
+|`etalCount`, `etalDisplay` |bibliography et-al truncation
+|`inTextEtalCount`, `inTextEtalDisplay` |in-text et-al truncation
+|===
+
+== 8. The template language
+
+**[impl]** Templates are chunk strings: `{{slot}}` fields and literal
+text. The evaluator carries the segment-join semantics — a literal
+renders when it separates two present fields, so absent elements
+swallow their separators; leading and trailing literals drop with
+their fields; parenthetical literals (`({{series}})`, `（{{series}}）`)
+pair as groups that drop whole when the field is absent, balanced on
+the template's literal parens alone; stacked separators collapse;
+trailing terminators apply per style. The short-cite evaluator splits
+after the leading field run at the first-biblio delimiter, which the
+presentation layer turns into the cross-reference capsule.
+
+Slots resolve to the 690 model presentations: `creator`, `title`,
+`edition`, `medium`, `series`, `production`, `date`, `numeration`,
+`component_part`, `identifier`, `location`, `size`, `extent`,
+`access`, `stddoc`, `status`, `citeid`, `authorizer`, `updated`;
+derived fields `role`, `dategroup` (the parenthesised date group),
+`disambiguateddate` (the batch-suffixed date, "2022a"); and the name
+fields (`surname`, `givenNames`, ...).
+
+**[spec]** The logic vocabulary supersets CSL's condition grammar:
+
+* **Conditionals** — `choose`/`if`/`else-if` over `type`, field
+  presence, `home`, and `disambiguated` ( CSL `position`-adjacent ),
+  as declarative blocks inside `perType` entries and templates.
+* **Fallback chains** — `creator: [authors, publisher_abbrev]`:
+  first present source wins, replacing today's single `creatorFallback`
+  knob and OGC's hack.
+* No loops, no arbitrary filters, no string mutation — those are
+  `postProcess` rules or named rules, never template logic.
+
+== 9. Model presentation templates (`rules`) — presentation-of-models
+
+Each 690 model element has a declarative presentation vocabulary; the
+pack selects per-slot rule implementations by name. **[impl]** the
+declarative surface (extent unit `%`-templates, production orders,
+group separators, locale templates, fallbacks); **[spec]** the
+registry: engine implements each named rule once, conformance-tested
+per rule, mirrored in relaton-ts, and addressable as pack data —
+`identifier: itu`, `creator: nist_series_publisher`.
+
+The promotion backlog — every flavor element override still standing
+is a rule to promote:
+
+[cols="2,2"]
+|===
+|Flavor override |Becomes rule
+
+|`ItuIdentifier` |`identifier: itu`
+|`NistIdentifier`, `NistCreator`, `NistDate`, `SerialDate`, `NistSeries`, `NistComponentPart`, `NistPublisher`, `Draft` |the NIST author-year rule set
+|`IeeeIdentifier`, `IeeeComponentPart`, `IeeeAccess`, `IeeeMedium` |the IEEE-SA rule set (designation-first standards)
+|`BipmCreator`, `BipmComponentPart`, `BipmProduction`, `BipmExtent`, `BipmMedium`, `BipmEdition`, `BipmVolume` |the BIPM rule set
+|`IhoEdition`, `IhoCreator` |affiliation-composite creators
+|`JisComponentPart`, `JisSeries`, `JisExtent` |the JIS host-citation rules
+|`BsiStatus` |status presentation
+|===
+
+== 10. Citation forms
+
+**[impl]** The renderings capsule every pack produces (the isodoc
+contract): `author`, `date`, `citation{full, default, short,
+author_date, author_date_br, author, date, reference_tag, title,
+title_reference_tag}`, `formattedref`. `templates.citation` is the
+in-text form; `shortFromReference` takes the reference form with the
+first-biblio marker; batch disambiguation suffixes derive from
+author+date collisions; `identifierMode` governs `default` (first vs
+all designations). **[spec]** `system: numeric | designation` selects
+numeric `[1]`/`[B4]` and designation-led citation systems — the
+IEEE-SA and JIS/BSI homes — as first-class engines, not author-date
+approximations.
+
+== 11. Deltas and the flavor triangle
+
+**[spec]** `extends` resolves base-then-delta at load, on model
+instances (never ad-hoc hash merges):
+
+* `perType`, `types`: merge **per type key** — a delta's `article`
+  entry overlays the base's; the base's other entries survive.
+* `labels`, `punct`, `fallbacks`: per-key merge.
+* `nameForm` knobs, `templates.*`, rule selections: replace — with
+  the caveat that a knob left at its model default counts as unset and
+  inherits (a Lutaml model cannot distinguish an explicit default from
+  an absent key).
+* `sortKey`, `requires`: union.
+
+The forcing test: PLATEAU's four near-copy styles (document-language
+x item-language quadrants) collapse to `extends: jis` plus two
+punct/label deltas. If the merge cannot express that, the merge is
+wrong.
+
+== 12. Validation, versioning, conformance
+
+* **Schema** — the CitationStyle model validates every pack; unknown
+  keys fail at load, not at render. [impl]
+* **`requires:`** — capability gating, frozen names per engine minor
+  line. [spec]
+* **Conformance corpora** — every canonical pack ships a corpus of
+  examples with expected renderings, in the iso690-test tradition:
+  LNCS from Springer's authors' instructions; Chicago from CMOS;
+  IEEE-SA from the Standards Style Manual clause 17 (`[B1] ASME
+  BPVC-I-2004, Title.` designation-only standards; Chicago-derived
+  books/articles with only the first name inverted). CI renders the
+  matrix: every declared type, every pattern, both engine ports.
+* **Portability & safety** — packs are data: they validate, sandbox
+  and render identically server-side (the CF Workers API) and in
+  relaton-ts. No interpreters, no Liquid, no flavor Ruby.
+
+== 13. Authoring walkthrough (LNCS, abridged)
+
+. Declare the pack: `family: lncs`, `extends: null` (canonical),
+  `requires: [production_order, extent_units]`.
+. Name forms: initials without periods, `invertedAll`, direct-order
+  subsequent names, `creatorFallback: [publisher_abbrev]` for
+  standards with no personal authors.
+. Locale: `production_order: publisher_first`, `production_sep: ", "`,
+  year trailing in parentheses (the `dategroup` form).
+. Types and patterns: `paper-conference` ("`{{creator}}: {{title}}.
+  In: {{componentpart}} {{extent}} {{production}} {{dategroup}}.`"),
+  `chapter`, `article-journal`, `book`, `thesis`, `webpage` — one
+  entry each, own `title`/`series` forms, own `short` cites.
+. Rules: `identifier: lncs-series` (LNCS vol./pp. forms).
+. Conformance: the Springer instruction examples become the corpus;
+  the pack merges only when the matrix is green.
+
+The same walk with CMOS examples yields Chicago; with the IEEE-SA
+manual, `family: ieee-sa` — whose `standard` pattern is two fields
+long.

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

@@ -24,8 +24,8 @@ module Relaton
 
         def initialize(style: DEFAULT_STYLE, lang: "en", script: "Latn",
                        labels: {}, elements: {})
-          @elements = elements
           @style = Style.load(style)
+          @elements = Rules.resolve(@style.rules, elements)
           @i18n = I18n.load(lang)
           @i18n.overlay_hash!(labels) unless labels.empty?
           # The style instance is the citation-style authority: its

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

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Relaton
+  module Render
+    module Iso690
+      # The named-rule registry: presentation-of-models implementations
+      # the engine ships once, addressable from pack data as
+      # rules: { slot: rule_name }. Flavors migrate their ELEMENTS maps
+      # onto registered rules; nothing references a flavor class.
+      module Rules
+        REGISTRY = {}
+
+        class << self
+          def register(name, klass)
+            REGISTRY[name.to_s] = klass
+          end
+
+          # A pack's rule selections become the renderer's element map;
+          # caller-supplied elements win over the pack's selections
+          def resolve(rules, elements = {})
+            Array(rules).to_h { |slot, name| [slot.to_sym, fetch(name)] }
+              .merge(elements || {})
+          end
+
+          private
+
+          def fetch(name)
+            REGISTRY.fetch(name.to_s) do
+              raise ArgumentError, "unknown citation style rule #{name}"
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -19,6 +19,21 @@ module Relaton
         autoload :TypeTemplate, "relaton/render/iso690/style/type_template"
 
         attribute :name, :string
+        # The citation-style family the pack belongs to (iso690 | lncs |
+        # chicago | ieee-sa | apa): selects the presentation-of-models
+        # conventions the templates address
+        attribute :family, :string, default: "iso690"
+        # A named pack this one deltas over; resolved at load with the
+        # documented merge semantics (#merge_delta)
+        attribute :extends, :string
+        # Engine capabilities the pack addresses; a resolver that lacks
+        # one fails loudly instead of mis-rendering
+        attribute :requires, :string, collection: true, default: []
+        # Pack-declared taxonomy: wire type -> kind (aliasing or
+        # fallthrough), consulted before the engine's Kinds table
+        attribute :types, :hash, default: -> { {} }
+        # Presentation-of-models selections: slot -> named engine rule
+        attribute :rules, :hash, default: -> { {} }
         attribute :scheme, Scheme, default: -> { Scheme.new }
         attribute :templates, TemplateMap, default: -> { TemplateMap.new }
         attribute :per_type, TypeTemplate, collection: true, default: []
@@ -26,6 +41,11 @@ module Relaton
 
         key_value do
           map "name", to: :name
+          map "family", to: :family
+          map "extends", to: :extends
+          map "requires", to: :requires
+          map "types", to: :types
+          map "rules", to: :rules
           map "scheme", to: :scheme
           map "templates", to: :templates
           map "perType", to: :per_type
@@ -44,6 +64,12 @@ module Relaton
         # the style's declared kind for types the vocabulary does not
         # map (a flavor whose untyped items are not reports)
         def kind_for(type)
+          declared_type = types[type.to_s]
+          unless declared_type.to_s.empty?
+            return Kinds.mapped?(declared_type) ? Kinds.kind_for(declared_type) :
+              declared_type
+          end
+
           return Kinds.kind_for(type) if Kinds.mapped?(type)
 
           declared = scheme.default_kind.to_s
@@ -97,11 +123,88 @@ module Relaton
           )
         end
 
+        # The documented delta merge: perType entries merge per type
+        # key (a delta re-declaring `article` never drops the base's
+        # `monograph`); hash sections merge per key; scalars, templates
+        # and rule selections replace; sortKey and requires union.
+        # Deterministic and engine-portable.
+        def merge_delta(base)
+          merged_per_type = base.per_type.dup
+          per_type.each do |delta|
+            index = merged_per_type.find_index do |b|
+              b.type == delta.type && (b.home || false) == (delta.home || false)
+            end
+            index ? merged_per_type[index] = delta : merged_per_type << delta
+          end
+          self.per_type = merged_per_type
+          self.types = base.types.merge(types)
+          self.rules = base.rules.merge(rules)
+          merge_scheme(base)
+          merge_templates(base)
+          self.sort_key = (base.sort_key + sort_key).uniq
+          self.requires = (base.requires + requires).uniq
+          self
+        end
+
+        private
+
+        def merge_scheme(base)
+          fresh = NameForm.new
+          NameForm.attributes.each_key do |attr|
+            val = scheme.name_form.send(attr)
+            next unless val == fresh.send(attr)
+
+            base_val = base.scheme.name_form.send(attr)
+            scheme.name_form.send("#{attr}=", base_val) if
+              base_val != fresh.send(attr)
+          end
+
+          scheme.system = base.scheme.system if scheme.system.to_s.empty?
+          scheme.short_from_reference = base.scheme.short_from_reference unless
+            scheme.short_from_reference
+          scheme.home_docid_type = base.scheme.home_docid_type if
+            Array(scheme.home_docid_type).empty?
+          scheme.default_kind = base.scheme.default_kind if
+            scheme.default_kind.to_s.empty?
+
+          locale = scheme.locale
+          base_locale = base.scheme.locale
+          locale.conj ||= base_locale.conj
+          locale.others ||= base_locale.others
+          locale.no_date ||= base_locale.no_date
+          locale.no_author ||= base_locale.no_author
+          locale.in_str ||= base_locale.in_str
+          locale.at ||= base_locale.at
+          locale.available_at ||= base_locale.available_at
+          locale.labels.merge!(base_locale.label_map) { |_k, _b, d| d }
+          locale.punct = (base_locale.punct || {}).merge(locale.punct || {})
+        end
+
+        def merge_templates(base)
+          fresh = TemplateMap.new
+          TemplateMap.attributes.each_key do |attr|
+            val = templates.send(attr)
+            base_val = base.templates.send(attr)
+            next unless val == fresh.send(attr) && base_val != fresh.send(attr)
+
+            templates.send("#{attr}=", base_val)
+          end
+        end
+
         class << self
-          def load(name_or_path)
+          def load(name_or_path, seen = [])
             path = style_path(name_or_path) or
               raise ArgumentError, "unknown style #{name_or_path}"
-            from_yaml(File.read(path))
+            style = from_yaml(File.read(path))
+            return style if style.extends.to_s.empty?
+
+            style.extends.split(/\s+/).each do |base_name|
+              raise ArgumentError,
+                    "circular extends #{base_name}" if seen.include?(base_name)
+
+              style.merge_delta(load(base_name, seen + [base_name]))
+            end
+            style
           end
 
           private

data/lib/relaton/render/iso690/styles/apa.yml

@@ -0,0 +1,45 @@
+# American Psychological Association (7th ed.) reference forms: all
+# author names invert with initials ("Author, A. B."), the date
+# follows the authors in parentheses, article titles take no marks
+# (sentence case is the author's), and only book titles and journal
+# names carry italics. The reference list joins with a comma and ampersand.
+name: "APA (7th edition) references"
+family: apa
+scheme:
+  system: name-date
+  nameForm:
+    initials: true
+    initialsSeparator: " "
+    initialsPeriod: true
+    invertedAll: true
+    givenNameFirst: false
+    editorsMarked: false
+    surnameUpcase: false
+    subsequentSurnameUpcase: false
+  locale:
+    "in": "In"
+    labels:
+      "and": "&"
+      oxford_comma: ","
+      oxford_comma: ","
+templates:
+  titleOpen: ""
+  titleClose: ""
+  citation: "{{surname}}, {{date}}"
+  reference: "{{creator}} ({{date}}). {{title}}. {{series}}. {{production}}. {{extent}}"
+  name: "{{surname}}, {{givenNames}}"
+  identifierMode: all
+perType:
+  - type: report
+    home: true
+    template: "{{title}}"
+  - type: report
+    template: "{{identifier}}. {{title}}. {{production}}."
+  - type: monograph
+    title: "<em>{{title}}</em>"
+    template: "{{creator}} ({{date}}). {{title}}. {{production}}."
+  - type: component_part
+    template: "{{creator}} ({{date}}). {{title}}. {{componentpart}} ({{extent}}). {{production}}."
+  - type: continuing
+    series: "<em>{{seriestitle}}, {{serienumber}}</em>"
+    template: "{{creator}} ({{date}}). {{title}}. {{series}} {{extent}}. {{location}}"

data/lib/relaton/render/iso690/styles/chicago.yml

@@ -0,0 +1,48 @@
+# Chicago Manual of Style (17th ed.), bibliography forms: the notes
+# system's reference list. Only the first author name inverts ("Peck,
+# R. B., W. E. Hanson, and T. H. Thornburn"), article titles carry
+# quotation marks, book titles are set in italics, and production runs
+# "Place: Publisher".
+name: "Chicago Manual of Style (bibliography)"
+family: chicago
+requires:
+  - extent_units
+scheme:
+  system: name-date
+  nameForm:
+    initials: false
+    initialsSeparator: " "
+    initialsPeriod: true
+    invertedAll: false
+    givenNameFirst: false
+    editorsMarked: true
+    loneEditorMarked: true
+    surnameUpcase: false
+    subsequentSurnameUpcase: false
+  locale:
+    "in": "in"
+    labels:
+      "and": "and"
+      oxford_comma: ","
+      series_no: "no."
+templates:
+  titleOpen: "\""
+  titleClose: "\""
+  citation: "{{surname}}, {{date}}"
+  reference: "{{creator}}. {{title}}. {{edition}}. {{series}}. {{production}}, {{date}}. {{extent}}."
+  name: "{{surname}}, {{givenNames}}"
+  identifierMode: all
+perType:
+  - type: report
+    home: true
+    template: "{{title}}"
+  - type: report
+    template: "{{creator}}. {{title}}. {{edition}}. {{production}}, {{date}}."
+  - type: monograph
+    title: "<em>{{title}}</em>"
+    template: "{{creator}}. {{title}}. {{edition}}. {{production}}, {{date}}. {{extent}}."
+  - type: component_part
+    template: "{{creator}}. \"{{title}}.\" {{componentpart}}. {{production}}, {{date}}. {{extent}}."
+  - type: continuing
+    series: "<em>{{seriestitle}}</em>"
+    template: "{{creator}}. \"{{title}}.\" {{series}} {{extent}} ({{date}}). {{location}}"