asciidoctor-lists-extended 1.1.10 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 16dda3a711337611c76e4fc8c4b6eda22fc66419e81ef557ff679578c292c986
-  data.tar.gz: 208a25e0ec8d8854970c8ab027d6a02c06f0f94517aa1086310d07588a729fe0
+  metadata.gz: 0a31187262d6b0b69f19786b57e05023e174e4aef336538624260d18e57af748
+  data.tar.gz: 335046829304d4f70054535a11cb247313347dda9a048f8b5ac9076e83fcbf69
 SHA512:
-  metadata.gz: c470295d328df8f293a372a66c72463c9d7393eb27e71ff9d768ba0a9932bfda9123ae34523298f4340a4b614a43a8ff7f3fab55f5d4fd71448f94b117d93233
-  data.tar.gz: 07e2c7a94bd841ba46c4ff168ec21f51e1209a495e0d522db60b4d2dbf390226a26e4e5434952bc1105705684b7b54b2dbf78e3d378053d8cac884539defca20
+  metadata.gz: 2850824a15b099050d2f49ad77fc3152732c8490361c9c406519a3424a27dce7bd240baff4e0ac46dce0b5f1e9ed285f1043bd82ef917bd9aa88c9090e1edda1
+  data.tar.gz: f19b9819b2b074e7f0c7af333696eb88f212de7620b87007994904279288199867bce593175220c4b060bcb07602a35e3c8f8feece1bfd6320a716c5ded745b8

data/lib/asciidoctor-lists-extended/pdf_converter.rb

@@ -86,11 +86,15 @@ module Asciidoctor
         # toc-in-toc: insert the Table of Contents itself as the first entry in
         # the PDF ToC, before any list-of:: sections.  Excluded from the bookmark
         # outline because asciidoctor-pdf's add_outline already adds a ToC bookmark.
-        if (doc.attr? 'toc-in-toc') && @toc_extent
+        # IMPORTANT: do this in both scratch and final passes. During scratch,
+        # @toc_extent may not yet be set; fall back to toc_page_number so the
+        # dry-run ToC entry count/height matches the final pass.
+        if doc.attr? 'toc-in-toc'
           toc_entry_title = doc.attr('toc-title') || 'Table of Contents'
-          insert_list_into_toc_section doc, toc_entry_title, @toc_extent.page_range,
+          toc_entry_range = @toc_extent&.page_range || (toc_page_number..toc_page_number)
+          insert_list_into_toc_section doc, toc_entry_title, toc_entry_range,
             '_toc_in_toc', @list_toc_insert_idx,
-            pdf_dest: dest_top(@toc_extent.page_range.first),
+            pdf_dest: (@toc_extent ? dest_top(@toc_extent.page_range.first) : nil),
             exclude_from_outline: true
           @list_toc_insert_idx += 1
         end
@@ -118,6 +122,7 @@ module Asciidoctor
         result = super
 
         # Phase 2: render deferred inline section-scoped lists.
+
         # traverse doc has completed before ink_toc is called, so all
         # pdf-page-start attributes are now set and page numbers are real.
         unless @inline_render_positions.empty?
@@ -150,6 +155,8 @@ module Asciidoctor
         end
 
         result
+      ensure
+        purge_virtual_sections doc
       end
 
       # -----------------------------------------------------------------------
@@ -175,6 +182,16 @@ module Asciidoctor
         super outline, filtered, num_levels, expand_levels
       end
 
+      # -----------------------------------------------------------------------
+      # convert_section override
+      # -----------------------------------------------------------------------
+      # Virtual sections inserted only to drive ToC/outline entries should not
+      # be rendered as normal body headings during document traversal.
+      def convert_section(node, *args)
+        return if node.attr? 'list-virtual-section'
+        super node, *args
+      end
+
       # -----------------------------------------------------------------------
       # convert_paragraph override
       # -----------------------------------------------------------------------
@@ -276,6 +293,22 @@ module Asciidoctor
 
       private
 
+      # -----------------------------------------------------------------------
+      # purge_virtual_sections
+      # -----------------------------------------------------------------------
+      # Remove synthetic sections inserted only for ToC/outline generation so
+      # they cannot leak into subsequent passes or downstream section processing.
+      def purge_virtual_sections(doc)
+        return unless doc
+        doc.find_by(context: :section).each do |sect|
+          next unless sect.attr? 'list-virtual-section'
+          parent = sect.parent
+          next unless parent
+          parent.blocks.delete sect if parent.respond_to? :blocks
+          parent.sections.delete sect if parent.respond_to? :sections
+        end
+      end
+
       # -----------------------------------------------------------------------
       # mark_empty_list_sections
       # -----------------------------------------------------------------------

data/lib/asciidoctor-lists-extended/pdf_renderer.rb

@@ -115,11 +115,25 @@ module Asciidoctor
           base_idx            = 0
         end
 
+        # If a virtual section with this id was already inserted during an earlier
+        # pass (e.g. scratch before final), refresh it in place rather than
+        # inserting a duplicate that would skew ToC height and entry count.
+        if (existing = grandparent_section.blocks.find { |b| b.context == :section && b.id == list_id })
+          existing.title = list_title
+          existing.set_attr 'pdf-destination', pdf_dest if pdf_dest
+          existing.set_attr 'pdf-page-start', list_page_nums.first
+          existing.set_attr 'list-virtual-section', ''
+          exclude_from_toc     ? existing.set_attr('list-exclude-from-toc', '')     : existing.remove_attr('list-exclude-from-toc')
+          exclude_from_outline ? existing.set_attr('list-exclude-from-outline', '') : existing.remove_attr('list-exclude-from-outline')
+          return existing
+        end
+
         list_section       = Asciidoctor::Section.new grandparent_section, toc_level, false
         list_section.set_attr 'pdf-destination', pdf_dest if pdf_dest
         list_section.title = list_title
         list_section.id    = list_id
         list_section.set_attr 'pdf-page-start', list_page_nums.first
+        list_section.set_attr 'list-virtual-section', ''
         list_section.set_attr 'list-exclude-from-toc',     '' if exclude_from_toc
         list_section.set_attr 'list-exclude-from-outline', '' if exclude_from_outline
         grandparent_section.blocks.insert base_idx + insert_idx, list_section

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: asciidoctor-lists-extended
 version: !ruby/object:Gem::Version
-  version: 1.1.10
+  version: 1.2.1
 platform: ruby
 authors:
 - 白一百 baiyibai