jekyll_pre 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ffe453b56e03d1e78bce68257b601f3361c5e9f39e81842bd2bc3b40f64aaddf
-  data.tar.gz: be4f574ee5a94854d6c28ea225d0a08f44319639b48d569e48d65e627c966c45
+  metadata.gz: 2a4c55485eec7e53914d0be22bc4fcd6701e0ec9fa2137193953e4cf8b1013d5
+  data.tar.gz: 9a150916aff92e21ac2ed5bd378018dc864cbeaeb5dd1792bcec58fd47bed40c
 SHA512:
-  metadata.gz: ea9a405d3fac946a19a6c306e188c1bec3b670398f6099d5de0ec35d40b7258ad559e300571c3291b965f17d647fb6eec045715acb3d23bd5e3bbfa6f35711c0
-  data.tar.gz: c77014a0cb77dcff1fcd63018d043b1b2dc4497028a03d8112b49d712bb1bd1c91cb542f297924bc05adf1cc23c0a9669ff41c99cbbbbef0cbf934cc10c63e0c
+  metadata.gz: 26b7a66d9bb2ed68f8f0d4f9e5e1f9bb8a07f21bc414abb8daa2ae50fa3206ad7a0942d395b67b1c50bf946c80be007c387f8492ed250e6ca32c16363e9f561c
+  data.tar.gz: 4e6a7e59158589373a8a4701d0985a948c16c9f5fbd6b9c940329df52c65bea6596108fa6ddb14e0aa50495ba10b522fb61b15b9a86e100da6ad307a38d2ad33

data/.rubocop.yml

@@ -11,21 +11,3 @@ AllCops:
 
 Layout/LineLength:
   Max: 150
-
-Layout/MultilineMethodCallIndentation:
-  Enabled: false
-
-Metrics/BlockLength:
-  Enabled: false
-
-Style/PercentLiteralDelimiters:
-  Enabled: false
-
-Style/RegexpLiteral:
-  Enabled: false
-
-Style/StringLiterals:
-  Enabled: false
-
-Style/StringLiteralsInInterpolation:
-  Enabled: false

data/CHANGELOG.md

@@ -1,3 +1,6 @@
+## 1.1.0 / 2022-03-31
+  * Added `number` option, which generates unselectable line numbers for contents
+
 ## 1.0.0 / 2022-03-13
   * Made into a Ruby gem and published on RubyGems.org as [jekyll_pre](https://rubygems.org/gems/jekyll_pre).
   * `bin/attach` script added for debugging

data/README.md

@@ -2,10 +2,42 @@ Jekyll_pre
 [![Gem Version](https://badge.fury.io/rb/jekyll_pre.svg)](https://badge.fury.io/rb/jekyll_pre)
 ===========
 
-This is a Jekyll plugin that provides two Liquid tags: `pre` and `noselect` that frequently work together:
+This Jekyll plugin provides 2 new Liquid tags that work together:
+
+  * A `pre` block tag that can optionally display a copy button.
+    ```
+    {% pre [copyButton] [shell] [headline words] %}
+    Contents of pre tag
+    {% endpre %}
+    ```
+  * A `noselect` tag that can renders HTML content passed to it unselectable.
+    ```
+    {% pre [copyButton] %}
+    {% noselect [text string, defaults to $]%}Contents of pre tag
+    {% endpre %}
+    ```
+
+## CSS
+Below are the CSS declarations that I defined pertaining to the pre and noselect tags that produced the above images:
+```css
+.maxOneScreenHigh {
+  max-height: 500px;
+}
+
+.numbered_line {
+  color: rgb(65, 77, 65);
+}
+
+.unselectable {
+  color: #7922f9;
+  -moz-user-select: none;
+  -khtml-user-select: none;
+  user-select: none;
+}
+```
 
- * A `pre` block tag that can optionally display a copy button.
- * A `noselect` tag that can renders HTML content passed to it unselectable.
+## 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).
 
 
 ## Installation
@@ -29,19 +61,7 @@ Or install it yourself as:
 
 ## Usage
 
-Unfortunately markdown does not support CSS styles, so the HTML rendering of the examples is compromised.
-
-### Syntax
-
-<pre data-lt-active="false" class="maxOneScreenHigh copyContainer" id="id7478d3e758a5"><button class="copyBtn" data-clipboard-target="#id7478d3e758a5" title="Copy to clipboard"><img src="images/clippy.svg" alt="Copy to clipboard" style="width: 13px"></button>{% pre [copyButton] [shell] [headline words] %}
-Contents of pre tag
-{% endpre %}</pre>
-
-<pre data-lt-active="false" class="maxOneScreenHigh copyContainer" id="idbb1564f70e84">{% pre [copyButton] %}
-{% noselect [text string]%}Contents of pre tag
-{% endpre %}</pre>
-
-### Usage Example 1
+### Example 1
 This example does not generate a copy button and does not demonstrate `noselect`.
 <pre data-lt-active="false" class="maxOneScreenHigh copyContainer" id="id110c50d624b4">{% pre %}
 Contents of pre tag
@@ -54,54 +74,68 @@ Which renders as:
 
 <pre data-lt-active="false" class="maxOneScreenHigh copyContainer" id="id377433c30186">Contents of pre tag</pre>
 
-### Usage Example 2
+
+### Example 2
 This example generates a copy button and does not demonstrate `noselect`.
 
-<pre data-lt-active="false" class="maxOneScreenHigh copyContainer" id="idb92b40eba687">{% pre copyButton %}Contents of pre tag
-{% endpre %}</pre>
+    {% pre copyButton %}
+    Contents of pre tag
+    {% endpre %}
 
 Generates:
 <pre data-lt-active="false" class="maxOneScreenHigh copyContainer" id="id08a5d26db177">&lt;pre data-lt-active='false' class='maxOneScreenHigh copyContainer' id='id6a831a3e8992'&gt;&lt;button class='copyBtn' data-clipboard-target='#id6a831a3e8992' title='Copy to clipboard'&gt;&lt;img src='images/clippy.svg' alt='Copy to clipboard' style='width: 13px'&gt;&lt;/button&gt;Contents of pre tag&lt;/pre&gt;</pre>
 
-Which renders as:
-<pre data-lt-active="false" class="maxOneScreenHigh copyContainer" id="id6a831a3e8992"><button class="copyBtn" data-clipboard-target="#id6a831a3e8992" title="Copy to clipboard"><img src="images/clippy.svg" alt="Copy to clipboard" style="width: 13px"></button>Contents of pre tag</pre>
+Which renders as (note the clipboard icon at the far right):
+![example 2](images/usage2example.png)
+
 
-### Usage Example 3
+### Example 3
 This example generates a copy button and does demonstrates the default usage of `noselect`, which renders an unselectable dollar sign followed by a space.
-<pre data-lt-active="false" class="maxOneScreenHigh copyContainer" id="id59feb02aa3b9">{% pre copyButton %}
+```
+{% pre copyButton %}
 {% noselect %}Contents of pre tag
-{% endpre %}</pre>
+{% endpre %}
+```
 
 Generates:
 
-<pre data-lt-active="false" class="maxOneScreenHigh copyContainer" id="id7935a9ec84be">&lt;pre data-lt-active='false' class='maxOneScreenHigh copyContainer' id='id8103adbe3dc2'&gt;&lt;button class='copyBtn' data-clipboard-target='#id8103adbe3dc2' title='Copy to clipboard'&gt;&lt;img src='images/clippy.svg' alt='Copy to clipboard' style='width: 13px'&gt;&lt;/button&gt;&lt;span class='unselectable'&gt;$ &lt;/span&gt;Contents of pre tag&lt;/pre&gt;</pre>
+```
+<pre data-lt-active='false' class='maxOneScreenHigh copyContainer' id='id1e4a8fe53480'><button class='copyBtn' data-clipboard-target='#id1e4a8fe53480' title='Copy to clipboard'><img src='/assets/images/clippy.svg' alt='Copy to clipboard' style='width: 13px'></button><span class='unselectable'>$ </span>Contents of pre tag</pre>
+```
 
 Which renders as:
 
-<pre data-lt-active="false" class="maxOneScreenHigh copyContainer" id="id8103adbe3dc2"><button class="copyBtn" data-clipboard-target="#id8103adbe3dc2" title="Copy to clipboard"><img src="images/clippy.svg" alt="Copy to clipboard" style="width: 13px"></button><span class="unselectable">$ </span>Contents of pre tag</pre>
+![example 3](images/usage3example.png)
+
 
-### Usage Example 4
+### Example 4
 This example generates a copy button and does demonstrates the `noselect` being used twice:
 the first time to render an unselectable custom prompt,
 and the second time to render unselectable output.
 
-<pre data-lt-active="false" class="maxOneScreenHigh copyContainer" id="id0f0a8de5ecc5">{% pre copyButton %}{% noselect &gt;&gt;&gt; %}Contents of pre tag
+```
+{% pre copyButton %}
+{% noselect &gt;&gt;&gt; %}Contents of pre tag
 {% noselect How now brown cow%}
-{% endpre %}</pre>
+{% endpre %}
+```
 
 Generates:
-<pre data-lt-active="false" class="maxOneScreenHigh copyContainer" id="id3095048e2ec2">&lt;pre data-lt-active='false' class='maxOneScreenHigh copyContainer' id='idcb8035dc3766'&gt;&lt;button class='copyBtn' data-clipboard-target='#idcb8035dc3766' title='Copy to clipboard'&gt;&lt;img src='images/clippy.svg' alt='Copy to clipboard' style='width: 13px'&gt;&lt;/button&gt;&lt;span class='unselectable'&gt;&gt;&gt;&gt; &lt;/span&gt;contents of pre tag
-&lt;span class='unselectable'&gt;How now brown cow&lt;/span&gt;&lt;/pre&gt;</pre>
+```
+<pre data-lt-active='false' class='maxOneScreenHigh copyContainer' id='idb58a6cf1761c'><button class='copyBtn' data-clipboard-target='#idb58a6cf1761c' title='Copy to clipboard'><img src='/assets/images/clippy.svg' alt='Copy to clipboard' style='width: 13px'></button><span class='unselectable'>>>> </span>contents of pre tag
+<span class='unselectable'>How now brown cow</span></pre>
+```
 
 Which renders as:
 
-<pre data-lt-active="false" class="maxOneScreenHigh copyContainer" id="idcb8035dc3766"><button class="copyBtn" data-clipboard-target="#idcb8035dc3766" title="Copy to clipboard"><img src="images/clippy.svg" alt="Copy to clipboard" style="width: 13px"></button><span class="unselectable">&gt;&gt;&gt; </span>contents of pre tag
-<span class="unselectable">How now brown cow</span></pre>
+![example 4](images/usage4example.png)
+
 
 ### CSS
-Here are the CSS declarations that I defined pertaining to the `pre` and `noselect` tags:
+Here are the CSS declarations that I defined pertaining to the `pre` and `noselect` tags that produced the above images:
 
-<pre data-lt-active="false" class="maxOneScreenHigh copyContainer" id="id68ec1ab4d04c"><button class="copyBtn" data-clipboard-target="#id68ec1ab4d04c" title="Copy to clipboard"><img src="images/clippy.svg" alt="Copy to clipboard" style="width: 13px"></button>.maxOneScreenHigh {
+```css
+.maxOneScreenHigh {
   max-height: 500px;
 }
 
@@ -110,13 +144,15 @@ Here are the CSS declarations that I defined pertaining to the `pre` and `nosele
   -moz-user-select: none;
   -khtml-user-select: none;
   user-select: none;
-}</pre>
+}
+```
+
 
 ### Comprehensive Example
 The code I wrote to generate the above CSS was a good example of how the plugins work together with
-the `from` and `to` tags from my `from_to_until` plugin:
+the `from` and `to` tags from my [`from_to_until`](https://github.com/mslinn/jekyll_from_to_until) plugin:
 
-<pre data-lt-active="false" class="maxOneScreenHigh copyContainer" id="id1ad3df5c4a2f">
+```
 {% capture css %}{% flexible_include '_sass/mystyle.scss' %}{% endcapture %}
 {% pre copyButton %}{{ css | from: '.copyBtn' | to: '^$' | strip }}
 
@@ -125,19 +161,62 @@ the `from` and `to` tags from my `from_to_until` plugin:
 {{ css | from: '.maxOneScreenHigh' | to: '^$' | strip }}
 
 {{ css | from: '.unselectable' | to: '^$' | strip }}
-{% endpre %}</pre>
+{% endpre %}
+```
 
 
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+After checking out the repo, run `bin/setup` to install dependencies.
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
 
-## Contributing
+### Build and Install Locally
+To build and install this gem onto your local machine, run:
+```shell
+$ rake install:local
+```
+
+The following also does the same thing:
+```shell
+$ bundle exec rake install
+```
+
+Examine the newly built gem:
+```shell
+$ gem info jekyll_pre
+
+*** LOCAL GEMS ***
+
+jekyll_pre (1.0.0)
+    Author: Mike Slinn
+    Homepage:
+    https://github.com/mslinn/jekyll_pre
+    License: MIT
+    Installed at: /home/mslinn/.gems
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/jekyll_pre.
+    Generates Jekyll logger with colored output.
+```
+
+
+### Build and Push to RubyGems
+To release a new version,
+  1. Update the version number in `version.rb`.
+  2. Commit all changes to git; if you don't the next step might fail with an unexplainable error message.
+  3. Run the following:
+     ```shell
+     $ bundle exec rake release
+     ```
+     The above creates a git tag for the version, commits the created tag,
+     and pushes the new `.gem` file to [RubyGems.org](https://rubygems.org).
+
+
+## Contributing
+1. Fork the project
+2. Create a descriptively named feature branch
+3. Add your feature
+4. Submit a pull request
 
 
 ## License

data/Rakefile

@@ -1,4 +1,7 @@
 # frozen_string_literal: true
 
 require "bundler/gem_tasks"
-task default: %i[]
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+task :default => :spec

data/jekyll_pre.gemspec

@@ -2,45 +2,47 @@
 
 require_relative "lib/jekyll_pre/version"
 
+# rubocop:disable Metrics/BlockLength
 Gem::Specification.new do |spec|
-  spec.name = "jekyll_pre"
-  spec.version = JekyllPre::VERSION
+  github = "https://github.com/mslinn/jekyll_pre"
+
   spec.authors = ["Mike Slinn"]
+  spec.bindir = "exe"
+  spec.description = <<~END_OF_DESC
+    Jekyll tags pre and noselect, for HTML <pre/> tag, prompts and unselectable text. Can number lines.
+  END_OF_DESC
   spec.email = ["mslinn@mslinn.com"]
-
-  spec.summary = "Jekyll tags pre and noselect, for HTML <pre/> tag, prompts and unselectable text."
-  spec.description = "Jekyll tags pre and noselect, for HTML <pre/> tag, prompts and unselectable text."
-  spec.homepage = "https://github.com/mslinn/jekyll_pre"
+  spec.files = Dir[".rubocop.yml", "LICENSE.*", "Rakefile", "{lib,spec}/**/*", "*.gemspec", "*.md"]
+  spec.homepage = "https://www.mslinn.com/blog/2020/10/03/jekyll-plugins.html#pre"
   spec.license = "MIT"
-  spec.required_ruby_version = ">= 2.6.0"
-
-  spec.metadata["allowed_push_host"] = "https://rubygems.org"
+  spec.metadata = {
+    "allowed_push_host" => "https://rubygems.org",
+    "bug_tracker_uri"   => "#{github}/issues",
+    "changelog_uri"     => "#{github}/CHANGELOG.md",
+    "homepage_uri"      => spec.homepage,
+    "source_code_uri"   => github,
+  }
+  spec.name = "jekyll_pre"
+  spec.post_install_message = <<~END_MESSAGE
 
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = "https://github.com/mslinn/jekyll_pre"
-  spec.metadata["changelog_uri"] = "https://github.com/mslinn/jekyll_pre/CHANGELOG.md"
+    Thanks for installing #{spec.name}!
 
-  # Specify which files should be added to the gem when it is released.
-  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files = Dir.chdir(File.expand_path(__dir__)) do
-    `git ls-files -z`.split("\x0").reject do |f|
-      (f == __FILE__) || f.match(%r{\A(?:(?:bin|test|spec|features)/|\.(?:git|travis|circleci)|appveyor)})
-    end
-  end
-  spec.bindir = "exe"
-  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  END_MESSAGE
   spec.require_paths = ["lib"]
+  spec.required_ruby_version = ">= 2.6.0"
+  spec.summary = "Jekyll tags pre and noselect, for HTML <pre/> tag, prompts and unselectable text. Can number lines."
+  spec.test_files = spec.files.grep(%r!^(test|spec|features)/!)
+  spec.version = JekyllPre::VERSION
 
-  spec.add_dependency 'jekyll'
+  spec.add_dependency "jekyll", ">= 3.5.0"
+  spec.add_dependency "jekyll_plugin_logger"
+  spec.add_dependency "key-value-parser"
+  spec.add_dependency "shellwords"
 
-  spec.add_development_dependency 'bundler'
-  spec.add_development_dependency 'debase'
-  spec.add_development_dependency 'jekyll'
-  spec.add_development_dependency 'pry'
-  spec.add_development_dependency 'rake'
-  spec.add_development_dependency 'rspec'
-  spec.add_development_dependency 'rubocop'
-  spec.add_development_dependency 'rubocop-jekyll'
-  spec.add_development_dependency 'rubocop-rake'
-  spec.add_development_dependency 'ruby-debug-ide'
+  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"
 end
+# rubocop:enable Metrics/BlockLength

data/lib/jekyll_pre/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module JekyllPre
-  VERSION = "1.0.0"
+  VERSION = "1.1.0"
 end

data/lib/jekyll_pre.rb

@@ -1,91 +1,122 @@
 # frozen_string_literal: true
 
+require "liquid"
+require "jekyll_plugin_logger"
 require_relative "jekyll_pre/version"
 
-module JekyllPre
-  class Error < StandardError; end
-
-  # """
-  #   \\{% pre %}
-  #   Content here
-  #   \\{% endpre %}
-  #
-  #   \\{% pre copyButton %}
-  #   Content here
-  #   \\{% endpre %}"""
-  #
-  #   \\{% pre shell %}
-  #   Content here
-  #   \\{% endpre %}
-  #
-  #   \\{% pre copyButton shell %}
-  #   Content here
-  #   \\{% endpre %}
-  #
-  #   \\{% pre copyButton label %}
-  #   Content here
-  #   \\{% endpre %}"""
-  class PreTagBlock < Liquid::Block
-    @@prefix = "<button class='copyBtn' data-clipboard-target="
-    @@suffix = " title='Copy to clipboard'><img src='/assets/images/clippy.svg' " \
-               "alt='Copy to clipboard' style='width: 13px'></button>"
-
-    def self.make_copy_button(pre_id)
-      "#{@@prefix}'##{pre_id}'#{@@suffix}"
-    end
+module JekyllPluginPreName
+  PLUGIN_NAME = "jekyll_pre"
+end
 
-    def self.make_pre(make_copy_button, label, content)
-      label = if label.to_s.empty?
-                ''
-              elsif label.to_s.downcase.strip == 'shell'
-                "<div class='codeLabel unselectable' data-lt-active='false'>Shell</div>"
-              else
-                "<div class='codeLabel unselectable' data-lt-active='false'>#{label}</div>"
-              end
-      pre_id = "id#{SecureRandom.hex(6)}"
-      copy_button = make_copy_button ? PreTagBlock.make_copy_button(pre_id) : ''
-      "#{label}<pre data-lt-active='false' class='maxOneScreenHigh copyContainer' id='#{pre_id}'>#{copy_button}#{content.strip}</pre>"
-    end
+# """
+#   \\{% pre %}
+#   Content here
+#   \\{% endpre %}
+#
+#   \\{% pre copyButton %}
+#   Content here
+#   \\{% endpre %}"""
+#
+#   \\{% pre shell %}
+#   Content here
+#   \\{% endpre %}
+#
+#   \\{% pre copyButton shell %}
+#   Content here
+#   \\{% endpre %}
+#
+#   \\{% pre copyButton label %}
+#   Content here
+#   \\{% endpre %}"""
+class PreTagBlock < Liquid::Block
+  @@prefix = "<button class='copyBtn' data-clipboard-target="
+  @@suffix = " title='Copy to clipboard'><img src='/assets/images/clippy.svg' " \
+             "alt='Copy to clipboard' style='width: 13px'></button>"
 
-    # @param tag_name [String] is the name of the tag, which we already know.
-    # @param text [Hash, String, Liquid::Tag::Parser] the arguments from the web page.
-    # @param tokens [Liquid::ParseContext] tokenized command line
-    # @return [void]
-    def initialize(tag_name, text, tokens)
-      super(tag_name, text, tokens)
-      text = '' if text.nil?
-      text.strip!
-      @make_copy_button = text.include? 'copyButton'
-      remaining_text = text.sub('copyButton', '').strip
-      #puts "@make_copy_button = '#{@make_copy_button}'; text = '#{text}'; remaining_text = '#{remaining_text}'"
-      @label = remaining_text
-    end
+  def self.make_copy_button(pre_id)
+    "#{@@prefix}'##{pre_id}'#{@@suffix}"
+  end
 
-    # Method prescribed by the Jekyll plugin lifecycle.
-    # @return [String]
-    def render(context)
-      content = super
-      # puts "@make_copy_button = '#{@make_copy_button}'; @label = '#{@label}'"
-      PreTagBlock.make_pre(@make_copy_button, @label, content)
-    end
+  def self.make_pre(make_copy_button, number_lines, label, content)
+    label = if label.to_s.empty?
+              ""
+            elsif label.to_s.downcase.strip == "shell"
+              "<div class='codeLabel unselectable' data-lt-active='false'>Shell</div>"
+            else
+              "<div class='codeLabel unselectable' data-lt-active='false'>#{label}</div>"
+            end
+    pre_id = "id#{SecureRandom.hex(6)}"
+    copy_button = make_copy_button ? PreTagBlock.make_copy_button(pre_id) : ""
+    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>"
   end
 
-  # """\\{% noselect %} or \\{% noselect this all gets copied.
-  # Also, space before the closing percent is signficant %}"""
-  class UnselectableTag < Liquid::Tag
-    def initialize(tag_name, text, tokens)
-      super(tag_name, text, tokens)
-      @content = text
-      # puts "UnselectableTag: content1= '#{@content}'"
-      @content = '$ ' if @content.nil? || @content.empty?
-      # puts "UnselectableTag: content2= '#{@content}'"
+  def self.number_content(content)
+    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, " ")
+      "<span class='unselectable numbered_line'> #{number}: </span>#{line}"
     end
+    result = numbered_content.join("\n")
+    result += "\n" unless result.end_with?("\n")
+    result
+  end
 
-    def render(_)
-      "<span class='unselectable'>#{@content}</span>"
-    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 _tokens [Liquid::ParseContext] tokenized command line
+  # @return [void]
+  def initialize(_tag_name, argument_string, _tokens)
+    super
+    argument_string = "" if argument_string.nil?
+    argument_string.strip!
+
+    @logger = PluginMetaLogger.instance.new_logger(self)
+
+    @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}'" }
+  end
+
+  # Method prescribed by the Jekyll plugin lifecycle.
+  # @return [String]
+  def render(context)
+    content = super
+    @logger.debug { "@make_copy_button = '#{@make_copy_button}'; @label = '#{@label}'" }
+    PreTagBlock.make_pre(@make_copy_button, @number_lines, @label, content)
+  end
+end
+
+# """\\{% noselect %} or \\{% noselect this all gets copied.
+# 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 _tokens [Liquid::ParseContext] tokenized command line
+  # @return [void]
+  def initialize(_tag_name, argument_string, _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}'" }
+  end
+
+  def render(_)
+    "<span class='unselectable'>#{@argument_string}</span>"
   end
 end
 
-Liquid::Template.register_tag('pre', JekyllPre::PreTagBlock)
-Liquid::Template.register_tag('noselect', JekyllPre::UnselectableTag)
+PluginMetaLogger.instance.info { "Loaded #{JekyllPluginPreName::PLUGIN_NAME} v#{JekyllPre::VERSION} plugin." }
+Liquid::Template.register_tag("pre", PreTagBlock)
+Liquid::Template.register_tag("noselect", UnselectableTag)

data/spec/pre_spec.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require "fileutils"
+require "jekyll"
+require "key_value_parser"
+require "shellwords"
+require_relative "../lib/jekyll_pre"
+
+RSpec.describe(PreTagBlock) do
+  it "parses arguments" do
+    argv = Shellwords.split "number copyButton shell"
+    options = KeyValueParser.new.parse(argv)
+    # puts options.map { |k, v| "#{k} = #{v}" }.join("\n")
+
+    expect(options[:copyButton]).to be true
+    expect(options[:number]).to be true
+    expect(options[:shell]).to be true
+  end
+
+  it "numbers content lines" 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
+    numbered_content = PreTagBlock.number_content(content)
+    expected_content = <<~END_CONTENT
+      <span class='unselectable numbered_line'>  1: </span>Line 1
+      <span class='unselectable numbered_line'>  2: </span>  Line 2
+      <span class='unselectable numbered_line'>  3: </span>    Line 3
+      <span class='unselectable numbered_line'>  4: </span>    Line 4
+      <span class='unselectable numbered_line'>  5: </span>  Line 5
+      <span class='unselectable numbered_line'>  6: </span>Line 6
+      <span class='unselectable numbered_line'>  7: </span>Line 7
+      <span class='unselectable numbered_line'>  8: </span>  Line 8
+      <span class='unselectable numbered_line'>  9: </span>  Line 9
+      <span class='unselectable numbered_line'> 10: </span>Line 10
+    END_CONTENT
+    expect(numbered_content).to eq(expected_content)
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require "jekyll"
+require "fileutils"
+require "key_value_parser"
+require "shellwords"
+
+require_relative "../lib/jekyll_pre"
+
+Jekyll.logger.log_level = :info
+
+RSpec.configure do |config|
+  config.filter_run :focus
+  config.order = "random"
+  config.run_all_when_everything_filtered = true
+
+  # See https://relishapp.com/rspec/rspec-core/docs/command-line/only-failures
+  config.example_status_persistence_file_path = "spec/status_persistence.txt"
+end

data/spec/status_persistence.txt

@@ -0,0 +1,4 @@
+example_id              | status | run_time        |
+----------------------- | ------ | --------------- |
+./spec/pre_spec.rb[1:1] | passed | 0.00253 seconds |
+./spec/pre_spec.rb[1:2] | passed | 0.00203 seconds |

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll_pre
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Mike Slinn
-autorequire:
+autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-03-13 00:00:00.000000000 Z
+date: 2022-03-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -16,92 +16,22 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 3.5.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: bundler
-  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: 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: jekyll
-  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: pry
-  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'
+        version: 3.5.0
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: jekyll_plugin_logger
   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: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -109,13 +39,13 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rubocop
+  name: key-value-parser
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -123,13 +53,13 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rubocop-jekyll
+  name: shellwords
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -137,7 +67,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rubocop-rake
+  name: debase
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -164,40 +94,40 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: Jekyll tags pre and noselect, for HTML <pre/> tag, prompts and unselectable
-  text.
+description: 'Jekyll tags pre and noselect, for HTML <pre/> tag, prompts and unselectable
+  text. Can number lines.
+
+'
 email:
 - mslinn@mslinn.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".rspec"
 - ".rubocop.yml"
-- ".ruby-version"
-- ".vscode/launch.json"
-- ".vscode/settings.json"
 - CHANGELOG.md
-- Gemfile
-- Gemfile.lock
 - LICENSE.txt
 - README.md
 - Rakefile
-- images/clippy.svg
-- images/clippy.svg:Zone.Identifier
 - jekyll_pre.gemspec
 - lib/jekyll_pre.rb
 - lib/jekyll_pre/version.rb
-- sig/jekyll_pre.rbs
-homepage: https://github.com/mslinn/jekyll_pre
+- spec/pre_spec.rb
+- spec/spec_helper.rb
+- spec/status_persistence.txt
+homepage: https://www.mslinn.com/blog/2020/10/03/jekyll-plugins.html#pre
 licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-  homepage_uri: https://github.com/mslinn/jekyll_pre
-  source_code_uri: https://github.com/mslinn/jekyll_pre
+  bug_tracker_uri: https://github.com/mslinn/jekyll_pre/issues
   changelog_uri: https://github.com/mslinn/jekyll_pre/CHANGELOG.md
-post_install_message:
+  homepage_uri: https://www.mslinn.com/blog/2020/10/03/jekyll-plugins.html#pre
+  source_code_uri: https://github.com/mslinn/jekyll_pre
+post_install_message: |2+
+
+  Thanks for installing jekyll_pre!
+
 rdoc_options: []
 require_paths:
 - lib
@@ -212,9 +142,12 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.3
-signing_key:
+rubygems_version: 3.1.4
+signing_key: 
 specification_version: 4
 summary: Jekyll tags pre and noselect, for HTML <pre/> tag, prompts and unselectable
-  text.
-test_files: []
+  text. Can number lines.
+test_files:
+- spec/pre_spec.rb
+- spec/spec_helper.rb
+- spec/status_persistence.txt

data/.rspec

@@ -1,2 +0,0 @@
---color
---format progress

data/.ruby-version

@@ -1 +0,0 @@
-3.0.0

data/.vscode/launch.json

@@ -1,47 +0,0 @@
-{
-  // Use IntelliSense to learn about possible attributes.
-  // Hover to view descriptions of existing attributes.
-  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
-  "version": "0.2.0",
-  "configurations": [
-    {
-      "cwd": "${workspaceRoot}",
-      "name": "Attach rdebug-ide",
-      "request": "attach",
-      "remoteHost": "localhost",
-      "remotePort": "1234",
-      "remoteWorkspaceRoot": "/",
-      "restart": true,
-      "showDebuggerOutput": true,
-      "stopOnEntry": true,
-      "type": "Ruby",
-    },
-    {
-      "args": [
-        "-I",
-        "${workspaceRoot}",
-        "${file}"
-      ],
-      "cwd": "${workspaceRoot}",
-      "name": "RSpec - active spec file only",
-      "program": "${env:HOME}/.rbenv/shims/rspec",
-      "showDebuggerOutput": false,
-      "request": "launch",
-      "type": "Ruby",
-      "useBundler": true,
-    },
-    {
-      "args": [
-        "-I",
-        "${workspaceRoot}"
-      ],
-      "cwd": "${workspaceRoot}",
-      "name": "RSpec - all",
-      "program": "${env:HOME}/.rbenv/shims/rspec",
-      "request": "launch",
-      "showDebuggerOutput": false,
-      "type": "Ruby",
-      "useBundler": true,
-    }
-  ]
-}

data/.vscode/settings.json

@@ -1,3 +0,0 @@
-{
-  "ruby.rubocop.configFilePath": ".rubocop.yml"
-}

data/Gemfile

@@ -1,8 +0,0 @@
-# frozen_string_literal: true
-
-source "https://rubygems.org"
-
-# Specify your gem's dependencies in jekyll_pre.gemspec
-gemspec
-
-gem "rake", "~> 13.0"

data/Gemfile.lock

@@ -1,134 +0,0 @@
-PATH
-  remote: .
-  specs:
-    jekyll_pre (1.0.0)
-      jekyll
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    addressable (2.8.0)
-      public_suffix (>= 2.0.2, < 5.0)
-    ast (2.4.2)
-    coderay (1.1.3)
-    colorator (1.1.0)
-    concurrent-ruby (1.1.9)
-    debase (0.2.4.1)
-      debase-ruby_core_source (>= 0.10.2)
-    debase-ruby_core_source (0.10.14)
-    diff-lcs (1.5.0)
-    em-websocket (0.5.3)
-      eventmachine (>= 0.12.9)
-      http_parser.rb (~> 0)
-    eventmachine (1.2.7)
-    ffi (1.15.5)
-    forwardable-extended (2.6.0)
-    http_parser.rb (0.8.0)
-    i18n (1.10.0)
-      concurrent-ruby (~> 1.0)
-    jekyll (4.2.2)
-      addressable (~> 2.4)
-      colorator (~> 1.0)
-      em-websocket (~> 0.5)
-      i18n (~> 1.0)
-      jekyll-sass-converter (~> 2.0)
-      jekyll-watch (~> 2.0)
-      kramdown (~> 2.3)
-      kramdown-parser-gfm (~> 1.0)
-      liquid (~> 4.0)
-      mercenary (~> 0.4.0)
-      pathutil (~> 0.9)
-      rouge (~> 3.0)
-      safe_yaml (~> 1.0)
-      terminal-table (~> 2.0)
-    jekyll-sass-converter (2.2.0)
-      sassc (> 2.0.1, < 3.0)
-    jekyll-watch (2.2.1)
-      listen (~> 3.0)
-    kramdown (2.3.1)
-      rexml
-    kramdown-parser-gfm (1.1.0)
-      kramdown (~> 2.0)
-    liquid (4.0.3)
-    listen (3.7.1)
-      rb-fsevent (~> 0.10, >= 0.10.3)
-      rb-inotify (~> 0.9, >= 0.9.10)
-    mercenary (0.4.0)
-    method_source (1.0.0)
-    parallel (1.21.0)
-    parser (3.1.1.0)
-      ast (~> 2.4.1)
-    pathutil (0.16.2)
-      forwardable-extended (~> 2.6)
-    pry (0.14.1)
-      coderay (~> 1.1)
-      method_source (~> 1.0)
-    public_suffix (4.0.6)
-    rainbow (3.1.1)
-    rake (13.0.6)
-    rb-fsevent (0.11.1)
-    rb-inotify (0.10.1)
-      ffi (~> 1.0)
-    regexp_parser (2.2.1)
-    rexml (3.2.5)
-    rouge (3.28.0)
-    rspec (3.11.0)
-      rspec-core (~> 3.11.0)
-      rspec-expectations (~> 3.11.0)
-      rspec-mocks (~> 3.11.0)
-    rspec-core (3.11.0)
-      rspec-support (~> 3.11.0)
-    rspec-expectations (3.11.0)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.11.0)
-    rspec-mocks (3.11.0)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.11.0)
-    rspec-support (3.11.0)
-    rubocop (1.18.4)
-      parallel (~> 1.10)
-      parser (>= 3.0.0.0)
-      rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.8, < 3.0)
-      rexml
-      rubocop-ast (>= 1.8.0, < 2.0)
-      ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 3.0)
-    rubocop-ast (1.16.0)
-      parser (>= 3.1.1.0)
-    rubocop-jekyll (0.12.0)
-      rubocop (~> 1.18.0)
-      rubocop-performance (~> 1.2)
-    rubocop-performance (1.13.3)
-      rubocop (>= 1.7.0, < 2.0)
-      rubocop-ast (>= 0.4.0)
-    rubocop-rake (0.6.0)
-      rubocop (~> 1.0)
-    ruby-debug-ide (0.7.3)
-      rake (>= 0.8.1)
-    ruby-progressbar (1.11.0)
-    safe_yaml (1.0.5)
-    sassc (2.4.0)
-      ffi (~> 1.9)
-    terminal-table (2.0.0)
-      unicode-display_width (~> 1.1, >= 1.1.1)
-    unicode-display_width (1.8.0)
-
-PLATFORMS
-  x86_64-linux
-
-DEPENDENCIES
-  bundler
-  debase
-  jekyll
-  jekyll_pre!
-  pry
-  rake (~> 13.0)
-  rspec
-  rubocop
-  rubocop-jekyll
-  rubocop-rake
-  ruby-debug-ide
-
-BUNDLED WITH
-   2.3.8

data/images/clippy.svg

@@ -1,3 +0,0 @@
-<svg height="1024" width="896" xmlns="http://www.w3.org/2000/svg">
-  <path d="M128 768h256v64H128v-64z m320-384H128v64h320v-64z m128 192V448L384 640l192 192V704h320V576H576z m-288-64H128v64h160v-64zM128 704h160v-64H128v64z m576 64h64v128c-1 18-7 33-19 45s-27 18-45 19H64c-35 0-64-29-64-64V192c0-35 29-64 64-64h192C256 57 313 0 384 0s128 57 128 128h192c35 0 64 29 64 64v320h-64V320H64v576h640V768zM128 256h512c0-35-29-64-64-64h-64c-35 0-64-29-64-64s-29-64-64-64-64 29-64 64-29 64-64 64h-64c-35 0-64 29-64 64z" />
-</svg>

data/sig/jekyll_pre.rbs

@@ -1,4 +0,0 @@
-module JekyllPre
-  VERSION: String
-  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-end