metanorma-plugin-plantuml 1.0.1 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 07e9ee8fdf5e99900198be1e8ea51dd948957c62475694b0b40660fd25bff4d2
-  data.tar.gz: c6b49a7ec9b20d96e45c6600f2a368c3b5df542e6ee3bcc3f75ed17dd7d929bc
+  metadata.gz: 3b3797ddb4db236753261836d74b360e635c58ea3b0eeaa09dfc1c7192dacf78
+  data.tar.gz: 0aba3ecbbc90f15570887ea206fa0a0c19b6d3179a7d9481438fb480df305873
 SHA512:
-  metadata.gz: f9903747e63488c1af15f954441acbdaaa17c715935b1d0d390d515173f5e052df6defc0828de335e6491e019c69b9fa915365850a91a91155e5d68e3ee60376
-  data.tar.gz: 73e6bac1cfc02b057d52eb39913bfb833f0b70237fb8d00323424ef17a6b5ea302baf57faae486dda1779f0254035a4b449e0abb9648c21ceb18e30a39234778
+  metadata.gz: ed86eced1c2c434f17ce4f3f5307c88f349c30275ad2051ea7c6063feb1d13ca6c64480ea406951221a75ceececd035ffed82519d9dfe169205f55a160996c9b
+  data.tar.gz: 2e1488a69e6c3ff71a88c17778fead0b264ed2b6c8d2a7d8803e04441d0d7f1b4b2cebdd102050e6428500a477a876d6f3cc8cdf9882da007a7bc6900a19cffa

data/Gemfile

@@ -17,7 +17,7 @@ gem "canon"
 gem "debug"
 gem "metanorma"
 gem "metanorma-standoc", github: "metanorma/metanorma-standoc",
-                         branch: "feature/extract-plantuml"
+                         branch: "main"
 gem "rake"
 gem "rspec"
 gem "rspec-html-matchers"

data/README.adoc

@@ -65,6 +65,8 @@ the `plantuml` block directive.
 
 === Basic syntax
 
+==== Block style
+
 [source,asciidoc]
 ----
 [plantuml]
@@ -76,6 +78,25 @@ Bob -> Alice: Hi there
 ....
 ----
 
+==== Block macro style
+
+[source,asciidoc]
+----
+plantuml_image::path/to/my-plantuml.puml[]
+----
+
+The file `path/to/my-plantuml.puml` looks like:
+[source,plantuml]
+----
+@startuml
+Alice -> Bob: Hello
+Bob -> Alice: Hi there
+@enduml
+----
+
+`plantuml_image` block macro performs the same function as the `plantuml` block,
+but the PlantUML diagram is defined in a separate file instead of a block.
+
 === Supported diagram types
 
 PlantUML supports various diagram types, each with its own `@start` and `@end` directives:
@@ -183,6 +204,132 @@ Alice -> Bob: Hello
 ....
 ----
 
+==== Document-level includedirs configuration
+
+When using `!include` or `!includesub` in your PlantUML diagrams, you can set
+the default include directories (separated by semicolons) by
+`plantuml-includedirs` to search for files for all PlantUML diagrams in your
+document:
+
+[source,asciidoc]
+----
+:plantuml-includedirs: path/to/plantuml/include-1;path/to/plantuml/include-2
+
+[plantuml]
+....
+@startuml
+!include sequences.puml!1
+@enduml
+....
+
+[plantuml]
+....
+@startuml
+!include components.puml!FRONTEND
+!include components.puml!BACKEND
+
+WebApp --> APIGateway
+MobileApp --> APIGateway
+APIGateway --> DB
+@enduml
+....
+
+[plantuml]
+....
+@startuml
+title this contains only B and D
+!includesub subpart.puml!BASIC
+@enduml
+....
+----
+
+This plugin will search the include directories specified by
+`includedirs` options (i.e. `path/to/plantuml/include-1` and
+`path/to/plantuml/include-2`) for the files referenced in `!include` or
+`!includesub` directives (i.e. `sequences.puml`, `components.puml` and
+`subpart.puml`).
+
+You can also use `plantuml_image` to include external PlantUML files as images:
+
+[source,asciidoc]
+----
+:plantuml-includedirs: path/to/plantuml/include-1;path/to/plantuml/include-2
+
+plantuml_image::path/to/my-plantuml-1.puml[]
+
+plantuml_image::path/to/my-plantuml-2.puml[]
+----
+
+The file `path/to/my-plantuml-1.puml` looks like:
+[source,plantuml]
+----
+@startuml
+!include sequences.puml!1
+@enduml
+----
+
+The file `path/to/my-plantuml-2.puml` looks like:
+[source,plantuml]
+----
+@startuml
+!include components.puml!FRONTEND
+!include components.puml!BACKEND
+
+WebApp --> APIGateway
+MobileApp --> APIGateway
+APIGateway --> DB
+@enduml
+----
+
+When using `plantuml_image`, the path of the directory of the PlantUML file will
+also be added into the `includedirs`. (i.e. `path/to` will be added to
+`includedirs`)
+
+==== Block-level includedirs configuration
+
+When using `!include` or `!includesub` in your PlantUML diagrams, you can set
+the default include directories (separated by semicolons) by `includedirs` in
+block-level to search for files for the PlantUML diagram defined in your block:
+
+[source,asciidoc]
+----
+[plantuml,includedirs="path/to/plantuml/include-1"]
+....
+@startuml
+!include sequences.puml!1
+@enduml
+....
+
+[plantuml,includedirs="path/to/plantuml/include-2"]
+....
+@startuml
+!include components.puml!FRONTEND
+!include components.puml!BACKEND
+
+WebApp --> APIGateway
+MobileApp --> APIGateway
+APIGateway --> DB
+@enduml
+....
+----
+
+This plugin will search `sequences.puml` in `path/to/plantuml/include-1` and
+`components.puml` in `path/to/plantuml/include-2`.
+
+The block-level `includedirs` configuration can be used together with the
+document-level configuration to provide more granular control over include
+paths.  You can set multiple paths by separating them with semicolons.
+
+You can also use `plantuml_image` to set `includedirs` option to include
+external PlantUML files:
+
+[source,asciidoc]
+----
+plantuml_image::path/to/my-plantuml-1.puml[includedirs=path/to/plantuml/include-1]
+
+plantuml_image::path/to/my-plantuml-2.puml[includedirs=path/to/plantuml/include-2]
+----
+
 === Image attributes
 
 Standard AsciiDoc image attributes are supported:
@@ -272,7 +419,7 @@ Metanorma integration and PlantUML execution:
 ----
 Metanorma Document
       ↓
-BlockProcessor ← (processes [plantuml] blocks)
+BlockProcessor ← (processes [plantuml] blocks) or ImageBlockMacroProcessor ← (processes plantuml_image::{path}[{options}] macros)
       ↓
 Backend ← (Metanorma integration, paths, validation)
       ↓
@@ -284,6 +431,9 @@ PlantUML JAR ← (diagram generation)
 `BlockProcessor`:: Processes `[plantuml]` blocks in Metanorma documents and
 integrates with the Metanorma rendering pipeline.
 
+`ImageBlockMacroProcessor`:: Processes `plantuml_image::{path}[{options}]` macros
+in Metanorma documents and integrates with the Metanorma rendering pipeline.
+
 `Backend`:: Handles Metanorma-specific logic including document paths, PlantUML
 source validation, filename extraction, and attribute mapping.
 

data/lib/metanorma/plugin/plantuml/backend.rb

@@ -14,19 +14,21 @@ module Metanorma
       class Backend
         class << self
           def plantuml_installed?
-            unless Wrapper.available?
-              raise "PlantUML not installed"
-            end
+            return true if plantuml_available?
+
+            raise "PlantUML not installed"
           end
 
           def plantuml_available?
             Wrapper.available?
           end
 
-          def generate_file(parent, reader, format_override = nil) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+          def generate_file( # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+            parent, reader, format_override: nil, options: {}
+          )
             ldir, imagesdir, fmt = generate_file_prep(parent)
             fmt = format_override if format_override
-            plantuml_content = prep_source(reader)
+            plantuml_content = prep_source(parent, reader)
 
             # Extract filename from PlantUML source if specified
             filename = generate_unique_filename(fmt)
@@ -43,6 +45,7 @@ module Metanorma
               plantuml_content,
               format: fmt,
               output_file: output_file,
+              includedirs: options[:includedirs],
             )
 
             unless result[:success]
@@ -52,10 +55,12 @@ module Metanorma
             File.join(relative_path, filename)
           end
 
-          def generate_multiple_files(parent, reader, formats, attrs)
+          def generate_multiple_files(
+            parent, reader, formats, attrs, options: {}
+          )
             # Generate files for each format
             filenames = formats.map do |format|
-              generate_file(parent, reader, format)
+              generate_file(parent, reader, format, options: options)
             end
 
             # Return data for BlockProcessor to create image block
@@ -72,8 +77,9 @@ module Metanorma
           def generate_file_prep(parent)
             ldir = localdir(parent)
             imagesdir = parent.document.attr("imagesdir")
-            fmt = parent
-              .document.attr("plantuml-image-format")&.strip&.downcase || "png"
+            fmt = parent.document
+              .attr("plantuml-image-format")&.strip&.downcase ||
+              Wrapper::DEFAULT_FORMAT
             [ldir, imagesdir, fmt]
           end
 
@@ -100,8 +106,15 @@ module Metanorma
             ]
           end
 
-          def prep_source(reader)
-            src = reader.source
+          def prep_source(parent, reader) # rubocop:disable Metrics/MethodLength
+            src = if reader.respond_to?(:source)
+                    # get content from BlockProcessor
+                    reader.source
+                  else
+                    # get content from ImageBlockMacroProcessor
+                    docdir = parent.document.attributes["docdir"]
+                    File.read(File.join(docdir, reader))
+                  end
 
             # Validate that we have matching start/end pairs
             validate_plantuml_delimiters(src)

data/lib/metanorma/plugin/plantuml/block_processor.rb

@@ -1,29 +1,16 @@
 # frozen_string_literal: true
 
-require "asciidoctor"
-require "asciidoctor/extensions"
-require_relative "backend"
-
 module Metanorma
   module Plugin
     module Plantuml
       # PlantUML block processor for Asciidoctor
       class BlockProcessor < ::Asciidoctor::Extensions::BlockProcessor
+        include ::Metanorma::Plugin::Plantuml::BlockProcessorBase
         use_dsl
         named :plantuml
         on_context :literal
         parse_content_as :raw
 
-        def abort(parent, reader, attrs, msg)
-          warn msg
-          attrs["language"] = "plantuml"
-          create_listing_block(
-            parent,
-            reader.source,
-            attrs.reject { |k, _v| k.to_s.match?(/^\d+$/) },
-          )
-        end
-
         def process(parent, reader, attrs) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
           # Check for document-level disable flag
           if parent.document.attr("plantuml-disabled")
@@ -37,45 +24,25 @@ module Metanorma
 
           # Parse format specifications
           formats = parse_formats(attrs, parent.document)
+          options = parse_options(parent, reader, attrs)
 
-          if formats.length == 1
-            # Single format - original behavior
-            filename = Backend.generate_file(parent, reader, formats.first)
-            through_attrs = Backend.generate_attrs(attrs)
-            through_attrs["target"] = filename
-          else
-            # Multiple formats - generate multiple files
-            through_attrs = Backend
-              .generate_multiple_files(parent, reader, formats, attrs)
-          end
-          create_image_block parent, through_attrs
+          process_image_block(parent, reader, attrs, formats, options)
         rescue StandardError => e
           abort(parent, reader, attrs, e.message)
         end
 
         private
 
-        def parse_formats(attrs, document) # rubocop:disable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity, Metrics/AbcSize, Metrics/MethodLength
-          # Check for formats attribute (multiple formats)
-          if attrs["formats"]
-            formats = attrs["formats"].split(",").map(&:strip).map(&:downcase)
-            return formats.select { |f| valid_format?(f) }
-          end
-
-          # Check for format attribute (single format override)
-          if attrs["format"]
-            format = attrs["format"].strip.downcase
-            return [format] if valid_format?(format)
-          end
+        def parse_options(parent, _reader, attrs)
+          options = {}
 
-          # Fall back to document attribute or default
-          default_format = document
-            .attr("plantuml-image-format")&.strip&.downcase || "png"
-          [default_format]
-        end
+          # Parse include directory
+          options[:includedirs] = parse_doc_includedirs(parent.document)
+          options[:includedirs] = add_attrs_to_includedirs(
+            parent.document, attrs, options[:includedirs]
+          )
 
-        def valid_format?(format)
-          %w[png svg pdf txt eps].include?(format)
+          options
         end
       end
     end

data/lib/metanorma/plugin/plantuml/block_processor_base.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+require "asciidoctor"
+require "asciidoctor/extensions"
+require_relative "backend"
+
+module Metanorma
+  module Plugin
+    module Plantuml
+      module BlockProcessorBase
+        def abort(parent, reader, attrs, msg)
+          warn msg
+          attrs["language"] = "plantuml"
+          create_listing_block(
+            parent,
+            reader.respond_to?(:source) ? reader.source : reader,
+            attrs.reject { |k, _v| k.to_s.match?(/^\d+$/) },
+          )
+        end
+
+        private
+
+        def parse_doc_includedirs(document)
+          docdir = document.attributes["docdir"]
+          includedirs = document.attr("plantuml-includedirs")&.split(";") || []
+
+          includedirs.map! do |includedir|
+            if Pathname.new(includedir).relative?
+              Pathname.new(docdir).join(includedir).to_s
+            else
+              includedir
+            end
+          end
+
+          includedirs.compact.uniq
+        end
+
+        def parse_formats(attrs, document) # rubocop:disable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity, Metrics/AbcSize, Metrics/MethodLength
+          # Check for formats attribute (multiple formats)
+          if attrs["formats"]
+            formats = attrs["formats"].split(",").map(&:strip).map(&:downcase)
+            return formats.select { |f| valid_format?(f) }
+          end
+
+          # Check for format attribute (single format override)
+          if attrs["format"]
+            format = attrs["format"].strip.downcase
+            return [format] if valid_format?(format)
+          end
+
+          # Fall back to document attribute or default
+          default_format = document
+            .attr("plantuml-image-format")&.strip&.downcase ||
+            Wrapper::DEFAULT_FORMAT
+
+          [default_format]
+        end
+
+        def valid_format?(format)
+          Wrapper::SUPPORTED_FORMATS.include?(format)
+        end
+
+        def add_attrs_to_includedirs(document, attrs, includedirs)
+          docdir = document.attributes["docdir"]
+          attrs_includedirs = attrs["includedirs"]&.split(";") || []
+
+          attrs_includedirs.each do |attrs_includedir|
+            includedirs << if Pathname.new(attrs_includedir).relative?
+                             Pathname.new(docdir).join(attrs_includedir).to_s
+                           else
+                             attrs_includedir
+                           end
+          end
+
+          includedirs.compact.uniq
+        end
+
+        def process_image_block(parent, reader, attrs, formats, options) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+          if formats.length == 1
+            # Single format - original behavior
+            filename = Backend.generate_file(
+              parent, reader, format_override: formats.first, options: options
+            )
+            through_attrs = Backend.generate_attrs(attrs)
+            through_attrs["target"] = filename
+          else
+            # Multiple formats - generate multiple files
+            through_attrs = Backend
+              .generate_multiple_files(
+                parent, reader, formats, attrs, options: options
+              )
+          end
+
+          create_image_block parent, through_attrs
+        end
+      end
+    end
+  end
+end

data/lib/metanorma/plugin/plantuml/image_block_macro_processor.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Metanorma
+  module Plugin
+    module Plantuml
+      # PlantUML block processor for Asciidoctor
+      class ImageBlockMacroProcessor < ::Asciidoctor::Extensions::BlockMacroProcessor
+        include ::Metanorma::Plugin::Plantuml::BlockProcessorBase
+        use_dsl
+        named :plantuml_image
+
+        def process(parent, reader, attrs) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+          # Check for document-level disable flag
+          if parent.document.attr("plantuml-disabled")
+            return abort(parent, reader, attrs, "PlantUML processing disabled")
+          end
+
+          # Check PlantUML availability explicitly
+          unless Backend.plantuml_available?
+            return abort(parent, reader, attrs, "PlantUML not installed")
+          end
+
+          # Parse format specifications
+          formats = parse_formats(attrs, parent.document)
+          options = parse_options(parent, reader, attrs)
+
+          process_image_block(parent, reader, attrs, formats, options)
+        rescue StandardError => e
+          abort(parent, reader, attrs, e.message)
+        end
+
+        private
+
+        def add_image_path_to_includedirs(document, image_path, includedirs)
+          docdir = document.attributes["docdir"]
+          includedirs << File.dirname(File.join(docdir, image_path))
+          includedirs.compact.uniq
+        end
+
+        def parse_options(parent, reader, attrs)
+          options = {}
+
+          # Parse include directory
+          options[:includedirs] = parse_doc_includedirs(parent.document)
+          options[:includedirs] = add_attrs_to_includedirs(
+            parent.document, attrs, options[:includedirs]
+          )
+          options[:includedirs] = add_image_path_to_includedirs(
+            parent.document, reader, options[:includedirs]
+          )
+
+          options
+        end
+      end
+    end
+  end
+end

data/lib/metanorma/plugin/plantuml/version.rb

@@ -1,7 +1,7 @@
 module Metanorma
   module Plugin
     module Plantuml
-      VERSION = "1.0.1".freeze
+      VERSION = "1.0.2".freeze
       PLANTUML_JAR_VERSION = "1.2025.4".freeze
     end
   end

data/lib/metanorma/plugin/plantuml/wrapper.rb

@@ -32,7 +32,7 @@ module Metanorma
             options
           end
 
-          def generate( # rubocop:disable Metrics/MethodLength
+          def generate( # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
             content,
             format: DEFAULT_FORMAT,
             output_file: nil,
@@ -42,6 +42,9 @@ module Metanorma
             ensure_jar_available!
             ensure_java_available!
 
+            include_files = get_include_files(content, options)
+            options[:include_files] = include_files unless include_files.empty?
+
             result = if output_file
                        generate_to_file(content, format, output_file, options)
                      elsif base64
@@ -55,6 +58,24 @@ module Metanorma
             { success: false, error: e }
           end
 
+          def get_include_files(content, _options) # rubocop:disable Metrics/MethodLength
+            include_files = []
+            content.each_line do |line|
+              case line
+              when /(!include|!includesub)\s(.+){1}/
+                found_file = $2.split("!").first
+
+                # skip web links and standard libraries
+                if found_file.start_with?("<", "http")
+                  found_file = nil
+                end
+
+                include_files << found_file
+              end
+            end
+            include_files.compact.uniq
+          end
+
           def generate_from_file(
             input_file, format: DEFAULT_FORMAT,
             output_file: nil, base64: false, **options
@@ -169,47 +190,85 @@ module Metanorma
           end
 
           def execute_plantuml(content, format, output_file, options) # rubocop:disable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity, Metrics/AbcSize, Metrics/MethodLength
-            Tempfile.create(["plantuml_input", ".puml"]) do |input_file| # rubocop:disable Metrics/BlockLength
-              input_file.write(content)
-              input_file.close
-
-              # PlantUML generates output files based on filename specified in
-              # @start... line
-              # We need to use a temp directory and then move the file
-              Dir.mktmpdir do |temp_dir| # rubocop:disable Metrics/BlockLength
-                cmd = build_command(input_file.path, format, temp_dir, options)
-
-                output, error, status = Open3.capture3(*cmd)
-
-                unless status.success?
-                  error_message = if error.empty?
-                                    "Unknown PlantUML error"
-                                  else
-                                    error.strip
-                                  end
-                  raise GenerationError.new(error_message, error)
+            # PlantUML generates output files based on filename specified in
+            # @start... line
+            # We need to use a temp directory and then move the file
+            Dir.mktmpdir do |temp_dir| # rubocop:disable Metrics/BlockLength
+              # create input file
+              File.open("#{temp_dir}/plantuml_input.puml", "w") do |f|
+                f.write(content)
+              end
+
+              # Handle include files
+              if options[:include_files] && !options[:include_files].empty?
+                if options[:includedirs].empty?
+                  # raise error when include files are found but includedirs
+                  # is nil
+                  raise PlantumlError.new(
+                    "includedirs is required when include files are specified",
+                  )
                 end
 
-                # Find the generated file and move it to the desired location
-                if output_file
-                  generated_file = find_generated_file(temp_dir, content,
-                                                       format)
-                  if generated_file && File.exist?(generated_file)
-                    FileUtils.mv(generated_file, output_file)
-                  else
-                    # Debug: List what files were actually generated
-                    generated_files = Dir.glob(File.join(temp_dir, "*"))
-                    error_msg = "Generated file not found in temp directory. "
-                    error_msg += "Expected: #{generated_file}. "
-                    error_msg += "Found files: #{generated_files.map do |f|
-                      File.basename(f)
-                    end.join(', ')}"
-                    raise GenerationError.new(error_msg)
+                options[:include_files].each do |include_file|
+                  # find local include file in includedirs
+                  found_include_file = nil
+                  options[:includedirs].each do |includedir|
+                    include_file_path = File.join(includedir, include_file)
+                    if File.exist?(include_file_path)
+                      found_include_file = include_file_path
+                      break
+                    end
+                  end
+
+                  if found_include_file
+                    # create include file in temp directory
+                    temp_include_file = File.join(temp_dir, include_file)
+                    FileUtils.mkdir_p(File.dirname(temp_include_file))
+
+                    File.open(temp_include_file, "w") do |f|
+                      f.write(File.read(found_include_file))
+                    end
                   end
                 end
+              end
+
+              cmd = build_command(
+                "#{temp_dir}/plantuml_input.puml",
+                format,
+                temp_dir,
+                options,
+              )
 
-                output
+              output, error, status = Open3.capture3(*cmd)
+
+              unless status.success?
+                error_message = if error.empty?
+                                  "Unknown PlantUML error"
+                                else
+                                  error.strip
+                                end
+                raise GenerationError.new(error_message, error)
               end
+
+              # Find the generated file and move it to the desired location
+              if output_file
+                generated_file = find_generated_file(temp_dir, content,
+                                                     format)
+                if generated_file && File.exist?(generated_file)
+                  FileUtils.mv(generated_file, output_file)
+                else
+                  # Debug: List what files were actually generated
+                  generated_files = Dir.glob(File.join(temp_dir, "*"))
+                  error_msg = "Generated file not found in temp directory. "
+                  error_msg += "Expected: #{generated_file}. "
+                  error_msg += "Found files: #{generated_files.map do |f|
+                    File.basename(f)
+                  end.join(', ')}"
+                  raise GenerationError.new(error_msg)
+                end
+              end
+
+              output
             end
           end
 

data/lib/metanorma-plugin-plantuml.rb

@@ -11,4 +11,6 @@ require "metanorma/plugin/plantuml/config"
 require "metanorma/plugin/plantuml/wrapper"
 require "metanorma/plugin/plantuml/utils"
 require "metanorma/plugin/plantuml/backend"
+require "metanorma/plugin/plantuml/block_processor_base"
 require "metanorma/plugin/plantuml/block_processor"
+require "metanorma/plugin/plantuml/image_block_macro_processor"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: metanorma-plugin-plantuml
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.0.2
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-08-28 00:00:00.000000000 Z
+date: 2025-09-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: asciidoctor
@@ -58,8 +58,10 @@ files:
 - lib/metanorma-plugin-plantuml.rb
 - lib/metanorma/plugin/plantuml/backend.rb
 - lib/metanorma/plugin/plantuml/block_processor.rb
+- lib/metanorma/plugin/plantuml/block_processor_base.rb
 - lib/metanorma/plugin/plantuml/config.rb
 - lib/metanorma/plugin/plantuml/errors.rb
+- lib/metanorma/plugin/plantuml/image_block_macro_processor.rb
 - lib/metanorma/plugin/plantuml/utils.rb
 - lib/metanorma/plugin/plantuml/version.rb
 - lib/metanorma/plugin/plantuml/wrapper.rb