Skip to content

bard v2.0.1

Latest
Latest
Compare
Choose a tag to compare
@github-actions github-actions released this 01 Jul 20:58
· 4 commits to main since this release
v2.0.1
9363eca

This is a new major version release of bard. This release also comes with new documentation – a book.

Breaking Changes

In bard 2.0, the PDF output via TeX has been overhauled.
The tex output has been replaced with a pdf output and there is no longer a process field.
Instead, bard auto-detects installed TeX and runs the appropriate rendering command. There are a few new options to (optionally) configure TeX lookup.

Along with this, the bard.toml project file format changed and is now also versioned..

See the Migration Guide and TeX Configuration.

Other breaking changes:

  • Paths in project settings now must be relative only.
  • The hovorka format now needs to be specified explicitly.
  • Alternative HTML file extensions (.htm, .xhtml, .xht) are no longer auto-detected, .html is the recommended one.
  • book.backmatter setting is removed.

Additionally, the MSRV is now increased to Rust 1.64.0.

New Features

  • New TeX invocation system, as mentioned above.
  • TeX/PDF template improved significantly.
  • Tectonic embedding - an optional feature.
  • MS Windows is now a fully supported platform.
  • Baseline chords added.
  • Improved fonts support.
    • Bard now brings fonts it uses along.
    • Font size and sans vs. serif can now be configured more easily.
  • Integrated ToC sorting, now also supported in HTML output.
  • Improved images support.
    • Image scaling setting for HTML output added.
    • Image sizes are now preloaded and available to templates in book AST.
    • Images are now part of bard watch watched paths.
  • Markdown smart punctuation option, enabled by default.
  • Syntax extensions via "HTML".
  • Scripts support – a way to post-process results in arbitrary ways. This is a replacement for the previous process field.
  • Syntax to turn off alt chords (!!none).
  • XML output (experimental).
  • New prebuilt packages/binaries provided:
    • Windows binaries with and without Tectonic.
    • Deb and RPM packages with statically built binary (without Tectonic).

Bugfixes & Misc

  • NB. v2.0.1 fixes a font option bug in PDF template that was overlooked in v2.0.0
  • Fixed SIGINT/interrupt handling.
  • Fixed a few parsing errors.
  • Fixed templates syntax compliance with reference implementation.
  • Fixes in the HTML template.
  • A few Handlebars helpers added.
  • Dependencies upgrades.
  • Testing improvements.
Assets 7