jekyll_pre 1.1.2 → 1.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '02751991aafe0decd461b0596ea3b8e06cd537bfe036ed5d2d5851aebf7c1295'
-  data.tar.gz: b2f326314d48b1752ad40b9c50c4df9c7f39dfb93d80662dddc9bab2ebe7291d
+  metadata.gz: a3eced8ae5430c67a303f08c90a38caf16c46efbad4e11232aa95ed9580c2f98
+  data.tar.gz: 9370b4fab76dc5ba5487c0d0876907ed9366d0f1e777e63ca8250121a9a32533
 SHA512:
-  metadata.gz: 8f62ab9616720b33cd9598c431501e1ac4de30ed8c0fd9a8afaba076f8f4dde15b8885381f4d2716f48c32b68a0dbda6fd021e1f3d0806a46a28322c4ab34671
-  data.tar.gz: d28408a99c9a4e465caedb7a71296c6ecdeb5a4e13719e2360039fc8eeb84d378034cd996162dbbc3fae57840b1da5afc4972fc892787161d291ff9dbc06f835
+  metadata.gz: 7fc327f37d0c5dc7f54ba78837984a05603ae24bbdee5e888eebdb01bc8d377ecd08bbc4b18a68c97a9bd3f1272f359cb8da53ee7a2143938793d5dca298fb31
+  data.tar.gz: 656acb136598d957e9b129a2ebd71cfb905f63191c6c0c09eb0565c9070c71d5790b1319289b6ac70d71f15b8710a1af5e693240102f10f5c4ecce0068784252

data/.rubocop.yml

@@ -1,6 +1,6 @@
-require: rubocop-jekyll
-inherit_gem:
-  rubocop-jekyll: .rubocop.yml
+# require: rubocop-jekyll
+# inherit_gem:
+#   rubocop-jekyll: .rubocop.yml
 
 AllCops:
   Exclude:

data/CHANGELOG.md

@@ -1,3 +1,15 @@
+## 1.1.5
+  * Added `class` and `style` options to allow for specifying additional CSS classes and inline CSS
+  * Added `clear` option to ensure no images overlap the pre output
+
+## 1.1.4
+  * Added `highlight` regex option
+  * Now using `lib/jekyll_tag_helper.rb` to parse markup
+
+## 1.1.3
+  * Documented the `data-lt-active="false"` attribute.
+  * Added the `dark` option, and [provided CSS](https://www.mslinn.com/blog/2020/10/03/jekyll-plugins.html#pre_css).
+
 ## 1.1.2 / 2022-04-05
   * Updated to `jekyll_plugin_logger` v2.1.0
 

data/README.md

@@ -10,6 +10,7 @@ This Jekyll plugin provides 2 new Liquid tags that work together:
     Contents of pre tag
     {% endpre %}
     ```
+    The generated <pre></pre> tag has an `data-lt-active="false"` attribute, so [LanguageTool](https://forum.languagetool.org/t/avoid-spell-check-on-certain-html-inputs-manually/3944) does not check the spelling or grammar of the contents.
   * A `noselect` tag that can renders HTML content passed to it unselectable.
     ```
     {% pre [copyButton] %}
@@ -39,7 +40,7 @@ Below are the CSS declarations that I defined pertaining to the pre and noselect
 ```
 
 ## Additional Information
-More information is available on my web site about [my Jekyll plugins](https://www.mslinn.com/blog/2020/10/03/jekyll-plugins.html).
+More information is available on [my web site](https://www.mslinn.com/blog/2020/10/03/jekyll-plugins.html#jekyll_pre).
 
 
 ## Installation

data/jekyll_pre.gemspec

@@ -39,10 +39,10 @@ Gem::Specification.new do |spec|
   spec.add_dependency "key-value-parser"
   spec.add_dependency "shellwords"
 
-  spec.add_development_dependency "debase"
+  # spec.add_development_dependency "debase"
   # spec.add_development_dependency "rubocop-jekyll"
   # spec.add_development_dependency "rubocop-rake"
   # spec.add_development_dependency "rubocop-rspec"
-  spec.add_development_dependency "ruby-debug-ide"
+  # spec.add_development_dependency "ruby-debug-ide"
 end
 # rubocop:enable Metrics/BlockLength

data/lib/jekyll_pre/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module JekyllPreVersion
-  VERSION = "1.1.2"
+  VERSION = "1.1.5"
 end

data/lib/jekyll_pre.rb

@@ -1,11 +1,14 @@
 # frozen_string_literal: true
 
-require "liquid"
-require "jekyll_plugin_logger"
-require_relative "jekyll_pre/version"
+require 'liquid'
+require 'jekyll_plugin_logger'
+require 'key_value_parser'
+require 'shellwords'
+require_relative 'jekyll_pre/version'
+require_relative 'jekyll_tag_helper'
 
 module JekyllPluginPreName
-  PLUGIN_NAME = "jekyll_pre"
+  PLUGIN_NAME = 'jekyll_pre'
 end
 
 # """
@@ -33,31 +36,47 @@ class PreTagBlock < Liquid::Block
   @@suffix = " title='Copy to clipboard'><img src='/assets/images/clippy.svg' " \
              "alt='Copy to clipboard' style='width: 13px'></button>"
 
+  def self.highlight(content, pattern)
+    content.gsub(Regexp.new(pattern), "<span class='bg_yellow'>\\0</span>")
+  end
+
   def self.make_copy_button(pre_id)
     "#{@@prefix}'##{pre_id}'#{@@suffix}"
   end
 
-  def self.make_pre(make_copy_button, number_lines, label, content)
+  def self.make_pre(make_copy_button, number_lines, label, dark, highlight_pattern, css_class, style, clear, content) # rubocop:disable Metrics/ParameterLists, Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity, Metrics/MethodLength
+    pre_clear = label_clear = ''
+    if clear
+      if label.to_s.empty?
+        pre_clear = ' clear'
+      else
+        label_clear = ' clear'
+      end
+    end
+    css_class = css_class ? " #{css_class}" : ''
+    style = style ? " style='#{style}'" : ''
+    dark_label = ' darkLabel' if dark
     label = if label.to_s.empty?
-              ""
-            elsif label.to_s.downcase.strip == "shell"
-              "<div class='codeLabel unselectable' data-lt-active='false'>Shell</div>"
+              ''
+            elsif label.to_s.downcase.strip == 'shell'
+              "<div class='codeLabel unselectable#{dark_label}#{label_clear}' data-lt-active='false'>Shell</div>"
             else
-              "<div class='codeLabel unselectable' data-lt-active='false'>#{label}</div>"
+              "<div class='codeLabel unselectable#{dark_label}#{label_clear}' data-lt-active='false'>#{label}</div>"
             end
     pre_id = "id#{SecureRandom.hex(6)}"
-    copy_button = make_copy_button ? PreTagBlock.make_copy_button(pre_id) : ""
+    copy_button = make_copy_button ? PreTagBlock.make_copy_button(pre_id) : ''
+    content = PreTagBlock.highlight(content, highlight_pattern) if highlight_pattern
     content = PreTagBlock.number_content(content) if number_lines
-    "#{label}<pre data-lt-active='false' class='maxOneScreenHigh copyContainer' id='#{pre_id}'>#{copy_button}#{content.strip}</pre>"
+    "#{label}<pre data-lt-active='false' class='maxOneScreenHigh copyContainer#{dark}#{pre_clear}#{css_class}'#{style} id='#{pre_id}'>#{copy_button}#{content.strip}</pre>"
   end
 
-  def self.number_content(content)
+  def self.number_content(content) # rubocop:disable Metrics/MethodLength
     lines = content.split("\n")
     digits = lines.length.to_s.length
     i = 0
     numbered_content = lines.map do |line|
       i += 1
-      number = i.to_s.rjust(digits, " ")
+      number = i.to_s.rjust(digits, ' ')
       "<span class='unselectable numbered_line'> #{number}: </span>#{line}"
     end
     result = numbered_content.join("\n")
@@ -66,33 +85,43 @@ class PreTagBlock < Liquid::Block
   end
 
   # @param _tag_name [String] is the name of the tag, which we already know.
-  # @param argument_string [String] the arguments from the web page.
+  # @param markup [String] the arguments from the web page.
   # @param _tokens [Liquid::ParseContext] tokenized command line
+  #        By default it has two keys: :locale and :line_numbers, the first is a Liquid::I18n object, and the second,
+  #        a boolean parameter that determines if error messages should display the line number the error occurred.
+  #        This argument is used mostly to display localized error messages on Liquid built-in Tags and Filters.
+  #        See https://github.com/Shopify/liquid/wiki/Liquid-for-Programmers#create-your-own-tags
   # @return [void]
-  def initialize(_tag_name, argument_string, _tokens)
+  def initialize(_tag_name, markup, _tokens)
     super
-    argument_string = "" if argument_string.nil?
-    argument_string.strip!
+    markup = '' if markup.nil?
+    markup.strip!
 
     @logger = PluginMetaLogger.instance.new_logger(self, PluginMetaLogger.instance.config)
-
-    @make_copy_button = argument_string.include? "copyButton"
-    remaining_text = argument_string.sub("copyButton", "").strip
-
-    @number_lines = remaining_text.include? "number"
-    remaining_text = remaining_text.sub("number", "").strip
-
-    @label = remaining_text
-
-    @logger.debug { "@make_copy_button = '#{@make_copy_button}'; argument_string = '#{argument_string}'; remaining_text = '#{remaining_text}'" }
+    @helper = JekyllTagHelper.new(tag_name, markup, @logger)
   end
 
   # Method prescribed by the Jekyll plugin lifecycle.
+  # @param liquid_context [Liquid::Context]
   # @return [String]
-  def render(context)
+  def render(liquid_context) # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
     content = super
+    @helper.liquid_context = liquid_context
+
+    @clear = @helper.parameter_specified?('clear')
+    @class = @helper.parameter_specified?('class')
+    @highlight = @helper.parameter_specified? 'highlight'
+    @make_copy_button = @helper.parameter_specified? 'copyButton'
+    @number_lines = @helper.parameter_specified? 'number'
+    @dark = ' dark' if @helper.parameter_specified? 'dark'
+    @label = @helper.parameter_specified? 'label'
+    @style = @helper.parameter_specified?('style')
+
+    # If a label was specified, use it, otherwise concatenate any dangling parameters and use that as the label
+    @label ||= @helper.params.join(' ')
+
     @logger.debug { "@make_copy_button = '#{@make_copy_button}'; @label = '#{@label}'" }
-    PreTagBlock.make_pre(@make_copy_button, @number_lines, @label, content)
+    PreTagBlock.make_pre(@make_copy_button, @number_lines, @label, @dark, @highlight, @class, @style, @clear, content)
   end
 end
 
@@ -100,23 +129,23 @@ end
 # Also, space before the closing percent is signficant %}"""
 class UnselectableTag < Liquid::Tag
   # @param _tag_name [String] is the name of the tag, which we already know.
-  # @param argument_string [String] the arguments from the web page.
+  # @param markup [String] the arguments from the web page.
   # @param _tokens [Liquid::ParseContext] tokenized command line
   # @return [void]
-  def initialize(_tag_name, argument_string, _tokens)
+  def initialize(_tag_name, markup, _tokens)
     super
     @logger = PluginMetaLogger.instance.new_logger(self)
 
-    @argument_string = argument_string
-    @argument_string = "$ " if @argument_string.nil? || @argument_string.empty?
-    @logger.debug { "UnselectableTag: argument_string= '#{@argument_string}'" }
+    @markup = markup
+    @markup = '$ ' if @markup.nil? || @markup.empty?
+    @logger.debug { "UnselectableTag: markup= '#{@markup}'" }
   end
 
   def render(_)
-    "<span class='unselectable'>#{@argument_string}</span>"
+    "<span class='unselectable'>#{@markup}</span>"
   end
 end
 
 PluginMetaLogger.instance.info { "Loaded #{JekyllPluginPreName::PLUGIN_NAME} v#{JekyllPreVersion::VERSION} plugin." }
-Liquid::Template.register_tag("pre", PreTagBlock)
-Liquid::Template.register_tag("noselect", UnselectableTag)
+Liquid::Template.register_tag('pre', PreTagBlock)
+Liquid::Template.register_tag('noselect', UnselectableTag)

data/lib/jekyll_tag_helper.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+require 'shellwords'
+require 'key_value_parser'
+
+# Parses arguments and options
+class JekyllTagHelper
+  attr_reader :argv, :liquid_context, :logger, :params, :tag_name
+
+  def self.escape_html(string)
+    string.gsub('&', '&')
+          .gsub('{', '{')
+          .gsub('}', '}')
+          .gsub('<', '&lt;')
+  end
+
+  # Expand a environment variable reference
+  def self.expand_env(str, die_if_undefined: false)
+    str.gsub(/\$([a-zA-Z_][a-zA-Z0-9_]*)|\${\g<1>}|%\g<1>%/) do
+      envar = Regexp.last_match(1)
+      raise FlexibleError, "flexible_include error: #{envar} is undefined".red, [] if !ENV.key?(envar) && die_if_undefined # Suppress stack trace
+
+      ENV[envar]
+    end
+  end
+
+  # strip leading and trailing quotes if present
+  def self.remove_quotes(string)
+    string.strip.gsub(/\A'|\A"|'\Z|"\Z/, '').strip if string
+  end
+
+  def initialize(tag_name, markup, logger)
+    @tag_name = tag_name
+    @argv = Shellwords.split(markup)
+    @keys_values = KeyValueParser.new.parse(@argv) # Hash[Symbol, String|Boolean]
+    @logger = logger
+    @logger.debug { "@keys_values='#{@keys_values}'" }
+  end
+
+  def delete_parameter(name)
+    @params.delete(name)
+    @argv.delete_if { |x| x.start_with? name }
+    @keys_values.delete(name.to_sym)
+  end
+
+  # @return if parameter was specified, returns value and removes it from the available tokens
+  def parameter_specified?(name)
+    value = @keys_values[name.to_sym]
+    delete_parameter(name)
+    value
+  end
+
+  PREDEFINED_SCOPE_KEYS = [:include, :page].freeze
+
+  # Finds variables defined in an invoking include, or maybe somewhere else
+  # @return variable value or nil
+  def dereference_include_variable(name)
+    @liquid_context.scopes.each do |scope|
+      next if PREDEFINED_SCOPE_KEYS.include? scope.keys.first
+
+      value = scope[name]
+      return value if value
+    end
+    nil
+  end
+
+  # @return value of variable, or the empty string
+  def dereference_variable(name)
+    value = @liquid_context[name] # Finds variables named like 'include.my_variable', found in @liquid_context.scopes.first
+    value ||= @page[name] if @page # Finds variables named like 'page.my_variable'
+    value ||= dereference_include_variable(name)
+    value ||= ''
+    value
+  end
+
+  # Sets @params by replacing any Liquid variable names with their values
+  def liquid_context=(context)
+    @liquid_context = context
+    @params = @keys_values.map { |k, _v| lookup_variable(k) }
+  end
+
+  def lookup_variable(symbol)
+    string = symbol.to_s
+    return string unless string.start_with?('{{') && string.end_with?('}}')
+
+    dereference_variable(string.delete_prefix('{{').delete_suffix('}}'))
+  end
+
+  def page
+    @liquid_context.registers[:page]
+  end
+end

data/spec/pre_spec.rb

@@ -45,4 +45,21 @@ RSpec.describe(PreTagBlock) do
     END_CONTENT
     expect(numbered_content).to eq(expected_content)
   end
+
+  it "highlights regex patterns" do
+    content = <<~END_CONTENT
+      Line 1
+        Line 2
+          Line 3
+          Line 4
+        Line 5
+      Line 6
+      Line 7
+        Line 8
+        Line 9
+      Line 10
+    END_CONTENT
+    highlighted = PreTagBlock.highlight(content, ".*2").split("\n")[1]
+    expect(highlighted).to eq("<span class='bg_yellow'>  Line 2</span>")
+  end
 end

data/spec/status_persistence.txt

@@ -1,4 +1,5 @@
 example_id              | status | run_time        |
 ----------------------- | ------ | --------------- |
-./spec/pre_spec.rb[1:1] | passed | 0.00366 seconds |
-./spec/pre_spec.rb[1:2] | passed | 0.00288 seconds |
+./spec/pre_spec.rb[1:1] | passed | 0.00187 seconds |
+./spec/pre_spec.rb[1:2] | passed | 0.00285 seconds |
+./spec/pre_spec.rb[1:3] | passed | 0.00056 seconds |

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll_pre
 version: !ruby/object:Gem::Version
-  version: 1.1.2
+  version: 1.1.5
 platform: ruby
 authors:
 - Mike Slinn
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-04-06 00:00:00.000000000 Z
+date: 2022-05-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -66,38 +66,10 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: debase
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: ruby-debug-ide
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 description: 'Jekyll tags pre and noselect, for HTML <pre/> tag, prompts and unselectable
   text. Can number lines.
 
-'
+  '
 email:
 - mslinn@mslinn.com
 executables: []
@@ -112,6 +84,7 @@ files:
 - jekyll_pre.gemspec
 - lib/jekyll_pre.rb
 - lib/jekyll_pre/version.rb
+- lib/jekyll_tag_helper.rb
 - spec/pre_spec.rb
 - spec/spec_helper.rb
 - spec/status_persistence.txt
@@ -142,8 +115,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
-signing_key: 
+rubygems_version: 3.3.3
+signing_key:
 specification_version: 4
 summary: Jekyll tags pre and noselect, for HTML <pre/> tag, prompts and unselectable
   text. Can number lines.
@@ -151,3 +124,4 @@ test_files:
 - spec/pre_spec.rb
 - spec/spec_helper.rb
 - spec/status_persistence.txt
+...