v1.5.0 Beta 2

Summary

Continuing with the beta series, this release brings numerous bug fixes and a healthy handful of enhancements. Asciidoctor PDF now has 370 tests in its arsenal to make it resilient against bugs and regressions as changes are made to the code base. While there's always room for more tests, it's the validation we'll need to advance beyond beta.

There were several problems that were addressed (and tested) related to page creation, which can be tricky in Prawn. Thanks to these fixes, background images are now applied to the correct pages. Additionally, aligning a table will no longer mess with the margins of subsequent pages. You may have also noticed that colors containing uppercase characters were being lost, which is no longer the case. Legacy Font Awesome icons are properly mapped so you don't have to change your document despite the previous upgrade to Font Awesome 5. The pdf-themesdir attribute is ignored unless pdf-theme is also set, which will prevent the default theme from being loaded from the wrong location.

The theme gives you more control than ever before. You can specify font properties for custom roles to control formatting of phrases. And the big and small roles are supported out of the box. For keybinding and button elements, you can set a background and/or border too. You can control the character ranges used for conums. If you don't want to include the section number in the chapter and section titles in the running content, you can now set the title-style in the theme to change this behavior.

The fonts have also been updated using the provided script. The bundled monospaced font (M+ 1mn) now includes all Latin, Greek, and Cyrillic characters. And the prose font has been regenerated so that it's easier to patch in the future.

Consult the CHANGELOG for a full list of changes.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

• only apply title page background image to the title page (#1144)
• make sure title page background or color (and only title page background or color) gets applied to title page even when page has already been created (#1144)
• fix crash when image_width is defined in theme (#995)
• fix crash when toc is enabled and toc-title attribute is unset
• correctly map legacy Font Awesome icon names when icon set is not specified (#1157)
• coerce color values in theme that contain uppercase letters (#1149)
• prevent table alignment from modifying margins of subsequent pages; only align table if width is less than bounds (#1170)
• ensure base font color is set
• use more robust mechanism to detect an empty page; tare content stream after adding page background color or image
• ignore pdf-themesdir unless pdf-theme is specified (#1167)
• allow theme to control glyphs used for conums (#133)
• allow theme to control background and border of inline kbd (#313, #1004)
• add support for link on image in running content (#1002)
• allow theme to disable font kerning
• add support for default theme alignment for tables (#1164)
• add theming support to (inline) roles on phrases (#368)
• allow theme to customize style of titles in running content (#1044)
• add support for the built-in big and small roles on phrases (#459)
• route AFM font warning through Asciidoctor logger
• upgrade code font (M+ 1mn) to TESTFLIGHT-63a
• include all alphanumeric characters in code font (mplus1mn) (#282)
• report clearer error message when theme can't be found or loaded
• document how to prepare a TTF font to work best with Asciidoctor PDF (#297)

Release meta

Released on: 2019-07-30
Released by: @mojavelinux
Release beer: Dragon's Milk Reserve Maple by New Holland Brewing Company

Logs: resolved issues | full diff

Credits

A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign who provided critical funding for the development of this release as well as ongoing development of the project.

v1.5.0 Beta.1

Summary

After many years, Asciidoctor PDF is finally ready to exit alpha status. The simple reason? Tests. Asciidoctor PDF now has over 300 tests in its arsenal to make it resilient against bugs and regressions as changes are made to the code base. While there's always room for more tests, this suite gives us plenty of confidence to enter beta.

The transition from alpha to beta also brought a slew of bug fixes, enhancements, and minor improvements. First and foremost, the running header works again (now with tests!). It's possible to size and position cover page images, background images, and images in the running content using the pdfwidth, cover, and position attributes on the image macro. Since the image position can now be controlled, we changed the default to center (vertical and horizontal). SVGs won't go fetching remote images unless the allow-uri-read document attribute is set via the API. There have been quite a number of new knobs and switches added to the theme. And speaking of the theme, we decided to fix the terminology and rename pdf-style and pdf-stylesdir to pdf-theme and pdf-themesdir, respectively (don't worry, though, the old names still work too). And if pdf-theme is a path, and pdf-themesdir is not set, the pdf-themesdir is set automatically. You can now find a custom theme for the chronicles example that you can use as a reference. If you a working with different page layouts in a single document, the running content will now keep up!

Deprecation notices:

• The legacy keys for the running content have been removed. Refer to the theming guide for the current schema.
• The pdf-style and pdf-stylesdir attribute have been renamed to pdf-theme and pdf-themesdir, respectively (though the old names still work too).
• The fallback font has been removed from the default theme (since it really slows down Prawn). Set pdf-theme=default-with-fallback-font to restore previous behavior (or define a fallback font in your own theme).
• The cover images and page background images are now centered by default and resized proportionally to fit the boundaries of the page. Use the pdfwidth (or fit) and position attributes on the image macro to customize this behavior.
• Remote images referenced in an SVG will only be fetched if the allow-uri-read attribute is set via the Asciidoctor API or CLI.
• The text-alignment attribute has been renamed to text-align.

Consult the CHANGELOG for a full list of changes.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

• rename pdf-style and pdf-stylesdir attributes to pdf-theme and pdf-themesdir, respectively (while still honoring the old names for compatibility) (#1127)
• don't load fallback font by default; move fallback font to default-with-fallback-font theme
• apply cell padding to table cells in the head row (#1098)
• allow the theme to control the padding of table cells in the head row using the table_head_cell_padding key (#1098)
• fix position of table caption for reduced-width tables when caption align is center (#1138)
• adjust width of table caption to match width of table unless table_caption_max_width is none in theme (#1138)
• fix position of text in running header (#1087)
• ignore start attribute on ordered list if marker is disabled
• allow start value to be negative for ordered lists that use arabic or roman numbering (#498)
• don't convert values in theme which are not color keys to a string (#1089)
• apply page layout specified on page break even when break falls page boundary (#1091)
• scale SVG background image to fit page in the same way raster image is scaled (#765)
• allow page background size to be controlled using image macro attributes (#1117)
• allow page background image position to be controlled using position attribute on image macro (#1124)
• add support for fit=cover for cover page, page background, and running content images (#1136)
• change default background image position to center (#1124)
• allow cover image position to be controlled using position attribute on image macro (#1134)
• change default cover image position to center (#1134)
• set enable_file_requests_with_root and enable_web_requests options for all SVGs (#683)
• automatically set pdf-stylesdir if pdf-style ends with .yml and pdf-stylesdir is not specified (#1126)
• replace hyphens with underscores in top-level theme keys
• allow hyphens to be used in variable references in theme (#1122)
• allow theme to control background and border of inline code (literal) (#306)
  • NOTE: The border will not work correctly if the phrase has nested formatting
• allow theme to control background and border of inline button (#451)
• resolve null color value in theme to nil (aka not set)
• add support for cgi-style options on source language when syntax highlighting with Rouge (#1102)
• apply custom theme to chronicles example to customize running content and demonstrate how to extend default theme
• drop remapping of legacy running content keys in theme data
• resize running content to fit page layout (#1036)
• exclude border width from running content area (#1109)
• support text-transform property in running content (#702)
• make depth of section titles assigned to section-title attribute in running content configurable (#1141)
• support width attribute on image in running content if no other dimension attribute is specified
• apply correct scale-down logic to image in running content
• allow image format to be specified using format attribute (cover page image, page background image, running content image) (#1132)
• allow theme to set bottom border properties (color, style, and width) of table head row (#770)
• allow column rule and spacing to be specified for running content when multiple columns are specified (#1093)
• never load base theme when loading default theme; otherwise load base theme if extends isn't specified, but only if theme data hasn't been initialized
• shorten text-alignment attribute to text-align
• set PDF version to 1.4 by default (#302)
• allow PDF version to be set using pdf-version document attribute (#302)

Release meta

Released on: 2019-07-08
Released by: @mojavelinux
Release beer: Piggie Smalls Wee Heavy by Resolute Brewing Company

Logs: resolved issues | full diff

Credits

A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign who provided critical funding for the development of this release as well as ongoing development of the project.

v1.5.0 Alpha 18

Summary

With this release, the Asciidoctor PDF test suite has been extended to over 200 tests! This release also restores compatibility with Asciidoctor 1.5 (back to 1.5.3) (and verified by the CI build). The parsing of a bibref and link inside footnotes has been restored. This release brings several small improvements, some of which have been lingering for a long time, such as the ability to extend themes, indent the first line of a paragraph, part numbering. Consult the CHANGELOG for a full list of changes.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

• restore compatibility with Asciidoctor back to 1.5.3 and add verification to test matrix (#1038)
• allow one theme to extend another theme using the top-level extends key (#367)
• allow theme to set text indent for paragraphs using prose_text_indent (#191)
• allow theme to set spacing between adjacent paragraphs using prose_margin_inner (#191)
• show parts in toc when toclevels=0 (#783)
• add support for autonumbered callouts in source blocks (#1076)
• fix duplication of footnotes in keep together regions (#1047)
• display standalone preamble in book normally (#1051)
• allow outline depth to be set using outlinelevels attribute independent of toclevels (#1054)
• fix compounding cell padding (#1053)
• add support for qanda list (#1013)
• fix parsing of bibref and link inside footnote text (#1061)
• restore square brackets around ID of bibliography entry with custom ID (#1065)
• add page_numbering_start_at key to theme to control start page for page numbering (#1041)
• don't allow running_content_start_at key to affect page numbering (#1041)
• substitute {chapter-title} property on front matter pages (replace with doctitle and toc-title, respectively, when running content starts before first page of body) (#1040)
• allow side margins to be set on elements on title page (#824)
• don't promote preamble to preface if preface-title attribute is empty
• expand padding value for running content (header and footer) to array
• add support for unnumbered (and no-bullet) style on ordered list (#1073)
• add visual regression capability to test suite (@beatchristen)
• ensure index section doesn't get numbered when using Asciidoctor < 1.5.7
• add part signifier and part number to part title if partnums is set; allow signifier to be customized using part-signifier attribute (#597)
• add support for the chapter-signifier attribute as the prefered alternative to chapter-label
• warn if the image referenced in the running content cannot be found (#731)

Release meta

Released on: 2019-06-01
Released by: @mojavelinux
Release beer: Elevated IPA by La Cumbre

Logs: resolved issues | full diff

Credits

A very special thanks to all the awesome supporters of the Asciidoctor Salt campaign who provided critical funding for the development of this release as well as ongoing development of the project.

v1.5.0 Alpha 17

With this release, Asciidoctor PDF finally has a test suite (with > 100 tests)! It also follows core in dropping support for Ruby < 2.3. Many users will be happy to know that footnotes will now be rendered as endnotes instead of inline! Users will also enjoy the fact that the document title and TOC now show on the first page of content for non-book doctypes (set title-page to restore old behavior). Font Awesome 5 makes it's first appearance in the Asciidoctor ecosystem with this release. Integration with Asciidoctor Diagram is also be smoother, SVGs render a whole lot better, and there's no longer extra space around SVGs when only the viewBox is specified in the file. Most of the dependencies have been updated as well. Consult the CHANGELOG for a full list of changes.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

• drop support for Ruby < 2.3 (and installation will fail for Ruby < 2.1)
• add asciidoctor/pdf and asciidoctor/pdf/version require aliases (#262)
• rename module to Asciidoctor::PDF and define Asciidoctor::Pdf alias for backwards compatibility (#262)
• switch to tilde dependency versions (flexible patch number) instead of ranges
• upgrade prawn-svg to 0.29.1; resolves numerous SVG rendering issues (#886, #430)
• drop support for Rouge < 2
• add a test suite (#37)
• allow running content (header and footer) to be enabled on title and toc pages; controlled by running_content_start_at property in theme (#606)
• add support for nbsp named entity (i.e., + ); replace occurances of nbsp named entity with a single space in outline
• upgrade to FontAwesome 5; introduce the fas, far, and fab icon sets, now preferred over fa; drop support for octicons (#891) (@jessedoyle)
• place footnotes at end of chapters in books or end of document otherwise (#85) (@bcourtine)
• place toc directly after document title when doctype is not book (#233) (@ogmios-voice)
• add page layout control to page break (#490) (@resort-diaper)
• allow additional style properties to be set per heading level (#176) (@billybooth)
• add support for hexadecimal character references, including in link href (#486)
• force set data-uri attribute on document so Asciidoctor Diagram returns absolute image paths (#1033)
• set line spacing for non-AsciiDoc table cells (#296)
• consider all scripts when looking for leading alpha characters in index (#853)
• don't create title page for article doctype unless title-page attribute is set (#105)
• don't show article title if notitle attribute is set (#998)
• generate name section for manpage doctype automatically (#882)
• remove unprocessed passthroughs in literal cells
• apply font style from theme to formatted text description list term (#854)
• prevent tempfile for remote image from being deleted before it's used (#947)
• handle case when uri to make breakable is empty (#936)
• add support for frame=ends as alternative to frame=topbot on table
• allow table frame and grid to be set globally using the table-frame and table-grid attributes (#822)
• disable table stripes by default (#1049)
• allow table stripes to be enabled globally using table-stripes attribute (#1049)
• use new logging subsystem, if available; otherwise, use shim (#905)
• allow alignment of list text to be controlled using roles (#182)
• allow text alignment to be set for abstract (#893)
• prevent text from overlapping page number in TOC (#839)
• allow ulist marker to be controlled by theme (#798)
• add support for reftext for bibliography entry (#864)
• add support for fw (full-width) icons (#890)
• decouple vw units with alignment (#948)
• add align-to-page option for block images (#948)
• add support for SVG admonition icons (#828) (@keith-packard)
• rename pastie theme for Rouge to asciidoctor_pdf_default
• add bw theme for Rouge (#1018)
• reset top margin of index columns when overflowing to new page (#929)
• add support for line numbers in source listings (#224)
• add U+2060 (word joiner) character to built-in Noto Serif font and fallback font (#877)
• add U+202F (narrow no-break space) character to fallback font (#807)
• ensure callout number ends up on same page as item text (#914)
• guard against pygments returning nil (#884)
• encode quotes in alt text of inline image (#977)
• fix crash when menu macro is used in a section or block title (#934)
• only look for the start attribute on the code block itself when highlighting with rouge
• apply block styling to background for line-oriented tokens in rouge by default
• detect pagenum ranges in index when media is print or prepress (#906)
• ignore style when resolving icon font (#956, #874)
• remove correct width method when overloading Prawn::Text::Formatted::Fragment
• remove ZWSP from alt text of image to prevent fragment from being duplicated (#958)
• avoid call to super in prepended module to fix Ruby 1.9.3
• look for correct file to require in bin script
• upgrade prawn-icon from 1.3.0 to 1.4.0
• upgrade rouge to 2.2.1
• add concurrent-ruby to runtime dependencies for compatiblity w/ Asciidoctor 1.5.8

Release meta

Released on: 2019-04-23
Released by: @mojavelinux
Release beer: KBS by Founders Brewing Company

Logs: resolved issues | full diff

Credits

A very special thanks to all the awesome supporters of the Asciidoctor Salt campaign who provided critical funding for the development of this release as well as ongoing development of the project.

v1.5.0 Alpha 16

This release brings the new custom cross reference text functionality introduced in Asciidoctor 1.5.6 to Asciidoctor PDF. It also upgrades Prawn SVG to the latest version, bringing generic font names, linear gradients, and a fix for dotted borders to SVGs, and upgrades Prawn Templates to 0.1.1. See the changelog for a full set of changes.

IMPORTANT: Make sure to update the prawn-svg gem to 0.27.1 when you update the asciidoctor-pdf gem. Earlier versions of prawn-svg had a sizing regression.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

• add support for xrefstyle attribute (#464)
• allow page side to be based on physical page number and/or be inverted (#813) (@fap-)
• fix layout error caused by nested keep together blocks (#791) (@TobiasHector)
• upgrade prawn-svg to allow generic font names to be mapped in SVG (#777)
• upgrade prawn-svg to fix issue with dotted lines (#741)
• upgrade prawn-svg to enable linear gradients (#228)
• don't attempt to parse text in literal cell (#816)
• warn if theme variable cannot be resolved; don't replace (#801)
• number appendix subsections based on appendix number when doctype is book (#627)
• don't add break hints to URI when using AFM font (#795)
• add rescue check for scratch document when state is not initialized
• allow page margin to be a single number; fixes regression introduced by #749
• check for margin as array, then as numeric, then as string
• extend version range for prawn-templates (#803)
• add missing part-title attribute to theming guide (#827)
• clarify in theming guide that variables are defined in document order
• clarify that the fallback font is only used when the primary font is a TrueType font
• add more information about prawn-gmagick to README
• fix warnings and incompatibility when using Ruby 1.9.3
• document in README how to install Asciidoctor PDF on Ruby 2.0.0
• enable Travis CI; configure CI-based deployment to RubyGems.org

Release meta

Released on: 2017-07-30
Released by: @mojavelinux

Logs: resolved issues | full diff

Credits

Thanks to @fap- for contributing the change to control the folio (recto/verso) placement. Thanks to @mogest for his incredible work on Prawn SVG. Thanks to @TobiasHector for tracking down the root cause of layout problems with nested keep together blocks.

A very special thanks to all the awesome supporters of the Asciidoctor Salt campaign who provided critical funding for the development of this release as well as ongoing development of the project.

v1.5.0 Alpha 15

This release fixes compatibility with Prawn 2.2.0. It also fixes several font width calculation bugs that were leading to Prawn::CannotFit errors when using custom fonts. The release includes numerous minor but important enhancements as well.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

• fix compatibility with Prawn 2.2.0 (#775)
• add workaround for TTFunk bug when font table has empty data (#619, #651)
• take fallback font into account when calculating width of string (#651)
• fill and stroke bounds of sidebar across all pages (#259) (@TobiasHector)
• allow page margin to be set using pdf-page-margin attribute (#749)
• implement none, no-bullet and unstyled unordered list styles
• add dots to all levels in TOC if toc_dot_leader_levels is all
• use bold style for description list term by default (#776)
• always escape index term text (#761)
• don't crash if color value on text span is invalid
• implement start line number for source listing (Rouge) (#752)
• enable "start inline" option when highlighting PHP (#755)
• persuade CodeRay to handle html+ source languages
• introduce stripes attribute to table to control zebra-striping (#724)
• allow theme to set style of table border and grid (#766)
• allow theme to set text transform on header cell in table body (#750)
• set top border width of first body row to match bottom border width of header row
• don't add TOC if empty (#747)
• optimize code that generates outline level
• don't recalculate header_cell_data for each row
• use slightly more efficient way to find Pygments lexer
• upgrade rouge to 2.0.7
• upgrade prawn-templates to 0.0.5
• revise information in theming guide pertaining to custom fonts
• document in README how to get full support for CJK languages
• document in theming guide that Asciidoctor PDF subsets font when embedding
• document that background images are scaled to fit bounds of page
• add note in theming guide about using double quoted strings

Release meta

Released on: 2017-03-27
Released by: @mojavelinux

Logs: resolved issues | full diff

Credits

A huge shout out to @TobiasHector for making sense of the code and helping to get #259 resolved. Thanks to @thjanssen for helping me find bugs and areas to improve in Asciidoctor PDF while working on his new Hibernate Tips Book. Also thanks to @akrabat and @lucascosti for helping with the design for the PHP start inline. Thanks to everyone who helped with this release by submitting issues, giving feedback, testing, and coding!

A very special thanks to all the awesome supporters of the Asciidoctor Salt campaign who provided critical funding for the development of this release as well as ongoing development of the project.

v1.5.0 Alpha 14

This was another minor release turned major, with 68 issues resolved officially as well as many other fixes that got squeezed in (214 commit in all). The big news for this release is that AsciiDoc-style table cells and nested tables are finally supported! You should no longer see unconverted table cell content in the output document. If you use index terms, Asciidoctor PDF now adds a catalog of terms to the index section at the end of the document. Image handling has improved massively, now with better sizing, less errors, and support for endless file formats via integration with prawn-gmagick. Highlighted source code blocks are going to look much better now that the background color from the theme is honored (Rouge and Pygments). If you have LaTeX-based STEM equations in your document, they're now rendered thanks to integration with Asciidoctor Mathematical. When converted to SVG, equations look very sharp thanks to integration with prawn-svg. Expect more accurate rendering of SVGs in general thanks to an upgrade to that library. If you're creating your own theme, you'll be happy to discover that the theming guide now lists all available keys and has better documentation in certain areas.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

• add support for AsciiDoc table cells (including nested tables) (#6)
• make header cell in body inherit styles from table head (#239)
• don't crash if table is empty and cols are explicitly set (#610)
• fix vertical centering for cells in table head row
• implement converter for index (#386)
• record page number for index term when writing anchor (#639)
• support the underline and line-through roles on phrases (#339)
• allow printed URI to break at break opportunities (#563)
• don't drop subsequent images after inline image fails to load
• don't crash if inline image is an unsupported format; issue warning instead (#587)
• show alt text when image fails to embed (#693)
• always show block image caption even if image fails to embed
• delegate to method to handle missing image
• permit use of GIF image format if prawn-gmagick is available (#573)
• add support for image macros that have a data URI target (#318)
• don't crash if format of image in running content is unrecognized
• only fit image within bounds of running content if contain option is set
• document fit attribute for image in running content
• fix alignment for SVG image in running content
• keep block image with caption (#690)
• place destination for block image on same page as image
• set color space when block image occurs on page by itself (#688)
• resize SVG to fit page (#691)
• disable system font scan in Prawn SVG
• use character spacing to fine-tune width of placeholder for inline image (#686)
• fix duplicate inline image rendering (@fap-) (#388)
• constrain inline image to width of bounds
• add support for pdfwidth to inline images (@fap-) (#620)
• honor pdfwidth attribute for image in running content (#625)
• add support for absolute measurement units to scaledwidth attribute (#674)
• resize inline SVG without an explicit width (#684)
• resize inline image to fit within content height (#700)
• calculate height of inline image correctly in table cell (#295)
• fix bug in calculation when image overflows page (#708)
• simplify calculation of rendered width and height of images
• add square brackets around alt text for inline image
• don't surround alt text of block image with non-breaking spaces
• specify width & height when embedding (inline) raster image to avoid recalc
• resize title logo image to keep on page (#714)
• don't leave blank page when importing PDF page (#614)
• fix running content dimensions (#616)
• introduce document attribute to control default text alignment (#396)
• allow setting a default columns spec for running content on both recto and verso pages; set if not defined
• show example of center column alignment in default theme
• map dynamic section-title attribute in running content to current section if page has no section (#709)
• assign dynamic part-title attribute for use in running content (#596)
• don't set dynamic chapter-title attribute in running content for preface unless doctype is book
• assign page number label to each page (#641)
• don't set dynamic page-number attribute in running content of pagenums is disabled
• allow toc title properties to be controlled by theme (#701)
• use correct number of dots when font style is applied to toc level (#621)
• allow theme to control which toc levels have dot leaders; default to 2-3 (#631)
• set font color of page number for parts in toc
• don't crash when toc dot leader is empty string
• list preface with title in table of contents (#732)
• allow theme to apply text decoration to link text (#567)
• allow page layout to be controlled from document (#565)
• don't crash if image in running content fails to embed (#728)
• treat abstract section as abstract block (#703)
• set example block background to white by default
• add support for background colors when highlighting code with Rouge
• add support underline style for token in Rouge theme (#665)
• drop background colors on strings in rouge pastie theme
• add support for image-based icons (#479) (@JBR69)
• preliminary support for vertical alignment of admonition icon/label
• allow side padding on admonition label to be controlled separately from admonition content
• add more control over vertical rule in admonition block (#601)
• allow theme to control font properties for admonition content (#592)
• only add lead role to first paragraph of preamble (#654)
• display poster image for video with link to video URI (#287)
• add link to audio file (#475)
• don't drop anchor within text that overruns page (#638)
• display title for abstract (#582)
• display title for open block (#577)
• display block title on quote and verse blocks (#416)
• don't draw border for quote/verse block on empty page or if border width is 0
• allow delimiter between author names on title page to be configured in theme
• coerce resolved value of content key in theme to String (#653)
• honor background color from Pygments theme
• set default inner/outer margins in base theme
• document missing glyph encoding warning in theming guide; minor rewording
• document how to configure fonts in SVG images (#739)
• document how to use Asciidoctor Mathematical to enable STEM support (#45)
• transform text containing multibyte characters (#363)
• document in theming guide how to transform unicode letters with Ruby < 2.4
• show unmodified text if text_transform is none (#584)
• make performance optimization to formatted text transform
• use reference_bounds instead of @margin_box to move past bottom
• handle negative bottom padding properly at page boundary
• use value of docdatetime & localdatetime attributes in PDF info (#590)
• use truncate_to_precision instead of round to truncate floats; map to native method in Ruby >= 2.4
• upgrade prawn-svg dependency to 0.26.x
• upgrade prawn-icon to 1.3.0
• document in the README how to use the autofit option on verbatim blocks
• clarify in README how inline image are sized
• clarify instructions in README about how to specify a page number range for printing
• document in theming guide how to define and apply a custom Rouge theme
• rename pdfmarks to pdfmarks; document pdfmark attribute in theming guide
• describe the quoted string value type in the theming guide
• add self-referencing anchor to each key prefix in theming guide
• document nonfacing option for sections (@jnerlich)
• fix documentation for toc_dot_leader_font_color in theming guide (@DavidGamba)
• document that dot leader inherits font properties from toc category
• fill in missing defaults for keys in theming guide
• rewrite intro to Keys section in theming guide
• add keys for prose, menu, and conum categories to theming guide
• document outline_list_marker_font_color key in theming guide
• refactor measurement value helpers into module (#677)
• add inline ref and corresponding xref to chronicles example
• fix Ruby warnings
• update instructions and Gemfile config to use with Ruby 1.9.3

Release meta

Released on: 2017-02-06
Released by: @mojavelinux

Logs: resolved issues | full diff

Credits

Thanks to @vogella for helping to identify important areas of improvement and to @fap- for contributing design and code changes to improve those areas. Thanks again to @mraible for collecting additional requirements for print publishing. Thanks to @JBR69 for adding image icon support to admonition blocks and pushing the styling of admonitions blocks forward. Thanks to @jnerlich and @DavidGamba for contributing documentation improvements. Finally, thanks to everyone else who submitted invaluable bug reports that led to the improvements in this release.

A very special thanks to all the awesome supporters of the Asciidoctor Salt campaign who provided critical funding for the development of this release as well as ongoing development of the project.

v1.5.0 Alpha 13

This release marks another important step forward. It adds features for print publishing, theme enhancements, bug fixes, better table compliance, documentation, and component upgrades.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

• Add support for mirror (recto/verso) margins and facing pages when media=prepress (#383)
• Add non-breaking hyphen glyph to built-in fonts so its intended behavior is honored (#462)
• Add page break before a book part (#329)
• Allow running (header/footer) content to be arranged in columns (#449)
• 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)
• 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)
• Allow image type to be specified explicitly using format attribute on image macro (#540)
• Add support for literal and verse table cell styles
• Preserve indentation in literal and verse table cells
• Preserve paragraph breaks in normal table cells
• Honor value of width attribute even when autowidth option is set on table (#519)
• Align table title to left edge of table, regardless of table alignment (#469)
• Add support for reversed option on ordered list (#491)
• Don't drop whitespace in front of conum on final line of source block (#470)
• Add more control over position of elements on title page, including support for vw units (#418)
• Allow table caption position/side to be controlled by theme (#531)
• Use base_align setting from theme as default alignment for headings
• Resolve bare image-related attribute values relative to base_dir
• Only allow Prawn SVG to fetch remote images if the allow-uri-read attribute is set (#548)
• Introduce page_margin_inner and page_margin_outer keys to theme
• Start title page, toc, main content, parts, and chapters on recto page when media=prepress and doctype=book
• Allow default font style for table to be set via theme (table_font_style)
• Use correct default bullet per nested unordered list level (#529)
• Call start_new_part at start of each book part
• Delegate to layout_part_title method to layout part title
• Don't match a special section as a chapter unless the doctype is book
• Fix list marker placement when list item touches bottom of page
• Eliminate excessive spacing between list items that contain nested lists
• Drop lines in running (header/footer) content with unresolved attributes (#522)
• Ensure start_new_chapter is always executed at a chapter transition (#524)
• Add support for root xref (e.g., <<included-doc>>) (#521)
• Prevent block from spilling to next page if there's no more content (#361)
• Add support for px units to pdf-page-size attribute
• Fix parsing error when value of pdf-page-size attribute is unitless
• Don't crash if table is empty (#480)
• Don't crash when deleting last remaining page; don't delete last page if empty (#317)
• Don't orphan space between conums when extracting from verbatim block (#506)
• Properly scope attr and attr? lookups
• Rename internal page_start and page_end attributes to pdf-page-start and pdf-page-end, respectively
• Fix settings for table header cell
• Fix padding around content of quote block in default theme
• Read theme file with UTF-8 encoding (#533)
• Allow temporary image file to be deleted on Windows (#425)
• Don't crash if theme file is empty (#551)
• Don't crash if cover image can't be read; warn instead
• Clarify in theming guide how to write numbers with 3 or more digits (#555)
• Document how inline images are sized
• Document how to disable default footer from theme
• Update explanation of WINANSI encoding behavior in theming guide
• Restore support for Ruby 1.9.3 (#528)
• Upgrade prawn-icon to 1.2.0 (which upgrades Font Awesome to 4.6.3)
• Upgrade prawn-svg to 0.25.2 (by way of more lenient version range)
• Fix Ruby warnings
• Document in README how image paths are resolved
• Configure README for better preview on GitHub
• Update chronicles example to modern AsciiDoc syntax; update content

Release meta

Released on: 2016-09-19
Released by: @mojavelinux

Logs: resolved issues | full diff

Credits

A big shout out to @meisterluk for doing excellent QA and providing several patches. And another to @Fale for packaging Asciidoctor PDF for Fedora! Also thanks to @vogella for helping to identify important areas of improvement. And thanks to @mraible and InfoQ for collecting requirements for print publishing. Finally, thanks to everyone else who submitted invaluable bug reports that led to the improvements in this release.

A very special thanks to all the awesome supporters of the Asciidoctor Salt campaign who provided critical funding for the development of this release as well as ongoing development of the project.

v1.5.0 Alpha 12

This was another minor release that focused on bug fixes, substantial improvements to the documentation, and smarter behavior in the theming system.

Distribution

• RubyGem (asciidoctor-pdf)
• Fedora RPM (rubygem-asciidoctor-pdf)

Changelog

• Fix incompatibility with Rouge 2 source highlighter (#471)
• Declare rouge gem in Gemfile for use with examples
• Add option to make URLs visible in printed PDF using show-link-uri or media=print attributes (#435, #463)
• Document options for scaling an image (#453)
• Add support for images to span width of page (#424)
• Fix embedding of remote images; fix case when imagesdir is a URI (#467)
• Collapse non-significant whitespace (#465)
• Document how to inherit font size for a given heading level (#460)
• Decode character references in link URIs (#448)
• Use arrow as caret for menu path instead of pipe (#441)
• Document theme-related AsciiDoc attributes in theming guide (#428)
• Section title alignment should be customizable via theme (#343)
• Collapse all whitespace when normalizing (#355)
• Require space on either side of math operator to avoid interpretting dates as math equations (#429)
• Allow specifying a font style for a title on the title page (#423)
• Fix Prawn SVG to support arrow heads on lines (#75)
• Upgrade prawn-svg to 0.25.1
• Upgrade prawn-icon to 1.1.0
• Fix rendering of two images in header or footer (#421)
• Allow table grid color and width to be controlled by theme (@ntfc)
• Fix undefined local variable or method `dest_y' when adding auto-generated anchor to section (#419)
• SVG files that include image elements are not rendered correctly improvement (@AlexanderZobkov) (#414)
• Fix Prawn SVG to support currentColor keyword (#407)
• Parser should recognize up to 6 digit character references (#404)
• Properly convert a negative measurement value in theme
• Coerce percentage value to float instead of integer in theme
• Set minimum required Ruby version to 1.9.3 instead of 1.9
• Use title capitalization for section titles in theming guide
• Update and reorganize keys in theming guide; document numerous keys previous missing
• Add hints to theming guide about how to apply styles when using Maven or Gradle (@fwilhe)
• Fix gemspec to collect files when project is not a git repository or git is not available

Release meta

Released on: 2016-08-05
Released by: @mojavelinux

Credits

Congratulations to @AlexanderZobkov, @ntfc, and @fwilhe for being first-time contributors to Asciidoctor PDF. Thanks to everyone else who submitted invaluable bug reports that led to the improvements in this release.

A very special thanks to all the awesome supporters of the Asciidoctor Salt campaign who provided critical funding for the development of this release as well as ongoing development of the project.

v1.5.0 Alpha 11

This was another minor release that focused on bug fixes, documentation and small improvements to the theming system.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

• control font style of first line of abstract from theme (@nawroth) (#378)
• Add option to control reproducible builds (@bk2204) (#338)
• set default page size to A4 (@stephenhay) (#319)
• preprocess all hex color values (#381)
• add note about preprocessing hex color values to theming guide
• apply base font style (#373)
• don't fail to delete tmp file (#369)
• lazy load icon fonts if detected (#364)
• reduce heading line height in default theme (#351)
• set default (fallback) SVG font from theme (#210)
• expand last column to fit width of table (#372)
• don't cache resolved imagesdir attribute value
• use fallback when merging icon data
• defer to built-in caching in prawn-icon
• document replacements and numeric character refs in header/footer content
• document base_font_size_min setting
• document that page background colors & images do not currently work in AsciidoctorJ PDF
• use failproof relative require logic in bin script

Release meta

Released on: 2016-01-05
Released by: @mojavelinux

Credits

Congratulations to @nawroth, @stephenhay and @bk2204 for being first-time contributors to Asciidoctor PDF.

A very special thanks to all the awesome supporters of the Asciidoctor Salt campaign who provided critical funding for the development of this release as well as ongoing development of the project.