Change Log

All notable changes to the PreTeXt-CLI will be documented in this file (admittedly started rather late in the game).

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Instructions: Add a subsection under [Unreleased] for additions, fixes, changes, and removals of features accompanying each PR. When a release is made, the github action will automatically add the next version number above the unreleased changes with the date of release.

[Unreleased]

[2.14.0] - 2025-02-26

Includes updates to core through commit: 8f8858c

Changed

We now package the latest runestone services with the CLI and use the packaged versions in case there is no internet access to download them directly. This allows builds to go through even if offline.

[2.13.5] - 2025-02-16

Includes updates to core through commit: 2f6bfae

Fixed

Improve robustness of pretext view command.

[2.13.4] - 2025-02-15

Includes updates to core through commit: 2f6bfae

Fixed

Update psutil requirement to 7.0 for consistent server checking with pretext view.

[2.13.3] - 2025-02-14

Includes updates to core through commit: 2f6bfae

Changed

Allow deployment even if there are un-committed changes to the project folder; issue warning.

Fixed

Addressed another bug causing errors on pretext update.

[2.13.2] - 2025-02-11

Includes updates to core through commit: 2f6bfae

Changed

Added a temporary hack to avoid build failures when not connected to the internet. This will be reverted in 2.14 in favor of a more robust solution.

[2.13.1] - 2025-02-11

Includes updates to core through commit: 2f6bfae

Fixed

Resolved bug with pretext update.
Better warning messages if unable to build css with node.

[2.13.0] - 2025-02-05

Includes updates to core through commit: 2f6bfae

Added

Logging is now available when the CLI is used programmatically (as a library). See docs/api.md.

Changed

Asset generation of asymptote, latex-image, and sageplot now utilize a generated-cache of images (stored in .cache in the root of a project, but customizable in project.ptx). This should speed up building and generating assets.

[2.12.0] - 2025-01-16

Includes updates to core through commit: 3ce0b18

Added

pretext update command will update managed files and the requirements.txt file to match current installed version of PreTeXt.

Changed

Improved help when deploy fails.
Managed files (project.ptx, requirements.txt, etc) are now managed by comparing to stock versions, not by a magic comment at top.
Only manage git-related files (.gitignore, .devcontainer.json, .github/workflows/pretext-cli.yml) when project is tracked by git.
Only updates managed files when pretext update is run, instead on every run.
Only check for new pretext version once a day.

Fixed

Removed unneeded warnings about pretext projects existing or not when running pretext upgrade and pretext new.

[2.11.4] - 2025-01-11

Includes updates to core through commit: 42236bf

Fixed

Bug with pretext view.

[2.11.3] - 2025-01-06

Includes updates to core through commit: 42236bf

[2.11.2] - 2024-12-28

Includes updates to core through commit: 3c662c9

Fixed

Improved codespace view command (now respects already running servers).
CSS fixes for logo and references from core.

[2.11.1] - 2024-12-25

Includes updates to core through commit: e4edfd0

Fixed

pretext view bug where a process is terminated abnormally

[2.11.0] - 2024-12-24

Includes updates to core through commit: e4edfd0

Added

New and improved css style options. See PreTeXt documentation.
pretext upgrade command will run pip install --upgrade pretext using the same python you are running pretext from, for smoother upgrades.

Changed

pretext view now reuses the current local server correctly, and starts different local servers for different projects. This allows you to correctly view multiple projects at the same time.

[2.10.1] - 2024-12-10

Includes updates to core through commit: e532f63

[2.10.0] - 2024-12-06

Added

Support for building stand-alone documents without adding the source to the manifest.
Support for upcoming html themes, including pretext build --theme to refresh theme without rebuilding entire project.

[2.9.2] - 2024-11-22

Fixed

prefigure graphics were not not being recognized.

[2.9.1] - 2024-11-09

Changed

prefigure dependency is now an optional install. To get it, install pretext with pip install pretext[prefigure].

[2.9.0] - 2024-11-07

Added

Support for generating prefigure graphics.
Always checks whether there is a new version of the CLI available.

[2.8.2] - 2024-11-05

Fixed

Further video id bug.

[2.8.1] - 2024-10-31

Fixed

Bug: could not use custom XSL on windows without special permissions
Bug: Runestone issue "Failed to evaluate the AVT of attribute 'data-video-divid'"

[2.8.0] - 2024-10-18

Added

From core: publication option to control latex style file.
From core: default programming language can be set in <docinfo>

Changed

From core: <bibinfo> container for bibliographic information previous held in <titlepage> and <colophon>.
Improved publication file template.

[2.7.1] - 2024-10-03

Fixed

Bug: temporary directories from core not deleted on builds.

[2.7.0] - 2024-09-24

Added

Support for reveal.js slides via format="revealjs".
Support for custom xsl that imports core xsl via ../xsl/pretext-[type].xsl

Fixed

Bug preventing the extraction of webwork sets.

Updated

Github action will test build on older versions listed in requirements.
Bumped lxml to at least 5.3 and psutils to at least 6.0.

[2.6.2] - 2024-08-21

Updated

Newest version of core pretext.

[2.6.1] - 2024-08-10

Fixed

pretext view should now work even if a previous view process did not exit properly.

[2.6.0] - 2024-07-18

Changed

Updated the process for generating latex-image to use pyMuPDF instead of pdf2svg

Fixed

Only generate myopenmath problems when actually needed.

[2.5.2] - 2024-07-17

Fixed

Bug with html build for source with version controlled components with duplicate ids.

[2.5.1] - 2024-07-16

Fixed

For compatibility with Runestone you must install pretext with pip install pretext[homepage] in order to get the landing page features.

[2.5.0] - 2024-07-15

Added

Automatically build a landing page for a project when deploying multiple targets.
New (optional) github action workflows for publishing/deploying sites.
Static versions of problems for MyOpenMath can now be downloaded using the CLI. Build/generate for print as usual to get these.
Support of mermaid diagrams.

Fixed

Improved pretext import command to handle modular latex files better.
Turned off image conversions for pretext import.
Always stage to a clean stage directory for pretext deploy.
Improved output messages for info and error messages.

Incorporated improvements from 'core' PreTeXt

Parsons problems can have partially ordered solutions.
Fill In The Blank problems improvements
Improved MyOpenMath support
Support "circular" cases for proofs (TFAE, eg)

[2.4.1] - 2024-05-18

Fixed

Improved pretext view for inside codespaces.

[2.4.0] - 2024-05-02

Added

pretext import command. Pass a path to a .tex file and it will use PlasTeX to do its best to convert the latex to pretext.

[2.3.10] - 2024-04-10

[2.3.9] - 2024-03-02

Fixed

Temporary hack fixes pretext view issues in codespaces.

Changed

pretext view now opens browser sooner when you are not using codespaces.

[2.3.8] - 2024-02-25

Added

Added this CHANGELOG.md file to track future changes to the PreTeXt-CLI.

Changed

Generating webwork will now continue in most cases where a single exercise is invalid, still creating a representations file.
Improve error message when webwork-representations file fails to build.