Releases: sile-typesetter/sile
v0.12.3
Summary of Improvements
This patch release changes the way new frames are generated to inherit settings differently. These changes should qualify as "fixes", but could affect workarounds for anybody that had trouble before. Loading the BiDi package (which happens by default) now changes the default typesetter in addition to the current one. This affects some features such as the commands to typeset into a different frame than the current one when RTL languages are involved. Additionally, the way frames are created has changed so that direction settings such RTL set on the class are inherited by default to default and new frames unless otherwise specified. This affects folio, footnote, and other default frames as well as any created programmatically.
Both changes are likely the behavior most users would expect anyway –hence the minor patch release– but could cause unexpected results in documents that had other ways of dealing with the previous unexpected behavior.
Bug Fixes
v0.12.2
Summary of Improvements
This patch release is to fix a regression in handling negative width spaces — something that turn up when typesetting Nastaliq. Thanks to first-time contributor @mimbrown for both the report and fix. Also the documentation for the dropcap package added in the last release is now in the manual. The only other thing possibly worth noting is that the prebuilt Docker images now run on the recently released Lua 5.4.4.
Bug Fixes
Contributors
Assets 5
v0.12.1
Summary of Improvements
The first minor release in the 12.x series brings several new features relevant to paragraph shaping. @Omikhleia has fleshed out the linebreak mechanism with full parity of LaTeX's settings including hangingIndent and parShape. Having fully featured paragraph-wise hanging indent settings enabled a new package, dropcaps, to provide much more robust dropcap functionality than the previous floating frame mechanism we used for this. (Note the dropcap package documentation did not make it in the manual, see the example on the website for usage.) Additionally the paragraph shape callback function can now be used to create fancy paragraph shapes using any geometry you can specify or calculate. Bugfixes in this release cover several issues with French language, PDF metadata encoding, color fonts, book class headers, and more.
Features
- build: Accommodate SOURCE_DATE_EPOCH for reproducible builds (16c81a8)
- classes: Add \noop function for versatile SILE.call() use (2b04507)
- core: Add OpenType post (v1) table parser (a985aed)
- core: Implement Knuth's hangAfter and hangIndent (5417189)
- core: Implement paragraph duration hanging indent settings (18ee23b)
- core: Implement paragraph shaping (parshape) (c2c0235)
- packages: Add dropcaps package (cb9105a)
- packages: Add shift, raise, and size options to dropcaps (0a88948)
- packages: Implement color option for dropcaps (d042bcf)
- packages: Use font's post table to determine underline position (ae1b929)
Bug Fixes
- backends: Move Lua 5.1 macro so covers whole file (9b40772)
- classes: Reset state when calling running headers (ec0a7b8)
- classes: Unnumbered book sections shall not display a number in running headers (4afde42)
- Fixes name of accented math symbol, eliminates duplicate newStandardHspace assignment (4c38f1a), closes #1274
- languages: Correct hyphenation after apostrophe in French and Catalan (4c93891)
- languages: Correct synchronisation between indexes in French word breaking (94ca931)
- languages: Repair broken French hyphenation patterns (c25d9d7)
- packages: Add \pdf:metadata support for dates (1b87305)
- packages: Apply OpenType x and y offsets to color fonts (d66dc5f), closes #1147
- packages: Correct rebox to not output duplicate content (2802d9b)
- packages: Don't over-isolate functions run in Pandoc imports (#1254) (84507a5)
- utilities: Fix UTF-16 encode/decode utility functions (7180081), closes #1280
- utilities: Set language of roman numerals to Latin to avoid casing issues (#1253) (95c4e2c)
Contributors
Assets 5
v0.12.0 — Please welcome MATH typesetting!
Summary of Improvements
While this release follows close on the heels of previous releases it represents over 2 years of work from community contributors. @harrysummer started work on a native math feature in April of 2019. While this initial phase was never completed, it did get as far as a working prototype. In November of 2020, @OlivierNicole picked up on the work and transformed the prototype into the shape as found in this release. Additional thanks to @akavel for input throughout the process.
On a conceptual level the math support is based on [MathML][] and relies on OpenType math fonts. The input notation may be MathML (either directly using the native XML syntax or using an 1-to-1 equivalent SILE syntax) or an alternative math shorthand similar to the math notation used by TeX. See section 5.29.5 in the [v0.12.0 manual][manual] for detailed documentation on the new math package. Examples are given for various formulas and syntax options. A math example has also been added to the packages example gallery on this website.
Additionally @Omikhleia contributed several new features and fixes including much more control over Table of Contents, styling options for PDF links, correct French punctuation treatment, and more.
Thanks to the contributions of @doronbehar, as of this release SILE is usable as a [Nix Flake][flake] (in addition to the usual Nix package). This is an easy way to test run the latest Git HEAD version at any time from almost any OS. One you have flake support enabled, just run nix run github:sile-typesetter/sile -- <sile orguments>. This website uses this to regenerate some of the examples in the gallery.
Even though the math package is a major new feature, ultimately the major version bump was caused by a breaking change elsewhere. Previous to this release, the font used for footnotes was the SILE default unless specifically set. Setting changes were relative to the SILE default rather than the document default. This behavior was workable, but usually came as a surprise to most users. With this release, footnote and folio frame font settings default to being relative to the current document font. The font family, size, leading, and all other aspects of footnotes and folios are still configurable with the same tools as before. But this is a breaking change because those settings are now relative to a different base which might cause many documents to need updating.
⚠ BREAKING CHANGES
- packages: Previous to this release footnote and folio frames took
their font settings from a new typesetter with default settings. With
this release the settings are now derived from the typesetter in the
default frame, hence inheriting font family, size, leading, and other
settings. Values can still be set using the same functions, but relative
values such as font sizes are based on a different base.
Features
- core: Add MATH variants table parser (b6c554e)
- core: Add OpenType MATH table parser (835da21)
- math: Add ‘debug’ option to math command (58cc9dc)
- math: Add “big operator” support (5b9a150)
- math: Add fixes to support less complete fonts (1c22af3)
- math: Add italic correction to superscript; correct subscript size (d81fdee)
- math: Add math.font.filename setting (522d70b)
- math: Add math.font.size setting (5077d1c)
- math: Add operator defaults (14bdf1a)
- math: Add parameter to draw debug boxes around math components (2458d18)
- math: Add parameters and support mathvariant param for mi tag (869dca8)
- math: Add plain text support (3a09e9d)
- math: Add subscript and superscript; add math constants (0489c04)
- math: Add support for “symbol macros”, expanding to strings (27658f5)
- math: Add support for fractions (6f4fc24)
- math: Add tags for some mathematical symbols (b9fd771)
- math: Add tex-like math parser (edceaf7)
- math: Allow vertical stacking of top-level ‘mrow’s (56b553c)
- math: Center display math neatly (8951378)
- math: Implement and use munder and mover (61eac7a)
- math: Implement generic bbox shaper (9c86aff)
- math: Output error if rending with non-math font (c79617b)
- math: Replace leading
-with−in numbers (f8d490c) - math: Support double-struck identifiers (29674bf)
- math: Support for simple macros (5b4ecf7)
- math: Support italic (c9b2884)
- math: Support more integral-like operators (90a6c44)
- math: Support of UTF-8 in texmath, support of mo, mi and mn in-grammar (959d1cc)
- math: Turn "-" (hyphen) into "−" (minus) in math (fbed523)
- packages: Add border style and color to hyperlinks (bb880be)
- packages: Add function to remove last added fallback font (acf987b)
- packages: Add linking support to toc entries (e589cb9)
- packages: Add toc depth option and hooks for showing section numbers (c48fcde)
- packages: Allow URLs to have many breakpoints (#1233) (b145605)
- packages: Warn if toc contents have changed (5b6eed8)
- tooling: Enable use as a Nix flake (8b503bb)
Bug Fixes
- classes: Don't increment counters on unnumbered book sections (6cfca4d)
- core: Correct --help output to reflect required values (da487ec)
- languages: Add test 704 for French punctuations, fix expected 621 and 702 results (8e9b056)
- languages: Correct Armenian support to use ISO 639 code ‘hy’ (ffafbe6)
- languages: Correct punctuation rules for French (95c2398)
- languages: Don't initialize Japanese unless actually called for (3aba931)
- languages: Shortcut ICU soft breaks in French (ed8734c)
- math: Fix underover error with sub wider than base but no sup (bc87393)
- packages: Don't replace shaper unless actually initializing color-fonts package ([269ca59](https://github.com/s...
Contributors
Assets 5
v0.11.1
Summary of Improvements
Today's small patch release is mostly to help out downstream packagers with some small issues that cropped up. First it's a stab in the dark hoping we made things easier to get Homebrew packaging working on ARM based macOS. Secondly we added a build time check for git, which is required in order to use SILE's internal package manager. This dependency may change in the future, but since we use it now it's helpful that system compatibility is checked at build time. Lastly we fixed up some internal usage of an API we deprecated 6 releases ago and documented as going away in v0.11.0, but forgot to stop using ourselves. Notably the French language support module was affected.
Bug Fixes
v0.11.0
Summary of Improvements
This release brings a significant fix to the vertical grid typesetting system that was causing extra full grid spaces between paragraphs where they didn't belong. The new behavior is objectively more correct, but it does break previous workarounds. If you previous used a workaround to get the right output in spite of the bug, those documents may not render incorrectly. They can be fixed by removing whatever other workaround was in place or adding a shim that makes the paragraph spacing emulate the old behavior. Some utility functions also received bug fixes. Thanks to contributor @ctrlcctrlv, color fonts now behave themselves much better in TTB layouts and the counter display style Alpha works as documented.
Not much has been added on the feature front, just a few conveniences such as traditional units of (small) measurement and handling more attributes in documents converted via the Pandoc writer (as-yet unreleased).
Beginning with this release Docker images will now be available from GitHub Packages (also known as the GitHub Container Registry). This is an alternative to Docker Hub which has recently started limiting the features available to open source projects.
⚠ BREAKING CHANGES
-
packages: Previous to this release any and all leading between
paragraphs (as set with document.parskip) –even a 0 height skip– would
result in the skip of one full empty grid space — as if parskip had been
set to something approximating a full line height. This change corrects
the calculation so if a 0 height skip is added and everything fits, the
next line or paragraph will continue uninterrupted in the next grid
slot. To get the previous layout behavior back, document.parskip must
be explicitly set to be something larger than 0. Even a minimal 1pt
skip will result in paragraph spacing that includes one full grid height
left blank as before:\set[parameter=document.parskip,value=1lh] -
utilities: Previous return value for breadcrumbs:contains() was
just an depth index with -1 indicating no match. This made sense when
I wrote it, but coming back to it for a new project I expected a boolean
return value. Returning two values seems like the best option, but given
the function naming it seemed to make sense to return the boolean first,
hence the API breakage.
Features
- actions: Use tagged images for faster CI job spin up (6a00388)
- build: Add configure flag --disable-dependency-checks (5caf413)
- docker: Build, tag, and push images to GHCR (3988339)
- measurements: Add ‘hm’ (himetric) unit (f4b6b62)
- measurements: Add ‘twip’ unit (cf9d5a7)
- packages: Map unnumbered class to legacy opts in Pandoc package (#1167) (2868da2)
Bug Fixes
- core: Avoid crash on warn by using correct function (b403ad9)
- packages: Avoid crash on warn by using correct function (5d05be1)
- packages: Avoid unnecessary skips to next grid space (6424369)
- packages: Correctly handle color fonts on TTB pages (9b35d6a), closes #1171
Code Refactoring
- utilities: Change breadcrumbs:contains() to return <bool, index> (a987394)
Contributors
Assets 5
v0.10.15
Summary of Improvements
This release fixes a couple of regressions and adds a couple small features. On the regression front, access to the interactive prompt has been restored and the table of contents metadata in PDFs is properly encoded again. For new features, COLR fonts are now automatically detected and the necessary support package is loaded when they are used, a new package allows spaces to be drawn using font-provided glyphs rather than assuming empty space, and another new package allows access to OpenType font features through more verbose fontspec names rather than their OpenType feature code names.
Features
- fonts: Allow for code to be run when a font is first loaded (bdf05ab)
- packages: Add \font-feature command (e2cf008)
- packages: Add complex-spaces package (#1148) (b7451ae)
Bug Fixes
- cli: Re-enable access to repl, input argument not required (a6434ee)
- core: Allow builtin Lua bitwise operators on Lua 5.4 (5f0c2c7)
- docker: Switch to BuildKit and make Docker Hub cooperate (783b104)
- docker: Use patched glibc to work around outdated hosts (fa2532c)
- docker: Use patched glibc to work around outdated hosts (#1141) (bf74417)
- docker: Work around libtexpdf build having side effects (33510d9)
- packages: Add CharacterVariant to features (929eca2)
- utilities: Correct UTF-8/UTF-16 conversions (4863ed6)
v0.10.14
Summary of Improvements
This release introduces a new dependency on an external Lua UTF-8 string handling library. By introducing proper string handling instead of our home grown functions we knocked out several bugs including invalid encoding in the output when error tracing was turned on. We also added some (ironically, home grown) UTF-16 string handling to sanitize output of Font meta data.
Features
- core: Make luautf8 library available in global scope (ab7e745)
Bug Fixes
v0.10.13
Summary of Improvements
This release brings a few bug fixes, most notably unscrambling Arabic (and some other complex script) shaping. Since current work in process includes significant changes to the document class API and these fixes have been sitting around for a while I figured it was time to give them a release number before anything potentially more disruptive lands.
Feature-wise the only significant improvement is complete coverage for all element types in the Pandoc document AST, enabling any converted documents to compile without errors. They might not be pretty out of the box yet, but at least they render and can be styled by adding or modifying commands.
Features
- classes: Allow footnotes in plain class if package loaded (42c1ceb)
- classes: Run deferred package init() on late load (0224fe3)
Bug Fixes
- backends: Add complex shaping data to debug backend (a1a6509)
- backends: Don't crash if debug output precedes regular (19c21f2)
- build: Don't abuse libtool internals (for NetBSD packaging) (#1084) (048c8b5)
- classes: Define \strong weight=700, not 600 (#1097) (68abf91)
- packages: Add default options to simpletable (1f10c97)
- packages: Correct math operations on grid spacing (5286188)
- packages: Turn off complex flag for items in \latin-in-tate (b20690f)
v0.10.12
Summary of Improvements
This release fixes just two bugs. The simpler of the stops custom styles in verbatim blocks. Much more urgently, a backend fix correctly accounts for offsets calculated during the shaping process and stops resetting the PDF cursor position. This issue primarily broke Arabic, but typesetting any fonts with cursive positioning or mark placement rules were affected.