asciidoctor-rhrev 1.2.0 → 1.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ba4b787b526a584c23e8d5c890cfc0459711552efb13b11e483b2847706f018e
-  data.tar.gz: 5e740bd4af7144bcc3ad461ddadfc402883354395f372c1336439e87d498547f
+  metadata.gz: 4d83e91d276df02dd54e4b4af8c2ca5524ec503c36603e0e5f268309e5f0d529
+  data.tar.gz: 7780816da60b8799b7c4e9427fa7436c086862b0b8dde350e5a681f76f4ee017
 SHA512:
-  metadata.gz: 9ad667cf9c86e5462ca177eae98fddad13335354c26083fb15cfe5639630b7044e0e623b7e5b1f5f069fe4689403e6c382246db47c7127aafe89d2f1fa204853
-  data.tar.gz: fca906ea2b5256d3d141828ee39ef3298fb9420dbea437f424e6cac633035e8dec6463ca2bdd30c76d86c73e08125bb7620c94fdff4015970cc9b65fa837f764
+  metadata.gz: a232c651f5391d90456fe32ada20a1f072044b74bc7998339197662015091fc2781ea053599911abb74fc56384ed63a86c77016562198ae25751282a5c9abfb4
+  data.tar.gz: 20cdc734fb0840b3846ff3f01add4d1442c957ce84add7057920b14cb1e456816fd5a20ad870fc77228fe63d3276233455a70dd3f7f1d15a6649be5a65ddff30

data/CHANGELOG.adoc

@@ -1,5 +1,16 @@
 = Changelog
 
+== 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
+* Fix the initial-release table dropping the custom first row in the HTML backend and the Antora extension (the caption already rendered there)
+* Fix the HTML backend dropping the right cell (`rhrev-customization-first-row-right`) whenever the left cell was also set, in both the regular and initial-release tables
+* Note: the npm package skips 1.2.1, which was a PDF-only fix; gem and npm versions are aligned again at 1.2.2
+
+== 1.2.1 (2026-07-07)
+
+* Fix PDF change bars bleeding from a marked section/chapter into its child sections/chapters: a section's bar now always stops at its own content, right before the first nested subsection, regardless of whether that subsection is itself marked
+
 == 1.2.0 (2026-07-07)
 
 * Fix document-level `-all`/`-cover` entries being ignored for revisions with more than two segments (e.g. `1-2-0`): revisions are now discovered from `*-prevrev` attributes instead of enumerating `major-minor` pairs (PDF and HTML backends)

data/lib/asciidoctor/rhrev/change_bars.rb

@@ -27,6 +27,7 @@ module Asciidoctor
             side: (doc.attr 'rhrev-change-bars-side'),
           }
           @change_bar_starts = {}
+          @change_bar_section_stack = []
         end
 
         # Resolved lazily on first ink: the theme (and @media/@folio_placement)
@@ -61,6 +62,25 @@ module Asciidoctor
           @change_bar_starts&.delete node
         end
 
+        # A section's bar covers only its own directly-owned content, not any
+        # nested child sections/chapters: as soon as a child section begins
+        # rendering, close out the bar of every still-open ancestor section
+        # right here, at the boundary between the parent's own content and
+        # its first child section.
+        def enter_change_bar_section node
+          return unless @change_bar_attr
+          @change_bar_section_stack.each do |ancestor|
+            next unless (start_pos = take_change_bar_start ancestor)
+            ink_change_bar start_pos, { page: page_number, cursor: cursor }
+          end
+          @change_bar_section_stack.push node
+        end
+
+        def exit_change_bar_section node
+          return unless @change_bar_attr
+          @change_bar_section_stack.pop
+        end
+
         # The offset measures the gap between the text edge and the near edge
         # of the bar. Sides recto/verso are determined by the physical page
         # number (honoring pdf-folio-placement inversion), matching prepress

data/lib/asciidoctor/rhrev/converter.rb

@@ -74,7 +74,7 @@ module Asciidoctor
           # Skip collect during render if prescan already did it
           collect_revision_entries node unless @prescan_complete
           update_revision_entry_metadata node
-          
+
           if node.id
             @anchor_catalog ||= {}
             @anchor_catalog[node.id] ||= {
@@ -85,12 +85,16 @@ module Asciidoctor
               level: node.level
             }
             @anchor_catalog[node.id][:dest] = { page: page_number, y: cursor }
-            
+
             # Link destination to page for revision history
             revision_history.link_dest_to_page node.id, page_number, 1, y: cursor
           end
 
+          # Entering a section closes out any still-open ancestor change bars,
+          # so a marked section's bar never bleeds into its child sections
+          enter_change_bar_section node
           result = super
+          exit_change_bar_section node
           # Start position was captured at heading-ink time (after any page advance)
           if @change_bar_attr && !scratch? && (start_pos = take_change_bar_start node)
             ink_change_bar start_pos, { page: page_number, cursor: cursor }

data/lib/asciidoctor/rhrev/renderer.rb

@@ -250,6 +250,7 @@ module Asciidoctor
           markup_lines = []
           markup_lines << "[cols='#{formatted_widths}']"
           markup_lines << "|==="
+          add_custom_first_row_to_markup markup_lines, doc
           table_data.each do |row|
              markup_lines << "|#{row[0]} |#{row[1]}"
           end
@@ -263,7 +264,11 @@ module Asciidoctor
           if (stripes = doc.attr 'rhrev-table-stripes')
             table.set_attr 'stripes', stripes
           end
-          
+
+          if !(doc.attr? 'rhrev-disable-caption') && (caption = doc.attr 'rhrev-table-caption')
+            table.title = caption
+          end
+
           convert_table table
         end
         

data/lib/asciidoctor/rhrev/rhrev_html.rb

@@ -134,6 +134,23 @@ module Asciidoctor
         column_widths.each { |w| html << %(<col style="width: #{w}%;">)}
         html << '</colgroup>'
         html << '<tbody>'
+
+        # Custom first row
+        if (first_row = doc.attr('rhrev-customization-first-row'))
+          html << '<tr class="rhrev-custom-first-row">'
+          html << %(<td colspan="2">#{first_row}</td>)
+          html << '</tr>'
+        else
+          first_row_left = doc.attr('rhrev-customization-first-row-left')
+          first_row_right = doc.attr('rhrev-customization-first-row-right')
+          if first_row_left || first_row_right
+            html << '<tr class="rhrev-custom-first-row">'
+            html << %(<td>#{first_row_left || '&nbsp;'}</td>)
+            html << %(<td>#{first_row_right || '&nbsp;'}</td>)
+            html << '</tr>'
+          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>)
@@ -228,12 +245,15 @@ module Asciidoctor
           html << '<tr class="rhrev-custom-first-row">'
           html << %(<td colspan="2">#{first_row}</td>)
           html << '</tr>'
-        elsif (first_row_left = doc.attr('rhrev-customization-first-row-left')) ||
-              (first_row_right = doc.attr('rhrev-customization-first-row-right'))
-          html << '<tr class="rhrev-custom-first-row">'
-          html << %(<td>#{first_row_left || '&nbsp;'}</td>)
-          html << %(<td>#{first_row_right || '&nbsp;'}</td>)
-          html << '</tr>'
+        else
+          first_row_left = doc.attr('rhrev-customization-first-row-left')
+          first_row_right = doc.attr('rhrev-customization-first-row-right')
+          if first_row_left || first_row_right
+            html << '<tr class="rhrev-custom-first-row">'
+            html << %(<td>#{first_row_left || '&nbsp;'}</td>)
+            html << %(<td>#{first_row_right || '&nbsp;'}</td>)
+            html << '</tr>'
+          end
         end
         
         section_label = doc.attr 'rhrev-localization-location', 'Section'

metadata

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