0.0.60

Release Notes

• The website shell's left sidebar and right table of contents can be sized separately. Both columns of the three-column grid were drawn from --calepin-sidebar-width, so narrowing the navigation also narrowed the table of contents and there was no way to give one more room than the other. The right column now reads a new token, --calepin-toc-width, which defaults to var(--calepin-sidebar-width): a theme or stylesheet that sets only --calepin-sidebar-width resizes both columns exactly as before, and setting --calepin-toc-width alongside it splits them. Thanks to @kylebutts for the request (#120).

Install calepin 0.0.60

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/vincentarelbundock/calepin/releases/download/v0.0.60/calepin-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/vincentarelbundock/calepin/releases/download/v0.0.60/calepin-installer.ps1 | iex"

Download calepin 0.0.60

File	Platform	Checksum
calepin-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
calepin-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
calepin-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
calepin-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
calepin-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo vincentarelbundock/calepin

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

0.0.59

Release Notes

• An R error now names the call it came from. Calepin reported conditionMessage(e), which is the message alone, so log("a") in a chunk rendered as non-numeric argument to mathematical function with nothing to say where the failure happened, while the same expression in the R console reads Error in log("a") : .... Errors are now formatted the way knitr formats them, with as.character() on the condition, which restores the console framing and dispatches to rlang's own method, so an error raised by rlang or by a package built on it (dplyr, tidyr) keeps its Error in `dplyr::mutate()`: heading and its bullets instead of arriving as a bare message. R warnings gain the same treatment, reported as Warning in log(-1): NaNs produced. A condition signalled at the top level of a chunk, such as a bare stop("boom"), has no call of its own other than Calepin's evaluator, and is reported as Error: boom rather than naming Calepin internals. Messages are unchanged, since R does not frame them with a call either. Python chunks already showed a full traceback and are unaffected. Thanks to @etiennebacher for the report (#119).
• calepin compile builds a searchable website on Windows again. The guard that keeps generated files inside the output directory rejected any path carrying a drive prefix, which every absolute Windows path has, so it refused paths plainly inside the directory and pagefind indexing could not run at all. Only the portion below the root is scanned now, which is what the traversal check was ever about. A website asset-dir written as a rooted path such as /assets is also refused rather than silently escaping the project root, matching the existing refusal of absolute paths.

Install calepin 0.0.59

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/vincentarelbundock/calepin/releases/download/v0.0.59/calepin-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/vincentarelbundock/calepin/releases/download/v0.0.59/calepin-installer.ps1 | iex"

Download calepin 0.0.59

File	Platform	Checksum
calepin-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
calepin-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
calepin-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
calepin-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
calepin-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo vincentarelbundock/calepin

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

0.0.58

Release Notes

• Windows users can install Calepin with Scoop: scoop bucket add vincentarelbundock https://github.com/vincentarelbundock/scoop-bucket and then scoop install calepin. The manifest is regenerated from each release by the same machinery that maintains the Homebrew tap, and points at the Windows archive the release already publishes, so its contents are byte for byte what the zip holds. Scoop owns the copy it installs, so the calepin-update helper is absent from it and calepin update does not apply; scoop update calepin is the upgrade path, exactly as with the Linux packages. Thanks to @draftman9 for the request (#118).
• A document holding fenced blocks in languages it does not run now settles on one layout. Such a block used to be handed back to Typst as the untouched raw element so that a package like codly could claim and style it, and keeping Calepin's own rules off that element required a flag flipped around where the element sat on the page rather than around the call that emitted it, because a show rule runs at layout time. A flag read by position cannot settle when the position is what the layout is still deciding: Typst exhausted its five attempts and kept whichever branch the last pass happened to hold, so the same source could render a block as a chunk or as plain code from one build to the next. Twelve pages of Calepin's own documentation carried the warning, in both HTML and paged output. Calepin now renders these blocks itself, from its own palette. Two consequences: executed chunks and plain fenced blocks match by default, with no set raw(theme: ..) needed, and that setting no longer reaches a fenced block, since it arrives already painted. Inline raw is untouched by Calepin's rules and still follows set raw, so pointing it at .calepin/syntax.tmTheme remains the way to line inline code up with the rest.
• Warnings that Typst reports during a successful compile now reach the terminal. Calepin runs typst compile with its output captured and read that output only when the command failed, so every warning from a successful render was discarded. A document using align(..)[..], pad(..)[..] or another layout element that Typst's HTML export has not implemented yet loses that element's content in the built page, and Typst says so on every compile, but the message never got past Calepin: a table wrapped in align(center) simply vanished from the website with nothing to explain it. Paged and HTML builds now print whatever Typst reported. Typst's standing html export is under active development notice is filtered out, since it repeats on every page of a website build and says nothing about the document being compiled. calepin watch already relayed these warnings and is unchanged. The dropped content itself is a Typst limitation (typst#5512); removing the align wrapper is the workaround, and alignment set on the table itself still applies. Thanks to @uwatlib for the report (#117).

Install calepin 0.0.58

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/vincentarelbundock/calepin/releases/download/v0.0.58/calepin-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/vincentarelbundock/calepin/releases/download/v0.0.58/calepin-installer.ps1 | iex"

Download calepin 0.0.58

File	Platform	Checksum
calepin-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
calepin-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
calepin-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
calepin-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
calepin-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo vincentarelbundock/calepin

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

v0.0.57

Install calepin 0.0.57

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/vincentarelbundock/calepin/releases/download/v0.0.57/calepin-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/vincentarelbundock/calepin/releases/download/v0.0.57/calepin-installer.ps1 | iex"

Download calepin 0.0.57

File	Platform	Checksum
calepin-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
calepin-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
calepin-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
calepin-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
calepin-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo vincentarelbundock/calepin

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

0.0.56

Release Notes

• Linux releases now ship a .deb, an .rpm and an Arch .pkg.tar.zst alongside the tarballs and the shell installer, for x86_64 and aarch64. Installing one puts calepin on PATH and leaves upgrades to the system package manager, instead of a downloaded archive that has to be replaced by hand. All three are generated from a single description, and they repackage the binaries the release already publishes, so their contents are byte for byte what the tarball holds. The packages declare no engine as a hard dependency: typst, python3, Rscript, julia and the diagram tools are all resolved on PATH at run time and overridable in .calepin/config.toml, so typst is a recommendation and the rest are suggestions, and a machine that only wants one engine can still install the package. The calepin-update helper is deliberately absent from them, since a package manager owns the installed copy and a self-updater beside it would fight over the same file; calepin update explains this rather than failing obscurely.
• Debian and Ubuntu users can subscribe to an APT repository at https://vincentarelbundock.github.io/apt, which serves these packages and picks up each new release automatically, so apt upgrade notices a new version instead of the releases page having to be checked by hand.

Install calepin 0.0.56

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/vincentarelbundock/calepin/releases/download/v0.0.56/calepin-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/vincentarelbundock/calepin/releases/download/v0.0.56/calepin-installer.ps1 | iex"

Download calepin 0.0.56

File	Platform	Checksum
calepin-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
calepin-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
calepin-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
calepin-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
calepin-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo vincentarelbundock/calepin

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

v0.0.55

Install calepin 0.0.55

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/vincentarelbundock/calepin/releases/download/v0.0.55/calepin-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/vincentarelbundock/calepin/releases/download/v0.0.55/calepin-installer.ps1 | iex"

Download calepin 0.0.55

File	Platform	Checksum
calepin-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
calepin-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
calepin-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
calepin-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
calepin-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo vincentarelbundock/calepin

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

v0.0.54

Install calepin 0.0.54

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/vincentarelbundock/calepin/releases/download/v0.0.54/calepin-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/vincentarelbundock/calepin/releases/download/v0.0.54/calepin-installer.ps1 | iex"

Download calepin 0.0.54

File	Platform	Checksum
calepin-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
calepin-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
calepin-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
calepin-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
calepin-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo vincentarelbundock/calepin

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

v0.0.53

Install calepin 0.0.53

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/vincentarelbundock/calepin/releases/download/v0.0.53/calepin-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/vincentarelbundock/calepin/releases/download/v0.0.53/calepin-installer.ps1 | iex"

Download calepin 0.0.53

File	Platform	Checksum
calepin-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
calepin-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
calepin-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
calepin-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
calepin-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo vincentarelbundock/calepin

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

0.0.52

Release Notes

• fig-alt-text set in a #| chunk header now survives relocation with #calepin.results(...). Options written in a fenced header exist only in the serialized results, and the paged path restored just a handful of them by name, silently dropping fig-caption, fig-cap-location, fig-link, fig-layout-*, fig-responsive, and fig-alt-text. A relocated plot therefore reached Typst with no alt text, and a strict --pdf-standard ua-1 build failed with missing alt text pointing inside the runtime. Both targets now forward every option that was actually set. Thanks to @eddelbuettel for the report.
• Multi-panel chunks render in paged output again. Restoring every stored option also handed fig-layout-columns and fig-layout-rows to the paged grid as the strings they serialize to, so any chunk with an explicit track list failed to compile with expected auto, relative length, or fraction, found string. Track lists are now converted to Typst lengths the way scalar sizes already were, fr included.
• A tbl- label wraps the chunk's printed output in a table figure, which holds no image and so cannot be described automatically. Under ua-1 Typst demands alt text for it, and no option could supply one. The table figure now reuses the chunk's fig-alt-text.
• calepin.elements.sidefigure and calepin.elements.lightbox-video accept an alt option. Both drew paged figures with no way to attach a description, which failed ua-1 with nothing the author could do about it.
• Page entries returned by calepin.pages() now carry an excerpt: the page's summary metadata if it has one, then description, and otherwise a description derived from the page body — the first paragraph of prose with markup, code chunks, headings, labels, and comments stripped, truncated on a word boundary. Web feeds use the same value, so a post without a hand-written summary no longer produces an entry with a bare title.
• Website builds now write llms.txt at the root of the built site: a Markdown index naming the site, its description, and every page with its URL and excerpt, for language models that cannot usefully crawl the rendered HTML. Links are absolute when base-url is set and root-relative otherwise. On by default, like robots.txt; set llms = false to turn it off, which also removes a previously generated file.

Install calepin 0.0.52

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/vincentarelbundock/calepin/releases/download/v0.0.52/calepin-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/vincentarelbundock/calepin/releases/download/v0.0.52/calepin-installer.ps1 | iex"

Download calepin 0.0.52

File	Platform	Checksum
calepin-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
calepin-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
calepin-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
calepin-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
calepin-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo vincentarelbundock/calepin

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

0.0.51

Release Notes

• Panels of a multi-plot chunk can now be referenced individually. Give a labeled chunk fig-subcaptions and each plot becomes a sub-figure, lettered within its parent: @fig-name-1 is the first panel and @fig-name-2 the second, and a reference reads "Figure 1b". Panel letters restart inside every figure, and panels consume no figure numbers of their own, so the figures around them are unaffected. A grid without sub-captions or a fig- label is left exactly as it was, with no letters and no counter. Reference formatting relies on the #show: calepin.document rule that scaffolded documents already apply; panel captions do not.
• fig-subcap written in a #| chunk header now reaches paged output. Only the label was read from the header on the Typst side, so a sub-caption list set there was dropped from PDF rendering while HTML showed it.
• tbl- and lst- cross-reference labels now resolve. A tbl- label names the chunk's non-image output as a table, and an lst- label names its echoed source as a listing, each with a new caption option (tbl-caption and lst-caption, also accepted as tbl-cap/lst-cap). Each kind numbers from its own Typst counter, so a document can hold Figure 1, Table 1, and Listing 1 at once, and a chunk can carry one label per kind: label: ("fig-plot", "lst-plot") names both the plot and the code that drew it. Both prefixes were previously classified and carried in chunk metadata but never attached to output, so @tbl-x and @lst-x failed to resolve. A tbl- label wraps everything the chunk printed, so it works whatever produced the table; an lst- label requires the chunk to echo its source. Chunks that use neither are unaffected and consume no table or listing number.
• A chunk that prints something between two plots is now a single figure. Output landing between plots split the chunk's images into separate batches, and each batch claimed the chunk's caption and cross-reference label: a fig- label made the document fail to compile with label occurs multiple times, and a caption without a label was silently rendered twice, consuming two figure numbers. The label, the caption, and the figure counter are now each used once. R interleaves output this way whenever a chunk calls cat() or print() between plot calls; Python buffers its stdout ahead of the plots and was never affected. Note that a document with such a chunk loses the spurious second figure, so figures after it are renumbered.

Install calepin 0.0.51

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/vincentarelbundock/calepin/releases/download/v0.0.51/calepin-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/vincentarelbundock/calepin/releases/download/v0.0.51/calepin-installer.ps1 | iex"

Download calepin 0.0.51

File	Platform	Checksum
calepin-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
calepin-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
calepin-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
calepin-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
calepin-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo vincentarelbundock/calepin

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>