jekyll-link-attributes 1.0.1 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ed356ca2469b67757d91ce556bd251a74c77568a8e59df78566484ca905f23fc
-  data.tar.gz: 3de4e708cf72fc5f7bf6e0b59cbf0fa36d316858e67fe760e5997aa49d4b58e6
+  metadata.gz: d791371caa0d64c3b9f0be8b0166c0dee989a8ba462e58c07ccef19625652fae
+  data.tar.gz: 56525b68f3c8ffb2568792b64b1e0e7c271d82cb742d77eaba772db3f7cd5112
 SHA512:
-  metadata.gz: dbe5f18b8e6e205293abe1c6cdea0c793fa4badc5e7c362f848ae099c7d01d2999736f0540c9bec6e1f47d3e0c6f32f8bc52cd213f9998892a39565828723538
-  data.tar.gz: a7318d90c5a161b75bbf56591b635f78c40902ac2c0dec5d1e62511bc982d29e7fa41fdddd023992da2e91e34c9452ad80eea82b346a162052b724de2681cd3c
+  metadata.gz: 0de1970490f37a7cce17f43303b234957aaf23f9f6fa10514d2e04da2a2c654d4d6b2aa4c9f0099ae1a555701da14f5724c72606c9f2ac610dd3b50a9dbf3bb7
+  data.tar.gz: 10bdda6fbaa8ef263b9a3648391fef15031ef507e36307632fceb011037f38c201b131dc718ce8dd6abd8154afec57cdfbd8febb4bd6290c37ea617d6227f050

data/.gitignore

@@ -1,2 +1,2 @@
-.idea
+.idea
 jekyll-link-attributes-*.gem

data/.ruby-version

@@ -1 +1 @@
-3.1.0
+3.1.0

data/Gemfile

@@ -1,9 +1,9 @@
-# frozen_string_literal: true
-
-source 'https://rubygems.org'
-
-gemspec
-
-group :test do
-  gem 'rspec'
-end
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec
+
+group :test do
+  gem 'rspec'
+end

data/Gemfile.lock

@@ -1,98 +1,98 @@
-PATH
-  remote: .
-  specs:
-    jekyll-link-attributes (0.0.3)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    addressable (2.8.1)
-      public_suffix (>= 2.0.2, < 6.0)
-    colorator (1.1.0)
-    concurrent-ruby (1.1.10)
-    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.12.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.4.0)
-      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)
-    nokogiri (1.13.8-x86_64-darwin)
-      racc (~> 1.4)
-    nokogiri (1.13.8-x86_64-linux)
-      racc (~> 1.4)
-    pathutil (0.16.2)
-      forwardable-extended (~> 2.6)
-    public_suffix (5.0.0)
-    racc (1.6.0)
-    rake (10.5.0)
-    rb-fsevent (0.11.2)
-    rb-inotify (0.10.1)
-      ffi (~> 1.0)
-    rexml (3.2.5)
-    rouge (3.30.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.1)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.11.0)
-    rspec-support (3.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-darwin-20
-  x86_64-linux
-
-DEPENDENCIES
-  bundler (>= 2.0.0)
-  jekyll (>= 4.0.0)
-  jekyll-link-attributes!
-  nokogiri (>= 1.0.0)
-  rake (>= 10.0.0)
-  rspec
-
-BUNDLED WITH
-   2.3.21
+PATH
+  remote: .
+  specs:
+    jekyll-link-attributes (2.0.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.8.1)
+      public_suffix (>= 2.0.2, < 6.0)
+    colorator (1.1.0)
+    concurrent-ruby (1.1.10)
+    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.12.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.4.0)
+      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)
+    nokogiri (1.13.8-x86_64-darwin)
+      racc (~> 1.4)
+    nokogiri (1.13.8-x86_64-linux)
+      racc (~> 1.4)
+    pathutil (0.16.2)
+      forwardable-extended (~> 2.6)
+    public_suffix (5.0.0)
+    racc (1.6.0)
+    rake (10.5.0)
+    rb-fsevent (0.11.2)
+    rb-inotify (0.10.1)
+      ffi (~> 1.0)
+    rexml (3.2.5)
+    rouge (3.30.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.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.11.0)
+    rspec-support (3.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-darwin-20
+  x86_64-linux
+
+DEPENDENCIES
+  bundler (>= 2.0.0)
+  jekyll (>= 4.0.0)
+  jekyll-link-attributes!
+  nokogiri (>= 1.0.0)
+  rake (>= 10.0.0)
+  rspec
+
+BUNDLED WITH
+   2.3.21

data/LICENSE

@@ -1,25 +1,25 @@
-Copyright 2022 Twin Sun, LLC
-
-Redistribution and use in source and binary forms, with or without modification,
-are permitted provided that the following conditions are met:
-
-    * Redistributions of source code must retain the above copyright
-      notice, this list of conditions and the following disclaimer.
-    * Redistributions in binary form must reproduce the above
-      copyright notice, this list of conditions and the following
-      disclaimer in the documentation and/or other materials provided
-      with the distribution.
-    * Neither the name of Twin Sun, LLC nor the names of its
-      contributors may be used to endorse or promote products derived
-      from this software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
-ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
-WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
-ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
-(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
-LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
-ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+Copyright 2022 Twin Sun, LLC
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above
+      copyright notice, this list of conditions and the following
+      disclaimer in the documentation and/or other materials provided
+      with the distribution.
+    * Neither the name of Twin Sun, LLC nor the names of its
+      contributors may be used to endorse or promote products derived
+      from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -1,64 +1,102 @@
-# Jekyll Link Attributes
-
-This plugin adds `rel` and `target` attributes to all external links in your Jekyll site.
-The default configuration opens external links in a new tab and conserves domain authority for your site.
-
-## Setup
-
-1. Add the gem to your `Gemfile`:
-    ```ruby
-    gem 'jekyll-link-attributes'
-    ```
-2. Run `bundle install` to install the gem
-3. Add the following to your `_config.yml`:
-    ```yaml
-    plugins:
-      - jekyll-link-attributes
-    ```
-
-## Usage
-
-### Configuration
-
-You can override the default configuration by adding the following section to your Jekyll site's `_config.yml`:
-
-```yaml
-external_links:
-  enabled: true
-  rel: external nofollow noopener
-  target: _blank
-  exclude:
-    - https://example.com
-    - https://another.example.com/test.html
-    - https://regex.example.com/.+
-```
-
-#### Default Configuration
-| Key | Default Value | Description |
-| ---------------------------- | ---------------------------- | -------------------------------------------------- |
-| `external_links.enabled` | `true`                       | Enable attribute modifications for external links. |
-| `external_links.rel`     | `external nofollow noopener` | The `rel` attribute to add to external links.      |
-| `external_links.target`  | `_blank`                     | The `target` attribute to add to external links.   |
-| `external_links.exclude` | `[]`                         | A list of URLs to exclude from processing.         |
-
-
-### Skipping individual links
-
-The `rel` or `target` attributes will not be modified for links that already have those existing attributes.
-This allows you to skip individual links without having to modify the plugin's configuration.
-
- ```html
- <a href"https://example.com" rel="nofollow">Example</a> <!-- `rel` will not be modified, but the configured `target` will be added. -->
- <a href"https://example.com" target="_self">Example</a> <!-- `target` will not be modified, but the configured `rel` will be added. -->
- <a href"https://example.com" rel="nofollow" target="_self">Example</a> <!-- Neither `rel` nor `target` will be modified. -->
- ```
-
-## Contributing
-
-Pull requests are welcome!
-If you wish to change existing behavior, please open an issue to discuss the change before investing time in a PR.
-RSpec tests are encouraged for any new features.
-
-## Supported by Twin Sun
-
-This project is maintained by [Twin Sun](https://twinsunsolutions.com/), a custom mobile and web app development agency in Nashville, TN.
+# Jekyll Link Attributes
+
+A Jekyll plugin for managing external link behavior: `rel` attributes, `target` attributes, and UTM tracking parameters.
+Each concern is independently configurable with its own value and exclude list.
+
+## Setup
+
+1. Add the gem to your `Gemfile`:
+    ```ruby
+    gem 'jekyll-link-attributes'
+    ```
+2. Run `bundle install` to install the gem
+3. Add the following to your `_config.yml`:
+    ```yaml
+    plugins:
+      - jekyll-link-attributes
+    ```
+
+## Configuration
+
+### Recommended (v2+)
+
+Each attribute type is its own section with a `value` and optional `exclude` list:
+
+```yaml
+external_links:
+  enabled: true
+
+  rel:
+    value: external nofollow noopener
+    exclude:
+      - https://myotherapp.com(/?|/.*)?
+
+  target:
+    value: _blank
+    exclude:
+      - https://myotherapp.com(/?|/.*)?
+
+  utm:
+    enabled: true
+    source: mysite.com
+    medium: website
+    exclude:
+      - https://github.com(/?|/.*)?
+```
+
+### Legacy (v1, still supported)
+
+The original flat configuration style continues to work. The top-level `rel`, `target`, and `exclude` keys are used as fallbacks when the new-style section config is not present:
+
+```yaml
+external_links:
+  enabled: true
+  rel: external nofollow noopener
+  target: _blank
+  exclude:
+    - https://example.com(/?|/.*)?
+```
+
+### Resolution order
+
+| Setting | Resolved from | Fallback |
+| ------- | ------------- | -------- |
+| rel value | `external_links.rel.value` | `external_links.rel` (string) or `external nofollow noopener` |
+| rel excludes | `external_links.rel.exclude` | `external_links.exclude` |
+| target value | `external_links.target.value` | `external_links.target` (string) or `_blank` |
+| target excludes | `external_links.target.exclude` | `external_links.exclude` |
+| utm excludes | `external_links.utm.exclude` | *(none, defaults to empty)* |
+
+### UTM tracking parameters
+
+When `external_links.utm.enabled` is `true`, UTM query parameters are automatically appended to external links:
+
+| Param | Value | Source |
+| -------------- | -------------------- | ---------------------------------------------------------------- |
+| `utm_source`   | Configured `source`  | Falls back to the site `url` with the protocol stripped.         |
+| `utm_medium`   | Configured `medium`  | Falls back to `website`.                                         |
+| `utm_campaign` | Auto-derived         | `blog` for post/blog layouts, otherwise the first URL path segment (e.g., `about`), or `homepage` for the root page. |
+| `utm_content`  | Auto-derived         | The page slug (e.g., `my-great-post` or `index`).               |
+
+Existing query parameters on links are preserved. UTM parameters already present on a link will not be overwritten.
+
+### Skipping individual links
+
+The `rel` or `target` attributes will not be modified for links that already have those existing attributes.
+This allows you to skip individual links without having to modify the plugin's configuration.
+
+ ```html
+ <a href="https://example.com" rel="nofollow">Example</a> <!-- rel will not be modified, but target will be added. -->
+ <a href="https://example.com" target="_self">Example</a> <!-- target will not be modified, but rel will be added. -->
+ <a href="https://example.com" rel="nofollow" target="_self">Example</a> <!-- Neither rel nor target will be modified. -->
+ ```
+
+## Contributing
+
+Pull requests are welcome!
+If you wish to change existing behavior, please open an issue to discuss the change before investing time in a PR.
+RSpec tests are encouraged for any new features.
+
+## Supported by Twin Sun
+
+This project is maintained by [Twin Sun](https://twinsunsolutions.com/), a custom mobile and web app development agency in Nashville, TN.

data/Rakefile

@@ -1,3 +1,3 @@
-# frozen_string_literal: true
-
-require 'bundler/gem_tasks'
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'

data/jekyll-link-attributes.gemspec

@@ -1,33 +1,33 @@
-lib = File.expand_path('../lib', __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'jekyll-link-attributes/version'
-
-Gem::Specification.new do |spec|
-  spec.name          = 'jekyll-link-attributes'
-  spec.version       = Jekyll::LinkAttributes::VERSION
-  spec.authors       = ['twinsunllc']
-  spec.email         = ['contact@twinsunsolutions.com']
-
-  spec.summary       = 'This plugin adds `rel` and `target` attributes to all external links in your Jekyll site.'
-  spec.description   = spec.summary
-  spec.homepage      = 'https://github.com/twinsunllc/jekyll-link-attributes'
-  spec.license       = 'BSD 3-Clause'
-
-  # Prevent pushing this gem to RubyGems.org by setting 'allowed_push_host', or
-  # delete this section to allow pushing this gem to any host.
-  if spec.respond_to?(:metadata)
-    spec.metadata['allowed_push_host'] = 'https://rubygems.org'
-  else
-    raise 'RubyGems 2.0 or newer is required to protect against public gem pushes.'
-  end
-
-  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
-  spec.bindir        = 'exe'
-  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.require_paths = ['lib']
-
-  spec.add_development_dependency 'bundler', '>= 2.0.0'
-  spec.add_development_dependency 'jekyll', '>= 4.0.0'
-  spec.add_development_dependency 'nokogiri', '>= 1.0.0'
-  spec.add_development_dependency 'rake', '>= 10.0.0'
-end
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'jekyll-link-attributes/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'jekyll-link-attributes'
+  spec.version       = Jekyll::LinkAttributes::VERSION
+  spec.authors       = ['twinsunllc']
+  spec.email         = ['contact@twinsunsolutions.com']
+
+  spec.summary       = 'This plugin adds `rel` and `target` attributes to all external links in your Jekyll site.'
+  spec.description   = spec.summary
+  spec.homepage      = 'https://github.com/twinsunllc/jekyll-link-attributes'
+  spec.license       = 'BSD 3-Clause'
+
+  # Prevent pushing this gem to RubyGems.org by setting 'allowed_push_host', or
+  # delete this section to allow pushing this gem to any host.
+  if spec.respond_to?(:metadata)
+    spec.metadata['allowed_push_host'] = 'https://rubygems.org'
+  else
+    raise 'RubyGems 2.0 or newer is required to protect against public gem pushes.'
+  end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '>= 2.0.0'
+  spec.add_development_dependency 'jekyll', '>= 4.0.0'
+  spec.add_development_dependency 'nokogiri', '>= 1.0.0'
+  spec.add_development_dependency 'rake', '>= 10.0.0'
+end

data/lib/jekyll-link-attributes/hooks.rb

@@ -1,18 +1,18 @@
-# frozen_string_literal: true
-
-require 'jekyll/hooks'
-require 'jekyll-link-attributes'
-
-Jekyll::Hooks.register :documents, :post_render do |document|
-  Jekyll::LinkAttributes.post_render_html(document)
-end
-
-Jekyll::Hooks.register :pages, :post_render do |page|
-  next unless page.output_ext.eql?('.html')
-
-  Jekyll::LinkAttributes.post_render_html(page)
-end
-
-Jekyll::Hooks.register :posts, :post_render do |post|
-  Jekyll::LinkAttributes.post_render_html(post)
-end
+# frozen_string_literal: true
+
+require 'jekyll/hooks'
+require 'jekyll-link-attributes'
+
+Jekyll::Hooks.register :documents, :post_render do |document|
+  Jekyll::LinkAttributes.post_render_html(document)
+end
+
+Jekyll::Hooks.register :pages, :post_render do |page|
+  next unless page.output_ext.eql?('.html')
+
+  Jekyll::LinkAttributes.post_render_html(page)
+end
+
+Jekyll::Hooks.register :posts, :post_render do |post|
+  Jekyll::LinkAttributes.post_render_html(post)
+end

data/lib/jekyll-link-attributes/version.rb

@@ -1,7 +1,7 @@
-# frozen_string_literal: true
-
-module Jekyll
-  class LinkAttributes
-    VERSION = '1.0.1'
-  end
-end
+# frozen_string_literal: true
+
+module Jekyll
+  class LinkAttributes
+    VERSION = '2.0.1'
+  end
+end

data/lib/jekyll-link-attributes.rb

@@ -1,56 +1,134 @@
-# frozen_string_literal: true
-
-require 'jekyll-link-attributes/hooks'
-require 'jekyll-link-attributes/version'
-require 'nokogiri'
-
-module Jekyll
-
-  # Adjusts external links in HTML documents.
-  class LinkAttributes
-
-    # Perform post_render processing on the specified document/page/post
-    # @param [Object] article a Jekyll document, page, or post
-    def self.post_render_html(article)
-      config = article.site.config
-      return unless external_links_enabled?(config: config)
-
-      output = Nokogiri::HTML(article.output)
-      output.css('a').each do |a|
-        next unless external_link?(config: config, url: a['href'])
-        next if excludes_external_link?(config: config, url: a['href'])
-
-        # only set rel and target if they're not already set
-        a['rel'] = external_link_rel(config: config) unless a['rel']
-        a['target'] = external_link_target(config: config) unless a['target']
-      end
-
-      article.output = output.to_s
-    end
-
-    private
-
-    def self.excludes_external_link?(config:, url:)
-      excludes = (config.dig('external_links', 'exclude') || [])
-      excludes.any? { |exclude| Regexp.new("^#{exclude}$").match? url }
-    end
-
-    def self.external_link?(config:, url:)
-      site_url = config['url']
-      !(url =~ %r{^https?://}).nil? && (site_url.nil? || !url.start_with?(site_url))
-    end
-
-    def self.external_links_enabled?(config:)
-      enabled = config.dig('external_links', 'enabled')
-      enabled.nil? || enabled
-    end
-
-    def self.external_link_rel(config:)
-      config.dig('external_links', 'rel') || 'external nofollow noopener'
-    end
-
-    def self.external_link_target(config:)
-      config.dig('external_links', 'target') || '_blank'
-    end
-  end
-end
+# frozen_string_literal: true
+
+require 'jekyll-link-attributes/hooks'
+require 'jekyll-link-attributes/version'
+require 'nokogiri'
+require 'uri'
+
+module Jekyll
+
+  # Adjusts external links in HTML documents.
+  class LinkAttributes
+
+    # Perform post_render processing on the specified document/page/post
+    # @param [Object] article a Jekyll document, page, or post
+    def self.post_render_html(article)
+      config = article.site.config
+      return unless external_links_enabled?(config: config)
+
+      ext_config = config['external_links'] || {}
+      utm_params = build_utm_params(ext_config: ext_config, site_config: config, article: article)
+
+      output = Nokogiri::HTML(article.output)
+      output.css('a').each do |a|
+        next unless external_link?(config: config, url: a['href'])
+
+        original_href = a['href']
+
+        # UTM: applied to all external links with its own exclude list
+        if utm_params && !excluded?(ext_config: ext_config, section: 'utm', url: original_href)
+          a['href'] = append_utm_params(url: a['href'], utm_params: utm_params)
+        end
+
+        # rel: new-style section config falls back to legacy top-level keys
+        unless a['rel']
+          rel_value = resolve_value(ext_config: ext_config, section: 'rel', legacy_key: 'rel',
+                                    default: 'external nofollow noopener')
+          unless excluded?(ext_config: ext_config, section: 'rel', url: original_href)
+            a['rel'] = rel_value
+          end
+        end
+
+        # target: new-style section config falls back to legacy top-level keys
+        unless a['target']
+          target_value = resolve_value(ext_config: ext_config, section: 'target', legacy_key: 'target',
+                                       default: '_blank')
+          unless excluded?(ext_config: ext_config, section: 'target', url: original_href)
+            a['target'] = target_value
+          end
+        end
+      end
+
+      article.output = output.to_s
+    end
+
+    private
+
+    # Resolve value for a section, falling back to legacy top-level key.
+    # New style: external_links.rel.value / external_links.target.value
+    # Legacy:   external_links.rel / external_links.target (string value)
+    def self.resolve_value(ext_config:, section:, legacy_key:, default:)
+      section_config = ext_config[section]
+      if section_config.is_a?(Hash)
+        section_config['value'] || default
+      else
+        section_config || default
+      end
+    end
+
+    # Check if a URL is excluded for a given section.
+    # New style: external_links.<section>.exclude
+    # Legacy fallback (rel/target only): external_links.exclude
+    def self.excluded?(ext_config:, section:, url:)
+      section_config = ext_config[section]
+      excludes = if section_config.is_a?(Hash)
+                   section_config['exclude'] || []
+                 elsif section == 'utm'
+                   []
+                 else
+                   ext_config['exclude'] || []
+                 end
+
+      excludes.any? { |pattern| Regexp.new("^#{pattern}$").match?(url) }
+    end
+
+    def self.external_link?(config:, url:)
+      site_url = config['url']
+      !(url =~ %r{^https?://}).nil? && (site_url.nil? || !url.start_with?(site_url))
+    end
+
+    def self.external_links_enabled?(config:)
+      enabled = config.dig('external_links', 'enabled')
+      enabled.nil? || enabled
+    end
+
+    def self.utm_enabled?(ext_config:)
+      ext_config.dig('utm', 'enabled') == true
+    end
+
+    def self.build_utm_params(ext_config:, site_config:, article:)
+      return nil unless utm_enabled?(ext_config: ext_config)
+
+      utm_config = ext_config['utm'] || {}
+      source = utm_config['source'] || site_config['url']&.sub(%r{\Ahttps?://}, '') || 'website'
+      medium = utm_config['medium'] || 'website'
+
+      campaign = case article.data['layout']
+                 when 'post', 'blog' then 'blog'
+                 else
+                   path = article.url.to_s.gsub(%r{\A/|/\z}, '')
+                   path.empty? ? 'homepage' : path.split('/').first
+                 end
+
+      content = article.data['slug'] || File.basename(article.url.to_s.chomp('/'))
+      content = 'index' if content.empty?
+
+      {
+        'utm_source'   => source,
+        'utm_medium'   => medium,
+        'utm_campaign' => campaign,
+        'utm_content'  => content,
+      }
+    end
+
+    def self.append_utm_params(url:, utm_params:)
+      uri = URI.parse(url)
+      existing = URI.decode_www_form(uri.query || '').to_h
+      utm_params.each { |k, v| existing[k] = v unless existing.key?(k) }
+      uri.query = URI.encode_www_form(existing)
+      uri.to_s
+    rescue URI::InvalidURIError
+      url
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-link-attributes
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 2.0.1
 platform: ruby
 authors:
 - twinsunllc
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-09-14 00:00:00.000000000 Z
+date: 2026-03-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -90,7 +90,7 @@ licenses:
 - BSD 3-Clause
 metadata:
   allowed_push_host: https://rubygems.org
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -106,7 +106,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.3.3
-signing_key: 
+signing_key:
 specification_version: 4
 summary: This plugin adds `rel` and `target` attributes to all external links in your
   Jekyll site.