metanorma-plugin-lutaml 0.7.37 → 0.7.39

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2322a39b5dc29e981cf64a1c383c7d53aee9e1b132412ea79fc91dfac88485aa
-  data.tar.gz: b1199f54f2e895a3938b1711c1b36184fbb0bc68fd79e56a6bc9acac12979c2e
+  metadata.gz: ad20f1059d6fb886f3b8f8e209a5eb2053bd84cf197b4df0a6f28c32ceb05b76
+  data.tar.gz: ea0e8cdfdc56ada195921fbefff8256f67e702dba4685a001ba22051031bfc74
 SHA512:
-  metadata.gz: a11578fe6890dbf07994ba86d55ae9eee7d7eac605907b0dde761570c48d1871de497418ca1adff80091fdd931b520dcedf68ff1fc20f0cedac1f26bc78062a0
-  data.tar.gz: a7f983789b4b1afd9d4b1b01b1b2546218d1530e9c6ff4cdb8f0ffab0d7f6af83d1f2611fdda609d038c0616dfe1ea50e91b0a61b053000602d3f1685f61a5e1
+  metadata.gz: a72753313c88e6a7bc1388c764fe2f315faf4ff7447690dd5d6a8851f5fe15285d1b53629ff6c79db3ba53ec20e7cdb9d05242e1ef2b5e9fe7b6e69076cedad0
+  data.tar.gz: 98fbf0c36b867aae35acf710853ea74506bfc7835e8ed4368e9acedc84fe9f622f2cc44aae66fabc75bd49c9242487027d94239cec948972cf0e6117941e1ac2

data/.github/workflows/rake.yml

@@ -10,6 +10,10 @@ on:
 
 jobs:
   rake:
-    uses: metanorma/ci/.github/workflows/graphviz-rake.yml@main
+    uses: metanorma/ci/.github/workflows/generic-rake.yml@main
+    with:
+      setup-tools: graphviz
+      submodules: true
+      choco-cache: true
     secrets:
       pat_token: ${{ secrets.METANORMA_CI_PAT_TOKEN }}

data/.gitignore

@@ -5,4 +5,5 @@ test.err
 
 .rubocop-https--*
 .DS_Store
-.vscode
+.vscode
+*.log.txt

data/.rubocop.yml

@@ -1,10 +1,19 @@
 # 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
+  - https://raw.githubusercontent.com/riboseinc/oss-guides/main/ci/rubocop.yml
+  - .rubocop_todo.yml
+
+inherit_mode:
+  merge:
+    - Exclude
 
 # local repo-specific modifications
 # ...
+plugins:
+  - rubocop-rspec
+  - rubocop-performance
+  - rubocop-rake
 
 AllCops:
-  TargetRubyVersion: 2.5
+  TargetRubyVersion: 3.0

data/.rubocop_todo.yml

@@ -0,0 +1,238 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2026-05-12 14:53:16 UTC using RuboCop version 1.86.1.
+# 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: 1
+# This cop supports safe autocorrection (--autocorrect).
+Gemspec/RequireMFA:
+  Exclude:
+    - 'metanorma-plugin-lutaml.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/plugin/lutaml/lutaml_klass_table_block_macro.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Layout/ClosingParenthesisIndentation:
+  Exclude:
+    - 'lib/metanorma/plugin/lutaml/lutaml_ea_xmi_base.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Layout/EmptyLines:
+  Exclude:
+    - 'lib/metanorma/plugin/lutaml/lutaml_ea_xmi_base.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, IndentationWidth.
+# SupportedStyles: consistent, consistent_relative_to_receiver, special_for_inner_method_call, special_for_inner_method_call_in_parentheses
+Layout/FirstArgumentIndentation:
+  Exclude:
+    - 'lib/metanorma/plugin/lutaml/lutaml_ea_xmi_base.rb'
+
+# Offense count: 9
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
+# URISchemes: http, https
+Layout/LineLength:
+  Exclude:
+    - 'Rakefile'
+    - 'lib/metanorma/plugin/lutaml/lutaml_ea_xmi_base.rb'
+    - 'lib/metanorma/plugin/lutaml/lutaml_klass_table_block_macro.rb'
+    - 'lib/metanorma/plugin/lutaml/utils.rb'
+    - 'spec/metanorma/plugin/lutaml/lutaml_uml_datamodel_description_preprocessor_spec.rb'
+    - 'spec/support/shared_examples/structured_data_2_text_preprocessor.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: symmetrical, new_line, same_line
+Layout/MultilineMethodCallBraceLayout:
+  Exclude:
+    - 'lib/metanorma/plugin/lutaml/lutaml_ea_xmi_base.rb'
+
+# Offense count: 3
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowInHeredoc.
+Layout/TrailingWhitespace:
+  Exclude:
+    - 'lib/metanorma/plugin/lutaml/lutaml_ea_xmi_base.rb'
+    - 'lib/metanorma/plugin/lutaml/lutaml_klass_table_block_macro.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowUnusedKeywordArguments, IgnoreEmptyMethods, IgnoreNotImplementedMethods, NotImplementedExceptions.
+# NotImplementedExceptions: NotImplementedError
+Lint/UnusedMethodArgument:
+  Exclude:
+    - 'lib/metanorma/plugin/lutaml/lutaml_ea_xmi_base.rb'
+
+# Offense count: 1
+# Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
+Metrics/AbcSize:
+  Exclude:
+    - 'lib/metanorma/plugin/lutaml/utils.rb'
+
+# Offense count: 2
+# Configuration parameters: AllowedMethods, AllowedPatterns, Max.
+Metrics/CyclomaticComplexity:
+  Exclude:
+    - 'lib/metanorma/plugin/lutaml/lutaml_ea_xmi_base.rb'
+    - 'lib/metanorma/plugin/lutaml/utils.rb'
+
+# Offense count: 3
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+Metrics/MethodLength:
+  Max: 19
+
+# Offense count: 2
+# Configuration parameters: AllowedMethods, AllowedPatterns, Max.
+Metrics/PerceivedComplexity:
+  Exclude:
+    - 'lib/metanorma/plugin/lutaml/lutaml_ea_xmi_base.rb'
+    - 'lib/metanorma/plugin/lutaml/utils.rb'
+
+# Offense count: 1
+# Configuration parameters: MinNameLength, AllowNamesEndingInNumbers, AllowedNames, ForbiddenNames.
+# AllowedNames: as, at, by, cc, db, id, if, in, io, ip, of, on, os, pp, to
+Naming/MethodParameterName:
+  Exclude:
+    - 'lib/metanorma/plugin/lutaml/utils.rb'
+
+# Offense count: 2
+# Configuration parameters: Mode, AllowedMethods, AllowedPatterns, AllowBangMethods, WaywardPredicates.
+# AllowedMethods: call
+# WaywardPredicates: infinite?, nonzero?
+Naming/PredicateMethod:
+  Exclude:
+    - 'lib/metanorma/plugin/lutaml/asciidoctor/preprocessor.rb'
+    - 'lib/metanorma/plugin/lutaml/liquid/custom_filters/file_exist.rb'
+
+# Offense count: 1
+# This cop supports unsafe autocorrection (--autocorrect-all).
+Performance/AncestorsInclude:
+  Exclude:
+    - 'lib/metanorma/plugin/lutaml/utils.rb'
+
+# Offense count: 86
+# Configuration parameters: Prefixes, AllowedPatterns.
+# Prefixes: when, with, without
+RSpec/ContextWording:
+  Exclude:
+    - 'spec/metanorma/plugin/lutaml/lutaml_ea_xmi_preprocessor_spec.rb'
+    - 'spec/metanorma/plugin/lutaml/lutaml_enum_table_block_macro_spec.rb'
+    - 'spec/metanorma/plugin/lutaml/lutaml_gml_dictionary_block_macro_spec.rb'
+    - 'spec/metanorma/plugin/lutaml/lutaml_gml_dictionary_block_spec.rb'
+    - 'spec/metanorma/plugin/lutaml/lutaml_klass_table_block_macro_spec.rb'
+    - 'spec/metanorma/plugin/lutaml/lutaml_text_preprocessor_spec.rb'
+    - 'spec/metanorma/plugin/lutaml/lutaml_uml_datamodel_description_preprocessor_spec.rb'
+    - 'spec/metanorma/plugin/lutaml/lutaml_xmi_index_spec.rb'
+    - 'spec/metanorma/plugin/lutaml/lutaml_xmi_uml_preprocessor_spec.rb'
+    - 'spec/metanorma/plugin/lutaml/macros_data2text_spec.rb'
+    - 'spec/support/shared_examples/structured_data_2_text_preprocessor.rb'
+
+# Offense count: 37
+# Configuration parameters: CountAsOne.
+RSpec/ExampleLength:
+  Max: 26
+
+# Offense count: 13
+# Configuration parameters: Max, AllowedIdentifiers, AllowedPatterns.
+RSpec/IndexedLet:
+  Exclude:
+    - 'spec/metanorma/plugin/lutaml/lutaml_ea_diagram_block_macro_spec.rb'
+    - 'spec/metanorma/plugin/lutaml/lutaml_xmi_index_spec.rb'
+    - 'spec/metanorma/plugin/lutaml/macros_data2text_spec.rb'
+    - 'spec/support/shared_examples/structured_data_2_text_preprocessor.rb'
+
+# Offense count: 4
+# Configuration parameters: AssignmentOnly.
+RSpec/InstanceVariable:
+  Exclude:
+    - 'spec/metanorma/plugin/lutaml/lutaml_express_preprocessor_spec.rb'
+
+# Offense count: 44
+RSpec/LeakyLocalVariable:
+  Exclude:
+    - 'spec/metanorma/plugin/lutaml/lutaml_ea_xmi_preprocessor_spec.rb'
+    - 'spec/metanorma/plugin/lutaml/lutaml_klass_table_block_macro_spec.rb'
+    - 'spec/metanorma/plugin/lutaml/lutaml_uml_datamodel_description_preprocessor_spec.rb'
+    - 'spec/metanorma/plugin/lutaml/lutaml_xmi_index_spec.rb'
+
+# Offense count: 14
+RSpec/MultipleExpectations:
+  Max: 6
+
+# Offense count: 9
+# Configuration parameters: AllowSubject.
+RSpec/MultipleMemoizedHelpers:
+  Max: 8
+
+# Offense count: 41
+# Configuration parameters: EnforcedStyle, IgnoreSharedExamples.
+# SupportedStyles: always, named_only
+RSpec/NamedSubject:
+  Exclude:
+    - 'spec/metanorma/plugin/lutaml/config/root_spec.rb'
+    - 'spec/metanorma/plugin/lutaml/lutaml_ea_xmi_preprocessor_spec.rb'
+    - 'spec/metanorma/plugin/lutaml/lutaml_gml_dictionary_block_macro_spec.rb'
+    - 'spec/metanorma/plugin/lutaml/lutaml_gml_dictionary_block_spec.rb'
+    - 'spec/metanorma/plugin/lutaml/lutaml_uml_datamodel_description_preprocessor_spec.rb'
+    - 'spec/metanorma/plugin/lutaml/lutaml_xmi_index_spec.rb'
+    - 'spec/metanorma/plugin/lutaml/source_extractor_spec.rb'
+
+# Offense count: 117
+# Configuration parameters: AllowedGroups.
+RSpec/NestedGroups:
+  Max: 7
+
+# Offense count: 1
+RSpec/PendingWithoutReason:
+  Exclude:
+    - 'spec/metanorma/plugin/lutaml/lutaml_text_preprocessor_spec.rb'
+
+# Offense count: 2
+RSpec/RepeatedExampleGroupBody:
+  Exclude:
+    - 'spec/metanorma/plugin/lutaml/macros_yaml2text_spec.rb'
+
+# Offense count: 6
+# Configuration parameters: CustomTransform, IgnoreMethods, IgnoreMetadata, InflectorPath, EnforcedInflector.
+# SupportedInflectors: default, active_support
+RSpec/SpecFilePathFormat:
+  Exclude:
+    - 'spec/metanorma/plugin/lutaml/lutaml_express_preprocessor_spec.rb'
+    - 'spec/metanorma/plugin/lutaml/lutaml_text_preprocessor_spec.rb'
+    - 'spec/metanorma/plugin/lutaml/lutaml_xmi_index_spec.rb'
+    - 'spec/metanorma/plugin/lutaml/macros_data2text_spec.rb'
+    - 'spec/metanorma/plugin/lutaml/macros_json2text_spec.rb'
+    - 'spec/metanorma/plugin/lutaml/macros_yaml2text_spec.rb'
+
+# Offense count: 1
+RSpec/SubjectDeclaration:
+  Exclude:
+    - 'spec/metanorma/plugin/lutaml/config/root_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Style/RedundantBegin:
+  Exclude:
+    - 'lib/metanorma/plugin/lutaml/lutaml_ea_xmi_base.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, ConsistentQuotesInMultiline.
+# SupportedStyles: single_quotes, double_quotes
+Style/StringLiterals:
+  Exclude:
+    - 'metanorma-plugin-lutaml.gemspec'

data/CLAUDE.md

@@ -0,0 +1,78 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+`metanorma-plugin-lutaml` is a Ruby gem that provides Asciidoctor extensions for the Metanorma document publishing system. It enables Metanorma documents to embed and render data models from multiple formats: EXPRESS (ISO 10303), LutaML DSL, Enterprise Architect XMI, GML Dictionaries, JSON, and YAML.
+
+## Build and Test Commands
+
+```bash
+# Install dependencies
+bundle install
+
+# Run all tests
+bundle exec rake
+
+# Run a single test file
+bundle exec rspec spec/metanorma/plugin/lutaml/lutaml_preprocessor_spec.rb
+
+# Run a specific test by line number
+bundle exec rspec spec/metanorma/plugin/lutaml/lutaml_preprocessor_spec.rb:42
+
+# Lint
+bundle exec rubocop
+
+# Build the gem
+bundle exec rake build
+```
+
+## Architecture
+
+### Asciidoctor Extension Pattern
+
+All extensions follow the Asciidoctor extension API. The two main extension types are:
+
+- **Preprocessors** (`::Asciidoctor::Extensions::Preprocessor`): Process document text before rendering. They read input lines, detect custom block syntax (e.g., `[lutaml_express, ...]`), and replace them with rendered content via Liquid templates.
+- **Block/BlockMacro/InlineMacro extensions**: Handle `lutaml_diagram`, `lutaml_ea_diagram`, `lutaml_gml_dictionary`, `lutaml_klass_table`, `lutaml_enum_table`, `lutaml_table`, `lutaml_figure` — these are Asciidoctor block-level or inline macros.
+
+### Preprocessor Inheritance Hierarchy
+
+- `LutamlPreprocessor` — handles `[lutaml]`, `[lutaml_express]`, `[lutaml_express_liquid]` blocks. Parses EXPRESS files via the `lutaml`/`expressir` gems, builds Liquid contexts, and renders templates.
+- `LutamlUmlDatamodelDescriptionPreprocessor` and `LutamlEaXmiPreprocessor` — both include `LutamlEaXmiBase`, which handles XMI parsing via `lutaml` gem and renders using bundled Liquid templates.
+- `LutamlXmiUmlPreprocessor` — another XMI-based preprocessor with its own macro regex.
+- `BaseStructuredTextPreprocessor` — base for `[yaml2text]`, `[json2text]`, `[data2text]` blocks. Its subclasses (`Yaml2TextPreprocessor`, `Json2TextPreprocessor`, `Data2TextPreprocessor`) differ only in how they load content (YAML vs JSON vs auto-detect). The `Content` module provides the actual parsing logic.
+
+### Key Shared Modules
+
+- `Utils` (`lib/metanorma/plugin/lutaml/utils.rb`) — shared helpers: file path resolution relative to document, Liquid template rendering with custom environment/filters, EXPRESS repository loading with caching, parsing document-level `:lutaml-express-index:` attributes.
+- `LutamlEaXmiBase` — shared logic for XMI-based preprocessors: XMI document loading/caching, config YAML parsing, package filtering/sorting, Liquid context building, nested macro collection.
+- `LutamlDiagramBase` — shared logic for diagram block extensions: parses LutaML DSL, renders via Graphviz to PNG.
+- `LutamlGmlDictionaryBase` — parses GML XML via `ogc-gml` gem, renders via Liquid.
+- `SourceExtractor` — scans document lines for anchors (`[[id]]`, `[#id]`, `[id=...]`) and `include::`/`embed::` directives, extracting source blocks into `document.attributes["source_blocks"]` for later use by preprocessors.
+
+### Liquid Template System
+
+The plugin uses Liquid templates extensively. Key components:
+
+- **Custom Liquid environment** with registered `keyiterator` tag and custom filters (`html2adoc`, `values`, `replace_regex`, `loadfile`, `file_exist`).
+- **`Liquid::LocalFileSystem`** subclass (`multiply_local_file_system.rb`) resolves includes from multiple paths.
+- **Liquid Drops** (`liquid_drops/`) wrap domain objects (e.g., `GmlDictionaryDrop`) for template rendering.
+- **Bundled templates** live in `lib/metanorma/plugin/lutaml/liquid_templates/` for XMI/EA rendering.
+
+### Config System
+
+The `Config` module (`lib/metanorma/plugin/lutaml/config.rb`) uses `lutaml/model` (LutaML::Model) to define config schemas: `Root`, `Package`, `Guidance`, `GuidanceKlass`, `GuidanceAttribute`. Config YAML files control which packages/entities to render from XMI documents.
+
+### Testing Pattern
+
+Tests use `metanorma-standoc` as the backend. The spec helper registers all extensions with Asciidoctor, then tests call `metanorma_convert(input)` which converts AsciiDoc input through the pipeline and compares XML output. Test fixtures (`.exp`, `.lutaml`, `.xmi`, `.xml`, `.liquid` files) are in `spec/fixtures/lutaml/` and `spec/assets/lutaml/`.
+
+## Key Dependencies
+
+- `lutaml` — core LutaML parser/model library (EXPRESS, UML, XMI formats)
+- `expressir` — EXPRESS schema parser
+- `ogc-gml` — OGC GML dictionary parser
+- `liquid` — template rendering engine
+- `asciidoctor` — document processing framework

data/Gemfile

@@ -12,18 +12,14 @@ rescue StandardError
   nil
 end
 
-gem "byebug"
-gem "debug"
-gem "equivalent-xml"
-gem "metanorma"
-gem "metanorma-standoc", "~> 3.0.8"
 gem "rake", "~> 13"
-gem "rspec", "~> 3.6"
+gem "rspec"
 gem "rspec-html-matchers"
-gem "rubocop", "~> 1.58"
-gem "rubocop-performance", "~> 1.19"
-gem "simplecov", "~> 0.15"
-gem "timecop", "~> 0.9"
-gem "vcr", "~> 6.1.0"
+gem "rubocop"
+gem "rubocop-performance"
+gem "rubocop-rake"
+gem "rubocop-rspec"
+gem "simplecov"
+gem "timecop"
+gem "vcr"
 gem "webmock"
-gem "xml-c14n"

data/Gemfile.devel

@@ -0,0 +1,2 @@
+gem "metanorma-standoc", github: "metanorma/metanorma-standoc", branch: "main"
+gem "metanorma", github: "metanorma/metanorma", branch: "main"

data/Rakefile

@@ -1,6 +1,23 @@
 require "bundler/gem_tasks"
 require "rspec/core/rake_task"
 
+XMI_SPEC_FILES = %w[
+  spec/metanorma/plugin/lutaml/lutaml_ea_xmi_preprocessor_spec.rb
+  spec/metanorma/plugin/lutaml/lutaml_uml_datamodel_description_preprocessor_spec.rb
+  spec/metanorma/plugin/lutaml/lutaml_klass_table_block_macro_spec.rb
+  spec/metanorma/plugin/lutaml/lutaml_enum_table_block_macro_spec.rb
+  spec/metanorma/plugin/lutaml/lutaml_xmi_index_spec.rb
+  spec/metanorma/plugin/lutaml/lutaml_xmi_uml_preprocessor_spec.rb
+].freeze
+
 RSpec::Core::RakeTask.new(:spec)
 
+RSpec::Core::RakeTask.new(:fast) do |t|
+  t.pattern = FileList["spec/**/*_spec.rb"] - XMI_SPEC_FILES
+end
+
+RSpec::Core::RakeTask.new(:xmi) do |t|
+  t.pattern = FileList[XMI_SPEC_FILES]
+end
+
 task default: :spec

data/docs/usages/enterprise_architect.adoc

@@ -184,6 +184,15 @@ The command accepts the options listed below:
   `lib/metanorma/plugin/lutaml/templates`.  This template can be customized by
   changing the template path in the `template` option.
 
+* `external_data="context_name:/path/to/my_data.yml"` specifies the path of
+  the YAML/JSON file of the external data to be used in the liquid template.
+  (Optional)
+  You can specify multiple external data by separating them with `;`.
+  (e.g. `external_data="my_data:/path/to/my_data.yml;second_data:/path/to/my_second_data.yml"`)
+  In the liquid template, you can access the data by using `context_name`.
+  (e.g. `my_data` or `second_data` in the above example)
+  The external data file should be in YAML/JSON format.
+
 * `guidance="/path/to/my_guidance.yml"` specifies the path of
   the yaml file of the guidance. (Optional)
 
@@ -240,6 +249,14 @@ The command accepts the options listed below:
   `lib/metanorma/plugin/lutaml/templates`.  This template can be customized by
   changing the template path in the `template` option.
 
+* `external_data="context_name:/path/to/my_data.yml"` specifies the path of
+  the YAML/JSON file of the external data to be used in the liquid template.
+  (Optional)
+  You can specify multiple external data by separating them with `;`.
+  (e.g. `external_data="my_data:/path/to/my_data.yml;second_data:/path/to/my_second_data.yml"`)
+  In the liquid template, you can access the data by using `context_name`.
+  (e.g. `my_data` or `second_data` in the above example)
+  The external data file should be in YAML/JSON format.
 
 === Usage of `lutaml_ea_xmi` command
 

data/docs/usages/express.adoc

@@ -297,3 +297,58 @@ from the paths other than the location of the document.
 The resulting block adds the `include_path` to the Liquid renderer.  The path is
 resolved based on the location of the document.  You can add multiple paths by
 separating them with commas.
+
+=== Using `loadfile` filter in templates
+
+This functionality allows `[lutaml_express_liquid]` blocks to load data from
+a yaml or json file from the specified path.
+
+For example, you have the Metanorma document file (.adoc) with the following
+content:
+
+[source,adoc]
+-----
+:lutaml-express-index: all_schemas; ../schemas_all.yaml;
+
+[lutaml_express_liquid,all_schemas,context,config_yaml=schemas.yaml,include_path=../templates]
+---
+{% assign all_schemas = repo.schemas  %}
+{% render "templates/resources/schema" for ordered_schemas as schema %}
+...
+----
+-----
+
+You have the liquid template file
+`templates/resources/schema.liquid` with the following content:
+
+[source,liquid]
+-----
+{% assign data = "my_file.yaml" | loadfile: "." %}
+This is {{ data.shape }} with color {{ data.color }}.
+-----
+
+Where:
+
+* `loadfile:` is a liquid filter that loads the file content based on the path
+  `my_file.yaml` with argument `.`.
+  The argument is the path of the parent folder, which is the
+  current directory of the Metanorma document.
+
+And the content of the yaml file `my_file.yaml` looks like:
+
+[source,yaml]
+----
+---
+shape: square
+color: blue
+corners: 4
+----
+
+Will render as:
+[source,asciidoc]
+----
+...
+This is square with color blue.
+...
+----
+

data/lib/metanorma/plugin/lutaml/base_structured_text_preprocessor.rb

@@ -15,9 +15,9 @@ module Metanorma
         ::Asciidoctor::Extensions::Preprocessor
         include Utils
 
-        BLOCK_START_REGEXP = /\{(.+?)\.\*,(.+),(.+)\}/.freeze
-        BLOCK_END_REGEXP = /\A\{[A-Z]+\}\z/.freeze
-        LOAD_FILE_REGEXP = /{% assign (.*) = (.*) \| load_file %}/.freeze
+        BLOCK_START_REGEXP = /\{(.+?)\.\*,(.+),(.+)\}/
+        BLOCK_END_REGEXP = /\A\{[A-Z]+\}\z/
+        LOAD_FILE_REGEXP = /{% assign (.*) = (.*) \| load_file %}/
         INCLUDE_PATH_OPTION = "include_path"
         TEMPLATE_OPTION = "template"
 
@@ -63,7 +63,7 @@ module Metanorma
               load_file_match = block_line.match(LOAD_FILE_REGEXP)
 
               # Add parent folder as argument to loadfile filter
-              block_line = "{% assign #{load_file_match[1]} = "\
+              block_line = "{% assign #{load_file_match[1]} = " \
                            "#{load_file_match[2]} | loadfile: " \
                            "\"#{document.attributes['docdir']}\" %}"
             end
@@ -106,7 +106,7 @@ module Metanorma
                          )
                        multiple_contexts
                      elsif block_match[1].start_with?("#")
-                       anchor = block_match[1].split(",").first.strip[1..-1]
+                       anchor = block_match[1].split(",").first.strip[1..]
                        {
                          block_match[1].split(",").last.strip =>
                            content_from_anchor(document, anchor),
@@ -153,7 +153,7 @@ module Metanorma
           end
           line
             .gsub(/(?<!{){(?!%)([^{}]{1,900})(?<!%)}(?!})/, '{{\1}}')
-            .gsub(/[a-z\.]{1,900}\#/, "index")
+            .gsub(/[a-z.]{1,900}\#/, "index")
             .gsub(/{{([^}]{1,900})\s+\+\s+(\d+)\s*?}}/, '{{ \1 | plus: \2 }}')
             .gsub(/{{([^}]{1,900})\s+-\s+(\d+)\s*?}}/, '{{ \1 | minus: \2 }}')
             .gsub(/{{([^}]{1,500})\.values([^}]{0,500})}}/,

data/lib/metanorma/plugin/lutaml/data2_text_preprocessor.rb

@@ -8,6 +8,7 @@ module Metanorma
     module Lutaml
       class Data2TextPreprocessor < BaseStructuredTextPreprocessor
         include Content
+
         # search document for block `data2text`
         #   after that take template from block and read file into this template
         #   example:

data/lib/metanorma/plugin/lutaml/express_remarks_decorator.rb

@@ -9,14 +9,14 @@ module Metanorma
           (link|image|video|audio|include) # Capture group 1: content type
           (:+)?                            # Capture group 2: optional colons
           (?!                              # Negative lookahead
-            [^\/:]+://|                    # Don't match URLs (http://, etc.)
+            [^/:]+://|                     # Don't match URLs (http://, etc.)
             [A-Z]:/|                       # Don't match Windows paths
             /                              # Don't match absolute paths
           )                                # End negative lookahead
           ([^:\[]+)                        # Capture group 3: the path/name
           (\[.*\])?                        # Capture group 4: optional attribute
           $                                # End of line
-        }x.freeze
+        }x
 
         attr_reader :remark, :options
 

data/lib/metanorma/plugin/lutaml/json2_text_preprocessor.rb

@@ -8,6 +8,7 @@ module Metanorma
     module Lutaml
       class Json2TextPreprocessor < BaseStructuredTextPreprocessor
         include Content
+
         # search document for block `json2text`
         #   after that take template from block and read file into this template
         #   example:

data/lib/metanorma/plugin/lutaml/liquid/multiply_local_file_system.rb

@@ -52,8 +52,8 @@ module Metanorma
 
             if result_path.nil?
               raise ::Liquid::FileSystemError,
-                    "No documents in template path: " \
-                    " #{File.expand_path(template_path)}"
+                    "No documents in template path:  " \
+                    "#{File.expand_path(template_path)}"
             end
 
             unless roots.any? do |root|

data/lib/metanorma/plugin/lutaml/liquid_templates/_klass_table.liquid

@@ -22,7 +22,7 @@ h| Stereotype 2+| {{ stereotype }}
 3+h| Inherited Properties
 h| Property Name h| Property Type and Multiplicity h| Definition
 {% for attr in root.inherited_props %}
-  {%- if attr.has_association? == false -%}
+  {%- unless attr.has_association? -%}
     {%- capture name_col -%}
       {{ attr.name_ns }}:{{ attr.name }}
       ({{ attr.gen_name }})
@@ -30,13 +30,13 @@ h| Property Name h| Property Type and Multiplicity h| Definition
     | {{ name_col | newline_to_br }}
     | {{ attr.type }} [{{ attr.cardinality.min }}..{{ attr.cardinality.max }}]
     | {{ attr.definition }}
-  {%- endif -%}
+  {%- endunless -%}
 {% endfor %}
 
 3+h| Self-defined Properties
 h| Property Name h| Property Type and Multiplicity h| Definition
 {% for attr in root.owned_props %}
-  {%- if attr.has_association? == false -%}
+  {%- unless attr.has_association? -%}
     {%- capture name_col -%}
       {{ attr.name_ns }}:{{ attr.name }}
       ({{ attr.gen_name }})
@@ -44,13 +44,13 @@ h| Property Name h| Property Type and Multiplicity h| Definition
     | {{ name_col | newline_to_br }}
     | {{ attr.type }} [{{ attr.cardinality.min }}..{{ attr.cardinality.max }}]
     | {{ attr.definition }}
-  {%- endif -%}
+  {%- endunless -%}
 {% endfor %}
 
 3+h| Properties Inherited from Association
 h| Property Name h| Property Type and Multiplicity h| Definition
 {% for attr in root.inherited_assoc_props %}
-  {%- if attr.has_association? == true -%}
+  {%- if attr.has_association? -%}
     {%- capture name_col -%}
       {{ attr.name_ns }}:{{ attr.name }}
       ({{ attr.gen_name }})
@@ -64,7 +64,7 @@ h| Property Name h| Property Type and Multiplicity h| Definition
 3+h| Properties Defined in Association
 h| Property Name h| Property Type and Multiplicity h| Definition
 {% for attr in root.assoc_props %}
-  {%- if attr.has_association? == true -%}
+  {%- if attr.has_association? -%}
     {%- capture name_col -%}
       {{ attr.name_ns }}:{{ attr.name }}
       ({{ attr.gen_name }})

data/lib/metanorma/plugin/lutaml/lutaml_ea_diagram_block_macro.rb

@@ -29,7 +29,7 @@ module Metanorma
         private
 
         def parse_result_document(full_path, guidance = nil)
-          ::Lutaml::XMI::Parsers::XML.serialize_xmi_to_liquid(
+          ::Lutaml::Xmi::Parsers::Xml.serialize_xmi_to_liquid(
             File.new(full_path, encoding: "UTF-8"),
             guidance,
           )