jekyll-plantuml 1.4.1 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 86089f21384efec7b5247e76310cf6f216163302a8503dfb14c0398c6cc3b44c
-  data.tar.gz: a0720294a6a0a642117c736544d24f8a839c7adca81e6c2c222be47c9cf1b574
+  metadata.gz: 28129a00eff58d52229ade0dc74dc009b052597309bf6e9758401aeb0308b8e3
+  data.tar.gz: b44e4f4c8d9cfdfe98c179f775b519a6a57dd57ad9ac6fe0c2487592416bd6d0
 SHA512:
-  metadata.gz: 7c1411a7d223784a48c1f24fe9757cdf1454aac992333289e3d1352e546bd2ae0a1f5ba7deaf6a9a38fb16110fa6d6d29304792290a8a660bf64fff6e7ef71cb
-  data.tar.gz: 538a39cf5816c611381903cb4b3fd6df1375ff8a5777acea4e65e7e9d35d7502398e5990870c7121e53cd1612db0e7a4fa4bc0f997843f2967d173a0b89a2a32
+  metadata.gz: bcc87236d47ad23085ed51ae65f2927f80e73795cddc9be4b1c6ccc67986ed96447c588cc89aaa99370f7b46bd24e0c2abae50cad57553edbcc441a2991d1180
+  data.tar.gz: d55476f68d7cdc8a4809283dc8e79dfee6eb793fd9126192def60a284ac23e2087c31e9586f8c9fccc37229e325929a4316deae9d8e90cf58a1407a654309c52

data/.0pdd.yml

@@ -1,3 +1,6 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+---
 errors:
   - yegor256@gmail.com
 # alerts:

data/.github/workflows/actionlint.yml

@@ -0,0 +1,25 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+---
+# yamllint disable rule:line-length
+name: actionlint
+'on':
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+jobs:
+  actionlint:
+    timeout-minutes: 15
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v6
+      - name: Download actionlint
+        id: get_actionlint
+        run: bash <(curl https://raw.githubusercontent.com/rhysd/actionlint/main/scripts/download-actionlint.bash)
+        shell: bash
+      - name: Check workflow files
+        run: ${{ steps.get_actionlint.outputs.executable }} -color
+        shell: bash

data/.github/workflows/codecov.yml

@@ -0,0 +1,28 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+---
+# yamllint disable rule:line-length
+name: codecov
+'on':
+  push:
+    branches:
+      - master
+jobs:
+  codecov:
+    timeout-minutes: 15
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v6
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.4.8
+          bundler-cache: true
+      - run: sudo apt-get install --yes plantuml
+      - run: bundle config set --global path "$(pwd)/vendor/bundle"
+      - run: bundle install --no-color
+      - run: bundle exec rake
+      - uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: coverage/.resultset.json
+          fail_ci_if_error: true

data/.github/workflows/copyrights.yml

@@ -0,0 +1,19 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+---
+# yamllint disable rule:line-length
+name: copyrights
+'on':
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+jobs:
+  copyrights:
+    timeout-minutes: 15
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v6
+      - uses: yegor256/copyrights-action@0.0.12

data/.github/workflows/markdown-lint.yml

@@ -0,0 +1,19 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+---
+# yamllint disable rule:line-length
+name: markdown-lint
+'on':
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+jobs:
+  markdown-lint:
+    timeout-minutes: 15
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v6
+      - uses: DavidAnson/markdownlint-cli2-action@v22.0.0

data/.github/workflows/pdd.yml

@@ -1,11 +1,19 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 ---
+# yamllint disable rule:line-length
 name: pdd
-on:
+'on':
   push:
+    branches:
+      - master
   pull_request:
+    branches:
+      - master
 jobs:
   pdd:
-    runs-on: ubuntu-20.04
+    timeout-minutes: 15
+    runs-on: ubuntu-24.04
     steps:
-      - uses: actions/checkout@v3
-      - uses: g4s8/pdd-action@master
+      - uses: actions/checkout@v6
+      - uses: volodya-lombrozo/pdd-action@master

data/.github/workflows/rake.yml

@@ -1,6 +1,9 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 ---
+# yamllint disable rule:line-length
 name: rake
-on:
+'on':
   push:
     branches:
       - master
@@ -9,17 +12,18 @@ on:
       - master
 jobs:
   test:
-    name: test
     strategy:
       matrix:
-        os: [ubuntu-20.04, macos-12]
-        ruby: [2.7, 3.2]
+        os: [ubuntu-24.04]
+        ruby: [3.3]
     runs-on: ${{ matrix.os }}
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v6
       - uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby }}
-      - run: sudo apt-get -y install plantuml
-      - run: bundle update
+          bundler-cache: true
+      - run: sudo apt-get install --yes plantuml
+      - run: bundle config set --global path "$(pwd)/vendor/bundle"
+      - run: bundle install --no-color
       - run: bundle exec rake

data/.github/workflows/reuse.yml

@@ -0,0 +1,19 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+---
+# yamllint disable rule:line-length
+name: reuse
+'on':
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+jobs:
+  reuse:
+    timeout-minutes: 15
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v6
+      - uses: fsfe/reuse-action@v6

data/.github/workflows/typos.yml

@@ -0,0 +1,19 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+---
+# yamllint disable rule:line-length
+name: typos
+'on':
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+jobs:
+  typos:
+    timeout-minutes: 15
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v6
+      - uses: crate-ci/typos@v1.40.0

data/.github/workflows/xcop.yml

@@ -1,11 +1,15 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 ---
+# yamllint disable rule:line-length
 name: xcop
-on:
+'on':
   push:
   pull_request:
 jobs:
   xcop:
-    runs-on: ubuntu-20.04
+    timeout-minutes: 15
+    runs-on: ubuntu-24.04
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v6
       - uses: g4s8/xcop-action@master

data/.github/workflows/yamllint.yml

@@ -0,0 +1,19 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+---
+# yamllint disable rule:line-length
+name: yamllint
+'on':
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+jobs:
+  yamllint:
+    timeout-minutes: 15
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v6
+      - uses: ibiqlik/action-yamllint@v3

data/.gitignore

@@ -1,4 +1,11 @@
-Gemfile.lock
-*.gem
 .bundle/
 .DS_Store
+.idea/
+.yardoc/
+*.gem
+coverage/
+doc/
+Gemfile.lock
+node_modules/
+rdoc/
+vendor/

data/.rubocop.yml

@@ -1,17 +1,30 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+---
 AllCops:
   Exclude:
     - 'bin/**/*'
     - 'assets/**/*'
+    - 'vendor/**/*'
   DisplayCopNames: true
   TargetRubyVersion: 2.3
   SuggestExtensions: false
   NewCops: enable
-
+plugins:
+  - rubocop-rake
+  - rubocop-minitest
+  - rubocop-performance
+Minitest/EmptyLineBeforeAssertionMethods:
+  Enabled: false
 Gemspec/RequiredRubyVersion:
   Enabled: false
 Metrics/MethodLength:
   Enabled: false
 Metrics/AbcSize:
-  Max: 30
+  Max: 50
 Naming/FileName:
   Enabled: false
+Style/ClassAndModuleChildren:
+  Enabled: false
+Layout/EmptyLineAfterGuardClause:
+  Enabled: false

data/.rultor.yml

@@ -1,12 +1,17 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+---
+# yamllint disable rule:line-length
 docker:
-  image: yegor256/rultor-image:1.20.0
+  image: yegor256/rultor-image:1.24.0
 assets:
   rubygems.yml: yegor256/home#assets/rubygems.yml
 install: |
   pdd -f /dev/null
-  sudo bundle install --no-color "--gemfile=$(pwd)/Gemfile"
-  sudo apt-get -y install plantuml
+  bundle install --no-color
+  sudo apt-get install --yes plantuml
 release:
+  pre: false
   script: |-
     bundle exec rake
     rm -rf *.gem

data/Gemfile

@@ -1,8 +1,22 @@
 # frozen_string_literal: true
 
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
 source 'https://rubygems.org'
 gemspec
 
-gem 'rake', '13.0.6', require: false
-gem 'rubocop', '1.51.0', require: false
-gem 'rubocop-rspec', '2.22.0', require: false
+gem 'base64', '~>0.3', require: false
+gem 'bigdecimal', '~>4.0', require: false
+gem 'kramdown-parser-gfm', '~>1.1', require: false
+gem 'logger', '~>1.7', require: false
+gem 'minitest', '~>6.0', require: false
+gem 'minitest-reporters', '~>1.7', require: false
+gem 'rake', '~>13.2', require: false
+gem 'rdoc', '~>7.0', require: false
+gem 'rubocop', '~>1.64', require: false
+gem 'rubocop-minitest', '>0', require: false
+gem 'rubocop-performance', '>0', require: false
+gem 'rubocop-rake', '>0', require: false
+gem 'simplecov', '~>0.22', require: false
+gem 'simplecov-cobertura', '~>3.1', require: false

data/LICENSE.txt

@@ -1,6 +1,6 @@
 (The MIT License)
 
-Copyright (c) 2014-2023 Yegor Bugayenko
+Copyright (c) 2014-2025 Yegor Bugayenko
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the 'Software'), to deal

data/LICENSES/MIT.txt

@@ -0,0 +1,21 @@
+(The MIT License)
+
+Copyright (c) 2014-2025 Yegor Bugayenko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the 'Software'), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -1,9 +1,15 @@
-[![rake](https://github.com/yegor256/jekyll-plantuml/actions/workflows/rake.yml/badge.svg)](https://github.com/yegor256/jekyll-plantuml/actions/workflows/rake.yml)
-[![Gem Version](https://badge.fury.io/rb/jekyll-plantuml.svg)](http://badge.fury.io/rb/jekyll-plantuml)
+# PlantUML Diagrams in Jekyll Static Sites
+
+[![DevOps By Rultor.com][rultor-badge]][rultor]
+[![We recommend RubyMine][rubymine-badge]][rubymine]
+
+[![rake][rake-badge]][rake]
+[![Gem Version][gem-badge]][gem]
+[![Test Coverage][codecov-badge]][codecov]
 
 Install it first:
 
-```
+```bash
 gem install jekyll-plantuml
 ```
 
@@ -21,46 +27,90 @@ create a plugin file within your Jekyll project's `_plugins` directory:
 require "jekyll-plantuml"
 ```
 
-Highly recommend to use Bundler. If you're using it, add this line
+We highly recommend using Bundler. If you're using it, add this line
 to your `Gemfile`:
 
-```
+```ruby
 gem "jekyll-plantuml"
 ```
 
+The plugin is compatible with [Jekyll 3.9.3][jekyll-3]
+  and [Jekyll 4.3.2][jekyll-4].
+You can find our [integration tests][test-jekylls],
+  which prove the compatibility.
+
 ## Install plantuml.jar
 
-Then, make sure [PlantUML](http://plantuml.sourceforge.net/download.html)
-is installed on your build machine, and can
+Then, make sure [PlantUML][plantuml] is installed on your build machine, and can
 be executed with a simple `plantuml` command.
 
-For Linux user, you could create a `/usr/bin/plantuml` with contents:
-
-```
-#!/bin/bash
+On Ubuntu, just `apt-get install -y plantuml` should work.
+However, if it doesn't, you can create a `/usr/bin/plantuml` with the
+following content:
 
+```bash
+#!/usr/bin/env bash
 java -jar /home/user/Downloads/plantuml.jar "$1" "$2"
 ```
 
-Remember to change the path to `plantuml.jar` file.
+Remember to change the path to the `plantuml.jar` file.
 
-Then set executable permission.
+Then, set the executable permission of the file:
 
-```
+```bash
 chmod +x /usr/bin/plantuml
 ```
 
 ## Test
 
-Now, it's time to create a diagram, in your Jekyll blog page:
+Now, it's time to create a diagram in your Jekyll blog page:
 
-```
+```text
 {% plantuml %}
 [First] - [Second]
 {% endplantuml %}
 ```
 
-Now, check [this blog post](http://www.yegor256.com/2014/06/01/aop-aspectj-java-method-logging.html):
+You can also include a file:
+
+```text
+{% plantuml_file foo.uml %}
+```
+
+Now, check [this blog post][blog-post]:
 the UML sequence diagram in it is auto-generated using exactly this plugin.
-The sources of the blog are available in [GitHub](https://github.com/yegor256/blog).
+The sources of the blog are available in [GitHub][blog-sources].
+
+## How to contribute
+
+Read [these guidelines][guidelines].
+Make sure your build is green before you contribute
+your pull request. You will need to have [Ruby][ruby] 2.3+ and
+[Bundler][bundler] installed. Then:
+
+```bash
+bundle update
+bundle exec rake
+```
 
+If it's clean and you don't see any error messages, submit your pull request.
+
+[rultor-badge]: https://www.rultor.com/b/yegor256/jekyll-plantuml
+[rultor]: https://www.rultor.com/p/yegor256/jekyll-plantuml
+[rubymine-badge]: https://www.elegantobjects.org/rubymine.svg
+[rubymine]: https://www.jetbrains.com/ruby/
+[rake-badge]: https://github.com/yegor256/jekyll-plantuml/actions/workflows/rake.yml/badge.svg
+[rake]: https://github.com/yegor256/jekyll-plantuml/actions/workflows/rake.yml
+[gem-badge]: https://badge.fury.io/rb/jekyll-plantuml.svg
+[gem]: https://badge.fury.io/rb/jekyll-plantuml
+[codecov-badge]: https://img.shields.io/codecov/c/github/yegor256/jekyll-plantuml.svg
+[codecov]: https://codecov.io/github/yegor256/jekyll-plantuml?branch=master
+[jekyll-3]: https://jekyllrb.com/news/2023/01/29/jekyll-3-9-3-released/
+[jekyll-4]: https://jekyllrb.com/news/2023/01/20/jekyll-4-3-2-released/
+[test-jekylls]: https://github.com/yegor256/jekyll-plantuml/tree/master/test-jekylls
+[plantuml]: http://plantuml.sourceforge.net/download.html
+[blog-post]: http://www.yegor256.com/2014/06/01/aop-aspectj-java-method-logging.html
+[blog-sources]: https://github.com/yegor256/blog
+[guidelines]: https://www.yegor256.com/2014/04/15/github-guidelines.html
+[ruby]: https://www.ruby-lang.org/en/
+[bundler]: https://bundler.io/

data/REUSE.toml

@@ -0,0 +1,37 @@
+# SPDX-FileCopyrightText: Copyright (c) 2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+version = 1
+[[annotations]]
+path = [
+    ".DS_Store",
+    ".gitattributes",
+    ".gitignore",
+    ".pdd",
+    "**.json",
+    "**.md",
+    "**.png",
+    "**.svg",
+    "**.txt",
+    "**/.DS_Store",
+    "**/.gitignore",
+    "**/.pdd",
+    "**/*.csv",
+    "**/*.jpg",
+    "**/*.json",
+    "**/*.md",
+    "**/*.pdf",
+    "**/*.png",
+    "**/*.svg",
+    "**/*.txt",
+    "**/*.vm",
+    "**/CNAME",
+    "test/schema.puml",
+    "**/Gemfile.lock",
+    "Gemfile.lock",
+    "README.md",
+    "renovate.json",
+]
+precedence = "override"
+SPDX-FileCopyrightText = "Copyright (c) 2025 Yegor Bugayenko"
+SPDX-License-Identifier = "MIT"

data/Rakefile

@@ -1,26 +1,7 @@
 # frozen_string_literal: true
 
-# (The MIT License)
-#
-# Copyright (c) 2014-2023 Yegor Bugayenko
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the 'Software'), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in all
-# copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-# SOFTWARE.
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 
 require 'rubygems'
 require 'rake'
@@ -35,8 +16,19 @@ def version
   Gem::Specification.load(Dir['*.gemspec'].first).version
 end
 
-task default: %i[clean jekylls rubocop copyright]
+task default: %i[clean test jekylls rubocop]
 
+require 'rake/testtask'
+desc 'Run all unit tests'
+Rake::TestTask.new(:test) do |test|
+  Rake::Cleaner.cleanup_files(['coverage'])
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.warning = true
+  test.verbose = false
+end
+
+desc 'Test with different versions of Jekyll'
 task :jekylls do
   sh 'cd test-jekylls; make'
 end
@@ -54,13 +46,4 @@ require 'rubocop/rake_task'
 desc 'Run RuboCop on all directories'
 RuboCop::RakeTask.new(:rubocop) do |task|
   task.fail_on_error = true
-  task.requires << 'rubocop-rspec'
-end
-
-task :copyright do
-  sh "grep -q -r '2014-#{Date.today.strftime('%Y')}' \
-    --include '*.rb' \
-    --include '*.txt' \
-    --include 'Rakefile' \
-    ."
 end

data/jekyll-plantuml.gemspec

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
 require 'English'
 lib = File.expand_path('lib', __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
@@ -20,6 +23,6 @@ Gem::Specification.new do |s|
   s.executables = s.files.grep(%r{^bin/}) { |f| File.basename(f) }
   s.rdoc_options = ['--charset=UTF-8']
   s.extra_rdoc_files = %w[README.md LICENSE.txt]
-  s.add_runtime_dependency 'jekyll', '>2.0'
+  s.add_dependency 'jekyll', '>2.0'
   s.metadata['rubygems_mfa_required'] = 'true'
 end

data/lib/jekyll-plantuml-file.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+require 'jekyll'
+require 'liquid'
+require 'digest'
+require 'fileutils'
+
+# Jekyll main module.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2014-2025 Yegor Bugayenko
+# License:: MIT
+class Jekyll::PlantumlFile < Liquid::Block
+  def initialize(tag_name, markup, tokens)
+    super
+    @html = (markup or '').strip
+  end
+
+  def render(context)
+    site = context.registers[:site]
+    relative_file_name = super.to_s
+    full_file_name = File.join(site.source, relative_file_name)
+    body = File.read(full_file_name)
+    name = Digest::MD5.hexdigest(body)
+    unless File.exist?(File.join(site.dest, "uml/#{name}.svg"))
+      # uml = File.join(site.source, "uml/#{name}.uml")
+      svg = File.join(site.source, "uml/#{name}.svg")
+      if File.exist?(svg)
+        puts "File #{svg} already exists (#{File.size(svg)} bytes)"
+      else
+        uml = File.join(site.source, "uml/#{name}.uml")
+        FileUtils.mkdir_p(File.dirname(uml))
+        IO.copy_stream(full_file_name, uml)
+        unless system("plantuml -tsvg #{uml} 2>&1")
+          raise "PlantUML failed to compile the following snippet (see logs above):\n#{body}\n"
+        end
+        site.static_files << Jekyll::StaticFile.new(
+          site, site.source, 'uml', "#{name}.svg"
+        )
+        puts "\nFile #{svg} created (#{File.size(svg)} bytes)"
+      end
+    end
+    "<p><object data='#{site.baseurl}/uml/#{name}.svg' type='image/svg+xml' #{@html} class='plantuml'></object></p>"
+  end
+end
+
+Liquid::Template.register_tag('plantuml_file', Jekyll::PlantumlFile)

data/lib/jekyll-plantuml.rb

@@ -1,66 +1,46 @@
 # frozen_string_literal: true
 
-# (The MIT License)
-#
-# Copyright (c) 2014-2023 Yegor Bugayenko
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the 'Software'), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in all
-# copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-# SOFTWARE.
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 
+require 'jekyll'
+require 'liquid'
 require 'digest'
 require 'fileutils'
+require_relative 'jekyll-plantuml-file'
 
 # Jekyll main module.
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
-# Copyright:: Copyright (c) 2014-2023 Yegor Bugayenko
+# Copyright:: Copyright (c) 2014-2025 Yegor Bugayenko
 # License:: MIT
-module Jekyll
-  # The main class
-  class PlantumlBlock < Liquid::Block
-    def initialize(tag_name, markup, tokens)
-      super
-      @html = (markup or '').strip
-    end
+class Jekyll::PlantumlBlock < Liquid::Block
+  def initialize(tag_name, markup, tokens)
+    super
+    @html = (markup or '').strip
+  end
 
-    def render(context)
-      site = context.registers[:site]
-      name = Digest::MD5.hexdigest(super)
-      unless File.exist?(File.join(site.dest, "uml/#{name}.svg"))
-        uml = File.join(site.source, "uml/#{name}.uml")
-        svg = File.join(site.source, "uml/#{name}.svg")
-        if File.exist?(svg)
-          puts "File #{svg} already exists (#{File.size(svg)} bytes)"
-        else
-          FileUtils.mkdir_p(File.dirname(uml))
-          File.open(uml, 'w') do |f|
-            f.write("@startuml\n")
-            f.write(super)
-            f.write("\n@enduml")
-          end
-          system("plantuml -tsvg #{uml}") or raise "PlantUML error: #{super}"
-          site.static_files << Jekyll::StaticFile.new(
-            site, site.source, 'uml', "#{name}.svg"
-          )
-          puts "File #{svg} created (#{File.size(svg)} bytes)"
+  def render(context)
+    site = context.registers[:site]
+    body = super.to_s
+    name = Digest::MD5.hexdigest(body)
+    unless File.exist?(File.join(site.dest, "uml/#{name}.svg"))
+      uml = File.join(site.source, "uml/#{name}.uml")
+      svg = File.join(site.source, "uml/#{name}.svg")
+      if File.exist?(svg)
+        puts "File #{svg} already exists (#{File.size(svg)} bytes)"
+      else
+        FileUtils.mkdir_p(File.dirname(uml))
+        File.write(uml, ["@startuml\n", body, "\n@enduml"].join)
+        unless system("plantuml -tsvg #{uml} 2>&1")
+          raise "PlantUML failed to compile the following snippet (see logs above):\n#{body}\n"
         end
+        site.static_files << Jekyll::StaticFile.new(
+          site, site.source, 'uml', "#{name}.svg"
+        )
+        puts "\nFile #{svg} created (#{File.size(svg)} bytes)"
       end
-      "<p><object data='#{site.baseurl}/uml/#{name}.svg' type='image/svg+xml' #{@html} class='plantuml'></object></p>"
     end
+    "<p><object data='#{site.baseurl}/uml/#{name}.svg' type='image/svg+xml' #{@html} class='plantuml'></object></p>"
   end
 end
 

data/lib/version.rb

@@ -1,27 +1,8 @@
 # frozen_string_literal: true
 
-# (The MIT License)
-#
-# Copyright (c) 2014-2023 Yegor Bugayenko
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the 'Software'), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in all
-# copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-# SOFTWARE.
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 
 module PlantUML
-  VERSION = '1.4.1'
+  VERSION = '1.5.0'
 end

data/renovate.json

@@ -2,5 +2,9 @@
   "$schema": "https://docs.renovatebot.com/renovate-schema.json",
   "extends": [
     "config:base"
+  ],
+  "ignorePaths": [
+    "jekyll-tests/jekyll-3/Gemfile",
+    "jekyll-tests/jekyll-4/Gemfile"
   ]
 }

data/test/schema.puml

@@ -0,0 +1,3 @@
+@startuml
+[A] -> [B]
+@enduml

data/test/test__helper.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+$stdout.sync = true
+
+require 'simplecov'
+require 'simplecov-cobertura'
+unless SimpleCov.running
+  SimpleCov.command_name('test')
+  SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter.new(
+    [
+      SimpleCov::Formatter::HTMLFormatter,
+      SimpleCov::Formatter::CoberturaFormatter
+    ]
+  )
+  SimpleCov.minimum_coverage 80
+  SimpleCov.minimum_coverage_by_file 80
+  SimpleCov.start do
+    add_filter 'test/'
+    add_filter 'vendor/'
+    add_filter 'target/'
+    track_files 'lib/**/*.rb'
+    track_files '*.rb'
+  end
+end
+
+require 'minitest/autorun'
+require 'minitest/reporters'
+Minitest::Reporters.use! [Minitest::Reporters::SpecReporter.new]
+Minitest.load :minitest_reporter

data/test/test_plantuml-file.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+require 'liquid'
+require 'tmpdir'
+require_relative 'test__helper'
+require_relative '../lib/jekyll-plantuml-file'
+
+# PlantumlBlock test.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2023-2025 Yegor Bugayenko
+# License:: MIT
+class PlantumlFileTest < Minitest::Test
+  def test_failure
+    schema_file = File.join(Dir.getwd, 'test/schema.puml')
+    puts "Schema file: #{schema_file}"
+    Dir.mktmpdir 'test' do |dir|
+      template = Liquid::Template.parse('{% plantuml_file %}schema.puml{% endplantuml_file %}')
+      source_dir = File.join(dir, 'source')
+      target_file = File.join(source_dir, 'schema.puml')
+      puts "Target file: #{target_file}"
+      puts "Folder exists: #{File.exist?(dir)}"
+      puts "File exists: #{File.exist?(schema_file)}"
+      FileUtils.mkdir_p(source_dir)
+      FileUtils.cp(schema_file, target_file)
+      puts "File exists after: #{File.exist?(target_file)}"
+      config = {
+        'destination' => File.join(dir, 'dest'),
+        'source' => source_dir
+      }
+      context = Liquid::Context.new({}, {}, { site: Jekyll::Site.new(Jekyll.configuration(config)) })
+      block = template.root.nodelist.first
+      output = block.render(context)
+      assert(output.start_with?('<p><object'))
+    end
+  end
+end

data/test/test_plantuml.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+require 'liquid'
+require 'tmpdir'
+require_relative 'test__helper'
+require_relative '../lib/jekyll-plantuml'
+
+# PlantumlBlock test.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2023-2025 Yegor Bugayenko
+# License:: MIT
+class PlantumlBlockTest < Minitest::Test
+  def test_failure
+    Dir.mktmpdir 'test' do |dir|
+      template = Liquid::Template.parse('{% plantuml %}[A] -> [B]{% endplantuml %}')
+      config = {
+        'destination' => File.join(dir, 'dest'),
+        'source' => File.join(dir, 'source')
+      }
+      context = Liquid::Context.new({}, {}, { site: Jekyll::Site.new(Jekyll.configuration(config)) })
+      block = template.root.nodelist.first
+      output = block.render(context)
+      assert(output.start_with?('<p><object'))
+    end
+  end
+end

data/test-jekylls/.gitignore

@@ -1,2 +1,2 @@
 _site/
-uml/
+uml/

data/test-jekylls/Makefile

@@ -1,3 +1,6 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
 .ONESHELL:
 .SHELLFLAGS: -e -o pipefail -c
 .PHONY: clean sa env lint
@@ -10,4 +13,4 @@ all:
 		cd $${t}
 		bundle install
 		bundle exec jekyll build
-	done
+	done

data/test-jekylls/jekyll-3/Gemfile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+source 'https://rubygems.org'
+
+gem 'jekyll', '4.4.1'
+gem 'jekyll-plantuml', path: '../..'
+gem 'kramdown', '2.5.1'
+gem 'kramdown-parser-gfm', '1.1.0'
+gem 'liquid', '4.0.4'

data/test-jekylls/{simple → jekyll-3}/_config.yml

@@ -1,3 +1,6 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+---
 title: simple
 markdown: kramdown
 encoding: utf-8

data/test-jekylls/jekyll-3/_layouts/default.html

@@ -0,0 +1,12 @@
+---
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+layout: default
+---
+<!DOCTYPE html>
+<html>
+  <body>
+    {{ content }}
+  </body>
+</html>

data/test-jekylls/jekyll-4/Gemfile

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+source 'https://rubygems.org'
+
+gem 'jekyll', '4.4.1'
+gem 'jekyll-plantuml', path: '../..'
+gem 'kramdown', '2.5.1'
+gem 'liquid', '4.0.4'

data/test-jekylls/jekyll-4/_config.yml

@@ -0,0 +1,9 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+---
+title: simple
+markdown: kramdown
+encoding: utf-8
+timezone: Europe/Moscow
+plugins:
+  - jekyll-plantuml

data/test-jekylls/jekyll-4/_layouts/default.html

@@ -0,0 +1,12 @@
+---
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+layout: default
+---
+<!DOCTYPE html>
+<html>
+  <body>
+    {{ content }}
+  </body>
+</html>

data/test-jekylls/jekyll-4/_posts/2023/06/2023-06-02-test.md

@@ -0,0 +1,17 @@
+---
+layout: default
+date: 2023-06-02
+title: "Test"
+---
+
+This is just a test:
+
+{% plantuml %}
+[First] - [Second]
+{% endplantuml %}
+
+This is another test:
+
+```plantuml
+[First] - [Second]
+```

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-plantuml
 version: !ruby/object:Gem::Version
-  version: 1.4.1
+  version: 1.5.0
 platform: ruby
 authors:
 - Yegor Bugayenko
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-06-02 00:00:00.000000000 Z
+date: 2025-12-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -33,28 +33,45 @@ extra_rdoc_files:
 - LICENSE.txt
 files:
 - ".0pdd.yml"
+- ".github/workflows/actionlint.yml"
+- ".github/workflows/codecov.yml"
+- ".github/workflows/copyrights.yml"
+- ".github/workflows/markdown-lint.yml"
 - ".github/workflows/pdd.yml"
 - ".github/workflows/rake.yml"
+- ".github/workflows/reuse.yml"
+- ".github/workflows/typos.yml"
 - ".github/workflows/xcop.yml"
+- ".github/workflows/yamllint.yml"
 - ".gitignore"
 - ".pdd"
 - ".rubocop.yml"
 - ".rultor.yml"
-- ".travis.yml"
 - Gemfile
 - LICENSE.txt
+- LICENSES/MIT.txt
 - README.md
+- REUSE.toml
 - Rakefile
 - jekyll-plantuml.gemspec
+- lib/jekyll-plantuml-file.rb
 - lib/jekyll-plantuml.rb
 - lib/version.rb
 - renovate.json
 - test-jekylls/.gitignore
 - test-jekylls/Makefile
-- test-jekylls/simple/Gemfile
-- test-jekylls/simple/_config.yml
-- test-jekylls/simple/_layouts/default.html
-- test-jekylls/simple/_posts/2023/06/2023-06-02-test.md
+- test-jekylls/jekyll-3/Gemfile
+- test-jekylls/jekyll-3/_config.yml
+- test-jekylls/jekyll-3/_layouts/default.html
+- test-jekylls/jekyll-3/_posts/2023/06/2023-06-02-test.md
+- test-jekylls/jekyll-4/Gemfile
+- test-jekylls/jekyll-4/_config.yml
+- test-jekylls/jekyll-4/_layouts/default.html
+- test-jekylls/jekyll-4/_posts/2023/06/2023-06-02-test.md
+- test/schema.puml
+- test/test__helper.rb
+- test/test_plantuml-file.rb
+- test/test_plantuml.rb
 homepage: https://github.com/yegor256/jekyll-plantuml
 licenses:
 - MIT
@@ -76,7 +93,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.15
+rubygems_version: 3.4.10
 signing_key: 
 specification_version: 4
 summary: Jekyll PlantUML Automation

data/.travis.yml

@@ -1,12 +0,0 @@
-language: ruby
-rvm:
-  - 2.2.2
-cache: bundler
-branches:
-  only:
-    - master
-install:
-  - travis_retry bundle install
-script:
-  - rake
-

data/test-jekylls/simple/Gemfile

@@ -1,6 +0,0 @@
-# frozen_string_literal: true
-
-source 'https://rubygems.org'
-
-gem 'jekyll', '4.3.2'
-gem 'jekyll-plantuml', path: '../..'

data/test-jekylls/simple/_layouts/default.html

@@ -1,9 +0,0 @@
----
-layout: default
----
-<!DOCTYPE html>
-<html>
-  <body>
-    {{ content }}
-  </body>
-</html>