v2.3.0

This minor release brings forth a new feature: bibliographic citations. It also fixes a couple of issues.

New feature

• Basic support for bibliographic citations (#135, #10)

  The Djot language does not officially support bibliographic citations yet, but we have modified the parser to allow for a basic form of citations.

  We have enabled citations too in the Markdown package, following the same syntax as in Djot.

  The supported syntax is a subset of the Pandoc citation syntax:

  • [@key] in the simplest form
  • [@key, page 123] to specify a "locator" (e.g. page, chapter, etc.)
    • The comma between the key and the locator is optional (e.g. [@key page 123] is also valid)
    • Only one locator per citation is supported.
    • The locator must be one of the supported locators in SILE's BibTeX module with CSL support enabled.
    • Some abbreviations are supported by SILE for locators, and here we accept an optional period after it (e.g. [@key, chap. 5] is also valid for full [@key, chapter 5]).
  • Be aware that multiple citations can be separated by semicolons (e.g. [@key1; @key2 page 123]), but due to the limitations of the current implementation in SILE, the output will not be as expected

  How to load bibliographies and configure citation styles is beyond the scope of this module. If you are using the resilient collection of classes and packages, the most natural way to do this is a "master document" (support planned in resilient v2.6.0).

  Also note the CSL (Citation Style Language) support in SILE is a very recent and experimental feature (introduced in SILE 0.15.7), so it may not work as expected in all cases.

Fixes

• Fix broken embedders detection for rendered code blocks (#128, #127)

• Always wrap tables in a captioned-table and let the latter handle a caption if present (#134)

  The captioned-table environment from resilient.book and the fallback environment for other classes always supported tables without caption. It's thus better to always wrap tables into it, so styling (in resilient's use case) is applied, rather than return a raw table, which would not be styled.

Other notes

The User Guide has been updated to reflect these changes.
Many thanks to @kianmeng for the typo fixes in the documentation and in-code comments (#132).
The new version of the User Guide will be available soon, after resilient.sile gets its own update.