jekyll-webawesome 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6846bb6aa40dc02ccf27b7dc52b2d1c519450931c778319171a6f6ea1c3e80be
-  data.tar.gz: 74ff31a509f50c591f1a24e3d336d6f22ed6d2e941ce6843bd22fd1ccbd75a9f
+  metadata.gz: f09b4ba8c46c0b7691411998aea6960e82dbe53654c95c777361b53876ecc19c
+  data.tar.gz: 125a368ad99787b0dbec1901781bd1c7fa2fcfdc0c1b14fe2440f8cfe9ad119a
 SHA512:
-  metadata.gz: 82adf1d1266bb4670410e0ac61cb3f245e83f18cf7a85477539f8ccd91e0ba31598aa5118a23bfd81e5008795c25378d842c2151753cabcf6a794bf8c318bed4
-  data.tar.gz: 3f0dfbb5db90f64b36e924e22b5ed0e979ee5faf180abda604bc29f28545653dcc1b60432bd9223a573ff11b12aba3624e260199be4e38db07b3643e4df0e18a
+  metadata.gz: bc8e69fcd0869698e5b9e8ce3225ab219be8b50eb781beab64a4b7ad0571d4e2580189a4607b6254f52ed7e1fa1cb776b44c7c7443f9e50785cd45fe7d75c83a
+  data.tar.gz: a27a198436f697ff26959c06b73eba4f52e72164f400251517487f0242a3c959f126a15088f3c91b86ae3c6e3dcb6645c9fcaaf12f6ac1bfb5a084170b540a9d

data/CHANGELOG.md

@@ -6,6 +6,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 
 ## [Unreleased]
 
+- Placeholder
+
+## [0.3.0] - 2025-09-29
+
+- Support for wa-copy-button component (`<<<...<<<` or `:::wa-copy-button`)
+
 ## [0.2.1] - 2025-09-23
 
 - Fixed issues with icon transformation messing up code blocks and inline code

data/README.md

@@ -17,6 +17,7 @@ This plugin focuses on the most commonly used Web Awesome components for Jekyll
 | **Callouts** | `:::info` | `:::wa-callout info` | `<wa-callout variant="brand"><wa-icon name="circle-info"></wa-icon>content</wa-callout>` |
 | **Card** | `===` | `:::wa-card` | `<wa-card>content</wa-card>` |
 | **Comparison** | `\|\|\|` or `\|\|\|25` | `:::wa-comparison` or `:::wa-comparison 25` | `<wa-comparison>` with before/after slots |
+| **Copy Button** | `<<<` | `:::wa-copy-button` | `<wa-copy-button value="content">content</wa-copy-button>` |
 | **Details** | `^^^` | `:::wa-details` | `<wa-details><summary>summary</summary>content</wa-details>` |
 | **Tab Group** | `++++++` | `:::wa-tabs` | `<wa-tab-group><wa-tab>content</wa-tab></wa-tab-group>` |
 | **Tag** | `@@@brand` | `:::wa-tag brand` | `<wa-tag variant="brand">content</wa-tag>` |
@@ -27,7 +28,6 @@ These content-focused components will get dedicated syntax in future releases:
 
 | Component | Primary Syntax | Alternative syntax | HTML Output |
 |-----------|----------------------|-------------------|-------------|
-| **Copy Button** | `<<<` | `:::wa-copy-button` | `<wa-copy-button>content</wa-copy-button>` |
 | **Icon** | `$$$icon-name` | `:::wa-icon name` | `<wa-icon name="icon-name"></wa-icon>` |
 | **Progress Bar** | `&&&value` | `:::wa-progress-bar value` | `<wa-progress-bar value="50"></wa-progress-bar>` |
 | **Rating** | `???value` | `:::wa-rating value` | `<wa-rating value="4"></wa-rating>` |
@@ -294,6 +294,44 @@ These transform into Web Awesome tag components with appropriate colors and styl
 
 ![Tags component example](readme_screenshots/tags.png)
 
+### Copy Buttons
+
+Create copy-to-clipboard buttons using the `<<<` syntax:
+
+```markdown
+<<<
+Copy this simple text
+<<<
+
+<<<
+npm install jekyll-webawesome
+<<<
+```
+
+Copy buttons support **markdown formatting** in the display text while preserving the original markdown in the clipboard value:
+
+```markdown
+<<<
+**Copy** this text with *markdown* formatting and `code`
+<<<
+```
+
+This transforms into a Web Awesome copy button component:
+
+```html
+<wa-copy-button value="**Copy** this text with *markdown* formatting and `code`"></wa-copy-button>
+```
+
+Copy buttons work well for:
+
+- Code snippets and commands
+- URLs and configuration values  
+- Installation instructions
+- API keys or tokens
+- Any text users might want to copy
+
+> **Note**: The `value` attribute contains the raw text (including any markdown) that gets copied to the clipboard. The copy button displays the standard Web Awesome copy icon and handles the clipboard operation automatically.
+
 ### Details/Summary (Collapsible Content)
 
 Create collapsible content using the `^^^` syntax:

data/lib/jekyll/webawesome/transformer.rb

@@ -14,6 +14,7 @@ module Jekyll
         content = CalloutTransformer.transform(content)
         content = CardTransformer.transform(content)
         content = ComparisonTransformer.transform(content)
+        content = CopyButtonTransformer.transform(content)
         content = DetailsTransformer.transform(content)
         content = IconTransformer.transform(content)
         content = TagTransformer.transform(content)

data/lib/jekyll/webawesome/transformers/copy_button_transformer.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require_relative 'base_transformer'
+
+module Jekyll
+  module WebAwesome
+    # Transforms copy button syntax into wa-copy-button elements
+    # Primary syntax: <<<\ncontent\n<<<
+    # Alternative syntax: :::wa-copy-button\ncontent\n:::
+    #
+    # Usage:
+    # <<<
+    # This text will be copied to clipboard
+    # <<<
+    #
+    # :::wa-copy-button
+    # Copy this text
+    # :::
+    class CopyButtonTransformer < BaseTransformer
+      def self.transform(content)
+        # Define both regex patterns
+        primary_regex = /^<<<\n(.*?)\n<<</m
+        alternative_regex = /^:::wa-copy-button\n(.*?)\n:::/m
+
+        # Define shared transformation logic
+        transform_proc = proc do |copy_content|
+          copy_content = copy_content.strip
+
+          build_copy_button_html(copy_content)
+        end
+
+        # Apply both patterns
+        patterns = dual_syntax_patterns(primary_regex, alternative_regex, transform_proc)
+        apply_multiple_patterns(content, patterns)
+      end
+
+      class << self
+        private
+
+        def build_copy_button_html(content)
+          # Escape the content for the value attribute
+          escaped_content = content.gsub('"', '&quot;').gsub("'", '&#39;')
+
+          "<wa-copy-button value=\"#{escaped_content}\"></wa-copy-button>"
+        end
+      end
+    end
+  end
+end

data/lib/jekyll/webawesome/transformers.rb

@@ -9,6 +9,7 @@ require_relative 'transformers/button_transformer'
 require_relative 'transformers/callout_transformer'
 require_relative 'transformers/card_transformer'
 require_relative 'transformers/comparison_transformer'
+require_relative 'transformers/copy_button_transformer'
 require_relative 'transformers/details_transformer'
 require_relative 'transformers/icon_transformer'
 require_relative 'transformers/tabs_transformer'

data/lib/jekyll/webawesome/version.rb

@@ -2,6 +2,6 @@
 
 module Jekyll
   module WebAwesome
-    VERSION = '0.2.1'
+    VERSION = '0.3.0'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-webawesome
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Janne Waren
@@ -123,6 +123,7 @@ files:
 - lib/jekyll/webawesome/transformers/callout_transformer.rb
 - lib/jekyll/webawesome/transformers/card_transformer.rb
 - lib/jekyll/webawesome/transformers/comparison_transformer.rb
+- lib/jekyll/webawesome/transformers/copy_button_transformer.rb
 - lib/jekyll/webawesome/transformers/details_transformer.rb
 - lib/jekyll/webawesome/transformers/icon_transformer.rb
 - lib/jekyll/webawesome/transformers/tabs_transformer.rb