asciidoctor-pdf 2.3.19 → 2.3.21

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 465fb67274afdfc25ce6bddf7a7f0f8a7079bcc828d11cd86472c30f62b6cf5c
-  data.tar.gz: e034a8cbedf9329cdd48d2cc03063ca146ae9cf1ed28e2417b878ce14b4ca680
+  metadata.gz: 4250f6c0a0f203fe5e164656467da521bf4741771dd2627030c02a5401c24970
+  data.tar.gz: ef2cdb91e970f26ec2cbbb680d94db21d613aaf3c339492f63bbdb5c30a19337
 SHA512:
-  metadata.gz: a8da14edb4931a36dcfe223d1ccbe9dbaf6aa3c0a443818412062850158a5c7f15eebb6b3cbe39824440b9c9613d232ee2537a5d77ec156d491e8e619139694a
-  data.tar.gz: 991f86d8acdddb6e4ec1773d5db27fce3673ec4f8a0c4b7889a6095ef69c52d1e08b0dc63fcdde797beaf4f4d12bea49f11595f67e576d5da7594386f9c76f6e
+  metadata.gz: a53a41fffe731219da61c25eea7f443dd7cb3b64594e116637f28f2f43173a8d4f43c1b7040cacee56566a3e0bb6be474a6d488275d02094646ea1d48b1fb9a2
+  data.tar.gz: 717af76d4f0f4d958301f099e68ccd3395bc54b5740b2fa47d741fee2bd13aec2d2f48e5443c5d43f64535f23f6b12dc1a00d1c0dd74216a0f95f7ac15845e89

data/CHANGELOG.adoc

@@ -5,6 +5,45 @@
 This document provides a high-level view of the changes to the {project-name} by release.
 For a detailed view of what has changed, refer to the {url-repo}/commits/main[commit history] on GitHub.
 
+== 2.3.21 (2025-10-08) - @mojavelinux
+
+Improvements::
+
+* remove shy hyphens from text in log message when formatted text cannot be parsed (#2599)
+* clear float box if next block falls outside of flaot group (#2596)
+* resolve fonts relative to theme dir before GEM_FONTS_DIR if `pdf-fontsdir` not specified (#2349)
+* add see and see-also associations on index terms to index (#2527)
+
+=== Details
+
+{url-repo}/releases/tag/v2.3.21[git tag] | {url-repo}/compare/v2.3.20\...v2.3.21[full diff]
+
+== 2.3.20 (2025-09-17) - @mojavelinux
+
+Improvements::
+
+* add symbols for shift, command, option, and return keys to the fallback font
+* render horizontal dlist without using prawn-table, allowing the description to exceed the height of one page (#2591)
+* allow relative font size for sub and sup to be set independently (support combined setting for backwards compatibility)
+* allow value of `base-font-size-min` and `<category>-font-size-min` theme keys to be relative (e.g., 0.75em) (#2547)
+* respect `hide-uri-scheme` attribute when appending URL to link text when media is print or prepress (#2583)
+
+Bug Fixes::
+
+* always force NULL character to have 0 width, even if missing from font (#2585)
+* don't drop line in running content if attribute reference resolves to text that contains attribute reference (not originally present)
+* correctly calculate extent for block in columns that starts below doctitle (#2579)
+* support internal link on image (value of link attribute starts with #) (#2572)
+
+Compliance::
+
+* suppress warning about the use of Ruby's logger gem when loading Asciidoctor
+* ignore error if bigdecimal gem cannot be eagerly required
+
+=== Details
+
+{url-repo}/releases/tag/v2.3.20[git tag] | {url-repo}/compare/v2.3.19\...v2.3.20[full diff]
+
 == 2.3.19 (2024-10-11) - @mojavelinux
 
 Improvements::

data/README.adoc

@@ -1,6 +1,6 @@
 = Asciidoctor PDF: A native PDF converter for AsciiDoc
 Dan Allen <https://github.com/mojavelinux[@mojavelinux]>; Sarah White <https://github.com/graphitefriction[@graphitefriction]>
-v2.3.19, 2024-10-11
+v2.3.21, 2025-10-08
 // Settings:
 :experimental:
 :idprefix:

data/asciidoctor-pdf.gemspec

@@ -41,7 +41,7 @@ Gem::Specification.new do |s|
   s.add_runtime_dependency 'prawn-templates', '~> 0.1.0'
   s.add_runtime_dependency 'prawn-svg', '~> 0.34.0'
   s.add_runtime_dependency 'prawn-icon', '~> 3.0.0'
-  s.add_runtime_dependency 'concurrent-ruby', '~> 1.1'
+  s.add_runtime_dependency 'concurrent-ruby', '~> 1.3'
   s.add_runtime_dependency 'treetop', '~> 1.6.0'
 
   s.add_development_dependency 'rake', '~> 13.0.0'

data/lib/asciidoctor/pdf/converter.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-require_relative 'formatted_string'
 require_relative 'formatted_text'
 require_relative 'index_catalog'
 require_relative 'pdfmark'
@@ -104,7 +103,7 @@ module Asciidoctor
       }
       TypographicQuotes = %w(“ ” ‘ ’)
       InlineFormatSniffRx = /[<&]/
-      SimpleAttributeRefRx = /(?<!\\)\{\w+(?:-\w+)*\}/
+      SimpleAttributeRefRx = /(?<!\\)\{(\w+(?:-\w+)*)\}/
       MeasurementRxt = '\\d+(?:\\.\\d+)?(?:in|cm|mm|p[txc])?'
       MeasurementPartsRx = /^(\d+(?:\.\d+)?)(in|mm|cm|p[txc])?$/
       PageSizeRx = /^(?:\[(#{MeasurementRxt}), ?(#{MeasurementRxt})\]|(#{MeasurementRxt})(?: x |x)(#{MeasurementRxt})|\S+)$/
@@ -403,7 +402,7 @@ module Asciidoctor
         @page_bg_image = {}
         @page_bg_color = resolve_theme_color :page_background_color, 'FFFFFF'
         # QUESTION: should ThemeLoader handle registering fonts instead?
-        register_fonts theme.font_catalog, ((doc.attr 'pdf-fontsdir')&.sub '{docdir}', (doc.attr 'docdir')) || 'GEM_FONTS_DIR'
+        register_fonts theme.font_catalog, ((doc.attr 'pdf-fontsdir')&.sub '{docdir}', (doc.attr 'docdir')) || (theme.__dir__ == ThemeLoader::ThemesDir ? 'GEM_FONTS_DIR' : %(#{theme.__dir__};GEM_FONTS_DIR))
         default_kerning theme.base_font_kerning != 'none'
         @fallback_fonts = Array theme.font_fallbacks
         @root_font_size = theme.base_font_size
@@ -710,6 +709,7 @@ module Asciidoctor
       end
 
       def convert_index_section node
+        @index.link_associations
         if ColumnBox === bounds || (columns = @theme.index_columns || 1) < 2
           convert_index_categories @index.categories, (node.document.attr 'index-pagenum-sequence-style')
         else
@@ -739,41 +739,73 @@ module Asciidoctor
       end
 
       def convert_index_term term, pagenum_sequence_style = nil
-        term_fragments = term.name.fragments
+        # NOTE: dup fragment list and all fragments to avoid any modification
+        term_fragments = term.name.fragments.map(&:dup)
         unless term.container?
-          pagenum_fragment = (parse_text %(<a>#{DummyText}</a>), inline_format: true)[0]
           if @media == 'screen'
-            case pagenum_sequence_style
-            when 'page'
-              pagenums = term.dests.uniq {|dest| dest[:page] }.map {|dest| pagenum_fragment.merge anchor: dest[:anchor], text: dest[:page] }
-            when 'range'
-              first_anchor_per_page = {}.tap {|accum| term.dests.each {|dest| accum[dest[:page]] ||= dest[:anchor] } }
-              pagenums = (consolidate_ranges first_anchor_per_page.keys).map do |range|
-                anchor = first_anchor_per_page[(range.include? '-') ? (range.partition '-')[0] : range]
-                pagenum_fragment.merge text: range, anchor: anchor
-              end
-            else # term
-              pagenums = term.dests.map {|dest| pagenum_fragment.merge text: dest[:page], anchor: dest[:anchor] }
+            link_fragment = (parse_text %(<a>#{DummyText}</a>), inline_format: true)[0]
+            term_fragments.unshift name: term.anchor, callback: [FormattedText::InlineDestinationMarker], text: DummyText
+          end
+          if (see = term.see)
+            term_fragments << { text: ' (see ' }
+            if link_fragment && IndexTerm === see
+              link_fragment_ = link_fragment.merge anchor: see.anchor
+              see.name.fragments.each {|it| term_fragments << (link_fragment_.merge it) }
+            else
+              term_fragments.concat see.name.fragments
             end
+            term_fragments << { text: ')' }
           else
-            pagenums = consolidate_ranges term.dests.map {|dest| dest[:page] }.uniq
-          end
-          pagenums.each do |pagenum|
-            if ::String === pagenum
-              term_fragments << ({ text: %(, #{pagenum}) })
+            if @media == 'screen'
+              case pagenum_sequence_style
+              when 'page'
+                pagenums = term.dests.uniq {|dest| dest[:page] }.map {|dest| link_fragment.merge anchor: dest[:anchor], text: dest[:page] }
+              when 'range'
+                first_anchor_per_page = {}.tap {|accum| term.dests.each {|dest| accum[dest[:page]] ||= dest[:anchor] } }
+                pagenums = (consolidate_ranges first_anchor_per_page.keys).map do |range|
+                  anchor = first_anchor_per_page[(range.include? '-') ? (range.partition '-')[0] : range]
+                  link_fragment.merge text: range, anchor: anchor
+                end
+              else # term
+                pagenums = term.dests.map {|dest| link_fragment.merge text: dest[:page], anchor: dest[:anchor] }
+              end
             else
-              term_fragments << { text: ', ' }
-              term_fragments << pagenum
+              pagenums = consolidate_ranges term.dests.map {|dest| dest[:page] }.uniq
+            end
+            pagenums.each do |pagenum|
+              if ::String === pagenum
+                term_fragments << ({ text: %(, #{pagenum}) })
+              else
+                term_fragments << { text: ', ' }
+                term_fragments << pagenum
+              end
+            end
+            if (see_also = term.see_also)
+              see_also_items = []
+              see_also.each do |also_term|
+                see_also_fragments = [{ text: '(see also ' }]
+                if link_fragment && IndexTerm === also_term
+                  link_fragment_ = link_fragment.merge anchor: also_term.anchor
+                  also_term.name.fragments.map {|it| see_also_fragments << (link_fragment_.merge it) }
+                else
+                  see_also_fragments.concat also_term.name.fragments
+                end
+                see_also_fragments << { text: ')' }
+                see_also_items << see_also_fragments
+              end
             end
           end
         end
         subterm_indent = @theme.description_list_description_indent
         typeset_formatted_text term_fragments, (calc_line_metrics @base_line_height), align: :left, color: @font_color, hanging_indent: subterm_indent * 2, consolidate: true
         indent subterm_indent do
+          see_also_items&.each do |see_also_fragments|
+            typeset_formatted_text see_also_fragments, (calc_line_metrics @base_line_height), align: :left, color: @font_color, hanging_indent: subterm_indent * 2, consolidate: true
+          end
           term.subterms.each do |subterm|
             convert_index_term subterm, pagenum_sequence_style
-          end
-        end unless term.leaf?
+          end unless term.leaf?
+        end if see_also_items || !term.leaf?
       end
 
       def convert_preamble node
@@ -871,14 +903,19 @@ module Asciidoctor
         end
 
         if (float_box = (@float_box ||= nil))
-          ink_paragraph_in_float_box node, float_box, prose_opts, role_keys, block_next, insert_margin_bottom
-        else
-          # TODO: check if we're within one line of the bottom of the page
-          # and advance to the next page if so (similar to logic for section titles)
-          ink_caption node, labeled: false if node.title?
-          role_keys ? theme_font_cascade(role_keys) { ink_prose node.content, prose_opts } : (ink_prose node.content, prose_opts)
-          insert_margin_bottom.call
+          if (prev_sibling = node.previous_sibling)&.context == :open && (prev_sibling.role? 'float-group')
+            move_cursor_to float_box[:bottom]
+            @float_box = nil
+          else
+            ink_paragraph_in_float_box node, float_box, prose_opts, role_keys, block_next, insert_margin_bottom
+            return
+          end
         end
+        # TODO: check if we're within one line of the bottom of the page
+        # and advance to the next page if so (similar to logic for section titles)
+        ink_caption node, labeled: false if node.title?
+        role_keys ? theme_font_cascade(role_keys) { ink_prose node.content, prose_opts } : (ink_prose node.content, prose_opts)
+        insert_margin_bottom.call
       end
 
       def convert_admonition node
@@ -1421,55 +1458,62 @@ module Asciidoctor
           convert_list list
           markers.pop
         when 'horizontal'
-          table_data = []
-          term_padding = term_padding_no_blocks = term_font_color = term_transform = desc_padding = term_line_metrics = term_inline_format = term_kerning = nil
+          ink_caption node, category: :description_list, labeled: false if node.title?
           max_term_width = 0
+          term_height = term_padding = term_font_styles = term_transform = desc_padding = term_line_metrics = term_inline_format = term_kerning = nil
           theme_font :description_list_term do
-            term_font_color = @font_color
+            term_height = height_of_typeset_text 'A'
             term_transform = @text_transform
             term_inline_format = (term_font_styles = font_styles).empty? ? true : [inherited: { styles: term_font_styles }]
             term_line_metrics = calc_line_metrics @base_line_height
-            term_padding_no_blocks = [term_line_metrics.padding_top, 10, term_line_metrics.padding_bottom, 10]
-            (term_padding = (term_padding_no_blocks.drop 0))[2] += @theme.prose_margin_bottom * 0.5
+            term_padding = [term_line_metrics.padding_top, 10, term_line_metrics.padding_bottom, 10]
             desc_padding = [0, 10, 0, 10]
             term_kerning = default_kerning?
           end
-          actual_node, node = node, node.dup
-          (node.instance_variable_set :@blocks, node.items.map(&:dup)).each do |item|
+          prose_height = height_of_typeset_text 'A'
+          items = node.items.map do |item|
             terms, desc = item
-            term_text = terms.map(&:text).join ?\n
-            term_text = transform_text term_text, term_transform if term_transform
-            if (term_width = width_of term_text, inline_format: term_inline_format, kerning: term_kerning) > max_term_width
-              max_term_width = term_width
-            end
-            row_data = [{
-              text_color: term_font_color,
-              kerning: term_kerning,
-              content: term_text,
-              inline_format: term_inline_format,
-              padding: desc&.blocks? ? term_padding : term_padding_no_blocks,
-              leading: term_line_metrics.leading,
-              # FIXME: prawn-table doesn't have support for final_gap option
-              #final_gap: term_line_metrics.final_gap,
-              valign: :top,
-            }]
-            if desc
-              desc_container = Block.new node, :open
-              desc_container << (Block.new desc_container, :paragraph, source: (desc.instance_variable_get :@text), subs: :default) if desc.text?
-              desc.blocks.each {|b| desc_container << b.dup } if desc.blocks?
-              row_data << { content: (::Prawn::Table::Cell::AsciiDoc.new self, content: (item[1] = desc_container), text_color: @font_color, padding: desc_padding, valign: :top, source_location: desc.source_location) }
-            else
-              row_data << {}
+            terms_as_text = terms.map do |term|
+              term_text = term_transform ? (transform_text term.text, term_transform) : term.text
+              if (term_width = width_of term_text, inline_format: term_inline_format, kerning: term_kerning) > max_term_width
+                max_term_width = term_width
+              end
+              term_text
             end
-            table_data << row_data
+            [terms_as_text, desc]
           end
-          max_term_width += (term_padding[1] + term_padding[3])
-          term_column_width = [max_term_width, bounds.width * 0.5].min
-          table table_data, position: :left, column_widths: [term_column_width] do
-            cells.style border_width: 0
-            @pdf.ink_table_caption node if node.title?
+          term_side_padding = term_padding[1] + (term_left = term_padding[3])
+          max_term_width += term_side_padding
+          term_column_width = [max_term_width, bounds.width * 0.5 - term_side_padding].min
+          term_spacing = @theme.description_list_term_spacing
+          items.each do |terms_as_text, desc|
+            advance_page if !at_page_top? && cursor < [((term_spacing + term_height) * terms_as_text.size) - term_spacing, desc ? prose_height : 0].max
+            initial_y = y
+            initial_page_number = page_number
+            indent term_left, (bounds.width - term_column_width) do
+              theme_font :description_list_term do
+                terms_as_text.each_with_index do |term_text, idx|
+                  ink_prose term_text, margin_top: (idx > 0 ? term_spacing : 0), margin_bottom: 0, align: :left, normalize_line_height: true, styles: term_font_styles
+                end
+              end
+            end
+            if desc # rubocop:disable Style/Next
+              after_term_y = y
+              after_term_page_number = page_number
+              go_to_page initial_page_number if page_number > initial_page_number
+              @y = initial_y
+              indent term_column_width + desc_padding[3], desc_padding[1] do
+                traverse_list_item desc, :dlist_desc, normalize_line_height: true, margin_bottom: ((next_enclosed_block desc, descend: true) ? nil : 0)
+              end
+              if page_number < after_term_page_number
+                go_to_page after_term_page_number
+                @y = after_term_y
+              elsif y > after_term_y
+                @y = after_term_y
+              end
+            end
           end
-          theme_margin :prose, :bottom, (next_enclosed_block actual_node) #unless actual_node.nested?
+          theme_margin :prose, :bottom, (next_enclosed_block node) unless node.nested?
         when 'qanda'
           @list_numerals << 1
           convert_list node
@@ -2459,6 +2503,7 @@ module Asciidoctor
             %(#{anchor}<a href="#{target}"#{attrs.join}>#{breakable_uri text}</a>)
           # NOTE: @media may not be initialized if method is called before convert phase
           elsif (doc.attr? 'show-link-uri') || (@media != 'screen' && (doc.attr_unspecified? 'show-link-uri'))
+            bare_target = (bare_target.split UriSchemeBoundaryRx, 2)[1] || bare_target if doc.attr? 'hide-uri-scheme'
             # QUESTION: should we insert breakable chars into URI when building fragment instead?
             # TODO: allow style of printed link to be controlled by theme
             %(#{anchor}<a href="#{target}"#{attrs.join}>#{text}</a> [<font size="0.85em">#{breakable_uri bare_target}</font>&#93;)
@@ -2639,7 +2684,11 @@ module Asciidoctor
             img = %([#{node.attr 'alt'}&#93;)
           end
         end
-        (node.attr? 'link') ? %(<a href="#{node.attr 'link'}">#{img}</a>) : img
+        if (node.attr? 'link') && (link = node.attr 'link')
+          link.chr == '#' ? %(<a anchor="#{link.slice 1}">#{img}</a>) : %(<a href="#{link}">#{img}</a>)
+        else
+          img
+        end
       end
 
       def convert_inline_indexterm node
@@ -2655,12 +2704,19 @@ module Asciidoctor
           # NOTE: page number (:page key) is added by InlineDestinationMarker
           dest = { anchor: (anchor_name = @index.next_anchor_name) }
           anchor = %(<a id="#{anchor_name}" type="indexterm"#{visible ? ' visible="true"' : ''}>#{DummyText}</a>)
+          assoc = {}
+          if (see = node.attr 'see')
+            assoc[:see] = parse_text see, inline_format: [normalize: true]
+          end
+          if (see_also = node.attr 'see-also')
+            assoc[:see_also] = see_also.map {|term| parse_text term, inline_format: [normalize: true] }
+          end
           if visible
             visible_term = node.text
-            @index.store_primary_term (FormattedString.new parse_text visible_term, inline_format: [normalize: true]), dest
+            @index.store_term [(parse_text visible_term, inline_format: [normalize: true])], dest, assoc
             %(#{anchor}#{visible_term})
           else
-            @index.store_term (node.attr 'terms').map {|term| FormattedString.new parse_text term, inline_format: [normalize: true] }, dest
+            @index.store_term (node.attr 'terms').map {|term| parse_text term, inline_format: [normalize: true] }, dest, assoc
             anchor
           end
         end
@@ -2831,8 +2887,11 @@ module Asciidoctor
         # FIXME: get sub_attributes to handle drop-line w/o a warning
         doc.set_attr 'attribute-missing', 'skip' unless (attribute_missing = doc.attr 'attribute-missing') == 'skip'
         value = value.gsub '\{', '\\\\\\{' if (escaped_attr_ref = value.include? '\{')
+        value_before_subs = value
         value = (subs = opts[:subs]) ? (doc.apply_subs value, subs) : (doc.apply_subs value)
-        value = (value.split LF).delete_if {|line| SimpleAttributeRefRx.match? line }.join LF if opts[:drop_lines_with_unresolved_attributes] && (value.include? '{')
+        if opts[:drop_lines_with_unresolved_attributes] && (value.include? '{')
+          value = (value.split LF).delete_if {|line| SimpleAttributeRefRx =~ line && (value_before_subs.include? '{' + $1 + '}') }.join LF
+        end
         value = value.gsub '\{', '{' if escaped_attr_ref
         doc.set_attr 'attribute-missing', attribute_missing unless attribute_missing == 'skip'
         page_layout_to_restore ? (doc.set_attr 'page-layout', page_layout_to_restore) : (doc.remove_attr 'page-layout') if page_layout
@@ -4724,7 +4783,12 @@ module Asciidoctor
           image_y = y - image_opts[:vposition]
         end unless (image_y = image_opts[:y])
 
-        link_annotation [image_x, (image_y - image_height), (image_x + image_width), image_y], Border: [0, 0, 0], A: { Type: :Action, S: :URI, URI: uri.as_pdf }
+        loc = [image_x, (image_y - image_height), (image_x + image_width), image_y]
+        if uri.chr == '#'
+          link_annotation loc, Border: [0, 0, 0], Dest: (uri.slice 1)
+        else
+          link_annotation loc, Border: [0, 0, 0], A: { Type: :Action, S: :URI, URI: uri.as_pdf }
+        end
       end
 
       def admonition_icon_data key
@@ -4805,7 +4869,7 @@ module Asciidoctor
         padding = expand_padding_value @theme[%(#{category}_padding)]
         if actual_width > (available_width = bounds.width - padding[3].to_f - padding[1].to_f)
           adjusted_font_size = ((available_width * font_size).to_f / actual_width).truncate 4
-          if (min = @theme[%(#{category}_font_size_min)] || @theme.base_font_size_min) && adjusted_font_size < min
+          if (min = @theme[%(#{category}_font_size_min)] || @theme.base_font_size_min) && adjusted_font_size < (min = resolve_font_size min)
             min
           else
             adjusted_font_size
@@ -4813,6 +4877,19 @@ module Asciidoctor
         end
       end
 
+      def resolve_font_size value
+        return value unless ::String === value
+        if value.end_with? 'rem'
+          @root_font_size * value.to_f
+        elsif value.end_with? 'em'
+          font_size * value.to_f
+        elsif value.end_with? '%'
+          font_size * (value.to_f / 100)
+        else
+          value.to_f
+        end
+      end
+
       def consolidate_ranges nums
         if nums.size > 1
           prev = nil

data/lib/asciidoctor/pdf/ext/prawn/extensions.rb

@@ -1146,7 +1146,11 @@ module Asciidoctor
           bounds_copy.instance_variable_set :@parent, saved_bounds
           bounds_copy.single_file if ColumnBox === bounds_copy
         end
-        scratch_pdf.move_cursor_to cursor unless (scratch_start_at_top = keep_together || pages_advanced > 0 || at_page_top?)
+        if !(scratch_start_at_top = keep_together || pages_advanced > 0 || at_page_top?)
+          scratch_pdf.move_cursor_to cursor
+        elsif ColumnBox === bounds
+          scratch_pdf.move_cursor_to scratch_pdf.bounds.top
+        end
         scratch_start_cursor = scratch_pdf.cursor
         scratch_start_page = scratch_pdf.page_number
         inhibit_new_page = state.on_page_create_callback == InhibitNewPageProc

data/lib/asciidoctor/pdf/ext/prawn/font/ttf.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+Prawn::Font::TTF.prepend (Module.new do
+  def character_width_by_code code
+    return 0 if code == 0
+    super
+  end
+end)

data/lib/asciidoctor/pdf/ext/prawn/formatted_text/arranger.rb

@@ -9,7 +9,7 @@ Prawn::Text::Formatted::Arranger.prepend (Module.new do
     super
     @dummy_text = ?\u0000
     @normalize_line_height = false
-    @sub_and_sup_relative_size = 0.583
+    @sub_relative_size = @sup_relative_size = 0.583
   end
 
   def format_array= array
@@ -38,13 +38,18 @@ Prawn::Text::Formatted::Arranger.prepend (Module.new do
   end
 
   def apply_font_size size, styles
-    if (subscript? styles) || (superscript? styles)
+    if (sub = subscript? styles) || (superscript? styles)
       size ||= @document.font_size
+      if instance_variable_defined? :@sub_and_sup_relative_size
+        relative_size = @sub_and_sup_relative_size
+      else
+        relative_size = sub ? @sub_relative_size : @sup_relative_size
+      end
       if String === size
         units = (size.end_with? 'em', '%') ? ((size.end_with? '%') ? '%' : 'em') : ''
-        size = %(#{size.to_f * @sub_and_sup_relative_size}#{units})
+        size = %(#{size.to_f * relative_size}#{units})
       else
-        size *= @sub_and_sup_relative_size
+        size *= relative_size
       end
       @document.font_size(size) { yield }
     elsif size

data/lib/asciidoctor/pdf/ext/prawn.rb

@@ -8,6 +8,7 @@ Prawn::FLOAT_PRECISION = 1e-3
 require_relative 'prawn/document/column_box'
 require_relative 'prawn/font_metric_cache'
 require_relative 'prawn/font/afm'
+require_relative 'prawn/font/ttf'
 require_relative 'prawn/images'
 require_relative 'prawn/formatted_text/arranger'
 require_relative 'prawn/formatted_text/box'

data/lib/asciidoctor/pdf/formatted_text/formatter.rb

@@ -10,6 +10,7 @@ module Asciidoctor
 
         FormattingSnifferPattern = /[<&]/
         WHITESPACE = %( \t\n)
+        SHY = ::Prawn::Text::SHY
 
         def initialize options = {}
           @parser = MarkupParser.new
@@ -26,7 +27,7 @@ module Asciidoctor
               return @transform.apply parsed.content, [], inherited
             end
             reason = @parser.failure_reason.sub %r/ at line \d+, column \d+ \(byte (\d+)\)(.*)/, '\2 at byte \1'
-            logger.error %(failed to parse formatted text: #{string} (reason: #{reason})) unless @scratch
+            logger.error %(failed to parse formatted text: #{string.tr SHY, ''} (reason: #{reason.tr SHY, ''})) unless @scratch
           end
           [inherited ? (inherited.merge text: string) : { text: string }]
         end

data/lib/asciidoctor/pdf/formatted_text/transform.rb

@@ -212,8 +212,12 @@ module Asciidoctor
                       fragment[:callback] = [TextBackgroundAndBorderRenderer] | fragment[:callback]
                     end
                   end if attributes.key? :class
-                  if inherited && (link = inherited[:link])
-                    fragment[:link] = link
+                  if inherited
+                    if (link = inherited[:link])
+                      fragment[:link] = link
+                    elsif (anchor = inherited[:anchor])
+                      fragment[:anchor] = anchor
+                    end
                   end
                   if (img_w = attributes[:width])
                     fragment[:image_width] = img_w

data/lib/asciidoctor/pdf/index_catalog.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require 'digest'
+require_relative 'formatted_string'
+
 module Asciidoctor
   module PDF
     class IndexCatalog
@@ -20,29 +23,29 @@ module Asciidoctor
         %(__indexterm-#{@sequence += 1})
       end
 
-      def store_term names, dest
-        if (num_terms = names.size) > 2
-          store_tertiary_term names[0], names[1], names[2], dest
+      def store_term names, dest, assoc = {}
+        if (num_terms = (names = names.map {|name| FormattedString.new name }).size) == 1
+          store_primary_term names[0], dest, assoc
         elsif num_terms == 2
-          store_secondary_term names[0], names[1], dest
-        elsif num_terms == 1
-          store_primary_term names[0], dest
+          store_secondary_term names[0], names[1], dest, assoc
+        elsif num_terms > 2
+          store_tertiary_term names[0], names[1], names[2], dest, assoc
         end
       end
 
-      def store_primary_term name, dest = nil
+      def store_primary_term name, dest = nil, assoc = {}
         store_dest dest if dest
-        (init_category name.chr.upcase).store_term name, dest
+        (init_category name.chr.upcase).store_term name, dest, assoc
       end
 
-      def store_secondary_term primary_name, secondary_name, dest = nil
+      def store_secondary_term primary_name, secondary_name, dest = nil, assoc = {}
         store_dest dest if dest
-        (store_primary_term primary_name).store_term secondary_name, dest
+        (store_primary_term primary_name).store_term secondary_name, dest, assoc
       end
 
-      def store_tertiary_term primary_name, secondary_name, tertiary_name, dest
+      def store_tertiary_term primary_name, secondary_name, tertiary_name, dest, assoc = {}
         store_dest dest
-        (store_secondary_term primary_name, secondary_name).store_term tertiary_name, dest
+        (store_secondary_term primary_name, secondary_name).store_term tertiary_name, dest, assoc
       end
 
       def init_category name
@@ -54,6 +57,34 @@ module Asciidoctor
         @categories[name]
       end
 
+      def find_primary_term name
+        @categories.each_value do |category|
+          term = category.terms.find {|candidate| candidate.name == name }
+          return term if term
+        end
+        nil
+      end
+
+      def link_associations group = nil
+        if group
+          group.terms.each do |term|
+            associations = term.associations
+            if (see_name = associations[:see])
+              see_name = FormattedString.new see_name
+              term.see = (find_primary_term see_name) || (UnresolvedIndexTerm.new see_name)
+            elsif (see_also_names = associations[:see_also])
+              term.see_also = see_also_names.map do |see_also_name|
+                see_also_name = FormattedString.new see_also_name
+                (find_primary_term see_also_name) || (UnresolvedIndexTerm.new see_also_name)
+              end
+            end
+            link_associations term unless term.leaf?
+          end
+        else
+          @categories.each_value {|category| link_associations category }
+        end
+      end
+
       def store_dest dest
         @dests[dest[:anchor]] = dest
       end
@@ -83,9 +114,18 @@ module Asciidoctor
         @terms = {}
       end
 
-      def store_term name, dest
+      def store_term name, dest, assoc = {}
         term = (@terms[name] ||= (IndexTerm.new name))
         term.add_dest dest if dest
+        term.associations ||= {}
+        unless assoc.empty?
+          if !term.associations[:see] && (see = assoc[:see])
+            term.associations[:see] = see
+          end
+          if (see_also = assoc[:see_also])
+            (term.associations[:see_also] ||= []).concat see_also
+          end
+        end
         term
       end
 
@@ -100,10 +140,22 @@ module Asciidoctor
 
     class IndexTermCategory < IndexTermGroup; end
 
+    class UnresolvedIndexTerm < IndexTermGroup; end
+
     class IndexTerm < IndexTermGroup
+      attr_reader :anchor
+
+      attr_accessor :associations
+
+      attr_accessor :see
+
+      attr_writer :see_also
+
       def initialize name
         super
         @dests = ::Set.new
+        @anchor = %(__indextermdef-#{(::Digest::MD5.new << name.to_s).hexdigest})
+        @associations = @see = @see_also = nil
       end
 
       alias subterms terms
@@ -124,6 +176,10 @@ module Asciidoctor
       def leaf?
         @terms.empty?
       end
+
+      def see_also
+        @see_also&.sort
+      end
     end
   end
 end

data/lib/asciidoctor/pdf/version.rb

@@ -2,6 +2,6 @@
 
 module Asciidoctor
   module PDF
-    VERSION = '2.3.19'
+    VERSION = '2.3.21'
   end
 end

data/lib/asciidoctor/pdf.rb

@@ -2,7 +2,10 @@
 
 proc do
   old_verbose, $VERBOSE = $VERBOSE, nil
-  require 'bigdecimal' # eagerly require bigdecimal without warnings to avoid warning caused by ttfunk 1.7.0
+  begin
+    require 'bigdecimal' # try to eagerly require bigdecimal with warnings off to avoid warning caused by ttfunk 1.7.0
+  rescue Exception # rubocop:disable Lint/SuppressedException,Lint/RescueException
+  end
   $VERBOSE = old_verbose
 end.call
 
@@ -11,7 +14,11 @@ autoload :StringIO, 'stringio'
 autoload :Tempfile, 'tempfile'
 require 'time' unless defined? Time.parse
 require_relative 'pdf/version'
-require 'asciidoctor'
+proc do
+  old_verbose, $VERBOSE = $VERBOSE, nil
+  require 'asciidoctor' # avoid warning in Ruby 3.4 caused by use of logger
+  $VERBOSE = old_verbose
+end.call
 require 'prawn'
 require 'prawn/templates'
 require_relative 'pdf/measurements'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: asciidoctor-pdf
 version: !ruby/object:Gem::Version
-  version: 2.3.19
+  version: 2.3.21
 platform: ruby
 authors:
 - Dan Allen
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-10-11 00:00:00.000000000 Z
+date: 2025-10-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: asciidoctor
@@ -129,14 +129,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '1.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: treetop
   requirement: !ruby/object:Gem::Requirement
@@ -290,6 +290,7 @@ files:
 - lib/asciidoctor/pdf/ext/prawn/document/column_box.rb
 - lib/asciidoctor/pdf/ext/prawn/extensions.rb
 - lib/asciidoctor/pdf/ext/prawn/font/afm.rb
+- lib/asciidoctor/pdf/ext/prawn/font/ttf.rb
 - lib/asciidoctor/pdf/ext/prawn/font_metric_cache.rb
 - lib/asciidoctor/pdf/ext/prawn/formatted_text/arranger.rb
 - lib/asciidoctor/pdf/ext/prawn/formatted_text/box.rb
@@ -351,7 +352,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.16
+rubygems_version: 3.5.22
 signing_key: 
 specification_version: 4
 summary: Converts AsciiDoc documents to PDF using Asciidoctor and Prawn