jekyll-mermaid-prebuild 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6fb78d9660c4601fc8e1b4b21d4c0f2e0b1c1d120ce09a3b61c6a47900b26a80
-  data.tar.gz: 4a7458ca917f5814760a6cd6b9dbfb38291b06db65bf325eb537aac64c09fc96
+  metadata.gz: e76d120b1e9c96438f6f84dea780e132e1bbaf498fd11d8a2f2e37f2b585c2f6
+  data.tar.gz: b7e4e4b1249cf4b64e9cd8ee8d7bd19bd0402117e96ad57289d3291e401567f6
 SHA512:
-  metadata.gz: 7aac32a6e29fda736401e36514bb751c4c94ceb01540e15234377fe660df5e8b4e925d6673fd476b2640f4c35e9ece4b5f957d2966448d75c410f92c9c8fee7b
-  data.tar.gz: 0d9d4ebcd23007a679221aed4f8154c0d1fe00e9a060bef13a4d8c429e0b9bf447c3067ead4b2b82d8bf002269547d6688a2e7f5ca4d60e32f70ed82d6a3fe9c
+  metadata.gz: 463dfec0e22358beeb09c7e4f3500c78bcc35d9c97f46352fe967e100bc5a0d422cfd074c3ade807683230f94a9b1cd8b73e338ba20de6b51e7042cfbebb2129
+  data.tar.gz: 89b982187ccb12009c02f7ebf8bb8bab5d97a3766b5bdcf368405ccec5167f533e918bc6c11f3767222ed2cc509178095e54d89c108ce452e3af652f0f454ce3

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.2.1](https://github.com/Texarkanine/jekyll-mermaid-prebuild/compare/v0.2.0...v0.2.1) (2026-01-18)
+
+
+### Bug Fixes
+
+* Allow literal mermaid code examples to remain un-rendered. ([#4](https://github.com/Texarkanine/jekyll-mermaid-prebuild/issues/4)) ([6a4e2e1](https://github.com/Texarkanine/jekyll-mermaid-prebuild/commit/6a4e2e1aa43145fde757c64dc20d7189c4eb4489))
+
 ## [0.2.0](https://github.com/Texarkanine/jekyll-mermaid-prebuild/compare/v0.1.0...v0.2.0) (2026-01-17)
 
 

data/lib/jekyll-mermaid-prebuild/processor.rb

@@ -3,6 +3,9 @@
 module JekyllMermaidPrebuild
   # Processes document/page content, replacing mermaid blocks with SVG references
   class Processor
+    # Pattern to detect any fence opener (captures fence chars and optional language)
+    FENCE_OPENER = /^(`{3,}|~{3,})(\w*)/
+
     # Initialize processor
     #
     # @param config [Configuration] plugin configuration
@@ -13,6 +16,7 @@ module JekyllMermaidPrebuild
     end
 
     # Process content, replacing mermaid code blocks with figure HTML
+    # Only processes top-level mermaid blocks (not nested inside other fences)
     #
     # @param content [String] markdown content
     # @param _site [Jekyll::Site] the Jekyll site (unused, kept for API compatibility)
@@ -20,35 +24,116 @@ module JekyllMermaidPrebuild
     def process_content(content, _site = nil)
       return [content, 0, {}] unless content
 
-      pattern = MmdcWrapper.mermaid_fence_pattern
       converted_count = 0
       svgs_to_copy = {}
 
-      processed = content.gsub(pattern) do |original_match|
-        mermaid_source = Regexp.last_match(2)
+      # Find top-level mermaid blocks respecting fence nesting
+      top_level_blocks = find_top_level_mermaid_blocks(content)
+
+      # Process blocks in reverse order to preserve string positions
+      processed = content.dup
+      top_level_blocks.reverse_each do |block|
+        result = convert_block(block)
+        next unless result
+
+        converted_count += 1
+        svgs_to_copy[result[:cache_key]] = result[:cached_path]
+        processed[block[:start]...block[:end]] = result[:html]
+      end
+
+      [processed, converted_count, svgs_to_copy]
+    end
+
+    private
 
-        # Generate cache key from content
-        cache_key = DigestCalculator.content_digest(mermaid_source)
+    # Convert a single mermaid block to SVG
+    #
+    # @param block [Hash] block info with :content key
+    # @return [Hash, nil] {cache_key:, cached_path:, html:} or nil if failed
+    def convert_block(block)
+      mermaid_source = block[:content]
+      cache_key = DigestCalculator.content_digest(mermaid_source)
+      cached_path = @generator.generate(mermaid_source, cache_key)
 
-        # Generate SVG
-        cached_path = @generator.generate(mermaid_source, cache_key)
+      return nil unless cached_path
 
-        if cached_path
-          converted_count += 1
+      svg_url = @generator.build_svg_url(cache_key)
+      { cache_key: cache_key, cached_path: cached_path, html: @generator.build_figure_html(svg_url) }
+    end
 
-          # Track SVG for copying to _site later
-          svgs_to_copy[cache_key] = cached_path
+    # Find all top-level mermaid code blocks (not nested inside other fences)
+    #
+    # @param content [String] markdown content
+    # @return [Array<Hash>] array of {start:, end:, content:} for each top-level mermaid block
+    def find_top_level_mermaid_blocks(content)
+      state = { blocks: [], fence_stack: [], current_mermaid: nil, position: 0 }
 
-          # Return replacement HTML
-          svg_url = @generator.build_svg_url(cache_key)
-          @generator.build_figure_html(svg_url)
-        else
-          # Keep original on failure
-          original_match
-        end
+      content.lines.each do |line|
+        process_line(line, state)
       end
 
-      [processed, converted_count, svgs_to_copy]
+      state[:blocks]
+    end
+
+    # Process a single line for fence detection
+    def process_line(line, state)
+      line_start = state[:position]
+      state[:position] += line.length
+
+      match = line.match(FENCE_OPENER)
+      if match
+        handle_fence_line(line, line_start, match, state)
+      elsif state[:current_mermaid]
+        state[:current_mermaid][:content_lines] << line
+      end
+    end
+
+    # Handle a line that matches a fence pattern
+    def handle_fence_line(line, line_start, match, state)
+      fence_chars = match[1]
+      language = match[2]
+      fence_type = fence_chars[0]
+      fence_length = fence_chars.length
+
+      if state[:current_mermaid]
+        handle_line_in_mermaid(line, fence_chars, fence_type, fence_length, state)
+      elsif state[:fence_stack].empty?
+        handle_line_at_top_level(line_start, language, fence_type, fence_length, state)
+      else
+        handle_line_in_nested_fence(line, fence_type, fence_length, state)
+      end
+    end
+
+    # Handle fence line while inside a mermaid block
+    def handle_line_in_mermaid(line, fence_chars, fence_type, fence_length, state)
+      cm = state[:current_mermaid]
+      if fence_type == cm[:fence_type] && fence_length == cm[:fence_length] && line.strip == fence_chars
+        state[:blocks] << { start: cm[:start], end: state[:position], content: cm[:content_lines].join }
+        state[:current_mermaid] = nil
+      else
+        cm[:content_lines] << line
+      end
+    end
+
+    # Handle fence line at top level (not inside any fence)
+    def handle_line_at_top_level(line_start, language, fence_type, fence_length, state)
+      if language == "mermaid"
+        state[:current_mermaid] = { start: line_start, fence_type: fence_type,
+                                    fence_length: fence_length, content_lines: [] }
+      else
+        state[:fence_stack].push([fence_length, fence_type])
+      end
+    end
+
+    # Handle fence line while inside a non-mermaid fence
+    def handle_line_in_nested_fence(line, fence_type, fence_length, state)
+      top_fence_length, top_fence_type = state[:fence_stack].last
+
+      if fence_type == top_fence_type && fence_length >= top_fence_length && line.strip.match?(/^[`~]+$/)
+        state[:fence_stack].pop
+      else
+        state[:fence_stack].push([fence_length, fence_type])
+      end
     end
   end
 end

data/lib/jekyll-mermaid-prebuild/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module JekyllMermaidPrebuild
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-mermaid-prebuild
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Texarkanine