asciidoctor-rhrev 1.2.2 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4d83e91d276df02dd54e4b4af8c2ca5524ec503c36603e0e5f268309e5f0d529
-  data.tar.gz: 7780816da60b8799b7c4e9427fa7436c086862b0b8dde350e5a681f76f4ee017
+  metadata.gz: cdb14bf628d2c8dd088c5f7f9a37012305efc17fd2c6f6717a4e6a08d3e9ac18
+  data.tar.gz: b8bbabee8370433715fc06a11259fae8ac7eb80e7821965aa2b348fbcd185bcb
 SHA512:
-  metadata.gz: a232c651f5391d90456fe32ada20a1f072044b74bc7998339197662015091fc2781ea053599911abb74fc56384ed63a86c77016562198ae25751282a5c9abfb4
-  data.tar.gz: 20cdc734fb0840b3846ff3f01add4d1442c957ce84add7057920b14cb1e456816fd5a20ad870fc77228fe63d3276233455a70dd3f7f1d15a6649be5a65ddff30
+  metadata.gz: a253125687474c408d3d89545d2c66d35f944a5330cb7e99213672bafcdcf199083a4528379b801a035726e0badd9ebd321101ebb27a9b2e3f3bd02e4a2be314
+  data.tar.gz: 8f4e7888fdbf89ba4a70705b97eed4aa4a05bc5b19e0b5ab96bbd4b295db47757b4d73b724b84243c724098ab4578c844cc9ee3564df655d9831c3adb5021e48

data/CHANGELOG.adoc

@@ -1,5 +1,15 @@
 = 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
+
 == 1.2.2 (2026-07-15)
 
 * Fix the initial-release table (revnumber `1.0`/`1`) dropping the `rhrev-table-caption` and the custom first row (`rhrev-customization-first-row`, `-left`, `-right`) in the PDF backend; both now render the same way as in the regular revision-history table

data/lib/asciidoctor/rhrev/renderer.rb

@@ -233,18 +233,10 @@ module Asciidoctor
           
           column_widths = get_column_widths doc
           table_data = []
-          
+
           page_label = doc.attr 'rhrev-localization-page', 'Page'
-          major_changes_text = doc.attr 'rhrev-localization-major-changes', 'Major changes since'
-          
-          revision_label = doc.attr('version-label', 'Revision')
-          revnumber = doc.attr('revnumber')
-          
-          header_text = "*#{major_changes_text} #{revision_label} #{revnumber}*"
-          table_data << ["*#{page_label}*", header_text]
-          
           initial_text = doc.attr 'rhrev-customization-initial-release-text', 'Initial Release'
-          table_data << ["", initial_text]
+          table_data << ["*#{page_label}*", initial_text]
           
           formatted_widths = column_widths.map { |w| w.to_i.to_s }.join(',')
           markup_lines = []

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
@@ -114,10 +157,7 @@ module Asciidoctor
         
         column_widths = doc.attr('rhrev-table-column-width', '30,70').split(',').map(&:strip)
         section_label = doc.attr('rhrev-localization-location', 'Section')
-        major_changes_text = doc.attr('rhrev-localization-major-changes', 'Major changes since')
-        version_label = doc.attr('version-label', 'Revision')
-        revnumber = doc.attr('revnumber', '1.0')
-        
+
         # Build table CSS classes with frame and grid
         frame = doc.attr('rhrev-table-frame', 'all')
         grid = doc.attr('rhrev-table-grid', 'all')
@@ -151,13 +191,9 @@ module Asciidoctor
           end
         end
 
-        html << '<tr class="rhrev-header">'
-        html << %(<th class="tableblock halign-left valign-top">#{section_label}</th>)
-        html << %(<th class="tableblock halign-left valign-top"><strong>#{major_changes_text} #{version_label} #{revnumber}</strong></th>)
-        html << '</tr>'
         html << '<tr>'
-        html << '<td>&nbsp;</td>'
-        html << %(<td>#{initial_text}</td>)
+        html << %(<th class="tableblock halign-left valign-top">#{section_label}</th>)
+        html << %(<td class="tableblock halign-left valign-top">#{initial_text}</td>)
         html << '</tr>'
         html << '</tbody>'
         html << '</table>'

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.2
+  version: 1.3.0
 platform: ruby
 authors:
 - 白一百 baiyibai