jekyll_plugin_support 0.8.3 → 0.8.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c9953a9a01da37cddcb43f16784ba12afbb90eeea9df7b7346b6593e7d7b483e
-  data.tar.gz: 69d7a9885fc9d3dfaa8308f8a4cfc989a42e3a0b6e5af76ce65a9b0b7dd081b1
+  metadata.gz: 0d96d3f40ca733d7fa1322a8fbec0a70131029baa063a32c55fdc003efcf0d24
+  data.tar.gz: 2ebb3e46419147a2f1b60e2024fd7118617be61c6cd8f359e448aad2279bf92f
 SHA512:
-  metadata.gz: ca1c2618a298fda325a4aa4a4b9d62e1c16d1ead64c1737390aa73fdd4326f7c7d6f3830155a6c6aa7c286fc50ec376c8c4ffcd4ba6698b00f1ce85769217368
-  data.tar.gz: 32702f17fbfb0bcc87df9f6f7033b210adade31c67d29aaa4daa7ebc0d3c4677a885ec088404caa787f00697d4d81f1e017108e4fc6c2a5ec9f5f19a5c16839a
+  metadata.gz: f4022b99e9b6b1eef55be72e3cbe6a8d99af12e6ec0004a1e2c610325c726ffdf5cef042ce8687eb9be4e352fc7372e3a51f7053e39303cb06ff2dd5f180d530
+  data.tar.gz: 6d6b5d1221e8985a02bc8bfe32d6411cb516aa4376a0a3f27d9dc6d7b66bee43ce41c02b026e102f9b5035f0b6b116cf8983e1b8b6cea3847a5c2d70733cff69

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 # Change Log
 
 
+## 0.8.4 / 2024-02-27
+
+* Problem in error handler fixed.
+
+
 ## 0.8.3 / 2024-01-05
 
 * Variables defined in front matter of layouts and pages are now handled.

data/README.md

@@ -26,6 +26,27 @@ Plugins that use `jekyll_plugin_support` include:
 [`jekyll_plugin_support`](https://github.com/mslinn/jekyll_plugin_support/tree/master/demo/_plugins)
 
 
+## Features
+
+Jekyll plugin tags created from `jekyll_plugin_support` framework automatically have the following features:
+
+1. Boilerplate is removed, so you can focus on the required logic and output.
+2. Arguments are parsed for keywords and name/value parameters.
+3. Single or double quotes can be used for arguments and parameters.
+4. Important variables are defined.
+5. Error handling is standardized, and includes an automatically defined error type
+   and corresponding CSS tag for each Jekyll tag.
+6. Liquid variables can be passed as parameters to tags, and used in the body of block tags.
+7. Registration is automatic, and important configuration details are reported during registration.
+8. A custom logger is created for each tag, independent of the default Jekyll logger.
+9. Variables can be defined in `_config.yml`, and optionally have different values for debug mode,
+   production mode and test mode.
+10. An attribution message is available.
+11. Draft pages are automatically detected.
+
+In addition, a demonstration website is provided for easy testing of your plugins.
+
+
 ## Installation
 
 `Jekyll_plugin_support` is packaged as a Ruby gem.
@@ -297,11 +318,14 @@ After your plugin has parsed all the keyword options and name/value parameters,
 call `@helper.remaining_markup` to obtain the remaining markup that was passed to your plugin.
 
 
-## Liquid Variable Definitions
+## Configuration Variables
 
 `jekyll_plugin_support` provides support for
 [Liquid variables](https://shopify.github.io/liquid/tags/variable/)
 to be defined in `_config.yml`, in a section called `liquid-vars`.
+These variables behave exactly like Liquid variables defined by `assign` and `capture` expressions,
+except they are global in scope; these variables are available in every Jekyll web page.
+
 The following `_config.yml` fragment defines 3 variables called `var1`, `var2` and `var3`:
 
 ```yaml
@@ -312,18 +336,44 @@ liquid-vars:
 ```
 
 Liquid variables defined in this manner are intended to be embedded in a webpage.
-They are expanded transparently, and can be referenced like any other Liquid variable.
-These Liquid variables can be passed as parameters to other plugins and includes.
+They are can be used like any other Liquid variable.
+
+
+### Variable Expansion
+
+Jekyll expands Liquid variable references during the page rendering process.
+Jekyll does not expand Liquid variable references passes as parameters to tag and block plugins, however.
+However, plugins made from `jekyll_plugin_support` automatically
+expand all types of variable references passed as parameters and in block tag bodies.
 
-In the following example web page, the Liquid variable called `var1` is expanded as part of the displayed page.
-Liquid variables `var1` and `var2` are expanded and passed to the `my_plugin` plugin.
+`Jekyll_plugin_support` tag and block plugins expand the following types of variables:
+
+* Jekyll_plugin_support configuration variables, discussed above.
+* Jekyll [page](https://jekyllrb.com/docs/variables/#page-variables) and
+  [layout](https://jekyllrb.com/docs/layouts/#variables) variables.
+* Inline Liquid variables (defined in [assign](https://shopify.dev/docs/api/liquid/tags/assign) and [capture](https://shopify.dev/docs/api/liquid/tags/capture) statements).
+
+In the following example web page, Jekyll expands the `var1` reference within the `<p></p>` tag,
+but not the `var1` or `var2` references passed to `my_plugin`.
 
 ```html
-This is the value of var1: {{var1}}.
+<p>This is the value of var1: {{var1}}.</p>
 
 {% my_plugin param1="{{var1}}" param2="{{var2}}" %}
 ```
 
+Assuming that `my_plugin` was written as a `jekyll_plugin_support` plugin,
+all variable references in its parameters are expanded.
+Thus, the above is interpreted as follows when `my_plugin` is evaluated during the Jekyll rendering process:
+</p>
+
+```html
+<p>This is the value of var1: value1.</p>
+
+{% my_plugin param1="value1" param2="value 2" %}
+```
+
+
 `Jekyll_plugin_support` expands most of the [plugin variables described above](#predefined-variables),
 replacing Liquid variable references with their values.
 The exception is `@argument_string`, which is not expanded.

data/lib/jekyll_plugin_support/version.rb

@@ -1,3 +1,3 @@
 module JekyllPluginSupportVersion
-  VERSION = '0.8.3'.freeze
+  VERSION = '0.8.4'.freeze
 end

data/lib/jekyll_plugin_support_tag.rb

@@ -63,7 +63,9 @@ module JekyllSupport
       render_impl
     rescue StandardError => e
       e.shorten_backtrace
-      @logger.error { "#{e.class} on line #{@line_number} of #{e.backtrace[0].split(':').first} while processing #{tag_name} - #{e.message}" }
+      file_name = e.backtrace[0]&.split(':')&.first
+      of_file_name = "of #{file_name} " if file_name
+      @logger.error { "#{e.class} on line #{@line_number} #{of_file_name}while processing #{tag_name} - #{e.message}" }
       binding.pry if @pry_on_standard_error # rubocop:disable Lint/Debugger
       raise e if @die_on_standard_error
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll_plugin_support
 version: !ruby/object:Gem::Version
-  version: 0.8.3
+  version: 0.8.4
 platform: ruby
 authors:
 - Mike Slinn
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-01-06 00:00:00.000000000 Z
+date: 2024-02-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: facets
@@ -139,7 +139,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
+rubygems_version: 3.5.6
 signing_key:
 specification_version: 4
 summary: Provides a framework for writing and testing Jekyll plugins