asciidoctor-rhrev 1.2.3 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 87f9419e740ba6f0002e1a4fd06c2930319910ff2a3bf2fbeeefbfee33d6c0d3
-  data.tar.gz: 2c6759b77bd7c9ab7d16e906a569541c36a185a594f45b0e398e2f028087e0bc
+  metadata.gz: cdb14bf628d2c8dd088c5f7f9a37012305efc17fd2c6f6717a4e6a08d3e9ac18
+  data.tar.gz: b8bbabee8370433715fc06a11259fae8ac7eb80e7821965aa2b348fbcd185bcb
 SHA512:
-  metadata.gz: d939d3d0be086e54ef94165c96532594992d45adf7d3f93cd1b1d64b2667db5bddfdfc6566252b7dc0b830536c46c2dc822c313d19477ec78c0e8dfbb816905a
-  data.tar.gz: 9918859a0819b3ad98926199f499eab62ff3185cd012f31b0c45fe5b8f76ae310c6fcdb9ab3096fa256335b2d5cdd42fb1f1a739e6cbba53e8db9da5c3fbb654
+  metadata.gz: a253125687474c408d3d89545d2c66d35f944a5330cb7e99213672bafcdcf199083a4528379b801a035726e0badd9ebd321101ebb27a9b2e3f3bd02e4a2be314
+  data.tar.gz: 8f4e7888fdbf89ba4a70705b97eed4aa4a05bc5b19e0b5ab96bbd4b295db47757b4d73b724b84243c724098ab4578c844cc9ee3564df655d9831c3adb5021e48

data/CHANGELOG.adoc

@@ -1,5 +1,11 @@
 = Changelog
 
+== 1.3.0 (2026-07-16)
+
+* Add HTML change bars: with `:rhrev-change-bars:` set, tracked blocks (section, floating title, example, listing, table, image) marked with the current revision get the `rhrev-changed` CSS class in the HTML backend and the Antora extension; `rhrev-change-bars-color`, `-width`, and `-offset` are emitted as CSS custom properties (`--rhrev-change-bar-*`). The side is always right in HTML (no recto/verso model), and a marked section's bar spans its nested subsections, unlike the PDF backend. Default styling (red right border) ships in the baiyibai UI bundle
+* Fix the documented Assembler xref format example emitting a "possible invalid reference" warning by escaping the inline example
+* Replace the figure example in the docs with an original image (gem and npm both 1.3.0)
+
 == 1.2.3 (2026-07-15)
 
 * Fix the initial-release table (revnumber `1.0`/`1` with `rhrev-initial-handling` `initial-release`) rendering a "Major changes since Revision X" header row: an initial release has no prior revision, so the table is now a single `Page | Initial Release` row (PDF backend, HTML backend, and Antora extension). Caption, custom first row, and all localization/customization attributes are unaffected; `rhrev-localization-major-changes` still applies to the regular revision-history table

data/lib/asciidoctor/rhrev/rhrev_html.rb

@@ -5,6 +5,49 @@ require 'asciidoctor/converter/html5'
 
 module Asciidoctor
   module Rhrev
+    # Tags blocks marked with the current revision (revnumber 1.2 => attribute
+    # rhrev1-2) with the rhrev-changed role so a stylesheet can draw an HTML
+    # change bar (border on the right side). Enabled by the rhrev-change-bars
+    # document attribute, mirroring the PDF backend. The rhrev-change-bars-color,
+    # -width, and -offset attributes are emitted as CSS custom properties; the
+    # side is always right in HTML output (no recto/verso model).
+    class ChangeBarsHtmlTreeprocessor < Asciidoctor::Extensions::Treeprocessor
+      TRACKED_CONTEXTS = [:section, :floating_title, :example, :listing, :table, :image].freeze
+
+      def process document
+        return document unless document.basebackend? 'html'
+        return document unless document.attr? 'rhrev-change-bars'
+        return document unless (revnumber = document.attr 'revnumber')
+        prefix = document.attr 'revhistoryprefix', 'rhrev'
+        change_attr = %(#{prefix}#{revnumber.to_s.tr '.', '-'})
+
+        tagged = false
+        document.find_by { |b| TRACKED_CONTEXTS.include? b.context }.each do |block|
+          next unless block.attributes && (block.attributes.key? change_attr)
+          roles = (block.attr 'role')
+          block.set_attr 'role', [roles, 'rhrev-changed'].compact.join(' ')
+          tagged = true
+        end
+        return document unless tagged
+
+        overrides = []
+        if (color = document.attr 'rhrev-change-bars-color')
+          overrides << %(--rhrev-change-bar-color: ##{color.to_s.delete_prefix '#'};)
+        end
+        if (width = document.attr 'rhrev-change-bars-width')
+          overrides << %(--rhrev-change-bar-width: #{width}px;)
+        end
+        if (offset = document.attr 'rhrev-change-bars-offset')
+          overrides << %(--rhrev-change-bar-offset: #{offset}px;)
+        end
+        unless overrides.empty?
+          style = create_block document, :pass, %(<style>:root { #{overrides.join ' '} }</style>), {}
+          document.blocks.unshift style
+        end
+        document
+      end
+    end
+
     # Treeprocessor to auto-inject revision history at document start
     class HtmlTreeprocessor < Asciidoctor::Extensions::Treeprocessor
       def process document

data/lib/asciidoctor/rhrev.rb

@@ -31,4 +31,5 @@ Asciidoctor::Extensions.register do
   block_macro Asciidoctor::Rhrev::RhrevBlockMacroProcessor
   inline_macro Asciidoctor::Rhrev::PagerhrefInlineMacroProcessor
   treeprocessor Asciidoctor::Rhrev::HtmlTreeprocessor if html_available
+  treeprocessor Asciidoctor::Rhrev::ChangeBarsHtmlTreeprocessor if html_available
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: asciidoctor-rhrev
 version: !ruby/object:Gem::Version
-  version: 1.2.3
+  version: 1.3.0
 platform: ruby
 authors:
 - 白一百 baiyibai