metanorma-taste 1.1.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eca330c6ecac8898e33460d368b0305ee83b2f44f08182a389231122d5970d7b
-  data.tar.gz: d775c3b890c30c6270f3e650a03324900a3b0fadcd4c01ee0fb50d2e5be78e46
+  metadata.gz: 686d4d785e6ed2890e94fb9c12cfaa0c4fbcc37968ed7ebdfc893b2ec7a48b07
+  data.tar.gz: c7016844988a435795d95f1acef03bc189bb258c9e10db6e314e1d9da5246fe1
 SHA512:
-  metadata.gz: db98365c339648ba8c6c36dd693f8d22b3b97a3370768d16677457bbd190462fdc6923813509ea4749d2b60a801a3b3328ee28ca476df1336a4f9e7c1eb52801
-  data.tar.gz: d51259cd69eefc681da4867d946fe075c27bd150201150003d673d5052245fc10bb7fb93d34c874444bd0788ac22cf8e5cbca9151f9c618a2a1fe508cde58b9f
+  metadata.gz: 2d31290947c4efce3b6d095c49697fa6807f14b2b6a8df05e493bae9e54b9ebdbe7d7a306c1ef01aeb322dab63340957d1c58687ccc65927950e3efbad3682a1
+  data.tar.gz: 7842302cc3f83237352fdaf86e07c8fa99c4d3c2dc73bde895d15a03bc18e070f383d4e011f20327851558d60e7bf1b18bc6ff35c67f982c472d392572b75d57

data/README.adoc

@@ -28,7 +28,9 @@ code is required.
 
 **Base flavor dependency**:: Every taste must specify a `base-flavor` (e.g.,
 `iso`, `ietf`, `ieee`) that provides the document structure and validation
-logic.
+logic. A taste may instead inherit from another taste with `base-taste`, in
+which case the parent taste supplies the `base-flavor`; see
+<<taste-inheritance>>.
 
 **Lightweight customization**:: Tastes can override document attributes, provide
 custom copyright notices, modify presentation styling, and add
@@ -189,6 +191,11 @@ currently available:
 |`iso`
 |International Organization of Legal Metrology specifications and standards with OIML branding and copyright
 
+|`oiml-cs`
+|OIML Certification System
+|`oiml` (via `base-taste`)
+|OIML Certification System publications (PD, OD, CID), inheriting the `oiml` taste and overriding only the OIML-CS logo, i18n, publisher and doctypes
+
 |`wmo`
 |World Meteorological Organization
 |`iho`
@@ -250,6 +257,7 @@ The main configuration file for each taste:
 flavor: string             # The name of the custom flavor (e.g., "icc")
 owner: string              # Organization name (e.g., "International Color Consortium")
 base-flavor: string        # Base Metanorma flavor to extend (e.g., "iso")
+base-taste: string         # Optional: another taste to inherit config and assets from (e.g., "oiml"); see Taste inheritance
 base-override:             # Document attributes to override from base flavor
   filename-attributes:     # Metanorma document attributes that contain filenames
     copyright-notice: string   # Path to boilerplate file (e.g., "copyright.adoc")
@@ -372,6 +380,62 @@ committees:
 ----
 ====
 
+[[taste-inheritance]]
+==== Taste inheritance (`base-taste`)
+
+A taste can inherit from another taste by declaring `base-taste` instead of
+`base-flavor`. This keeps related tastes DRY: the child inherits all of the
+parent taste's configuration and content assets, and overrides only the keys
+and files that genuinely differ.
+
+Resolution rules:
+
+* Configuration is merged parent-first, child-wins. Nested mappings (such as
+  `base-override.filename-attributes` and `base-override.value-attributes`) are
+  merged key-by-key; arrays and scalars (such as `doctypes`,
+  `bibliography-sort` and `base-flavor`) are replaced wholesale by the child
+  when it specifies them.
+* Content assets are resolved from the child taste's directory first, then the
+  parent's. A child therefore ships only the assets it overrides and reuses the
+  parent's copyright notice, stylesheets, portfolio pages, and so on.
+* `base-flavor` is inherited from the parent unless the child overrides it, so
+  the child maps to the same underlying Metanorma flavor.
+* Multi-level inheritance chains are supported; cycles and unknown parents are
+  reported as configuration errors.
+
+.The `oiml-cs` taste inherits `oiml`, overriding only its own logo, i18n, publisher and doctypes
+[example]
+====
+[source,yaml]
+----
+flavor: oiml-cs
+owner: OIML Certification System
+base-taste: oiml           # inherit OIML (base-flavor iso, shared XSL, copyright, portfolio, fonts)
+base-override:
+  filename-attributes:
+    i18n-dictionary: i18n.yaml             # OIML-CS-specific
+    publisher-logo: oiml-logo-cs-light.svg # OIML-CS cover logo
+  value-attributes:
+    publisher: OIML Certification System
+    publisher_abbr: OIML-CS
+  bibliography-sort:
+  - abbrev: OIML-CS
+    rank: 1
+    name: International Organization of Legal Metrology
+doctypes:
+- taste: procedural-document
+  base: international-standard
+- taste: operational-document
+  base: international-standard
+- taste: clarification-document
+  base: international-standard
+----
+
+Here `copyright.adoc`, the PDF stylesheet (`oiml.xsl`) and the PDF-portfolio
+page are absent from the `oiml-cs` taste directory: they are inherited from the
+`oiml` taste.
+====
+
 ==== i18n.yaml
 
 Internationalization dictionary for custom text translations: