jekyll-webawesome 0.12.0 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aed77f29e5a3ab5d74e76d237ffdce23b1984c408c0753bbc3b73944a1d3698a
-  data.tar.gz: 5806f68d8f8564cc51ffae8f21fcd3cf9e4c1d980131d31014660b2149018970
+  metadata.gz: 245ba4dad039172f52286841d437c0949cc10e0769324b192707589dbde2ac84
+  data.tar.gz: 2035f8185bdf9da3b664d88c22351842142098fcc185af977a091bf6cea79c65
 SHA512:
-  metadata.gz: a31bfaa6e6c070c01f5f7d91475d495b02dee4b2b7bfca62dff6079e9e4c294c89cf5a3dc5fcb0be07f94d2308529b4d912041c313827311b5a82331e9d473e2
-  data.tar.gz: c009c3bd6956c0d3c671c507047f80648a97ec169029b281a83bad47aa89b81e638cea5132223f89c00205ec33c9fa89ead304b028ce25f7f6bf2eed16c6e088
+  metadata.gz: fd137a5495ce01aa36194f528873758706b9925d491a564e3b86e0080481ea1499bbd7d8380e844a80b791810893aa8f77603353fec76b0cc73e254061d214d8
+  data.tar.gz: dc4318b0450ef4fd151b7ef5cdec10d1c72b2c63361a64eb39892a17685763355b9d283b06d562773fb3efd05a96172ad2fd326504e1e3865b52d9947c6e5de5

data/CHANGELOG.md

@@ -4,6 +4,25 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 
+## [0.14.0] - 2026-03-12
+
+### Changed
+
+- Updated `markawesome` dependency to `~> 0.7`
+- Popover rich content examples added to example site
+
+## [0.13.0] - 2026-03-12
+
+### Added
+
+- **Popover component** (`&&&` or `:::wa-popover`) via markawesome 0.7.0:
+  - Floating popover content attached to a trigger element
+  - Placement options: `top` (default), `bottom`, `left`, `right`
+  - `without-arrow` flag, `distance:N` parameter, `link` trigger style
+  - Trigger text and popover content separated by `>>>`
+- Example site updated with popover demonstrations (placements, link style, combined parameters)
+- Example site README updated to reference Web Awesome Kit (replaces outdated beta CDN reference)
+
 ## [0.12.0] - 2026-02-14
 
 ### Changed

data/README.md

@@ -24,6 +24,7 @@ This plugin focuses on the most commonly used Web Awesome components for Jekyll
 | **Details** | `^^^appearance? icon-placement?` | `:::wa-details appearance? icon-placement?` | `<wa-details appearance="..." icon-placement="...">content</wa-details>` |
 | **Dialog** | `???params?` | `:::wa-dialog params?` | `<wa-dialog>` with trigger button and content |
 | **Icon** | `$$$icon-name` | `:::wa-icon name` | `<wa-icon name="icon-name" variant="solid"></wa-icon>` |
+| **Popover** | `&&&placement? link? without-arrow? distance:N?` | `:::wa-popover params?` | `<wa-popover>` with trigger and floating content |
 | **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>` |
 
@@ -1052,6 +1053,154 @@ This dialog has light dismiss enabled and is 700px wide.
 
 > **Note**: The dialog uses Web Awesome's declarative `data-dialog` API, so no custom JavaScript is needed. Each dialog gets a unique ID automatically generated from its content. The header with X close button is always shown for accessibility, and a "Close" button is automatically added to the footer.
 
+### Popovers
+
+Create floating popover content attached to a trigger element using the `&&&` syntax:
+
+```markdown
+&&&
+Hover for info
+>>>
+This is the popover content with **markdown** support.
+&&&
+```
+
+This creates a trigger button and a floating popover:
+
+```html
+<wa-button id='popover-abc123' variant='text'>Hover for info</wa-button>
+<wa-popover for='popover-abc123' placement='top'>
+  <p>This is the popover content with <strong>markdown</strong> support.</p>
+</wa-popover>
+```
+
+#### Popover Placement
+
+Control where the popover appears relative to the trigger:
+
+```markdown
+&&&top
+Hover (top)
+>>>
+Popover content above the trigger.
+&&&
+
+&&&bottom
+Hover (bottom)
+>>>
+Popover content below the trigger.
+&&&
+
+&&&left
+Hover (left)
+>>>
+Popover content to the left.
+&&&
+
+&&&right
+Hover (right)
+>>>
+Popover content to the right.
+&&&
+```
+
+**Supported placements:** `top` (default), `bottom`, `left`, `right`
+
+#### Link-style Trigger
+
+Use the `link` parameter to render the trigger as underlined text instead of a button:
+
+```markdown
+&&&link
+Learn more
+>>>
+Detailed explanation that appears on hover.
+&&&
+
+&&&bottom link
+See details
+>>>
+This popover appears below the link-style trigger.
+&&&
+```
+
+Link triggers render as a native `<button>` styled to look like inline text with an underline, making them blend naturally into surrounding prose.
+
+#### Without Arrow
+
+Hide the popover's arrow indicator:
+
+```markdown
+&&&without-arrow
+Hover me
+>>>
+This popover has no arrow pointing to the trigger.
+&&&
+```
+
+#### Custom Distance
+
+Set the distance between the trigger and the popover (in pixels):
+
+```markdown
+&&&distance:20
+Hover me
+>>>
+This popover is 20px away from the trigger.
+&&&
+```
+
+#### Combining Parameters
+
+All parameters can be combined in any order:
+
+```markdown
+&&&bottom link without-arrow distance:10
+Read more
+>>>
+A link-style trigger with popover below, no arrow, and custom distance.
+&&&
+```
+
+#### Rich Popover Content
+
+The popover content supports full markdown — multiple paragraphs, lists, links, bold, italic, code, etc.:
+
+```markdown
+&&&top
+Show details
+>>>
+**Feature highlights:**
+
+- Supports *rich* markdown content
+- Including [links](https://example.com)
+- And `inline code`
+
+Multiple paragraphs work too.
+&&&
+```
+
+#### Alternative Syntax
+
+You can also use the explicit `:::wa-popover` syntax:
+
+```markdown
+:::wa-popover bottom link
+Click for details
+>>>
+Popover content using the alternative syntax.
+:::
+```
+
+#### Popover Parameters
+
+| Option | Values | Default | Description |
+|--------|--------|---------|-------------|
+| `placement` | `top`, `bottom`, `left`, `right` | `top` | Where the popover appears |
+| `link` | keyword | off | Renders trigger as underlined text instead of button |
+| `without-arrow` | keyword | off | Hides the popover arrow |
+| `distance:N` | number (pixels) | (default) | Distance between trigger and popover |
+
 ### Details/Summary (Collapsible Content)
 
 Create collapsible content using the `^^^` syntax:
@@ -1488,6 +1637,15 @@ Cards automatically parse content into these slots:
 - **Label Extraction**: First `#` heading becomes the dialog label, or button text is used as fallback
 - **Markdown Support**: Full markdown formatting in dialog content
 
+### Popover Parameters
+
+| Option | Values | Default | Description |
+|--------|--------|---------|-------------|
+| `placement` | `top`, `bottom`, `left`, `right` | `top` | Where the popover appears relative to the trigger |
+| `link` | keyword | off | Renders trigger as underlined text instead of a `wa-button` |
+| `without-arrow` | keyword | off | Hides the popover arrow indicator |
+| `distance:N` | number (pixels) | (default) | Custom distance between trigger and popover |
+
 ### Image Dialogs (Auto-transformation)
 
 Enable automatic image-to-dialog transformation in your `_config.yml`:

data/jekyll-webawesome.gemspec

@@ -33,7 +33,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ['lib']
 
   spec.add_dependency 'jekyll', '>= 3.7', '< 5.0'
-  spec.add_dependency 'markawesome', '~> 0.6'
+  spec.add_dependency 'markawesome', '~> 0.7'
 
   spec.add_development_dependency 'bundler', '~> 2.0'
   spec.add_development_dependency 'rake', '~> 13.0'

data/lib/jekyll/webawesome/version.rb

@@ -2,6 +2,6 @@
 
 module Jekyll
   module WebAwesome
-    VERSION = '0.12.0'
+    VERSION = '0.14.0'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-webawesome
 version: !ruby/object:Gem::Version
-  version: 0.12.0
+  version: 0.14.0
 platform: ruby
 authors:
 - Janne Waren
@@ -35,14 +35,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.7'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement