metanorma-taste 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 40130f7061043b85b1764af26102db83804e934b656f6af7e83ee0b582e65346
+  data.tar.gz: 0bb630519b80b9f726847b7ca2ba38ce63ce7379f325a61929bddc49b7324a3b
+SHA512:
+  metadata.gz: bf149523ea974279e19331aca8220c2c51c08634981513501811698422da5b3e0ad37b7272d79d0b172f86c8fa86f1716a9e43f57a4e2494cca94de001b5349d
+  data.tar.gz: 57570e155e0f800820488a4974aa5f57fa07c2b85784faa62a64a1c5c17c8478dbfb531fb06248d47576a527947a4e13bcd17a66da0d604392886849ce5b1b13

data/.rspec

@@ -0,0 +1,3 @@
+--require spec_helper
+--format documentation
+--color

data/.rubocop.yml

@@ -0,0 +1,14 @@
+# Auto-generated by Cimas: Do not edit it manually!
+# See https://github.com/metanorma/cimas
+inherit_from:
+  - .rubocop_todo.yml
+  - https://raw.githubusercontent.com/riboseinc/oss-guides/master/ci/rubocop.yml
+
+# local repo-specific modifications
+# ...
+
+AllCops:
+  TargetRubyVersion: 3.1
+
+Lint/MissingSuper:
+  AllowedParentClasses: [Liquid::Drop]

data/.rubocop_todo.yml

@@ -0,0 +1,118 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2025-06-03 11:30:10 UTC using RuboCop version 1.75.8.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 11
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: TreatCommentsAsGroupSeparators, ConsiderPunctuation, Include.
+# Include: **/*.gemspec
+Gemspec/OrderedDependencies:
+  Exclude:
+    - 'metanorma-taste.gemspec'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, IndentationWidth.
+# SupportedStyles: with_first_argument, with_fixed_indentation
+Layout/ArgumentAlignment:
+  Exclude:
+    - 'lib/metanorma/taste_register.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyleAlignWith.
+# SupportedStylesAlignWith: either, start_of_block, start_of_line
+Layout/BlockAlignment:
+  Exclude:
+    - 'spec/metanorma/taste_register_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Layout/BlockEndNewline:
+  Exclude:
+    - 'spec/metanorma/taste_register_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EmptyLineBetweenMethodDefs, EmptyLineBetweenClassDefs, EmptyLineBetweenModuleDefs, DefLikeMacros, AllowAdjacentOneLineDefs, NumberOfEmptyLines.
+Layout/EmptyLineBetweenDefs:
+  Exclude:
+    - 'lib/metanorma/taste/base.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Layout/EmptyLines:
+  Exclude:
+    - 'lib/metanorma/taste/base.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: Width, AllowedPatterns.
+Layout/IndentationWidth:
+  Exclude:
+    - 'spec/metanorma/taste_register_spec.rb'
+
+# Offense count: 10
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: Max, AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, AllowedPatterns, SplitStrings.
+# URISchemes: http, https
+Layout/LineLength:
+  Exclude:
+    - 'lib/metanorma/taste_register.rb'
+    - 'metanorma-taste.gemspec'
+    - 'spec/metanorma/taste_register_spec.rb'
+
+# Offense count: 3
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, IndentationWidth.
+# SupportedStyles: aligned, indented, indented_relative_to_receiver
+Layout/MultilineMethodCallIndentation:
+  Exclude:
+    - 'metanorma-taste.gemspec'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowInHeredoc.
+Layout/TrailingWhitespace:
+  Exclude:
+    - 'lib/metanorma/taste_register.rb'
+
+# Offense count: 3
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+Metrics/MethodLength:
+  Max: 16
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, ProceduralMethods, FunctionalMethods, AllowedMethods, AllowedPatterns, AllowBracesOnProceduralOneLiners, BracesRequiredMethods.
+# SupportedStyles: line_count_based, semantic, braces_for_chaining, always_braces
+# ProceduralMethods: benchmark, bm, bmbm, create, each_with_object, measure, new, realtime, tap, with_object
+# FunctionalMethods: let, let!, subject, watch
+# AllowedMethods: lambda, proc, it
+Style/BlockDelimiters:
+  Exclude:
+    - 'spec/metanorma/taste_register_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Style/MultilineIfModifier:
+  Exclude:
+    - 'lib/metanorma/taste_register.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Style/RedundantFreeze:
+  Exclude:
+    - 'lib/metanorma/taste/version.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyleForMultiline.
+# SupportedStylesForMultiline: comma, consistent_comma, diff_comma, no_comma
+Style/TrailingCommaInHashLiteral:
+  Exclude:
+    - 'lib/metanorma/taste_register.rb'

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,24 @@
+BSD 2-Clause License
+
+Copyright (c) 2025, Metanorma
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. 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,422 @@
+= Metanorma Taste: lightweight customizable Metanorma flavours
+
+image:https://img.shields.io/gem/v/metanorma-taste.svg["Gem Version", link="https://rubygems.org/gems/metanorma-taste"]
+image:https://github.com/metanorma/metanorma-taste/workflows/rake/badge.svg["Build Status", link="https://github.com/metanorma/metanorma-taste/actions?workflow=rake"]
+image:https://img.shields.io/github/issues-pr-raw/metanorma/metanorma-taste.svg["Pull Requests", link="https://github.com/metanorma/metanorma-taste/pulls"]
+image:https://img.shields.io/github/commits-since/metanorma/metanorma-taste/latest.svg["Commits since latest",link="https://github.com/metanorma/metanorma-taste/releases"]
+
+== Metanorma Taste
+
+=== Overview
+
+A **Metanorma Taste** is a lightweight, configuration-only customization of an existing Metanorma flavor.
+
+Unlike a full Metanorma flavor, a taste does not define its own document
+structure, validation rules, or processing logic. Instead, it provides
+organizational branding and content customization on top of a base flavor.
+
+Think of it as "taste" being one aspect of "flavor" in real life -- a taste
+modifies the presentation and branding without changing the fundamental
+characteristics of the underlying flavor.
+
+=== Features
+
+**Configuration-Only**:: Tastes are defined purely through YAML configuration
+files and content assets (copyright notices, i18n dictionaries, stylesheets). No
+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.
+
+**Lightweight customization**:: Tastes can override document attributes, provide
+custom copyright notices, modify presentation styling, and add
+internationalization content.
+
+
+=== Limitations
+
+Since tastes are configuration-only overlays on existing flavors, they have
+important limitations.
+
+**Document structure constraints**:: A taste cannot define document structures
+not allowed by the underlying base flavor. For example, an ISO-based taste
+cannot add document types that ISO doesn't support.
+
+**Validation inheritance**:: All document validation rules from the base flavor
+apply unchanged. This includes:
+
+* ISO/IEC warnings on terms and definitions requirements
+* Provision requirements and numbering rules
+* Document structure validation
+* Metadata requirements
+
+**Processing logic**:: Tastes cannot modify the core document processing,
+rendering, or output generation logic of the base flavor.
+
+**Customization scope**:: Tastes can only customize from document attributes or
+presentation attributes supported by the base flavor.
+
+
+== Installation
+
+The gem is distributed within Metanorma.
+
+
+== Usage
+
+=== Compiling documents
+
+If a taste abbreviation is used instead of a flavor in compiling a Metanorma document, e.g. as the document attribute `:flavor: icc` or
+`:mn-document-class: icc`, this gem is used to process that document as an instance of its base flavor, and will substitute the necessary
+configuration files and document attributes required to get the document to render as expected.
+
+=== Basic usage
+
+[source,ruby]
+----
+require "metanorma-taste"
+
+# Get a registered taste (returns Metanorma::Taste::Icc instance)
+taste = Metanorma::TasteRegister.get(:icc)
+# => Metanorma::Taste::Icc
+
+# Process document attributes and options
+taste.process_input_adoc_overrides(attributes, options)
+----
+
+=== Listing tastes
+
+[source,ruby]
+----
+# List all available tastes
+Metanorma::TasteRegister.instance.available_tastes
+# => [:icc]
+
+# Get information about a specific taste
+Metanorma::TasteRegister.instance.taste_info(:icc)
+# => { flavor: :icc, owner: "International Color Consortium", base_flavor: :iso, ... }
+
+# Get flavor aliases (mapping to base flavours)
+Metanorma::Taste.aliases
+# => { icc: :iso }
+
+# Demonstrate dynamic class creation
+taste = Metanorma::TasteRegister.get(:icc)
+puts taste.class.to_s
+# => "Metanorma::Taste::Icc"
+----
+
+== Official tastes
+
+=== General
+
+Official tastes are maintained by the Metanorma team and provide standardized
+customizations for specific organizations or purposes. They are designed to
+be used with the Metanorma framework and provide consistent branding and
+presentation across documents.
+
+=== Adding official tastes
+
+Official tastes are maintained and version tested by the Metanorma team and are
+not user-configurable.
+
+Official tastes are only available to organizations that have an existing
+relationship with Metanorma. To request a new official taste, please open an
+issue on the Metanorma GitHub repository.
+
+Official tastes are located at the `data/` directory of the metanorma-taste gem.
+
+Each official taste has its own directory with the taste package structure.
+
+See <<creating-a-taste,Creating a taste>> for instructions on how to create a
+taste.
+
+=== Available taste codes
+
+All taste short codes must be unique among tastes. The following tastes are
+currently available:
+
+[cols="a,a,a,a", options="header"]
+|===
+|Code |Organization |Base Flavor |Description
+
+|`icc`
+|International Color Consortium
+|`iso`
+|ICC specifications and standards with ICC branding and copyright
+
+|===
+
+
+== Community tastes
+
+=== General
+
+Community tastes are user-defined Metanorma tastes. They are not maintained by
+the Metanorma team, but are available for use by your own community.
+
+=== Adding community tastes
+
+WARNING: This is to be implemented in a future release.
+
+Community tastes can be hosted on GitHub repositories or distributed as zip
+files.
+
+See <<creating-a-taste,Creating a taste>> for instructions on how to create a
+taste.
+
+== Taste package
+
+=== General
+
+A taste package is a directory structure that contains all the necessary files
+to define a Metanorma taste. It includes configuration files, copyright notices, internationalization dictionaries, and stylesheets if any.
+
+=== Directory structure
+
+Tastes are configured using a directory-based structure under `data/`:
+
+[source]
+----
+data/
+└── {taste-code}/
+    ├── config.yaml
+    ├── copyright.adoc (optional)
+    └── i18n.yaml (optional)
+----
+
+
+=== Configuration schema
+
+==== config.yaml
+
+The main configuration file for each taste:
+
+[source,yaml]
+----
+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")
+copyright-notice: string   # Path to boilerplate file (e.g., "copyright.adoc"), which includes
+                           # copyright, license, legal, and feedback notices
+i18n-dictionary: string    # Path to internationalization dictionary (e.g., "i18n.yaml")
+base-override:             # Hash of document attributes to override from base flavor
+  publisher: string        # Publisher name override
+  publisher_abbr: string   # Publisher abbreviation
+  presentation-metadata-*: # Template style attributes for presentation
+----
+
+.Taste configuration example from ICC
+[example]
+====
+[source,yaml]
+----
+flavor: icc
+owner: International Color Consortium
+base-flavor: iso
+copyright-notice: copyright.adoc
+i18n-dictionary: i18n.yaml
+base-override:
+  publisher: International Color Consortium
+  publisher_abbr: ICC
+  presentation-metadata-color-secondary: '#376795'
+  presentation-metadata-backcover-text: color.org
+----
+====
+
+==== i18n.yaml
+
+Internationalization dictionary for custom text translations:
+
+[source,yaml]
+----
+doctype_dict:             # Document type translations
+  international-standard: string  # Custom name for document types
+  # Add more document type mappings as needed
+----
+
+.i18n.yaml example from ICC
+[example]
+====
+[source,yaml]
+----
+doctype_dict:
+  international-standard: Specification
+----
+====
+
+
+==== copyright.adoc
+
+Organization-specific copyright, legal, license and feedback text. This file can contain:
+
+* Copyright statements with template variables (e.g., `{{ docyear }}`)
+* License information
+* Legal disclaimers
+* Organization contact information
+
+The file is in the Metanorma AsciiDoc format, with the following syntax:
+
+[source,asciidoc]
+----
+== copyright-statement
+...
+----
+
+.Copyright notice from ICC
+[example]
+====
+[source,asciidoc]
+----
+== copyright-statement
+=== Copyright notice
+
+Copyright (c) {{ docyear }} Your Organization Name
+
+[Legal text here...]
+
+== feedback-statement
+=== Contact Information
+
+[Organization contact details...]
+----
+====
+
+The same file format is used internally for Metanorma flavors, and is documented in
+https://www.metanorma.org/develop/topics/metadata-and-boilerplate/[Metadata and predefined text]
+on the metaorma.org site.
+
+=== Base-Override configuration
+
+The `base-override` section allows customization of any document attribute
+supported by the base flavor.
+
+This includes:
+
+Document attributes:
+
+* `publisher`: Organization name
+* `publisher_abbr`: Organization abbreviation
+* `doctype`: Document type mappings
+* Custom organization-specific attributes
+
+Template style attributes:
+
+* `presentation-metadata-*`: Visual styling attributes
+* Color schemes, logos, layout preferences
+* Typography and formatting options
+
+The availability of these attributes depends on the base flavor's supported
+document attributes and template system.
+
+For example, the ISO flavor supports specific presentation metadata attributes.
+
+Other flavors may have different customization options. Please check the base
+flavor documentation for available attributes.
+
+
+== Data model
+
+The metanorma-taste system follows this architecture:
+
+[source]
+----
++------------------+       +-------------------+
+|   TasteRegister  |       |   Taste::Base     |
+|   (Singleton)    |       |                   |
+| +available_tastes|<>---->| +flavor           |
+| +get(flavor)     |       | +config           |
+| +taste_info()    |       | +taste_info       |
++--------+---------+       | +process_input_*  |
+         |                 +-------------------+
+         |
+         | scans
++--------v---------+       +-------------------+
+|   data/ directory|       |   Dynamic Classes |
+|                  |       |                   |
+| +{taste}/        |------>| Taste::Icc        |
+|   config.yaml    |       | Taste::Foo        |
+|   copyright.adoc |       | (auto-generated)  |
+|   i18n.yaml      |       +-------------------+
++------------------+
+----
+
+=== Components
+
+`TasteRegister`:: (Singleton) Manages taste discovery and registration. Scans
+the `data/` directory on initialization and creates a registry of available
+tastes.
+
+`Taste::Base`:: Base class containing the core logic for processing document
+attributes and applying taste-specific overrides.
+
+`Taste::*` dynamic taste classes:: Automatically generated classes (e.g.,
+`Taste::Icc`) that inherit from `Taste::Base` and are configured with
+taste-specific data.
+
+Configuration files:: YAML and AsciiDoc files that define the behavior and
+content for each taste.
+
+
+=== Workflow
+
+. Discovery: On gem load, `TasteRegister` scans `data/` directory for taste configurations
+. Registration: Each valid taste directory is registered with its configuration
+. Access: Users call `TasteRegister.get(:flavor)` to obtain a configured taste instance
+. Processing: The taste instance applies overrides and customizations to document attributes
+. Integration: The customized attributes are used by Metanorma for document processing
+
+
+[[creating-a-taste]]
+== Creating a taste
+
+=== Overview
+
+Creating a new Metanorma taste is straightforward and involves defining a
+configuration directory with the necessary files.
+
+=== Directory structure
+
+To create a new taste:
+
+. Create directory: Add a new directory under `data/` with your unique taste code
+. Add configuration: Create `config.yaml` with your taste settings
+. Add content: Optionally add `copyright.adoc` and `i18n.yaml` files
+. Test: The taste will be automatically discovered and available via the TasteRegister
+
+Example for a new `acme` taste:
+
+[source]
+----
+data/acme/
+├── config.yaml
+├── copyright.adoc
+└── i18n.yaml
+----
+
+The taste will be accessible as:
+
+[source,ruby]
+----
+taste = Metanorma::TasteRegister.get(:acme)
+# Returns an instance of Metanorma::Taste::Acme
+----
+
+=== Taste code
+
+* Must be unique among all tastes
+* Should be short and descriptive (typically 2-5 characters)
+* Must be valid Ruby constant names when capitalized
+* Should reflect the owner organization's name
+
+
+== Copyright
+
+This gem is developed, maintained and funded by
+https://www.ribose.com[Ribose Inc.]
+
+== License
+
+The gem is available as open source under the terms of the
+https://opensource.org/licenses/BSD-2-Clause[2-Clause BSD License].

data/data/elf/config.yaml

@@ -0,0 +1,11 @@
+---
+flavor: elf
+owner: EXPRESS Language Foundation
+base-flavor: iso
+copyright-notice: copyright.adoc
+i18n-dictionary: i18n.yaml
+base-override:
+  publisher: EXPRESS Language Foundation
+  publisher_abbr: ELF
+  presentation-metadata-color-secondary: '#3f65a2'
+  presentation-metadata-backcover-text: expresslang.org

data/data/elf/copyright.adoc

@@ -0,0 +1,26 @@
+== copyright-statement
+=== {blank}
+(c) {{ docyear }} EXPRESS Language Foundation.
+
+All rights reserved. Unless otherwise specified, or required in the context of
+its implementation, no part of this publication may be reproduced or utilized
+otherwise in any form or by any means, electronic or mechanical, including
+photocopying, or posting on the internet or an intranet, without prior written
+permission. Permission can be requested from the EXPRESS Language Foundation.
+
+EXPRESS Language Foundation +
+2093 Philadelphia Pike Ste 3311 +
+Claymont, Delaware 19703 +
+USA
+
+E-mail: link:mailto:info@expresslang.org[info@expresslang.org]
+
+Published in the USA
+
+
+== feedback-statement
+
+=== {blank}
+
+[align=center]
+Don't panic, [css color:#3f65a2]#**EXPRESS**#.

data/data/elf/i18n.yaml

@@ -0,0 +1,2 @@
+doctype_dict:
+  international-standard: Standard

data/data/icc/config.yaml

@@ -0,0 +1,11 @@
+---
+flavor: icc
+owner: International Color Consortium
+base-flavor: iso
+copyright-notice: copyright.adoc
+i18n-dictionary: i18n.yaml
+base-override:
+  publisher: International Color Consortium
+  publisher_abbr: ICC
+  presentation-metadata-color-secondary: '#376795'
+  presentation-metadata-backcover-text: color.org

data/data/icc/copyright.adoc

@@ -0,0 +1,70 @@
+== copyright-statement
+=== Copyright notice
+
+Copyright (c) {{ docyear }} International Color Consortium
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this Specification (the "Specification") to exploit the Specification without
+restriction including, without limitation, the rights to use, copy, modify,
+merge, publish, distribute, and/or sublicense, copies of the Specification, and
+to permit persons to whom the Specification is furnished to do so, subject to
+the following conditions:
+
+Elements of this Specification may be the subject of intellectual property
+rights of third parties throughout the world including, without limitation,
+patents, patent application, utility, models, copyrights, trade secrets or other
+proprietary rights ("Third Party IP Rights"). Although no Third Party IP Rights
+have been brought to the attention of the International Color Consortium (the
+"ICC") by its members, or as a result of the publication of this Specification
+in certain trade journals, the ICC has not conducted any independent
+investigation regarding the existence of Third Party IP Rights. The ICC shall
+not be held responsible for identifying Third Party IP Rights that may be
+implicated by the practice of this Specification or the permissions granted
+above, for conducting inquiries into the applicability, existence, validity, or
+scope of any Third Party IP Rights that are brought to the ICC's attention, or
+for obtaining licensing assurances with respect to any Third Party IP Rights.
+
+THE SPECIFICATION IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS,
+IMPLIED, OR OTHERWISE INCLUDING, BUT NOT LIMITED TO, WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NONINFRINGEMENT, QUIET
+ENJOYMENT, SYSTEM INTEGRATION, AND DATA ACCURACY. IN NO EVENT SHALL THE ICC BE
+LIABLE FOR ANY CLAIM, DAMAGES, LOSSES, EXPENSES OR OTHER LIABILITY, WHETHER IN
+AN ACTION OF CONTRACT, TORT OR OTHERWISE, CAUSED BY, ARISING OR RESULTING FROM,
+OR THAT RELATE TO THE SPECIFICATION OR THE PRACTICE OR OTHER EXPLOITATION OF THE
+SPECIFICATION. FURTHER, YOU HEREBY AGREE TO DEFEND, INDEMNIFY AND HOLD HARMLESS
+THE ICC, AND ITS DIRECTORS AND EMPLOYEES, FROM AND AGAINST ANY AND ALL THIRD
+PARTY CLAIMS, ACTIONS SUITS, DAMAGES, LOSSES, COSTS, EXPENSES, OR OTHER
+LIABILITIES (INCLUDING REASONABLE ATTORNEY'S FEES AND EXPENSES) THAT WERE CAUSED
+BY, ARISE OR RESULT FROM, OR RELATE TO, YOUR PRACTICE OR OTHER EXPLOITATION OF
+THE SPECIFICATION (INCLUDING, WITHOUT LIMITATION, CLAIMS OF INFRINGEMENT).
+
+The above copyright notice, permission, and conditions and disclaimers shall be
+included in all copies of any material portion of the Specification. Except as
+contained in this statement, the name "International Color Consortium" shall not
+be used in advertising or otherwise to promote the use or other dealings in this
+Specification without prior written authorization from the ICC.
+
+=== Licenses and trademarks
+
+International Color Consortium and the ICC logo are registered trademarks of the
+International Color Consortium.
+
+Rather than put a trademark symbol in every occurrence of other trademarked
+names, we state that we are using the names only in an editorial fashion, and to
+the benefit of the trademark owner, with no intention of infringement of the
+trademark.
+
+=== For additional information on the ICC
+
+Visit the ICC Web site: http://www.color.org
+
+
+== feedback-statement
+
+=== {blank}
+
+// [align=center]
+// **International Color Consortium**:
+// Standardizing [css color:blue]#color# fidelity since 1993.
+
+// (c) ICC {{ docyear }} - All rights reserved

data/data/icc/i18n.yaml

@@ -0,0 +1,2 @@
+doctype_dict:
+  international-standard: Specification

data/lib/metanorma/taste/base.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+require "yaml"
+
+module Metanorma
+  module Taste
+    class Base
+      attr_reader :flavor, :config, :taste_info
+
+      def initialize(flavor, taste_info)
+        @flavor = flavor
+        @taste_info = taste_info
+        @config = taste_info[:config]
+      end
+
+      def process_input_adoc_overrides(attrs, options)
+        # Insert after the second element (index 1)
+        # If attrs has fewer than 2 elements, this will handle it appropriately
+        insertion_index = [attrs.length, 2].min
+
+        new_attrs = build_attribute_overrides
+        attrs.insert(insertion_index, *new_attrs) unless new_attrs.empty?
+
+        # Set boilerplate authority if copyright notice exists
+        copyright_file = copyright_notice_path
+        if copyright_file && File.exist?(copyright_file)
+          options[":boilerplate-authority:"] = copyright_file
+        end
+
+        attrs
+      end
+
+      private
+
+      def build_attribute_overrides
+        overrides = []
+
+        # Add copyright notice if available
+        copyright_file = copyright_notice_path
+        if copyright_file && File.exist?(copyright_file)
+          overrides << ":boilerplate-authority: #{copyright_file}"
+        end
+
+        # Add i18n dictionary if available
+        i18n_file = i18n_dictionary_path
+        if i18n_file && File.exist?(i18n_file)
+          overrides << ":i18nyaml: #{i18n_file}"
+        end
+
+        # Add base-override attributes
+        @taste_info[:base_override].each do |key, value|
+          overrides << ":#{key}: #{value}"
+        end
+
+        overrides
+      end
+
+      def copyright_notice_path
+        return nil unless @taste_info[:copyright_notice]
+
+        File.join(@taste_info[:directory], @taste_info[:copyright_notice])
+      end
+
+      def i18n_dictionary_path
+        return nil unless @taste_info[:i18n_dictionary]
+
+        File.join(@taste_info[:directory], @taste_info[:i18n_dictionary])
+      end
+
+      def load_i18n_dictionary
+        i18n_file = i18n_dictionary_path
+        return {} unless i18n_file && File.exist?(i18n_file)
+
+        YAML.load_file(i18n_file)
+      rescue StandardError
+        {}
+      end
+    end
+  end
+end

data/lib/metanorma/taste/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Metanorma
+  module Taste
+    VERSION = "0.0.2"
+  end
+end

data/lib/metanorma/taste.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require_relative "taste/base"
+require_relative "taste_register"
+
+module Metanorma
+  module Taste
+    # Convenience method for aliases
+    def self.aliases
+      TasteRegister.instance.aliases
+    end
+  end
+end
+
+# Initialize the register on load
+Metanorma::TasteRegister.instance

data/lib/metanorma/taste_register.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+require "yaml"
+require "singleton"
+
+module Metanorma
+  class TasteRegister
+    include Singleton
+
+    def initialize
+      @tastes = {}
+      @taste_classes = {}
+      scan_data_directory
+    end
+
+    def self.get(flavor)
+      instance.get(flavor)
+    end
+
+    def get(flavor)
+      flavor_sym = flavor.to_sym
+      return @taste_classes[flavor_sym] if @taste_classes[flavor_sym]
+
+      config = @tastes[flavor_sym]
+      raise "Unknown taste: #{flavor}" unless config
+
+      # Dynamically create and cache the taste class
+      @taste_classes[flavor_sym] = create_taste_class(flavor_sym, config)
+    end
+
+    def available_tastes
+      @tastes.keys
+    end
+
+    def taste_info(flavor)
+      @tastes[flavor.to_sym]
+    end
+
+    def aliases
+      # Build aliases dynamically from registered tastes
+      aliases = {}
+      @tastes.each do |flavor, info|
+        aliases[flavor] = info[:base_flavor] if info[:base_flavor]
+      end
+      aliases
+    end
+
+    private
+
+    def scan_data_directory
+      data_dir = File.join(File.dirname(__FILE__), "..", "..", "data")
+      return unless Dir.exist?(data_dir)
+
+      Dir.entries(data_dir).each do |entry|
+        next if entry.start_with?(".")
+
+        taste_dir = File.join(data_dir, entry)
+        next unless Dir.exist?(taste_dir)
+
+        config_file = File.join(taste_dir, "config.yaml")
+        next unless File.exist?(config_file)
+
+        register_taste(entry, taste_dir, config_file)
+      end
+    end
+
+    def register_taste(directory_name, taste_dir, config_file)
+      config = YAML.load_file(config_file)
+      flavor = config["flavor"]&.to_sym || directory_name.to_sym
+
+      @tastes[flavor] = {
+        flavor: flavor,
+        owner: config["owner"],
+        base_flavor: config["base-flavor"]&.to_sym,
+        directory: taste_dir,
+        config: config,
+        copyright_notice: config["copyright-notice"],
+        i18n_dictionary: config["i18n-dictionary"],
+        base_override: config["base-override"] || {},
+      }
+    end
+
+    def create_taste_class(flavor, config)
+      # Create a dynamic class that inherits from Base
+      taste_class = Class.new(Taste::Base) do
+        define_method :initialize do
+          super(flavor, config)
+        end
+      end
+
+      # Define the class constant dynamically
+      class_name = flavor.to_s.split(/[-_]/).map(&:capitalize).join
+      unless Taste.const_defined?(class_name)
+        Taste.const_set(class_name,
+                        taste_class)
+      end
+
+      taste_class.new
+    end
+  end
+end

data/lib/metanorma-taste.rb

@@ -0,0 +1,2 @@
+require_relative "metanorma/taste"
+require_relative "metanorma/taste/version"

data/metanorma-taste.gemspec

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require_relative "lib/metanorma/taste/version"
+
+all_files_in_git = Dir.chdir(File.expand_path(__dir__)) do
+  `git ls-files -z`.split("\x0")
+end
+
+Gem::Specification.new do |spec|
+  spec.name = "metanorma-taste"
+  spec.version = Metanorma::Taste::VERSION
+  spec.authors = ["Ribose Inc."]
+  spec.email = ["open.source@ribose.com"]
+
+  spec.summary = "Metanorma Taste Library"
+  spec.description = "Library to process and handle default Metanorma Tastes, providing configuration-driven customization of Metanorma flavours."
+  spec.homepage = "https://github.com/metanorma/metanorma-taste"
+  spec.license = "BSD-2-Clause"
+  spec.required_ruby_version = Gem::Requirement.new(">= 3.1.0")
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["bug_tracker_uri"] = "#{spec.homepage}/issues"
+
+  # Specify which files should be added to the gem when it is released.
+  spec.files = all_files_in_git
+    .reject { |f| f.match(%r{\A(?:test|spec|features|bin|\.github)/}) }
+    .reject { |f| f.match(%r{Rakefile|bin/rspec}) }
+    .reject { |f| f.match(%r{flake|\.(?:direnv|pryrc|irbrc|nix)}) }
+
+  spec.extra_rdoc_files = %w[README.adoc LICENSE.txt]
+  spec.bindir = "bin"
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "debug"
+  spec.add_development_dependency "equivalent-xml", "~> 0.6"
+  spec.add_development_dependency "metanorma"
+  spec.add_development_dependency "metanorma-iso"
+  spec.add_development_dependency "mnconvert"
+  spec.add_development_dependency "pry"
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "rspec-command", "~> 1.0"
+  spec.add_development_dependency "rubocop", "~> 1"
+  spec.add_development_dependency "rubocop-performance"
+  spec.add_development_dependency "sassc-embedded", "~> 1"
+  spec.add_development_dependency "simplecov", "~> 0.15"
+  spec.add_development_dependency "xml-c14n"
+end

metadata

@@ -0,0 +1,263 @@
+--- !ruby/object:Gem::Specification
+name: metanorma-taste
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Ribose Inc.
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-06-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: debug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: equivalent-xml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: metanorma
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: metanorma-iso
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mnconvert
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rspec-command
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+- !ruby/object:Gem::Dependency
+  name: rubocop-performance
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sassc-embedded
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.15'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.15'
+- !ruby/object:Gem::Dependency
+  name: xml-c14n
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Library to process and handle default Metanorma Tastes, providing configuration-driven
+  customization of Metanorma flavours.
+email:
+- open.source@ribose.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.adoc
+- LICENSE.txt
+files:
+- ".rspec"
+- ".rubocop.yml"
+- ".rubocop_todo.yml"
+- Gemfile
+- LICENSE.txt
+- README.adoc
+- data/elf/config.yaml
+- data/elf/copyright.adoc
+- data/elf/i18n.yaml
+- data/icc/config.yaml
+- data/icc/copyright.adoc
+- data/icc/i18n.yaml
+- lib/metanorma-taste.rb
+- lib/metanorma/taste.rb
+- lib/metanorma/taste/base.rb
+- lib/metanorma/taste/version.rb
+- lib/metanorma/taste_register.rb
+- metanorma-taste.gemspec
+homepage: https://github.com/metanorma/metanorma-taste
+licenses:
+- BSD-2-Clause
+metadata:
+  homepage_uri: https://github.com/metanorma/metanorma-taste
+  source_code_uri: https://github.com/metanorma/metanorma-taste
+  bug_tracker_uri: https://github.com/metanorma/metanorma-taste/issues
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Metanorma Taste Library
+test_files: []