v1.0.0-alpha.4

Summary

Release meta

Released on: 2019-11-17
Released by: @Mogztter
Published by: @Mogztter

Logs: full diff

Changelog

Breaking changes

• stylesheet attribute now replaces the default stylesheet. If you still want to extend the default stylesheet, you can do:

-:stylesheet: custom.css
+:stylesheet: asciidoctor-pdf/css/asciidoctor.css;asciidoctor-pdf/css/document.css;asciidoctor-pdf/css/features/title-document-numbering.css;custom.css

Bug Fixes

• Use a class to force a page break
• Use link element and replace default stylesheet
• Upgrade @asciidoctor/cli to v3.0.2
  • doctype defined in the document was ignored
• Ensure rendering is complete before creating PDF
• Remove workaround for text blocks split by a page break
• Replace deprecated and experimental syntax in the default CSS

Improvements

• Preview mode using --preview option
• Table Of Contents
• PDF outline
• PDF metadata (title, authors, subject, keywords, lang, etc...)
• SVG icons with Font Awesome 5
• STEM support with MathJax 3
• Capture console output and display a helpful message when the page throws an exception
• Resolve stylesheets from node_modules and local folders
• Allow to specify multiple stylesheets (separated by ;)
• Add language support in the default HTML template

Documentation

• Improve the README
  • Add alternative install options
  • Add an examples section
  • Explain how to create a custom layout

Credits

Thanks to the following people who contributed to this release:

@Ablu @ahus1 @oncletom @rdmueller @lurch