SILE v0.15.10 Is Released

21 Mar 2025 — Caleb Maclennan

Version v0.15.10 of SILE has been released and is available for download! See the included CHANGELOG.md or review the commit history for more explicit details.

Summary of Improvements

This release brings yet another layer of improvements contributed by Didier Willis, especially to the bibliography and indexing features. The bibliography system now uses CSL (Citation Style Language) by default, with enhanced support for grouped citations via \cites, better name formatting, and improved style compliance. The indexer received significant upgrades including page range collapsing, customizable styling hooks, flexible placement in documents, and language-aware sorting. Font handling saw improvements with new ex-height and cap-height adjustments, particularly benefiting code and verbatim text display.

The CLI also gained a new argument to streamline the process of loading 3rd party modules. SILE has always found packages in specific system or relative locations easily, but setting the path to custom LuaRocks trees was not trivial. A new --luarocks-tree argument should make it much simpler to match however you install with .

Other notable changes include avoiding hyphenation prior to page breaks, and fixes for various language-specific issues including Uyghur hyphenation and UTF-16 handling. Warning messages involving unsupported languages should also make more sense and not spam the terminal over and over.

New Features

  • build: Add tooling to generate tarball of vendored crates (55be5cd)
  • cli: Add argument to ease soarch for 3rd party module(s) (4f0d5a4)
  • core: Support ex-height and cap-height font adjustment (4e16acf)
  • packages: Add \cites to output grouped bibliographic citations (bdba2ea)
  • packages: Add \nocite for marking a bibliography entry as cited (f828e9b)
  • packages: Add indexer options minimal/minimal-two for page range collapsing (e272e43)
  • packages: Add new styling hooks to the indexer (facf84c)
  • packages: Add option for filler between item and page in indexer (691bfe2)
  • packages: Allow indexes to be used anywhere in a document (808aaf4)
  • packages: Honor bibliography style indentation rules (c08fcaa)
  • packages: Partial support for name-parts formatting (18c436e)
  • packages: Support links to pages in the indexer (5953e59)
  • packages: Support page ranges in indexer (a84d4ef)
  • packages: Use the CSL implementation by default for bibliographies (d3c352b)
  • shapers: Warn when asked to measure a character not shaped in a font (e0b5cd8)
  • typesetters: Add content to text utility to the base typesetter (6af4934)
  • typesetters: Discourage page breaks after hyphenated lines (ba49c8c)

Bug Fixes

  • classes,packages: Use ex-height font adjustment for code (5b52afc)

  • font: Properly cache fonts before use so a hook could look at them (7e24648)

  • languages: Account for possible null termination in UTF-16 → 8 conversion (#2243) (e42b8de)

  • languages: Fix Uyghur hyphenation (2bff142)

  • languages: Move language setting declaration to after language supporte exists (447df41)

  • languages: Update tests for changed ICU defaults (bf6e0bc)

  • math: Script 'math' is needed for the ssty feature to work properly (cb64f9e)

  • packages: Always use fake superscripts in bibliography for consistency (97453b1)

  • packages: Apply default locale on locale overrides without xml:lang (cd70266)

  • packages: Automatically register the indexer on endpage class hook (d697388)

  • packages: Correct error handling the locator on some CSL styles (21b751e)

  • packages: Correct invalid links on CSL DOI, PMID, PMCID with affixes (d8386ab)

  • packages: CSL choose must inherit delimiter from nearest ancestor (64eaba4)

  • packages: Honor affixes on multiple CSL citations correctly (5de5607)

  • packages: Option "plural" on bibliography terms can be false (4d4bae5)

  • packages: Suppress empty CSL macros (98a7ebe)

  • packages: Use ex-height font adjustment for verbatim (dae3849)

  • packages: Use language-dependent sorting (collation) in indexer (5db2dcd)

  • shapers: Properly calculate metrics of single characters composed of many glyphs (2b109a0)

  • typesetters: Special punctuation spaces need better italic correction (448ab15)

SILE v0.15.9 Is Released

04 Jan 2025 — Caleb Maclennan

Version v0.15.9 of SILE has been released and is available for download! See the included CHANGELOG.md or review the commit history for more explicit details.

Summary of Improvements

This release actually fixes build issues for macOS (Darwin) we tried to fix in v0.15.8 but were more involved than first suspected. It also packages some CSL files that were missing from previous source distributions and touches up a few other odds and ends.

In non-build related changes, Didier Willis patched up some bibliography behaviour. As a cherry on top I patched up the ability to generate a completely blank PDF without throwing an error and changed the outputter API to include an official way to throw an error without also generating a blank PDF.

New Features

  • outputters: Add a method to handle empty PDFs vs. cleanup after error (5a7694d)

Bug Fixes

  • build: Bundle XML and CSL resources with bibtex package (#2201) (73ffcd5)

  • build: Correct dependencies in non-embedded mode (5805cd4)

  • build: Re-organize rules so sources don't have platform detection artifacts (15a20e0)

  • build: Set correct final permissions on intermediary shell completion artifacts (a3de042)

  • classes: Avoid assuming legacy script tags will return a table (d596d53)

  • deps: Bump luautf8 dependency to restore building against latest LuaJIT (206f4b7)

  • docker: Package bootstrap script so Docker images can be built from source tarballs (15a18c0)

  • packages: CSL subsequent-author-substitute is optional (680df8c)

SILE v0.15.8 Is Released

12 Dec 2024 — Caleb Maclennan

Version v0.15.8 of SILE has been released and is available for download! See the included CHANGELOG.md or review the commit history for more explicit details.

Summary of Improvements

This release fixes build issues for macOS (Darwin) we introduced back in v0.15.6 that have been holding back releases on Homebrew and Nix's Darwin support. In addition to the build support, the macfonts font loader has been tweaked to support fallback to fontconfig when a font is not found so it will behave more similarly to Linux builds.

On all platforms, CLI output is a bit cleaner. Many runtime errors now output cleaner message formatting instead of a jumble of joined lines. Also some error chains where one error would trigger another have been resolved.

The math support continues to be refined by Didier Willis, this release bringing a few new commands and features, better behavior parity with MathML, and a couple bug fixes.

New Features

  • build: Add rockspec and build tooling for rusile module (d1ed71e)
  • cli: Output runtime errors pretty-printed for readability (fb45160)
  • fonts: Configure macOS to fallback from macfonts to fontconfig (4b6aa5e)
  • math: Add (AMS)LaTeX-like stackrel, overset and underset (bfd41c0)
  • math: Minimal support for accents in MathML and TeX-like commands (dd0b1b5)
  • packages: Add handler for passing raw content to verbatim (46b0164)

Bug Fixes

  • build: Fix Lua module detection to fail if not found (18f707b)

  • build: Remove obsolete workaround for macOS dependency paths (3fb891a)

  • build: Set module build flags needed for darwin shared libraries (625ea69)

  • cli: Correctly pass through font manager preference from Rust CLI (d2fb48a)

  • core: Avoid internal error when also erroring due to user provided content errors (d83e63c)

  • inputters: Discard duplicate values being parsed without keys in XML (4bb31f0)

  • math: Change under/over constructs' inheritance of the base atom type (70d4f69)

  • math: Erroneous capital H and I in fraktur variant (#2183) (3263be3)

  • outputters: Don't attempt to create output if we error before processing even starts (d38ff03)

  • rusile: Adjust module loader to Darwin's shared module extension (2c5ea3e)

SILE v0.15.7 Is Released

26 Nov 2024 — Caleb Maclennan

Version v0.15.7 of SILE has been released and is available for download! See the included CHANGELOG.md or review the commit history for more explicit details.

Summary of Improvements

Please welcome CSL support. This is still a bit experimental, but this begins the deprecation of the home grown bibliography styling in our bibtex package. SILE can now leverage industry standard Citation Style Language specifications, which opens up a world of existing locale and style guide support. This is thanks to long-running work from from Didier Willis on overhauling bibliography support. His work on the math package also continues with many operator and layout fixes and a few new features continuing to round out out MathML compatibility.

For folks calling out to Lua functions or system tools in their classes, packages, or documents, those calls will now track the document locale. If you use an OS function or external tool that supports localization, you should now get results that match the locale in the document at the time it was called. Responsiveness to locale modifiers might be a little rough until we normalize our locale format to be BCP-47 compliant, but it already works for basic locales. Incidentally this also provides a utility API that can be used to set any ENV variable you want before running external tooling.

Of interest only to SILE developers, some new configure flags have been added for convenience. Any individual tool used in the development and release process can be skipped or overridden using standard --with[out]-PACKAGE=PATH flags. Additionally skipping all the tooling checks can be done with --without-developer-tools even when --with-developer-mode is used.

Finally for distribution packagers, cross compilation of the Rust binaries should be a bit easier now.

New Features

  • build: Add configure flag to skip checks for all developer tools (c01c867)
  • build: Enable --with[out]-EXECUTABLE=PATH configure flags for tooling dependencies (89b5836)
  • core: Set Lua's internal locale so builtin functions respond to document language (a614169)
  • core: Set system locale for subprocesses to match the document language (b28cafd)
  • math: Add pre-defined TeX-like operator functions (cos, sin, etc.) (8d83821)
  • math: Support TeX-like apostrophe and multiplication sign as primes and asterisk (b8f35ff)
  • math: Support TeX-like left..right delimiter syntax (960dc3f)
  • math: Support the MathML operator dictionary and many TeX-like aliases (3dd25e9)
  • packages: Add lightweight CSL engine (8d3961c)
  • packages: Keep track of cited bibliography entries (57b3b7c)
  • packages: Use experimental CSL renderer for BibTeX (808c6bb)
  • utilities: Add function to set environment variables (0f0ed02)

Bug Fixes

  • build: Support cross-compilation of Rust binaries (#2178) (19c7c1d)

  • math: A period must be allowed in TeX-like math syntax for numbers (56edc14)

  • math: Add math.font.script.feature setting, defaulting to ssty (2adc912)

  • math: Improve spacing rules on limit-like operators (781f62a)

  • math: Spacing rules must distinguish binary and unary operators (81a1be5)

  • math: Suppress invisible operators in MathML (#2177) (72faad5)

  • math: The (escaped) percent is an ordinary atom in TeX-like syntax (4170719)

  • packages: Fix bogus command in Pandoc module's definition lists leaking bold (8c9348b)

SILE v0.15.6 Is Released

13 Nov 2024 — Caleb Maclennan

Version v0.15.6 of SILE has been released and is available for download! See the included CHANGELOG.md or review the commit history for more explicit details.

Summary of Improvements

Things got away from me. This release has more features and fixes than we usually let pile up in a patch release. I’ve spent a good deal of time over the last month in the hospital with my son and PR notifications just kept pouring in!

Most of the substantive features and fixes again come from Didier Willis. This release includes a whole bunch of his work on math feature support fleshing out the MathML compatibility and correcting various math layout issues. It also his work updating hyphenation support for a number of languages and adding support for many more, mostly adapted from TeX hyphenation libraries. He also normalized some inconsistencies in the AST generated by the SIL and XML readers and fixed line layout in the verbatim package. His work towards CSL support is still pending my bandwidth to review in the bibliography project.

Additionally this release should be a bit more flexible in working with 3rd party modules. Notably we've accommodated some Lua limitations on macOS and Homebrew installations should be more versatile now. For Docker workflows, the SILE-provided LuaRocks should be visible to the host system as well.

Behind the scenes some minor features provided by vendored Lua libraries have been ported to Rust instead. This shouldn't even be noticeable to end users at this point, but serves as a proof of concept for implementing other internals in Rust while still bridging seamlessly to Lua. Many issues with building static binaries with embedded resources were resolved and build conflicts with ICU 76.1 resolved. Passing the class options via a CLI flag is again parsed correctly. Finally a few error messages and warnings have been cleaned up to be more readable and perspicuous.

New Features

  • build: Add --with-vendored-luarocks=dir for use in distros with pseudo-system path handling (e93f072)
  • cli: Catch missing required arguments at parse time (84f0d78)
  • cli: Mimic Lua VM's ;; to extend not replace the default package paths (bb47f21)
  • core: Add px unit as 0.75pt as per CSS3 (59f4bfd)
  • core: Add separate crate to enable exporting interfaces to Lua (3a95a48)
  • core: Extend SU.collatedSort for complex table sorting (3854be8)
  • docker: Splice SILE's vendored rocks tree into system LuaRocks (548f426)
  • languages: Add Albanian (sq) basic support (a1eedfc)
  • languages: Add Belarusian (be) basic support (084f81d)
  • languages: Add bibliography localizations for Swedish (#2125) (17371f3)
  • languages: Add bibliography localizations for Turkish (84f15e9)
  • languages: Add Church Slavonic (cu) basic support (01bead5)
  • languages: Add Coptic (cop) basic support (e25b806)
  • languages: Add Friulan (fur) basic support (4b88d91)
  • languages: Add Galician (gl) basic support (b5116ed)
  • languages: Add Interlingua (ia) basic support (6f920e6)
  • languages: Add Kurmanji (kmr) basic support (c700786)
  • languages: Add Macedonian (mk) basic support (c4ef9e9)
  • languages: Add Occitan (oc) basic support (4610122)
  • languages: Add Pāli (pi) basic support (13c2531)
  • languages: Add Telugu (te) basic support (237d06d)
  • languages: Add Upper Sorbian (hsb) basic support (51ac4f8), closes #1994
  • math: Add mathcal, mathbb and similar commands in TeX-like math (c867d60)
  • math: Add more TeX-like math commands behaving as big operators (ac9337e)
  • math: Support a TeX math like text command (518e497)
  • math: Support MathML beveled fractions (567ac54)
  • math: Support MathML maction (basic) and mstyle (partial) (0df93b1)
  • math: Support MathML movablelimits attribute (92c678a)
  • math: Support MathML mpadded and refactor TeX-like phantoms (d579096)
  • math: Support MathML mphantom and TeX-like phantom, hphantom, vphantom (46e5954)
  • math: Support MathML mroot element (88ebff7)
  • math: Support MathML mtext and ms elements (3023b93)
  • math: Support mathvariant on special extra greek characters (6f379da)
  • math: Support square roots (7efd24d)
  • math: Support TeX-like math limits (eb402c5)
  • rusile: Enable embedding of Rusile module (693d7d4)

Bug Fixes

  • build: Correct regression in v0.15.5 in generating embedded files list (dae2f7f)

  • build: Smooth out build on ICU 76.1 per Homebrew report (8390534), closes #2152

  • cli: Correct return value handling when process() doesn't lift weight (fb6b866)

  • cli: Fix handling of --option flag in Rust CLI (a77170e)

  • core: Correct module load paths when building in developer mode (4fbb6c0)

  • docker: Setup system locales in containers where it actually counts, not before (55a4ba3)

  • inputters: SIL commands and environments must generate the same syntax tree (4854992)

  • languages: Add missing hyphenation patterns in polytonic Greek (42d14dd)

  • math: Add missing MathML mathvariant mappings (803d699)

  • math: Avoid page breaks before display math equations (19fd61f), closes #2160

  • math: Correct math greek symbols and their var-alternate (6346a2d)

  • math: Correct sub/superscript position for subformulas vs. symbols (6827eb9), closes #2122

  • math: Default table row/column spacing must depend on the math font size (9ce5271)

  • math: Empty mrow's in munderover should not affect the baseline (6f67be5)

  • math: Fractions must have padding to avoid visual confusion (1c009c7)

  • math: Handle LaTeX-like math top accent commands correctly (f4c513a)

  • math: Honor stretchy attribute on MathML mo elements (bde46cd)

  • math: Paired open/close atoms shall be forced in a mrow in TeX-like math (4bbeaa6)

  • math: Stretchy symbols should work on large content (workaround) (589c058)

  • math: Support basic operator stretching along the inline axis (b6e054e)

  • math: Support linethickness attribute on MathML mfrac (e0559e8)

  • math: Top-level math element must behave as an (horizontally stacked) mrow (1f1a1a0), closes #1293

  • math: Wrong condition on moveable limits (workaround) (19906b9)

  • math: Wrong vertical alignment of integral signs (a42181f)

  • packages: Ensure package dependency verbatim is loaded when using autodoc (3a0ef46)

  • packages: Honor margins and base line skips in verbatim mode (58f65d5)

  • shapers: Measure a character should also return its depth (e243b2f)

  • typesetters: Obey blank lines in verbatim-like context (94cfe06)

  • utilities: Fixup AST debugger to handle anonymous content (c50dd07)

  • utilities: Normalize formatting of messages, warnings, and errors (a47b8f3)