Released11 Aug 2026Commit6d090f36Line0.1.x

v0.1.2

Sigil Doc 0.1.2

Notes

Sixteen commits since 0.1.1. The headline is that the document root and the prose model both became things a delegating language can parameterise, which is what lets folio/doc exist as a profile over this one rather than a fork.

The root container is a reader/profile parameter

The parser hardcoded "exactly one @chapter" as the only legal document root. Two consequences went with it: the article and book model kinds were unreachable from source, and no delegating language could deliver its own roots. Both are gone. A profile now names its root commands and their multiplicity, so (folio doc reader) can deliver @note and @project roots through the public module alone.

Inline commands fold into bare prose

A command that is not at a block boundary now folds into the enclosing paragraph run instead of breaking it. Block-boundary commands keep their existing semantics, and the document-escape and raw @code paths are untouched. Paragraph formation is frozen author-facing behaviour, so this one was gated against a derived 80-manuscript corpus with a pre-change baseline, cross-checked against an independent boundary census.

New and renamed

  • url-link, an inline node for links that leave the publication. Video destinations are held to the same link-target policy, and the print backend refuses a destination it cannot safely emit.
  • The note admonition is now aside. Clean break, no alias.
  • A passive parse API with localized parser state, so a caller can inspect a document without executing it.

Requires sigil ^0.18.4

The manifest previously declared ^0.17, which was stale and actively wrong: it resolved sigil-stdlib to v0.17.20 against 0.18-era source and twelve of fourteen test files failed to load. It went unnoticed because dev-redirects.sgl points at a local checkout, so nobody building here ever resolved the declared constraint. If you consumed 0.1.1 with a 0.17 toolchain and it worked, you were not using what the manifest said.

Verified before tagging with a real 0.18.5 toolchain and a cold cache: 117 tests passed, 14 of 14 files run.

Commit

6d090f36e07236c8ee09044f60cdb19f932c4afd

This commit is older than the 20 that keep a page here, so it has none. It is in the clone.

Releases