v1.5.0 Alpha 10

This was a fairly minor release. We released it primarily to align with AsciidoctorJ so it can be part of the AsciidoctorJ 1.5.3 release.

Highlights

You can now customize the admonition icons (name, stroke color and size) in your theme file:

admonition:
  icon:
    caution:
      name: fa-fire
      stroke_color: ff0000
      size: 24

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

• admonition icon can be customized by theme (#121) (@jessedoyle)
• update to prawn-icon 1.0.0 (#335) (@jessedoyle)
• only generate the pdfmarks file if the pdfmarks attribute is set
• honor table alignment (via align attribute or role) (#299)
• use map for ViewerPreferences; set initial magnification (#303)
• handle case when colpcwidth is unspecified (#314)
• show title for lists (olist, ulist, dlist) (#316)
• don't attempt to add running content if document has no content pages
• correctly calculate toc page range (#322)
• don't insert blank page after back cover (#328)
• document key in theme to set sidebar padding (#344)
• handle case when CodeRay passes nil text to text_token

Credits

Thanks to @jessedoyle for allowing the admonition icons to be customized and for his great work on prawn-icon. Thanks to @mraible and @rlopez133 for providing valuable QA feedback and to @anandchida for contributing to the documentation. Finally, thanks to everyone who reported issues that were fixed in this release.

v1.5.0 Alpha 9

IMPORTANT: If you've created a custom theme that uses the built-in fonts, you must update your font catalog as follows:

font:
  catalog:
    Noto Serif:
      normal: notoserif-regular-subset.ttf
      bold: notoserif-bold-subset.ttf
      italic: notoserif-italic-subset.ttf
      bold_italic: notoserif-bold_italic-subset.ttf
    M+ 1mn:
      normal: mplus1mn-regular-ascii-conums.ttf
      bold: mplus1mn-bold-ascii.ttf
      italic: mplus1mn-italic-ascii.ttf
      bold_italic: mplus1mn-bold_italic-ascii.ttf
    M+ 1p Fallback:
      normal: mplus1p-regular-fallback.ttf
      bold: mplus1p-regular-fallback.ttf
      italic: mplus1p-regular-fallback.ttf
      bold_italic: mplus1p-regular-fallback.ttf
  fallbacks:
    - M+ 1p Fallback

There have been several other changes to the theme keys, so verify your theme settings.

• apply point conversion to image widths (#221)
• restore missing glyphs in Noto Serif font; adds support for Cyrillic languages (#72, #99)
• add support for the Rouge source highlighter (#247)
• fix parsing of style attribute in inline markup when it contains spaces; fixes Pygments highlighting
• expand tabs to spaces in source document (#236)
• scale down SVG if width is wider than page (#242)
• load a base theme with defaults for required keys (#132)
• enable PDF page import using block image macro (#177)
• restore method in PDF::Core needed to import PDF page (#237)
• restore text rendering mode after PDF import (#251)
• support writing to STDOUT and other IO objects (#254)
• enable pagenums by default; allow noheader & nofooter to control running header/footer (#205)
• implement explicit table width, including autowidth (#258)
• handle conversion to windows-1252 more gracefully when using built-in (AFM) fonts (#290)
• disable warning if using a built-in (AFM) font
• remove use of "rhythm" theme keys from converter (#289)
• allow font_style to be set on literal text (#291)
• parse inline image macro value of page_background_image (#222)
• allow theme to control header cells in table body (#272)
• make line height in running header/footer configurable (#274)
• normalize text content in running header/footer (#266)
• modify vertical alignment setting for running header/footer (#264)
• use table background color, even if white; upgrade to Prawn Table 0.2.2 (#214)
• delete trailing content page if empty (#147)
• fix dry run calculation of block height...again (#215)
• move footnotes to inline in a lighter shade
• fix for JRuby 1.7 running in 2.0 mode
• upgrade Prawn SVG to 0.21.0; fixes most badge SVGs
• upgrade thread_safe gem
• prevent crash if doc has no sections (@abatalev)

Thanks again to @rlopez133 for performing critical QA for this release. Also a big thanks to @graphitefriction for providing project management support for this release. Finally, thanks to everyone who reported issues that were fixed in this release.

v1.5.0 Alpha 8

• Support inline images (#9)
• Support link attribute on inline images (#209)
• Support inline icon macro (#97)
• Allow fine-grained control over image width (#76)
  • Size conversion not yet applied to images on title page or in running header/footer
• Enable checklists (#181)
• Fix block height calculation when content is indented by propagating bounds to scratch document (#215)
• Don't insert page break before content whose height exceeds a single page (#183)
• Dash border of literal/listing block at page boundary when broken across pages (#190)
• Don't crash if toc entry is too long (#200)
• Add missing methods on OpenStruct to fix Rubinius compatibility (#81)
• Autofit font size in listing & literal blocks if autofit option is specified (#185)
• Support border style (e.g., double, dashed, dotted) (#196)
• Allow font color of outline list marker to be set by theme (#170)
• Allow use of hyphen in property names in the theme (#193)
• Only include table of contents if toc attribute is defined in header (#187)
• Improve parsing of pdf-page-size attribute
• Handle case in colist converter when previous block isn't found (#173)
• Print Asciidoctor PDF version in CLI output
• Upgrade Prawn (< 3.0.0, >= 1.3.0) (#68)
• Upgrade Prawn SVG to 0.20.0
• Document gem installation in README (#112)
• Perform code cleanups (#195)
• Silence warning about toc block macro
• Add -example suffix to example file names
• Use CodeRay as syntax highlighter in examples (#207)
• Use proper font names in default them to support custom fonts in SVGs
• Rework parser to parse void elements
• Apply first line formatting correctly (no dropped words)
• Add support for text-center role on paragraphs
• Update theming guide
• Fix cross references in README

A big thanks to @rlopez133 for providing critical QA feedback during this development iteration.

v1.5.0 Alpha 7

• add support for font-based icons (Jesse Doyle) (#15)
• enable font fallback support (Rei)
• add option to specify the background color for even table rows (Tord Heimdal) (#104)
• add block title for paragraphs (David Gamba) (#67)
• allow custom page size setting (Otavio Salvador) (#84)
• fix xref to sections (#56)
• fix xrefs to non-section content (#110)
• allow theme to control layout of title page (#135)
• allow theme to control style of table of contents (#167)
• allow running header & footer content to be customized (#89)
• tighten spacing between list items, make value configurable (#92)
• support CMYK color values (#155)
• add support for measurement values in theme (#156)
• name per-level heading theme keys consistently (e.g., heading_h<n>_font_size) (#157)
• preprocess theme data to allow # in front of hex colors (#158)
• support linkable images (#51)
• render table footer row (#123)
• don't crash if sectids attribute is disabled (#70)
• support text transform in theme (uppercase / lowercase) (#138)
• keep together shouldn't create blank pages (#150)
• properly resolve image target as system path (#87)
• show warning when image cannot be read (#148)
• allow page background image to be specified (#134)
• support PDF format as cover page (#113)
• accomodate numbered list with large numbers (#91)
• position list marker correctly (#140)
• allow theme to set font size & family of table cells (#139)
• unencode character entities in document title (#136)
• process callouts in listing & literal blocks (#31)
• use :center to vertically align table cell (#118)
• normalize endlines in table cell text (#116)
• support setting page size via attribute (#65)
• remove unused fonts; update version of NotoSerif font license file
• remove Asciidoctor theme until we're ready to fully implement
• restore source highlighting when nested inside block
• allow keys in theme to be nested to an arbitrary depth
• assign width to border for blockquote if not specified in theme
• support single value for font_fallbacks key in theme
• add support for font family and style per heading level
• implement basic converter for inline_indexterm
• coerce negative values in theme if they slip through
• use preserve_indentation in layout_prose
• support remote images
• add warning about unsupported gif format
• abort cli if option parsing returns exit code
• use SafeYAML to load theme files
• handle transparent value for table background colors
• reenable M+ 1p as the fallback font

A special thanks to @tomitribe for sponsoring the development of this release.

v1.5.0 Alpha 6

• add pdf-fontsdir attributes to redefine fonts directory (andrey)
• use require_relative for ../lib/asciidoctor-pdf in bin/asciidoctor-pdf (Ryan Bigg)
• add example for specifying theme file (Leif Gruenwoldt)
• add thread_safe gem to remove warning when registering converter

v1.5.0 Alpha 5

• allow chapter label to be controlled using chapter-label attribute
• prevent toc from overflowing content
• fix page numbering for various permutations of front matter
• don't activate implicit header include processor by default
• draw box around listings and literal blocks than span more than one page

v1.5.0 Alpha 4

• fix yield statement so Asciidoctor PDF can be used with JRuby

v1.5.0 Alpha 3

• remove unnecessary dependencies (tilt, slim, thread_safe)

v1.5.0 Alpha 2

• add magic encoding header to source file so Asciidoctor PDF can be used with Ruby 1.9.3.

v1.5.0 Alpha 1

First pre-release of Asciidoctor PDF.