jekyll-webawesome 0.20.0 → 0.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 357c6fd1272603627457c36d096cd9df2eafefc0fbe79564278d246db85ee400
-  data.tar.gz: 55058f53d7164006a4de03d8135245b957cc88b3ff6562339dccc67bac2e5690
+  metadata.gz: 25a526401b8eb686097d354c75428eafd60dd2ea7ba35c3293ac393573c5f4bd
+  data.tar.gz: f3d8d6533c249bffefcc0a88b60eb29167f7db38ef1cf8898624a954b4e01bf1
 SHA512:
-  metadata.gz: 17840e18f7bc1c5c131a30320b05ea243a5215519aa46dff76c55ab6b9abc06959751acae7c98504d71f62a0b2dd8ac97100f9eed9aed3bc72ce76546370a10a
-  data.tar.gz: fe51782529d4091b9675dd074c88e2ce568e98e955190a1ef47c0eea3105f8ef08eceff4d0ce22f0b75740347df3ce31d813df0f36ec45e78938ec6bdb74418e
+  metadata.gz: cfc7e9c8b52ef424ca2aff190c153c2a8bad32f51f4f7fdb16aedf05a5b2b2b168849c1797d314a48b11c3efa65d1dc7051a95c8a18697e343400d3e30d2b8f5
+  data.tar.gz: f9024f9d5645b18dabb0aa47a6abb5e3ebc22caba3636c6f93b9a33014dc25e20e7fc661d0e03dd38f890754bac4de6acc1fba184a562d2491a3b7dbbc7f7ee5

data/CHANGELOG.md

@@ -4,6 +4,13 @@ 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.21.0] - 2026-06-25
+
+### Added
+
+- Tooltip support, via markawesome 0.15.0. Inline contextual help shown on hover or focus — ideal for glossary terms and inline definitions. The primary form is inline: `(((anchor term >>> tip text)))`. The anchor becomes a focusable, dotted-underlined `<span>` (`tabindex="0"`, class `ma-tooltip-anchor`) and the tip is emitted as a `<wa-tooltip>` wired to it via a generated `for`/`id` pair, so keyboard and assistive-technology users get the tip too. Leading `placement` (`top` default, `bottom`, `left`, `right`) and `distance:N` tokens go before the anchor; tip text is plain text (HTML-escaped) with literal `\n` rendered as `<br>`. A `:::wa-tooltip placement? distance:N? … >>> … :::` block alternative is also accepted. Declarative and zero-JavaScript; no Jekyll-side configuration needed.
+- Example site gains a `## Tooltips` section exercising the basic inline form, every placement, `distance:N`, combined parameters, multiple inline tooltips in one sentence, HTML escaping, `\n` line breaks, and the `:::wa-tooltip` alternative form. Validated live in the browser against the examples kit (WA 3.9.0): each anchor's `for` resolves to its tooltip's `id`, the `<wa-tooltip>` upgrades and opens on both hover and focus, and the requested `placement` positions the bubble correctly in the live DOM.
+
 ## [0.20.0] - 2026-06-24
 
 ### Added

data/README.md

@@ -27,6 +27,7 @@ This plugin focuses on the most commonly used Web Awesome components for Jekyll
 | **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>` |
+| **Tooltip** | `(((anchor >>> tip)))` | `:::wa-tooltip placement? distance:N?` | focusable `<span>` anchor + `<wa-tooltip for="…" placement="top">tip</wa-tooltip>` |
 
 Not all components will make sense to include here, to be included in the "prose" content of a web page. Some components are more suitable to be used in layouts or used in the page as includes, too complicated for this purpose.
 
@@ -1215,6 +1216,82 @@ Popover content using the alternative syntax.
 | `without-arrow` | keyword | off | Hides the popover arrow |
 | `distance:N` | number (pixels) | (default) | Distance between trigger and popover |
 
+### Tooltips
+
+Add brief contextual help on hover or focus — ideal for glossary terms and inline definitions. The primary form is inline: put the anchor term and the tip text inside triple parentheses, separated by `>>>`:
+
+```markdown
+The web is styled with (((CSS >>> Cascading Style Sheets))) and structured with (((HTML >>> HyperText Markup Language))).
+```
+
+The anchor term becomes a focusable, dotted-underlined `<span>`, with a `<wa-tooltip>` wired to it via a generated `for`/`id` pair:
+
+```html
+<span id="tooltip-ab12c3d4" tabindex="0" class="ma-tooltip-anchor" style="text-decoration: underline dotted; cursor: help;">CSS</span>
+<wa-tooltip for="tooltip-ab12c3d4" placement="top">Cascading Style Sheets</wa-tooltip>
+```
+
+The anchor is focusable (`tabindex="0"`) so keyboard and assistive-technology users get the tip too (Web Awesome tooltips fire on focus as well as hover). The `ma-tooltip-anchor` class is a styling hook for overriding the default underline/cursor. No JavaScript is required.
+
+#### Tooltip Placement
+
+Leading `placement`/`distance:N` tokens go before the anchor term:
+
+```markdown
+Routed over (((bottom Peppol >>> A standardized pan-European e-invoicing network))) to the recipient.
+
+Authentication uses an (((left API key >>> A secret token that authorizes a request))).
+
+Files are delivered over (((right SFTP >>> SSH File Transfer Protocol))) for batch processing.
+```
+
+**Supported placements:** `top` (default), `bottom`, `left`, `right`
+
+#### Custom Distance
+
+Set the distance between the anchor and the tooltip (in pixels):
+
+```markdown
+Hover over (((distance:12 SLA >>> Service Level Agreement))) to see the tip pushed further from the anchor.
+```
+
+#### Combining Parameters
+
+Tokens can be combined in any order before the anchor term:
+
+```markdown
+Read about (((bottom distance:8 OCR >>> Optical Character Recognition))) in the pipeline.
+```
+
+#### Tip Content and Line Breaks
+
+Tip text is plain text and HTML-escaped, so symbols are safe. Use `\n` for line breaks (rendered as `<br>`):
+
+```markdown
+Org numbers differ by country — (((Org number >>> NO: 9 digits\nSE: 10 digits\nDK: 8-digit CVR))).
+```
+
+Tooltips hold brief text, so there is no Markdown body (unlike popovers).
+
+#### Alternative Syntax
+
+For consistency with the other components, a block form is also accepted:
+
+```markdown
+:::wa-tooltip bottom
+JIT
+>>>
+Just-In-Time — produced only at the moment it is needed.
+:::
+```
+
+#### Tooltip Parameters
+
+| Option | Values | Default | Description |
+|--------|--------|---------|-------------|
+| `placement` | `top`, `bottom`, `left`, `right` | `top` | Where the tooltip appears relative to the anchor |
+| `distance:N` | number (pixels) | (default) | Distance between the anchor and the tooltip |
+
 ### Details/Summary (Collapsible Content)
 
 Create collapsible content using the `^^^` syntax:

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.14'
+  spec.add_dependency 'markawesome', '~> 0.15'
 
   spec.add_development_dependency 'rake', '~> 13.0'
   spec.add_development_dependency 'rspec', '~> 3.0'

data/lib/jekyll/webawesome/version.rb

@@ -2,6 +2,6 @@
 
 module Jekyll
   module WebAwesome
-    VERSION = '0.20.0'
+    VERSION = '0.21.0'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-webawesome
 version: !ruby/object:Gem::Version
-  version: 0.20.0
+  version: 0.21.0
 platform: ruby
 authors:
 - Janne Waren
@@ -35,14 +35,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.14'
+        version: '0.15'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.14'
+        version: '0.15'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement