asciidoctor-pdf 2.3.23 → 2.3.25

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 29a4c9b5fe96da65792626ef875be766bf2ef161038907e2284a91133c354d6d
-  data.tar.gz: ad429bfed1094f031c17fa520e03823b118668f931bbc3d12f2de0d284a0ffdf
+  metadata.gz: 6d3d3298e3d9c986a74fd881afef3849962ab116bfb821d3dc0ae5aa119cdda7
+  data.tar.gz: 322b16750318c051ada5b847aa1abe9ef77259f04976f37f74c956011d025ee9
 SHA512:
-  metadata.gz: 2eebb18e0a1e91c1acdbabc7b4b06db2d2d0b22a3d5df05cba3e52c8fb5c99e37b91c9850e093094e7abc486c787aa686377f473bfe50a6a93547b43d5e28e51
-  data.tar.gz: a5c7524f2b7d66debb40f8c4a71e4a1150660b9fb8db65f326da008b58318e0466e691fffd9e76efce5e25a8fcb3c3f812d71abf50f72f16ea62538443ce7abe
+  metadata.gz: 2ad59d7144d4585635e3e2c69fee235ea5f0ab592edf79b2092dfbd2f4078f2f3762c963f3d5a2dda22ded28e31eb4868fe2cc78477bb8abce83dae827e0a482
+  data.tar.gz: cb719b82e3c3a9111d9b3ceb64f21481b8bdd35499e452a6dcb0c10dfc3c2ca52db116ea3cc2999ec83984141a87ed04379e9fa1723abaab2f8f39a17a1271ca

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.25 (2026-08-31) - @mojavelinux
+
+Enhancements::
+
+* add the ballot X glyphs (U+2717 and U+2718) to the code and fallback fonts (#2652)
+
+Improvements::
+
+* suppress warning if glyph for LF cannot be found in fallback font as it's unlike to impact rendering
+
+Bug Fixes::
+
+* properly encode all non-ASCII IDs when creating and referencing destinations in PDF (#2646) (*@sandraLbdvTW*)
+* don't crash when creating toc for article with only an abstract section (#2649)
+* use empty value for preface in running content if `preface-title` attribute is explicitly unset (#2644)
+* don't allow `admonition-label-min-width` key to be less than required space to fit admonition icon
+* correctly map all icons from FontAwesome 4 (#2373)
+* don't include children of section with empty title in TOC
+* don't include children of section with empty title in outline
+* when checking whether an attribute is unspecified, consider attributes that are soft set/unset from API/CLI (#2654)
+* restore original require after loading treetop
+
+=== Details
+
+{url-repo}/releases/tag/v2.3.25[git tag] | {url-repo}/compare/v2.3.24\...v2.3.25[full diff]
+
+== 2.3.24 (2025-11-15) - @mojavelinux
+
+Improvements::
+
+* bypass any dry run logic if remaining height on page is less than heading font size
+* update import_page method on converter to return true if page was imported (nil otherwise), on par with the functionality of method it replaces
+* limit min toclevels value so it does not cause TOC to be empty (#2619)
+* add checkmark glyph (U+2713) to prose fonts (Noto Serif and Noto Sans) to avoid need for fallback font (#2617)
+
+=== Details
+
+{url-repo}/releases/tag/v2.3.24[git tag] | {url-repo}/compare/v2.3.23\...v2.3.24[full diff]
+
 == 2.3.23 (2025-10-26) - @mojavelinux
 
 Bug Fixes::
@@ -1683,7 +1722,7 @@ Bug Fixes::
 * Allow font properties to be set per element in running content (#454)
 * Prevent the SVG from modifying the document font (#494)
 * Implement decorative border for multipage quote and verse blocks (#270, #557, #558)
-* Encode anchors in hex that contain characters outside of ASCII range (#481, #301)
+* Encode anchors in hex that contain characters outside of ASCII range (#481, #308)
 * Size the line number gutter correctly (accounting for width of largest line number) (#402)
 * Allow theme to specify default value for pdfwidth attribute on image and document in README (#455)
 * Fix front matter page numbering by adding page labels for all front matter pages in outline (#458)

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.23, 2025-10-26
+v2.3.25, 2026-08-31
 // Settings:
 :experimental:
 :idprefix:

data/data/fonts/ABOUT-mplus1mn-subset

@@ -15,7 +15,7 @@ The following changes were made using fontforge to produce mplus1mn-*-ascii.ttf
  ** Latin Extended-A (U+0100–U+017f)
  ** Greek Alphabet (U+0391–U+03c9)
  ** Cyrillic (U+0400–U+04ff)
- ** Assorted Symbols (U+20ac, U+2713–U+2714)
+ ** Assorted Symbols (U+20ac, U+2713–U+2714, U+2717–U+2718)
  ** Enclosed Numbers (U+2460–U+2473, U+2776–U+277f, U+24eb–U+24f4) (mplus1mn-regular only)
  ** Box Drawing Symbols (U+2500–U+257f)
  ** .notdef glyph

data/data/fonts/ABOUT-mplus1p-subset

@@ -17,7 +17,7 @@ The following changes were made using fontforge to produce mplus1p-regular-fallb
  ** Mathematical Operators (U+2200–U+22ff, U+2116)
  ** General Punctuation (U+2000–U203a)
  ** Geometric Shapes (U+25a0–U25ff)
- ** Assorted Symbols (U+20ac, U+2122, U+21d0–U+21d5, U+2190–U+2195, U+2610–U+2611, U+2713–U+2714)
+ ** Assorted Symbols (U+20ac, U+2122, U+21d0–U+21d5, U+2190–U+2195, U+2610–U+2611, U+2713–U+2714, U+2717–U+2718)
  ** Latin Small Capital Letters (U+1D00, U+0299, U+1D04, U+1D05, U+1D07, U+A730, U+0262, U+029C, U+026A, U+1D0A, U+1D0B, U+029F, U+1D0D, U+0274, U+1D0F, U+1D18, U+A7AF (missing), U+0280, U+A731, U+1D1B, U+1D1C, U+1D20, U+1D21, U+028F, U+1D22)
  ** .notdef glyph
 * Added BOM (U+feff), hair space (U+200a), zero-width space (U+200b) and line feed (U+000a) characters (from blank)

data/data/fonts/fa-legacy-mapping.yml

@@ -0,0 +1,786 @@
+fa-500px: fab-500px
+fa-address-book: fas-address-book
+fa-address-book-o: far-address-book
+fa-address-card: fas-address-card
+fa-address-card-o: far-address-card
+fa-adjust: fas-adjust
+fa-adn: fab-adn
+fa-align-center: fas-align-center
+fa-align-justify: fas-align-justify
+fa-align-left: fas-align-left
+fa-align-right: fas-align-right
+fa-amazon: fab-amazon
+fa-ambulance: fas-ambulance
+fa-american-sign-language-interpreting: fas-american-sign-language-interpreting
+fa-anchor: fas-anchor
+fa-android: fab-android
+fa-angellist: fab-angellist
+fa-angle-double-down: fas-angle-double-down
+fa-angle-double-left: fas-angle-double-left
+fa-angle-double-right: fas-angle-double-right
+fa-angle-double-up: fas-angle-double-up
+fa-angle-down: fas-angle-down
+fa-angle-left: fas-angle-left
+fa-angle-right: fas-angle-right
+fa-angle-up: fas-angle-up
+fa-apple: fab-apple
+fa-archive: fas-archive
+fa-area-chart: fas-chart-area
+fa-arrow-circle-down: fas-arrow-circle-down
+fa-arrow-circle-left: fas-arrow-circle-left
+fa-arrow-circle-o-down: far-arrow-alt-circle-down
+fa-arrow-circle-o-left: far-arrow-alt-circle-left
+fa-arrow-circle-o-right: far-arrow-alt-circle-right
+fa-arrow-circle-o-up: far-arrow-alt-circle-up
+fa-arrow-circle-right: fas-arrow-circle-right
+fa-arrow-circle-up: fas-arrow-circle-up
+fa-arrow-down: fas-arrow-down
+fa-arrow-left: fas-arrow-left
+fa-arrow-right: fas-arrow-right
+fa-arrow-up: fas-arrow-up
+fa-arrows: fas-arrows-alt
+fa-arrows-alt: fas-expand-arrows-alt
+fa-arrows-h: fas-arrows-alt-h
+fa-arrows-v: fas-arrows-alt-v
+fa-asl-interpreting: fas-american-sign-language-interpreting
+fa-assistive-listening-systems: fas-assistive-listening-systems
+fa-asterisk: fas-asterisk
+fa-at: fas-at
+fa-audio-description: fas-audio-description
+fa-automobile: fas-car
+fa-backward: fas-backward
+fa-balance-scale: fas-balance-scale
+fa-ban: fas-ban
+fa-bandcamp: fab-bandcamp
+fa-bank: fas-university
+fa-bar-chart: far-chart-bar
+fa-bar-chart-o: far-chart-bar
+fa-barcode: fas-barcode
+fa-bars: fas-bars
+fa-bath: fas-bath
+fa-bathtub: fas-bath
+fa-battery: fas-battery-full
+fa-battery-0: fas-battery-empty
+fa-battery-1: fas-battery-quarter
+fa-battery-2: fas-battery-half
+fa-battery-3: fas-battery-three-quarters
+fa-battery-4: fas-battery-full
+fa-battery-empty: fas-battery-empty
+fa-battery-full: fas-battery-full
+fa-battery-half: fas-battery-half
+fa-battery-quarter: fas-battery-quarter
+fa-battery-three-quarters: fas-battery-three-quarters
+fa-bed: fas-bed
+fa-beer: fas-beer
+fa-behance: fab-behance
+fa-behance-square: fab-behance-square
+fa-bell: fas-bell
+fa-bell-o: far-bell
+fa-bell-slash: fas-bell-slash
+fa-bell-slash-o: far-bell-slash
+fa-bicycle: fas-bicycle
+fa-binoculars: fas-binoculars
+fa-birthday-cake: fas-birthday-cake
+fa-bitbucket: fab-bitbucket
+fa-bitbucket-square: fab-bitbucket
+fa-bitcoin: fab-bitcoin
+fa-black-tie: fab-black-tie
+fa-blind: fas-blind
+fa-bluetooth: fab-bluetooth
+fa-bluetooth-b: fab-bluetooth-b
+fa-bold: fas-bold
+fa-bolt: fas-bolt
+fa-bomb: fas-bomb
+fa-book: fas-book
+fa-bookmark: fas-bookmark
+fa-bookmark-o: far-bookmark
+fa-braille: fas-braille
+fa-briefcase: fas-briefcase
+fa-btc: fab-btc
+fa-bug: fas-bug
+fa-building: fas-building
+fa-building-o: far-building
+fa-bullhorn: fas-bullhorn
+fa-bullseye: fas-bullseye
+fa-bus: fas-bus
+fa-buysellads: fab-buysellads
+fa-cab: fas-taxi
+fa-calculator: fas-calculator
+fa-calendar: fas-calendar-alt
+fa-calendar-check-o: far-calendar-check
+fa-calendar-minus-o: far-calendar-minus
+fa-calendar-o: far-calendar
+fa-calendar-plus-o: far-calendar-plus
+fa-calendar-times-o: far-calendar-times
+fa-camera: fas-camera
+fa-camera-retro: fas-camera-retro
+fa-car: fas-car
+fa-caret-down: fas-caret-down
+fa-caret-left: fas-caret-left
+fa-caret-right: fas-caret-right
+fa-caret-square-o-down: far-caret-square-down
+fa-caret-square-o-left: far-caret-square-left
+fa-caret-square-o-right: far-caret-square-right
+fa-caret-square-o-up: far-caret-square-up
+fa-caret-up: fas-caret-up
+fa-cart-arrow-down: fas-cart-arrow-down
+fa-cart-plus: fas-cart-plus
+fa-cc: far-closed-captioning
+fa-cc-amex: fab-cc-amex
+fa-cc-diners-club: fab-cc-diners-club
+fa-cc-discover: fab-cc-discover
+fa-cc-jcb: fab-cc-jcb
+fa-cc-mastercard: fab-cc-mastercard
+fa-cc-paypal: fab-cc-paypal
+fa-cc-stripe: fab-cc-stripe
+fa-cc-visa: fab-cc-visa
+fa-certificate: fas-certificate
+fa-chain: fas-link
+fa-chain-broken: fas-unlink
+fa-check: fas-check
+fa-check-circle: fas-check-circle
+fa-check-circle-o: far-check-circle
+fa-check-square: fas-check-square
+fa-check-square-o: far-check-square
+fa-chevron-circle-down: fas-chevron-circle-down
+fa-chevron-circle-left: fas-chevron-circle-left
+fa-chevron-circle-right: fas-chevron-circle-right
+fa-chevron-circle-up: fas-chevron-circle-up
+fa-chevron-down: fas-chevron-down
+fa-chevron-left: fas-chevron-left
+fa-chevron-right: fas-chevron-right
+fa-chevron-up: fas-chevron-up
+fa-child: fas-child
+fa-chrome: fab-chrome
+fa-circle: fas-circle
+fa-circle-o: far-circle
+fa-circle-o-notch: fas-circle-notch
+fa-circle-thin: far-circle
+fa-clipboard: far-clipboard
+fa-clock-o: far-clock
+fa-clone: far-clone
+fa-close: fas-times
+fa-cloud: fas-cloud
+fa-cloud-download: fas-cloud-download-alt
+fa-cloud-upload: fas-cloud-upload-alt
+fa-cny: fas-yen-sign
+fa-code: fas-code
+fa-code-fork: fas-code-branch
+fa-codepen: fab-codepen
+fa-codiepie: fab-codiepie
+fa-coffee: fas-coffee
+fa-cog: fas-cog
+fa-cogs: fas-cogs
+fa-columns: fas-columns
+fa-comment: fas-comment
+fa-comment-o: far-comment
+fa-commenting: fas-comment-alt
+fa-commenting-o: far-comment-dots
+fa-comments: fas-comments
+fa-comments-o: far-comments
+fa-compass: far-compass
+fa-compress: fas-compress
+fa-connectdevelop: fab-connectdevelop
+fa-contao: fab-contao
+fa-copy: fas-copy
+fa-copyright: far-copyright
+fa-creative-commons: fab-creative-commons
+fa-credit-card: far-credit-card
+fa-credit-card-alt: fas-credit-card
+fa-crop: fas-crop
+fa-crosshairs: fas-crosshairs
+fa-css3: fab-css3
+fa-cube: fas-cube
+fa-cubes: fas-cubes
+fa-cut: fas-cut
+fa-cutlery: fas-utensils
+fa-dashboard: fas-tachometer-alt
+fa-dashcube: fab-dashcube
+fa-database: fas-database
+fa-deaf: fas-deaf
+fa-deafness: fas-deaf
+fa-dedent: fas-outdent
+fa-delicious: fab-delicious
+fa-desktop: fas-desktop
+fa-deviantart: fab-deviantart
+fa-diamond: far-gem
+fa-digg: fab-digg
+fa-dollar: fas-dollar-sign
+fa-dot-circle-o: far-dot-circle
+fa-download: fas-download
+fa-dribbble: fab-dribbble
+fa-drivers-license: fas-id-card
+fa-drivers-license-o: far-id-card
+fa-dropbox: fab-dropbox
+fa-drupal: fab-drupal
+fa-edge: fab-edge
+fa-edit: fas-edit
+fa-eercast: fab-sellcast
+fa-eject: fas-eject
+fa-ellipsis-h: fas-ellipsis-h
+fa-ellipsis-v: fas-ellipsis-v
+fa-empire: fab-empire
+fa-envelope: fas-envelope
+fa-envelope-o: far-envelope
+fa-envelope-open: fas-envelope-open
+fa-envelope-open-o: far-envelope-open
+fa-envelope-square: fas-envelope-square
+fa-envira: fab-envira
+fa-eraser: fas-eraser
+fa-etsy: fab-etsy
+fa-eur: fas-euro-sign
+fa-euro: fas-euro-sign
+fa-exchange: fas-exchange-alt
+fa-exclamation: fas-exclamation
+fa-exclamation-circle: fas-exclamation-circle
+fa-exclamation-triangle: fas-exclamation-triangle
+fa-expand: fas-expand
+fa-expeditedssl: fab-expeditedssl
+fa-external-link: fas-external-link-alt
+fa-external-link-square: fas-external-link-square-alt
+fa-eye: fas-eye
+fa-eye-slash: far-eye-slash
+fa-eyedropper: fas-eye-dropper
+fa-fa: fab-font-awesome
+fa-facebook: fab-facebook-f
+fa-facebook-f: fab-facebook-f
+fa-facebook-official: fab-facebook
+fa-facebook-square: fab-facebook-square
+fa-fast-backward: fas-fast-backward
+fa-fast-forward: fas-fast-forward
+fa-fax: fas-fax
+fa-feed: fas-rss
+fa-female: fas-female
+fa-fighter-jet: fas-fighter-jet
+fa-file: fas-file
+fa-file-archive-o: far-file-archive
+fa-file-audio-o: far-file-audio
+fa-file-code-o: far-file-code
+fa-file-excel-o: far-file-excel
+fa-file-image-o: far-file-image
+fa-file-movie-o: far-file-video
+fa-file-o: far-file
+fa-file-pdf-o: far-file-pdf
+fa-file-photo-o: far-file-image
+fa-file-picture-o: far-file-image
+fa-file-powerpoint-o: far-file-powerpoint
+fa-file-sound-o: far-file-audio
+fa-file-text: fas-file-alt
+fa-file-text-o: far-file-alt
+fa-file-video-o: far-file-video
+fa-file-word-o: far-file-word
+fa-file-zip-o: far-file-archive
+fa-files-o: far-copy
+fa-film: fas-film
+fa-filter: fas-filter
+fa-fire: fas-fire
+fa-fire-extinguisher: fas-fire-extinguisher
+fa-firefox: fab-firefox
+fa-first-order: fab-first-order
+fa-flag: fas-flag
+fa-flag-checkered: fas-flag-checkered
+fa-flag-o: far-flag
+fa-flash: fas-bolt
+fa-flask: fas-flask
+fa-flickr: fab-flickr
+fa-floppy-o: far-save
+fa-folder: fas-folder
+fa-folder-o: far-folder
+fa-folder-open: fas-folder-open
+fa-folder-open-o: far-folder-open
+fa-font: fas-font
+fa-font-awesome: fab-font-awesome
+fa-fonticons: fab-fonticons
+fa-fort-awesome: fab-fort-awesome
+fa-forumbee: fab-forumbee
+fa-forward: fas-forward
+fa-foursquare: fab-foursquare
+fa-free-code-camp: fab-free-code-camp
+fa-frown-o: far-frown
+fa-futbol-o: far-futbol
+fa-gamepad: fas-gamepad
+fa-gavel: fas-gavel
+fa-gbp: fas-pound-sign
+fa-ge: fab-empire
+fa-gear: fas-cog
+fa-gears: fas-cogs
+fa-genderless: fas-genderless
+fa-get-pocket: fab-get-pocket
+fa-gg: fab-gg
+fa-gg-circle: fab-gg-circle
+fa-gift: fas-gift
+fa-git: fab-git
+fa-git-square: fab-git-square
+fa-github: fab-github
+fa-github-alt: fab-github-alt
+fa-github-square: fab-github-square
+fa-gitlab: fab-gitlab
+fa-gittip: fab-gratipay
+fa-glass: fas-glass-martini
+fa-glide: fab-glide
+fa-glide-g: fab-glide-g
+fa-globe: fas-globe
+fa-google: fab-google
+fa-google-plus: fab-google-plus-g
+fa-google-plus-circle: fab-google-plus
+fa-google-plus-official: fab-google-plus
+fa-google-plus-square: fab-google-plus-square
+fa-google-wallet: fab-google-wallet
+fa-graduation-cap: fas-graduation-cap
+fa-gratipay: fab-gratipay
+fa-grav: fab-grav
+fa-group: fas-users
+fa-h-square: fas-h-square
+fa-hacker-news: fab-hacker-news
+fa-hand-grab-o: far-hand-rock
+fa-hand-lizard-o: far-hand-lizard
+fa-hand-o-down: far-hand-point-down
+fa-hand-o-left: far-hand-point-left
+fa-hand-o-right: far-hand-point-right
+fa-hand-o-up: far-hand-point-up
+fa-hand-paper-o: far-hand-paper
+fa-hand-peace-o: far-hand-peace
+fa-hand-pointer-o: far-hand-pointer
+fa-hand-rock-o: far-hand-rock
+fa-hand-scissors-o: far-hand-scissors
+fa-hand-spock-o: far-hand-spock
+fa-hand-stop-o: far-hand-paper
+fa-handshake-o: far-handshake
+fa-hard-of-hearing: fas-deaf
+fa-hashtag: fas-hashtag
+fa-hdd-o: far-hdd
+fa-header: fas-heading
+fa-headphones: fas-headphones
+fa-heart: fas-heart
+fa-heart-o: far-heart
+fa-heartbeat: fas-heartbeat
+fa-history: fas-history
+fa-home: fas-home
+fa-hospital-o: far-hospital
+fa-hotel: fas-bed
+fa-hourglass: fas-hourglass
+fa-hourglass-1: fas-hourglass-start
+fa-hourglass-2: fas-hourglass-half
+fa-hourglass-3: fas-hourglass-end
+fa-hourglass-end: fas-hourglass-end
+fa-hourglass-half: fas-hourglass-half
+fa-hourglass-o: far-hourglass
+fa-hourglass-start: fas-hourglass-start
+fa-houzz: fab-houzz
+fa-html5: fab-html5
+fa-i-cursor: fas-i-cursor
+fa-id-badge: far-id-badge
+fa-id-card: fas-id-card
+fa-id-card-o: far-id-card
+fa-ils: fas-shekel-sign
+fa-image: fas-image
+fa-imdb: fab-imdb
+fa-inbox: fas-inbox
+fa-indent: fas-indent
+fa-industry: fas-industry
+fa-info: fas-info
+fa-info-circle: fas-info-circle
+fa-inr: fas-rupee-sign
+fa-instagram: fab-instagram
+fa-institution: fas-university
+fa-internet-explorer: fab-internet-explorer
+fa-intersex: fas-transgender
+fa-ioxhost: fab-ioxhost
+fa-italic: fas-italic
+fa-joomla: fab-joomla
+fa-jpy: fas-yen-sign
+fa-jsfiddle: fab-jsfiddle
+fa-key: fas-key
+fa-keyboard-o: far-keyboard
+fa-krw: fas-won-sign
+fa-language: fas-language
+fa-laptop: fas-laptop
+fa-lastfm: fab-lastfm
+fa-lastfm-square: fab-lastfm-square
+fa-leaf: fas-leaf
+fa-leanpub: fab-leanpub
+fa-legal: fas-gavel
+fa-lemon-o: far-lemon
+fa-level-down: fas-level-down-alt
+fa-level-up: fas-level-up-alt
+fa-life-bouy: fas-life-ring
+fa-life-buoy: fas-life-ring
+fa-life-ring: far-life-ring
+fa-life-saver: fas-life-ring
+fa-lightbulb-o: far-lightbulb
+fa-line-chart: fas-chart-line
+fa-link: fas-link
+fa-linkedin: fab-linkedin-in
+fa-linkedin-square: fab-linkedin
+fa-linode: fab-linode
+fa-linux: fab-linux
+fa-list: fas-list
+fa-list-alt: far-list-alt
+fa-list-ol: fas-list-ol
+fa-list-ul: fas-list-ul
+fa-location-arrow: fas-location-arrow
+fa-lock: fas-lock
+fa-long-arrow-down: fas-long-arrow-alt-down
+fa-long-arrow-left: fas-long-arrow-alt-left
+fa-long-arrow-right: fas-long-arrow-alt-right
+fa-long-arrow-up: fas-long-arrow-alt-up
+fa-low-vision: fas-low-vision
+fa-magic: fas-magic
+fa-magnet: fas-magnet
+fa-mail-forward: fas-share
+fa-mail-reply: fas-reply
+fa-mail-reply-all: fas-reply-all
+fa-male: fas-male
+fa-map: fas-map
+fa-map-marker: fas-map-marker-alt
+fa-map-o: far-map
+fa-map-pin: fas-map-pin
+fa-map-signs: fas-map-signs
+fa-mars: fas-mars
+fa-mars-double: fas-mars-double
+fa-mars-stroke: fas-mars-stroke
+fa-mars-stroke-h: fas-mars-stroke-h
+fa-mars-stroke-v: fas-mars-stroke-v
+fa-maxcdn: fab-maxcdn
+fa-meanpath: fab-font-awesome
+fa-medium: fab-medium
+fa-medkit: fas-medkit
+fa-meetup: fab-meetup
+fa-meh-o: far-meh
+fa-mercury: fas-mercury
+fa-microchip: fas-microchip
+fa-microphone: fas-microphone
+fa-microphone-slash: fas-microphone-slash
+fa-minus: fas-minus
+fa-minus-circle: fas-minus-circle
+fa-minus-square: fas-minus-square
+fa-minus-square-o: far-minus-square
+fa-mixcloud: fab-mixcloud
+fa-mobile: fas-mobile-alt
+fa-mobile-phone: fas-mobile
+fa-modx: fab-modx
+fa-money: far-money-bill-alt
+fa-moon-o: far-moon
+fa-mortar-board: fas-graduation-cap
+fa-motorcycle: fas-motorcycle
+fa-mouse-pointer: fas-mouse-pointer
+fa-music: fas-music
+fa-navicon: fas-bars
+fa-neuter: fas-neuter
+fa-newspaper-o: far-newspaper
+fa-object-group: far-object-group
+fa-object-ungroup: far-object-ungroup
+fa-odnoklassniki: fab-odnoklassniki
+fa-odnoklassniki-square: fab-odnoklassniki-square
+fa-opencart: fab-opencart
+fa-openid: fab-openid
+fa-opera: fab-opera
+fa-optin-monster: fab-optin-monster
+fa-outdent: fas-outdent
+fa-pagelines: fab-pagelines
+fa-paint-brush: fas-paint-brush
+fa-paper-plane: fas-paper-plane
+fa-paper-plane-o: far-paper-plane
+fa-paperclip: fas-paperclip
+fa-paragraph: fas-paragraph
+fa-paste: fas-paste
+fa-pause: fas-pause
+fa-pause-circle: fas-pause-circle
+fa-pause-circle-o: far-pause-circle
+fa-paw: fas-paw
+fa-paypal: fab-paypal
+fa-pencil: fas-pencil-alt
+fa-pencil-square: fas-pen-square
+fa-pencil-square-o: far-edit
+fa-percent: fas-percent
+fa-phone: fas-phone
+fa-phone-square: fas-phone-square
+fa-photo: far-image
+fa-picture-o: far-image
+fa-pie-chart: fas-chart-pie
+fa-pied-piper: fab-pied-piper
+fa-pied-piper-alt: fab-pied-piper-alt
+fa-pied-piper-pp: fab-pied-piper-pp
+fa-pinterest: fab-pinterest
+fa-pinterest-p: fab-pinterest-p
+fa-pinterest-square: fab-pinterest-square
+fa-plane: fas-plane
+fa-play: fas-play
+fa-play-circle: fas-play-circle
+fa-play-circle-o: far-play-circle
+fa-plug: fas-plug
+fa-plus: fas-plus
+fa-plus-circle: fas-plus-circle
+fa-plus-square: fas-plus-square
+fa-plus-square-o: far-plus-square
+fa-podcast: fas-podcast
+fa-power-off: fas-power-off
+fa-print: fas-print
+fa-product-hunt: fab-product-hunt
+fa-puzzle-piece: fas-puzzle-piece
+fa-qq: fab-qq
+fa-qrcode: fas-qrcode
+fa-question: fas-question
+fa-question-circle: fas-question-circle
+fa-question-circle-o: far-question-circle
+fa-quora: fab-quora
+fa-quote-left: fas-quote-left
+fa-quote-right: fas-quote-right
+fa-ra: fab-rebel
+fa-random: fas-random
+fa-ravelry: fab-ravelry
+fa-rebel: fab-rebel
+fa-recycle: fas-recycle
+fa-reddit: fab-reddit
+fa-reddit-alien: fab-reddit-alien
+fa-reddit-square: fab-reddit-square
+fa-refresh: fas-sync
+fa-registered: far-registered
+fa-remove: fas-times
+fa-renren: fab-renren
+fa-reorder: fas-bars
+fa-repeat: fas-redo
+fa-reply: fas-reply
+fa-reply-all: fas-reply-all
+fa-resistance: fab-rebel
+fa-retweet: fas-retweet
+fa-rmb: fas-yen-sign
+fa-road: fas-road
+fa-rocket: fas-rocket
+fa-rotate-left: fas-undo
+fa-rotate-right: fas-redo
+fa-rouble: fas-ruble-sign
+fa-rss: fas-rss
+fa-rss-square: fas-rss-square
+fa-rub: fas-ruble-sign
+fa-ruble: fas-ruble-sign
+fa-rupee: fas-rupee-sign
+fa-s15: fas-bath
+fa-safari: fab-safari
+fa-save: fas-save
+fa-scissors: fas-cut
+fa-scribd: fab-scribd
+fa-search: fas-search
+fa-search-minus: fas-search-minus
+fa-search-plus: fas-search-plus
+fa-sellsy: fab-sellsy
+fa-send: fas-paper-plane
+fa-send-o: far-paper-plane
+fa-server: fas-server
+fa-share: fas-share
+fa-share-alt: fas-share-alt
+fa-share-alt-square: fas-share-alt-square
+fa-share-square: fas-share-square
+fa-share-square-o: far-share-square
+fa-shekel: fas-shekel-sign
+fa-sheqel: fas-shekel-sign
+fa-shield: fas-shield-alt
+fa-ship: fas-ship
+fa-shirtsinbulk: fab-shirtsinbulk
+fa-shopping-bag: fas-shopping-bag
+fa-shopping-basket: fas-shopping-basket
+fa-shopping-cart: fas-shopping-cart
+fa-shower: fas-shower
+fa-sign-in: fas-sign-in-alt
+fa-sign-language: fas-sign-language
+fa-sign-out: fas-sign-out-alt
+fa-signal: fas-signal
+fa-signing: fas-sign-language
+fa-simplybuilt: fab-simplybuilt
+fa-sitemap: fas-sitemap
+fa-skyatlas: fab-skyatlas
+fa-skype: fab-skype
+fa-slack: fab-slack
+fa-sliders: fas-sliders-h
+fa-slideshare: fab-slideshare
+fa-smile-o: far-smile
+fa-snapchat: fab-snapchat
+fa-snapchat-ghost: fab-snapchat-ghost
+fa-snapchat-square: fab-snapchat-square
+fa-snowflake-o: far-snowflake
+fa-soccer-ball-o: far-futbol
+fa-sort: fas-sort
+fa-sort-alpha-asc: fas-sort-alpha-down
+fa-sort-alpha-desc: fas-sort-alpha-up
+fa-sort-amount-asc: fas-sort-amount-down
+fa-sort-amount-desc: fas-sort-amount-up
+fa-sort-asc: fas-sort-up
+fa-sort-desc: fas-sort-down
+fa-sort-down: fas-sort-down
+fa-sort-numeric-asc: fas-sort-numeric-down
+fa-sort-numeric-desc: fas-sort-numeric-up
+fa-sort-up: fas-sort-up
+fa-soundcloud: fab-soundcloud
+fa-space-shuttle: fas-space-shuttle
+fa-spinner: fas-spinner
+fa-spoon: fas-utensil-spoon
+fa-spotify: fab-spotify
+fa-square: fas-square
+fa-square-o: far-square
+fa-stack-exchange: fab-stack-exchange
+fa-stack-overflow: fab-stack-overflow
+fa-star: fas-star
+fa-star-half: fas-star-half
+fa-star-half-empty: fas-star-half
+fa-star-half-full: fas-star-half
+fa-star-half-o: far-star-half
+fa-star-o: far-star
+fa-steam: fab-steam
+fa-steam-square: fab-steam-square
+fa-step-backward: fas-step-backward
+fa-step-forward: fas-step-forward
+fa-stethoscope: fas-stethoscope
+fa-sticky-note: fas-sticky-note
+fa-sticky-note-o: far-sticky-note
+fa-stop: fas-stop
+fa-stop-circle: fas-stop-circle
+fa-stop-circle-o: far-stop-circle
+fa-street-view: fas-street-view
+fa-strikethrough: fas-strikethrough
+fa-stumbleupon: fab-stumbleupon
+fa-stumbleupon-circle: fab-stumbleupon-circle
+fa-subscript: fas-subscript
+fa-subway: fas-subway
+fa-suitcase: fas-suitcase
+fa-sun-o: far-sun
+fa-superpowers: fab-superpowers
+fa-superscript: fas-superscript
+fa-support: far-life-ring
+fa-table: fas-table
+fa-tablet: fas-tablet-alt
+fa-tachometer: fas-tachometer-alt
+fa-tag: fas-tag
+fa-tags: fas-tags
+fa-tasks: fas-tasks
+fa-taxi: fas-taxi
+fa-telegram: fab-telegram
+fa-television: fas-tv
+fa-tencent-weibo: fab-tencent-weibo
+fa-terminal: fas-terminal
+fa-text-height: fas-text-height
+fa-text-width: fas-text-width
+fa-th: fas-th
+fa-th-large: fas-th-large
+fa-th-list: fas-th-list
+fa-themeisle: fab-themeisle
+fa-thermometer: fas-thermometer
+fa-thermometer-0: fas-thermometer-empty
+fa-thermometer-1: fas-thermometer-quarter
+fa-thermometer-2: fas-thermometer-half
+fa-thermometer-3: fas-thermometer-three-quarters
+fa-thermometer-4: fas-thermometer-full
+fa-thermometer-empty: fas-thermometer-empty
+fa-thermometer-full: fas-thermometer-full
+fa-thermometer-half: fas-thermometer-half
+fa-thermometer-quarter: fas-thermometer-quarter
+fa-thermometer-three-quarters: fas-thermometer-three-quarters
+fa-thumb-tack: fas-thumbtack
+fa-thumbs-down: fas-thumbs-down
+fa-thumbs-o-down: far-thumbs-down
+fa-thumbs-o-up: far-thumbs-up
+fa-thumbs-up: fas-thumbs-up
+fa-ticket: fas-ticket-alt
+fa-times: fas-times
+fa-times-circle: fas-times-circle
+fa-times-circle-o: far-times-circle
+fa-times-rectangle: fas-window-close
+fa-times-rectangle-o: far-window-close
+fa-tint: fas-tint
+fa-toggle-down: far-caret-square-down
+fa-toggle-left: far-caret-square-left
+fa-toggle-off: fas-toggle-off
+fa-toggle-on: fas-toggle-on
+fa-toggle-right: far-caret-square-right
+fa-toggle-up: far-caret-square-up
+fa-trademark: fas-trademark
+fa-train: fas-train
+fa-transgender: fas-transgender
+fa-transgender-alt: fas-transgender-alt
+fa-trash: fas-trash-alt
+fa-trash-o: far-trash-alt
+fa-tree: fas-tree
+fa-trello: fab-trello
+fa-tripadvisor: fab-tripadvisor
+fa-trophy: fas-trophy
+fa-truck: fas-truck
+fa-try: fas-lira-sign
+fa-tty: fas-tty
+fa-tumblr: fab-tumblr
+fa-tumblr-square: fab-tumblr-square
+fa-turkish-lira: fas-lira-sign
+fa-tv: fas-tv
+fa-twitch: fab-twitch
+fa-twitter: fab-twitter
+fa-twitter-square: fab-twitter-square
+fa-umbrella: fas-umbrella
+fa-underline: fas-underline
+fa-undo: fas-undo
+fa-universal-access: fas-universal-access
+fa-university: fas-university
+fa-unlink: fas-unlink
+fa-unlock: fas-unlock
+fa-unlock-alt: fas-unlock-alt
+fa-unsorted: fas-sort
+fa-upload: fas-upload
+fa-usb: fab-usb
+fa-usd: fas-dollar-sign
+fa-user: fas-user
+fa-user-circle: fas-user-circle
+fa-user-circle-o: far-user-circle
+fa-user-md: fas-user-md
+fa-user-o: far-user
+fa-user-plus: fas-user-plus
+fa-user-secret: fas-user-secret
+fa-user-times: fas-user-times
+fa-users: fas-users
+fa-vcard: fas-address-card
+fa-vcard-o: far-address-card
+fa-venus: fas-venus
+fa-venus-double: fas-venus-double
+fa-venus-mars: fas-venus-mars
+fa-viacoin: fab-viacoin
+fa-viadeo: fab-viadeo
+fa-viadeo-square: fab-viadeo-square
+fa-video-camera: fas-video
+fa-vimeo: fab-vimeo-v
+fa-vimeo-square: fab-vimeo-square
+fa-vine: fab-vine
+fa-vk: fab-vk
+fa-volume-control-phone: fas-phone-volume
+fa-volume-down: fas-volume-down
+fa-volume-off: fas-volume-off
+fa-volume-up: fas-volume-up
+fa-warning: fas-exclamation-triangle
+fa-wechat: fab-weixin
+fa-weibo: fab-weibo
+fa-weixin: fab-weixin
+fa-whatsapp: fab-whatsapp
+fa-wheelchair: fas-wheelchair
+fa-wheelchair-alt: fab-accessible-icon
+fa-wifi: fas-wifi
+fa-wikipedia-w: fab-wikipedia-w
+fa-window-close: fas-window-close
+fa-window-close-o: far-window-close
+fa-window-maximize: far-window-maximize
+fa-window-minimize: fas-window-minimize
+fa-window-restore: far-window-restore
+fa-windows: fab-windows
+fa-won: fas-won-sign
+fa-wordpress: fab-wordpress
+fa-wpbeginner: fab-wpbeginner
+fa-wpexplorer: fab-wpexplorer
+fa-wpforms: fab-wpforms
+fa-wrench: fas-wrench
+fa-xing: fab-xing
+fa-xing-square: fab-xing-square
+fa-y-combinator: fab-y-combinator
+fa-y-combinator-square: fab-hacker-news
+fa-yahoo: fab-yahoo
+fa-yc: fab-y-combinator
+fa-yc-square: fab-hacker-news
+fa-yelp: fab-yelp
+fa-yen: fas-yen-sign
+fa-yoast: fab-yoast
+fa-youtube: fab-youtube
+fa-youtube-play: fab-youtube
+fa-youtube-square: fab-youtube-square

data/lib/asciidoctor/pdf/converter.rb

@@ -188,6 +188,12 @@ module Asciidoctor
           font @theme.base_font_family, size: @root_font_size, style: @theme.base_font_style
         end
 
+        # HACK: demote abstract section to styled open block to hide from TOC
+        if doctype == 'article' && (first_section = doc.sections[0]) && first_section.sectname === 'abstract'
+          first_section.context = :open
+          first_section.style = 'abstract'
+        end
+
         unless title_as_page
           body_start_page_number = page_number
           theme_font :heading, level: 1 do
@@ -195,10 +201,10 @@ module Asciidoctor
           end if doc.header? && !doc.notitle
         end
 
-        num_front_matter_pages = toc_page_nums = toc_num_levels = nil
+        num_front_matter_pages = toc_page_nums = nil
 
+        toc_num_levels = resolve_toclevels doc
         indent_section do
-          toc_num_levels = (doc.attr 'toclevels', 2).to_i
           if (toc_at_top = (doc.attr? 'toc') && !((toc_placement = doc.attr 'toc-placement') == 'macro' || toc_placement == 'preamble') && !(get_entries_for_toc doc).empty?)
             start_new_page if @ppbook && verso_page?
             add_dest_for_block doc, id: 'toc', y: (at_page_top? ? page_height : nil)
@@ -634,11 +640,8 @@ module Asciidoctor
       end
 
       def convert_section sect, _opts = {}
-        if (sectname = sect.sectname) == 'abstract'
-          # HACK: cheat a bit to hide this section from TOC; TOC should filter these sections
-          sect.context = :open
-          return convert_abstract sect
-        elsif (index_section = sectname == 'index') && @index.empty?
+        sectname = sect.sectname
+        if (index_section = sectname == 'index') && @index.empty?
           # override numbered_title to hide entry from TOC
           sect.define_singleton_method :numbered_title, ->(*) { '' }
           return
@@ -673,7 +676,7 @@ module Asciidoctor
         # QUESTION: should we just assign the section this generated id?
         # NOTE: section must have pdf-anchor in order to be listed in the TOC
         sect.set_attr 'pdf-anchor', (sect_anchor = derive_anchor_from_id sect.id, %(#{start_pgnum}-#{y.ceil}))
-        add_dest_for_block sect, id: sect_anchor, y: (at_page_top? ? page_height : nil)
+        add_dest_for_block sect, anchor: sect_anchor, y: (at_page_top? ? page_height : nil)
         theme_font :heading, level: hlevel do
           if part
             ink_part_title sect, title, hopts
@@ -932,8 +935,8 @@ module Asciidoctor
           if !(has_icon = node.attr? 'icon') && (doc.attr 'icons') == 'font'
             icons = 'font'
             icon_data = admonition_icon_data type.to_sym
-            icon_size = icon_data[:size] || 24
-            label_width = label_min_width || (icon_size * 1.5)
+            label_width = (icon_size = icon_data[:size] || 24) * 1.5
+            label_width = label_min_width if label_min_width && label_min_width > label_width
           elsif (icon_path = has_icon || !(icon_path = (@theme[%(admonition_icon_#{type})] || {})[:image]) ?
               (get_icon_image_path node, type) :
               (ThemeLoader.resolve_theme_asset (apply_subs_discretely doc, icon_path, subs: [:attributes], imagesdir: @themesdir), @themesdir)) &&
@@ -2423,7 +2426,7 @@ module Asciidoctor
         if ((doc = node.document).attr? 'toc-placement', placement) && (doc.attr? 'toc') && !(get_entries_for_toc doc).empty?
           start_toc_page node, placement if (is_book = doc.doctype == 'book')
           add_dest_for_block node, id: (node.id || 'toc') if is_macro
-          toc_extent = @toc_extent = allocate_toc doc, (doc.attr 'toclevels', 2).to_i, cursor, (title_as_page = is_book || (doc.attr? 'title-page'))
+          toc_extent = @toc_extent = allocate_toc doc, (resolve_toclevels doc), cursor, (title_as_page = is_book || (doc.attr? 'title-page'))
           if title_as_page
             if @theme.page_numbering_start_at == 'toc'
               @index.start_page_number = toc_extent.from.page
@@ -2487,7 +2490,7 @@ module Asciidoctor
         target = node.target
         case node.type
         when :link
-          anchor = node.id ? %(<a id="#{node.id}">#{DummyText}</a>) : ''
+          anchor = node.id ? %(<a id="#{derive_anchor_from_id node.id}">#{DummyText}</a>) : ''
           attrs = []
           if (role = node.role)
             attrs << %( class="#{role}")
@@ -2522,7 +2525,7 @@ module Asciidoctor
                 text = text.gsub DropAnchorRx, ''
               end
               if ref.inline? && ref.type == :bibref && !scratch? && (@bibref_refs.add? refid)
-                anchor = %(<a id="_bibref_ref_#{refid}">#{DummyText}</a>)
+                anchor = %(<a id="#{derive_anchor_from_id "_bibref_ref_#{refid}"}">#{DummyText}</a>)
               end
               @resolving_xref = nil
             end
@@ -2532,14 +2535,14 @@ module Asciidoctor
           end
         when :ref
           # NOTE: destination is created inside callback registered by FormattedTextTransform#build_fragment
-          %(<a id="#{node.id}">#{DummyText}</a>)
+          %(<a id="#{derive_anchor_from_id node.id}">#{DummyText}</a>)
         when :bibref
           id = node.id
           # NOTE: technically node.text should be node.reftext, but subs have already been applied to text
           reftext = (reftext = node.reftext) ? %([#{reftext}]) : %([#{id}])
-          reftext = %(<a anchor="_bibref_ref_#{id}">#{reftext}</a>) if @bibref_refs.include? id
+          reftext = %(<a anchor="#{derive_anchor_from_id "_bibref_ref_#{id}"}">#{reftext}</a>) if @bibref_refs.include? id
           # NOTE: destination is created inside callback registered by FormattedTextTransform#build_fragment
-          %(<a id="#{id}">#{DummyText}</a>#{reftext})
+          %(<a id="#{derive_anchor_from_id id}">#{DummyText}</a>#{reftext})
         else
           log :warn, %(unknown anchor type: #{node.type.inspect})
           nil
@@ -2782,7 +2785,7 @@ module Asciidoctor
         end
 
         # NOTE: destination is created inside callback registered by FormattedTextTransform#build_fragment
-        node.id ? %(<a id="#{node.id}">#{DummyText}</a>#{quoted_text}) : quoted_text
+        node.id ? %(<a id="#{derive_anchor_from_id node.id}">#{DummyText}</a>#{quoted_text}) : quoted_text
       end
 
       # If an id is provided or the node passed as the first argument has an id,
@@ -2795,8 +2798,8 @@ module Asciidoctor
       # experience. If the current x position is at or inside the left margin, set
       # the x position equal to 0 (left edge of page) to improve the navigation
       # experience.
-      def add_dest_for_block node, id: nil, y: nil
-        if !scratch? && (id ||= node.id)
+      def add_dest_for_block node, anchor: nil, id: nil, y: nil
+        if !scratch? && (anchor || ((id ||= node.id) && (anchor = derive_anchor_from_id id)))
           dest_x = bounds.absolute_left.truncate 4
           # QUESTION: when content is aligned to left margin, should we keep precise x value or just use 0?
           dest_x = 0 if dest_x <= page_margin_left
@@ -2806,7 +2809,7 @@ module Asciidoctor
           end
           # TODO: find a way to store only the ref of the destination; look it up when we need it
           node.set_attr 'pdf-destination', (node_dest = (dest_xyz dest_x, dest_y))
-          add_dest id, node_dest
+          add_dest anchor, node_dest
         end
         nil
       end
@@ -2815,7 +2818,7 @@ module Asciidoctor
         if ::String === num_levels
           if num_levels.include? ':'
             num_levels, expand_levels = num_levels.split ':', 2
-            num_levels = num_levels.empty? ? (doc.attr 'toclevels', 2).to_i : num_levels.to_i
+            num_levels = num_levels.empty? ? (resolve_toclevels doc) : num_levels.to_i
             expand_levels = expand_levels.to_i
           else
             num_levels = expand_levels = num_levels.to_i
@@ -2835,7 +2838,7 @@ module Asciidoctor
           pagenum_labels[n] = { P: (::PDF::Core::LiteralString.new (i + 1).to_s) }
         end
 
-        unless toc_page_nums.none? || (toc_title = doc.attr 'toc-title').nil_or_empty?
+        unless toc_page_nums.none? || (toc_title = doc.attr 'toc-title').nil_or_empty? || doc.sections.empty?
           toc_section = insert_toc_section doc, toc_title, toc_page_nums
         end
 
@@ -2864,6 +2867,7 @@ module Asciidoctor
           next if (num_levels_for_sect = (sect.attr 'outlinelevels', num_levels).to_i) < (level = sect.level) ||
             ((sect.option? 'notitle') && sect == sect.document.last_child && sect.empty?)
           sect_title = sanitize sect.numbered_title formal: true
+          next if sect_title.empty?
           sect_destination = sect.attr 'pdf-destination'
           if level < num_levels_for_sect && sect.sections?
             outline.section sect_title, destination: sect_destination, closed: expand_levels < 1 do
@@ -2910,6 +2914,11 @@ module Asciidoctor
       # the next page. This method is not called if the cursor is already at the top of the page or
       # whether this node has no node that follows it in document order.
       def arrange_heading node, title, opts
+        # quick optimization if font size itself won't fit in remaining space
+        unless theme_font(:heading, level: (hlevel = opts[:level])) { font_size <= cursor }
+          advance_page
+          return
+        end
         if (min_height_after = @theme.heading_min_height_after) == 'auto' || (node.option? 'breakable')
           orphaned = nil
           doc = node.document
@@ -2917,7 +2926,7 @@ module Asciidoctor
           dry_run single_page: true do
             push_scratch doc
             start_page_number ||= page_number # block will be restarted if first attempt fails
-            theme_font :heading, level: opts[:level] do
+            theme_font :heading, level: hlevel do
               if opts[:part]
                 ink_part_title node, title, opts
               elsif opts[:chapterlike]
@@ -2937,7 +2946,7 @@ module Asciidoctor
           end
           advance_page if orphaned
         else
-          theme_font :heading, level: (hlevel = opts[:level]) do
+          theme_font :heading, level: hlevel do
             if (space_below = ::Numeric === min_height_after ? min_height_after : 0) > 0 && (node.context == :section ? node.blocks? : !node.last_child?)
               space_below += @theme[%(heading_h#{hlevel}_margin_bottom)] || @theme.heading_margin_bottom
             else
@@ -3650,7 +3659,7 @@ module Asciidoctor
             end
             toc_page_nums = nil if toc_page_nums.end == pgnum
           elsif last_chap == :pre
-            chapters_by_page[pgnum] = pgnum < body_start_page_number ? doc.doctitle : (doc.attr 'preface-title', 'Preface')
+            chapters_by_page[pgnum] = pgnum < body_start_page_number ? doc.doctitle : (doc.attr 'preface-title', (doc.attr_unspecified? 'preface-title') ? 'Preface' : '')
             sections_by_page[pgnum] = last_sect
           else
             chapters_by_page[pgnum] = last_chap
@@ -3928,6 +3937,13 @@ module Asciidoctor
         node.sections
       end
 
+      def resolve_toclevels doc
+        if (toc_num_levels = (doc.attr 'toclevels', 2).to_i) < 1
+          toc_num_levels = doc.doctype == 'book' && doc.sections.find {|s| s.sectname == 'part' } ? 0 : 1
+        end
+        toc_num_levels
+      end
+
       # NOTE: num_front_matter_pages not used during a dry run
       def ink_toc doc, num_levels, toc_page_number, start_cursor, num_front_matter_pages = 0
         go_to_page toc_page_number unless (page_number == toc_page_number) || scratch?
@@ -3978,9 +3994,9 @@ module Asciidoctor
         entries.each do |entry|
           next if (num_levels_for_entry = (entry.attr 'toclevels', num_levels).to_i) < (entry_level = entry.level + 1).pred ||
             ((entry.option? 'notitle') && entry == entry.document.last_child && entry.empty?)
+          entry_title = entry.context == :section ? entry.numbered_title : (entry.title? ? entry.title : (entry.xreftext 'basic'))
+          next if entry_title.empty?
           theme_font :toc, level: entry_level do
-            entry_title = entry.context == :section ? entry.numbered_title : (entry.title? ? entry.title : (entry.xreftext 'basic'))
-            next if entry_title.empty?
             entry_title = entry_title.gsub DropAnchorRx, '' if entry_title.include? '<a'
             entry_title = transform_text entry_title, @text_transform if @text_transform
             pgnum_label_placeholder_width = rendered_width_of_string '0' * @toc_max_pagenum_digits
@@ -4936,7 +4952,7 @@ module Asciidoctor
       def derive_anchor_from_id value, default_value = nil
         if value
           value.ascii_only? ? value : %(0x#{::PDF::Core.string_to_hex value})
-        else
+        elsif default_value
           %(__anchor-#{default_value})
         end
       end

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

@@ -26,6 +26,20 @@ class Asciidoctor::Document
 
   # Internal: Returns whether the specified attribute has never been set and is not locked.
   def attr_unspecified? name
-    !((attribute_locked? name) || (@attributes_modified.include? name))
+    if (attribute_locked? name) || (@attributes_modified.include? name)
+      false
+    else
+      @options[:attributes].each_pair.none? do |k, v|
+        if k == name
+          true
+        elsif v == '@'
+          k == %(!#{name}) || k == %(#{name}!)
+        elsif k.end_with? '@'
+          (k = k.chop) == name || k == %(!#{name}) || k == %(#{name}!)
+        else
+          false
+        end
+      end
+    end
   end
 end

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

@@ -2,10 +2,6 @@
 
 Prawn::Font::AFM.instance_variable_set :@hide_m17n_warning, true
 
-require 'prawn/icon'
-
-Prawn::Icon::Compatibility.prepend (Module.new { def warning *_args; end })
-
 module Asciidoctor
   module Prawn
     module Extensions
@@ -322,7 +318,7 @@ module Asciidoctor
         if name
           options = { size: options } if ::Numeric === options
           if IconSets.include? name
-            ::Prawn::Icon::FontData.load self, name
+            icon_font_data name
             options = options.reject {|k| k == :style } if options.key? :style
           end
         end
@@ -404,14 +400,6 @@ module Asciidoctor
         string == PlaceholderChar ? @character_spacing : super
       end
 
-      def icon_font_data family
-        ::Prawn::Icon::FontData.load self, family
-      end
-
-      def resolve_legacy_icon_name name
-        ::Prawn::Icon::Compatibility::SHIMS[%(fa-#{name})]
-      end
-
       def calc_line_metrics line_height, font = self.font, font_size = self.font_size
         line_height_length = line_height * font_size
         leading = line_height_length - font_size
@@ -891,6 +879,8 @@ module Asciidoctor
       # However, due to how page creation works in Prawn, understand that advancing
       # to the next page is necessary to prevent the size & layout of the imported
       # page from affecting a newly created page.
+      #
+      # Returns a Boolean indicating whether the page to import exists and was imported.
       def import_page file, options = {}
         prev_page_layout = page.layout
         prev_page_size = page.size
@@ -912,6 +902,7 @@ module Asciidoctor
             advance_page layout: prev_page_layout, margin: prev_page_margin, size: prev_page_size
             (@bounding_box = prev_bounds).reset_top if ColumnBox === prev_bounds
           end
+          imported = true
         elsif options.fetch :advance_if_missing, true
           delete_current_page
           # NOTE: see previous comment
@@ -920,7 +911,7 @@ module Asciidoctor
         else
           delete_current_page
         end
-        nil
+        imported
       end
 
       # Create a new page for the specified image.

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

@@ -67,7 +67,7 @@ Prawn::Text::Formatted::Box.prepend (Module.new do
     if doc.font.glyph_present? char
       current_font
     elsif fallback_fonts_to_check.empty?
-      if logger.info? && !doc.scratch?
+      if logger.info? && !doc.scratch? && char != ?\u000a
         fonts_checked = [original_font].concat @fallback_fonts
         missing_chars = (doc.instance_variable_defined? :@missing_chars) ?
             (doc.instance_variable_get :@missing_chars) : (doc.instance_variable_set :@missing_chars, {})

data/lib/asciidoctor/pdf/ext/prawn-icon/interface.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Prawn::Icon::Interface
+  def icon_font_data family
+    ::Prawn::Icon::FontData.load self, family
+  end
+
+  def resolve_legacy_icon_name name
+    ::Prawn::Icon::Legacy.mapping[%(fa-#{name})]
+  end
+end

data/lib/asciidoctor/pdf/ext/prawn-icon/legacy.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+class Prawn::Icon::Legacy
+  FontsDir = ::File.absolute_path %(#{__dir__}/../../../../../data/fonts)
+  MappingDataPath = ::File.join FontsDir, 'fa-legacy-mapping.yml'
+  class << self
+    def mapping
+      @mapping ||= YAML.load_file MappingDataPath
+    end
+  end
+end

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

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+require 'prawn/icon'
+Prawn::Icon::Compatibility.prepend (Module.new { def warning *_args; end })
+require_relative 'prawn-icon/legacy'
+require_relative 'prawn-icon/interface'

data/lib/asciidoctor/pdf/ext.rb

@@ -5,5 +5,6 @@ require_relative 'ext/asciidoctor'
 require_relative 'ext/pdf-core'
 require_relative 'ext/prawn'
 require_relative 'ext/prawn-gmagick'
+require_relative 'ext/prawn-icon'
 require_relative 'ext/prawn-svg'
 require_relative 'ext/prawn-table'

data/lib/asciidoctor/pdf/formatted_text.rb

@@ -1,6 +1,9 @@
 # frozen_string_literal: true
 
 require 'treetop'
+module Kernel
+  alias require polyglot_original_require
+end if defined? polyglot_original_require
 require_relative 'formatted_text/parser'
 require_relative 'formatted_text/transform'
 require_relative 'formatted_text/formatter'

data/lib/asciidoctor/pdf/version.rb

@@ -2,6 +2,6 @@
 
 module Asciidoctor
   module PDF
-    VERSION = '2.3.23'
+    VERSION = '2.3.25'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: asciidoctor-pdf
 version: !ruby/object:Gem::Version
-  version: 2.3.23
+  version: 2.3.25
 platform: ruby
 authors:
 - Dan Allen
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-10-26 00:00:00.000000000 Z
+date: 2026-08-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: asciidoctor
@@ -231,6 +231,7 @@ files:
 - data/fonts/ABOUT-notoserif-subset
 - data/fonts/LICENSE-mplus
 - data/fonts/LICENSE-noto
+- data/fonts/fa-legacy-mapping.yml
 - data/fonts/mplus1mn-bold-subset.ttf
 - data/fonts/mplus1mn-bold_italic-subset.ttf
 - data/fonts/mplus1mn-italic-subset.ttf
@@ -273,6 +274,9 @@ files:
 - lib/asciidoctor/pdf/ext/pdf-core.rb
 - lib/asciidoctor/pdf/ext/pdf-core/page.rb
 - lib/asciidoctor/pdf/ext/prawn-gmagick.rb
+- lib/asciidoctor/pdf/ext/prawn-icon.rb
+- lib/asciidoctor/pdf/ext/prawn-icon/interface.rb
+- lib/asciidoctor/pdf/ext/prawn-icon/legacy.rb
 - lib/asciidoctor/pdf/ext/prawn-svg.rb
 - lib/asciidoctor/pdf/ext/prawn-svg/calculators/document_sizing.rb
 - lib/asciidoctor/pdf/ext/prawn-svg/elements/image.rb