jekyll-enhanced-codeblocks 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 47bbe21f32e87e7b986157289abda2e52b13b35a169d7eb399a5adf97f546cda
+  data.tar.gz: 824afbce3d4610eda28db0b1752824c05eeb26b32f899dcbd0399cf4a6235c54
+SHA512:
+  metadata.gz: 11c0307a3f8e47555f098c31dfcb35510658e6617159500a3f849fe195d2491dfe5f1682013d303867f73c211e88d92195fe769fa969dfca671ca1b795b8d291
+  data.tar.gz: 90c51e38151b5fd55f70920a5c437e8fde737085aa3484d80d9706a90c60b79ce86ce8093ecfcfdbc7f2067ce3c7a4b1dc2041b0a2ef5d46b4a880ccb879bdd9

data/lib/jekyll-enhanced-codeblocks/generator.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module Jekyll::EnhancedCodeBlocks
+  class EnhancedCodeBlockGenerator < Jekyll::Generator
+    safe true
+
+    def generate(site)
+      (site.pages + site.posts.docs + site.collections.flat_map { |_, collection| collection.docs }).each do |doc|
+        next unless markdown_file?(doc)
+        doc.content = transform_code_blocks(doc.content)
+      end
+    end
+
+    private
+
+    def markdown_file?(doc)
+      doc.extname == '.md' || doc.extname == '.markdown'
+    end
+
+    def transform_code_blocks(content)
+      content.gsub(
+        /^```(\w+)(.*?)\s*\n(.*?)^```/m
+      ) do
+        lang = Regexp.last_match(1)
+        raw_opts = Regexp.last_match(2).strip
+        code = Regexp.last_match(3)
+    
+        highlight_args = parse_options(raw_opts)
+        "{% highlight #{lang}#{' ' + highlight_args.join(' ') unless highlight_args.empty?} %}\n#{code}{% endhighlight %}"
+      end
+    end
+
+    def parse_options(opts_str)
+      args = []
+
+      linenos_match = opts_str.match(/:linenos(?:=(\d+))?/)
+      if linenos_match
+        args << "linenos"
+        relative_line = linenos_match[1] ? linenos_match[1].to_i : 1
+        args << "start_line=#{relative_line}" if relative_line != 1
+        relative_line -= 1
+      end
+
+      highlight_match = opts_str.match(/:highlight(?:=\{([^}]+)\})?(?:=(\d+))?/)
+      if highlight_match
+        expanded_lines = []
+      
+        if highlight_match[1]  # handle bracketed list, i.e., :highlight={123, 342-345}
+          highlight_lines = highlight_match[1].split(',').map(&:strip)
+      
+          highlight_lines.each do |line|
+            if line.include?('-')  # handle range like "342-345"
+              start_line, end_line = line.split('-').map(&:to_i)
+      
+              start_line -= relative_line if relative_line != nil
+              end_line -= relative_line if relative_line != nil
+      
+              if start_line > end_line
+                raise ArgumentError, "Invalid range: #{line}. The start line must be less than or equal to the end line."
+              end
+      
+              expanded_lines.concat((start_line..end_line).to_a)
+            else  # handle individual line like "123"
+              line_number = line.to_i
+              line_number -= relative_line if relative_line != nil
+              expanded_lines << line_number
+            end
+          end
+        elsif highlight_match[2]  # handle single number, i.e., :highlight=123
+          line_number = highlight_match[2].to_i
+          line_number -= relative_line if relative_line != nil
+          expanded_lines << line_number
+        end
+      
+        expanded_lines = expanded_lines.reject { |line| line < 1 }
+      
+        if expanded_lines.any?
+          expanded_lines = expanded_lines.uniq.sort
+          args << %(mark_lines="#{expanded_lines.join(' ')}")
+        end
+      end
+
+      args
+    end
+  end
+end

data/lib/jekyll-enhanced-codeblocks/start_line_formatter_patch.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# Patch Jekyll to expose start_line tags for highlight liquid blocks
+module Jekyll
+  module Tags
+    class HighlightBlock < Liquid::Block
+      def table_formatter(formatter)
+        options = {
+          :css_class    => "highlight",
+          :gutter_class => "gutter",
+          :code_class   => "code"
+        }
+        if @highlight_options[:start_line]
+          options[:start_line] = @highlight_options[:start_line].to_i
+        end
+        Rouge::Formatters::HTMLTable.new(formatter, options)
+      end
+    end
+  end
+end

data/lib/jekyll-enhanced-codeblocks/version.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+module Jekyll
+  module EnhancedCodeBlocks
+    VERSION = "0.1.0"
+  end
+end

data/lib/jekyll-enhanced-codeblocks.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require 'jekyll-enhanced-codeblocks/start_line_formatter_patch'
+require 'jekyll-enhanced-codeblocks/generator'

metadata

@@ -0,0 +1,105 @@
+--- !ruby/object:Gem::Specification
+name: jekyll-enhanced-codeblocks
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- damned-me
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-05-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: jekyll
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.3'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+description: This Jekyll plugin provides better support for markdown fenced codeblocks,
+  allowing to specify options such as highlighting and line numbering in the info
+  strings allowed by the GFM syntax
+email:
+- damned-me@protonmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/jekyll-enhanced-codeblocks.rb
+- lib/jekyll-enhanced-codeblocks/generator.rb
+- lib/jekyll-enhanced-codeblocks/start_line_formatter_patch.rb
+- lib/jekyll-enhanced-codeblocks/version.rb
+homepage: https://github.com/damned-me/jekyll-enhanced-codeblocks
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.2.3
+signing_key:
+specification_version: 4
+summary: Enhanced code block syntax support for Jekyll
+test_files: []