Release notes

Contents

Release notes#

0.63 (2025-10-04)#

Fixed layout issues in admonitions.
Added a logo and a favicon. Yay!
Split run.py into two stages, a loader (still in the site repository) and a payload fetched from GitHub. This should reduce the frequency of run.py updates across all repositories.
Full changelog

0.62 (2025-09-28)#

Hardened t-doc against supply chain attacks.
Full changelog

0.61 (2025-09-14)#

Added the hspace and vspace roles.
Added the leader role.
Added the {jsxgraph} :template: option.
Full changelog

0.60 (2025-09-07)#

Added the points role.
Added a print stylesheet for exams.
Added support for styling console output with {exec} :console-style:.
Full changelog

0.59 (2025-08-23)#

Added the mermaid directive.
Changed the mapping for auto-completion in editors from Enter to Tab.
Full changelog

0.58 (2025-08-10)#

Added the jsxgraph directive.
Made it easier to run multiple local servers simultaneously by automatically selecting a port.
Full changelog

0.57 (2025-08-05)#

Added the list-grid directive.
Fixed exec blocks with a :caption: option.
Full changelog

0.56 (2025-08-04)#

Added the flex-table directive.
Added the block and blocks directives.
Added the num1, num2 and nump roles.
Added styles for numbered lists and multi-column layouts.
Added a print stylesheet and styles for column and page break control.
Full changelog

0.55 (2025-07-24)#

❤️ Happy anniversary t-doc! ❤️
The first changeset was committed to the common repository one year ago, on 2024-07-23, followed by 682 more changesets until this release.
Added support for running Python code on the main thread. This enables the use of pygame-ce in {exec} python blocks.
Full changelog

0.54 (2025-07-10)#

Fixed a build issue on Windows.
Full changelog

0.53 (2025-07-10)#

Fixed an issue that broke {exec} python.
This release breaks builds on Windows.
Full changelog

0.52 (2025-07-10)#

Unbundled most JavaScript dependencies. They are now loaded from a CDN, and cached locally when using the local server.
This release breaks {exec} python directives.
Full changelog

0.51 (2025-06-28)#

Added a UI for signing in and out. Signing in is domain-wide, so it needs to be done only once to work across all sites.
Full changelog

0.50 (2025-06-22)#

Integrated table-based dynamic quizzes into the quiz directive.
Fixed an issue with line numbers in tracebacks in {exec} micropython.
Full changelog

0.49 (2025-06-14)#

Renamed "quizz" to "quiz" everywhere. English is hard.
Full changelog

0.48 (2025-06-13)#

Added the quiz directive and associated roles to create interactive quizzes.
Reduced the latency of database change notifications, to make them practically instantaneous.
Full changelog

0.47 (2025-05-25)#

Added the poll directive to perform live audience polls.
Improved the performance of incremental rebuilds.
Full changelog

0.46 (2025-05-20)#

Fixed the rendering of numref references to num roles.
Added automatic store upgrades.
Full changelog

0.45 (2025-05-17)#

Made automatic rebuilds in the dev server incremental. This significantly speeds up the edit-view loop.
This release breaks the rendering of numref references to num roles. The links are correct, but their numbering is wrong.
Full changelog

0.44 (2025-05-16)#

Added a config value to set the default solution visibility.
Fixed an internal error in unauthenticated API requests.
Full changelog

0.43 (2025-05-15)#

Added dynamic control of the visibility of solutions.
Added support for user authentication.
Added an event streaming API to enable more dynamic pages.
Full changelog

0.42 (2025-04-21)#

Added a visual indication that editor content is unchanged.
Added a mechanism to show removed solutions.
Prepared for per-site subdomains.
Full changelog

0.41 (2025-04-13)#

Added functionality to draw over page content.
Full changelog

0.40 (2025-04-11)#

Added a metadata setting to remove the content of solution directives from the output.
Added an option to open the site in a browser when running the local server.
Full changelog

0.39 (2025-03-20)#

Added table-based quiz generation functionality.
Full changelog

0.38 (2025-03-01)#

Added a menu entry to read main.py in {exec} micropython.
Simplified math typesetting in quiz prompts.
Full changelog

0.37 (2025-02-21)#

Added support for programming MicroPython devices through {exec} micropython.
Full changelog

0.36 (2025-02-13)#

Improved command-line option parsing.
Moved the check for upgrades to the run.py script.
Full changelog

0.35 (2025-02-06)#

Simplified the generation of color output on the terminal.
Refactored internals to enable running single-file scripts within the venv.
Full changelog

0.34 (2025-02-02)#

Enabled loading packages for {exec} python blocks.
- Bundled the micropip, packaging and sqlite3 packages.
Enabled calling async functions synchronously on Chrome-based browsers.
Added tdoc.core.input().
Full changelog

0.33 (2025-01-25)#

Fixed the breakage in CLI sub-commands.
Full changelog

0.32 (2025-01-25)#

Made it simpler to run a local server with a store.
Added a script to test all document repositories.
This release breaks certain CLI sub-commands.
Full changelog

0.31 (2025-01-12)#

Added the t-doc version in the content footer.
Full changelog

0.30 (2025-01-12)#

Finalized the auto-install and upgrade functionality.
On Windows, made the run.py script pause on termination due to an exception, so that the console window doesn't close immediately.
Enabled development in an isolated virtual environment.
Full changelog

0.29 (2025-01-09)#

Added a wrapper script for the tdoc command to auto-install and upgrade t-doc-common.
Full changelog

0.28 (2025-01-09)#

Fixed an issue with missing _static directories.
Full changelog

0.27 (2025-01-03)#

Added packaging of Python modules in the _python directory.
Added tdoc.core.redirect() to redirect stdout / stderr.
Fixed the overflow of wide non-editable exec blocks.
Full changelog

0.26 (2024-12-27)#

Added quiz functionality.
Fixed issues with non-ID characters in {exec} :after: and {exec} :then:.
Full changelog

0.25 (2024-12-15)#

Made editor IDs globally unique, to allow moving across documents.
Made the "Toggle solutions" button conditional on the presence of solutions.
Full changelog

0.24 (2024-12-14)#

Enabled saving the content of editors to browser local storage and restoring it on reload.
Renamed {exec} :editable: to {exec} :editor:.
Added links to the documentation of major dependencies.
Full changelog

0.23 (2024-12-07)#

Converted the dev server to WSGI.
Added support for a backend store to the dev server.
Fixed more cosmetic issues with collapsed admonitions.
Full changelog

0.22 (2024-11-26)#

Added some basic cryptographic helpers for secret management.
Full changelog

0.21 (2024-11-23)#

Added the defaults directive.
Fixed a cosmetic issue with collapsed admonitions.
Full changelog

0.20 (2024-11-21)#

Added the num role.
Full changelog

0.19 (2024-11-17)#

Fixed the un-collapsing of admonitions through click events.
Fixed the full-screen mode of {exec} html.
Full changelog

0.18 (2024-11-14)#

Added the youtube and iframe directives.
Removed the dependency on sphinx_togglebutton.
Full changelog

0.17 (2024-11-09)#

Added the solution directive and the "Toggle solutions" navbar button.
Fixed the flickering on page load due to sphinx_togglebutton.
Added an option to exclude files from watching in the dev server.
Full changelog

0.16 (2024-11-03)#

Added support for {exec} html.
Added support for styling editors and output blocks with {exec} :style: and {exec} :output-style:.
Added the metadata directive.
The rendered HTML output is now fully self-contained.
Full changelog

0.15 (2024-10-19)#

Added a mechanism to render arbitrary HTML from {exec} python blocks.
Added a Python module to create SVG images.
Added automatic focusing of {exec} python text input elements.
Fixed the positioning of the "Remove" button on scrollable tables.
Full changelog

0.14 (2024-10-03)#

Added a button to remove {exec} output.
Fixed {exec} :linenos:.
Full changelog

0.13 (2024-09-29)#

Added support for executing blocks after a block with {exec} :then:.
Full changelog

0.12 (2024-09-28)#

Added user input functionality for {exec} python blocks.
Full changelog

0.11 (2024-09-27)#

{exec} python now works when offline.
Fixed an issue that prevented entering the character / in editors.
Disabled the search shortcut, as it can interfere with editors.
Made the workaround for missing SharedArrayBuffer configurable.
- By default, no workaround is installed, and Polyscript seems to work fine.
- Cross-origin isolation can be enabled, but this breaks <iframe> tags.
- Alternatively, a Sabayon service worker can be installed.
Full changelog

0.10 (2024-09-21)#

Added initial support for {exec} python.
- Currently, Python code execution only works when online.
Made the automatic page reloading more reactive.
Made pages cross-origin isolated even if the server doesn't set the appropriate headers.
This release breaks <iframe> tags in documents. On Chrome, setting the credentialless attribute on the <iframe> tags fixes the issue, but Firefox and Safari don't support it (yet).
Full changelog

0.9 (2024-09-12)#

Added automatic page reloading on successful builds in the dev server.
Fixed encoding issues with {exec} :include:.
Full changelog

0.8 (2024-09-12)#

Allowed multiple references in {exec} :after:.
Added support for including external files with {exec} :include:.
Full changelog

0.7 (2024-09-07)#

Fine-tuned the exec control buttons.
Full changelog

0.6 (2024-09-07)#

Added support for editable blocks with {exec} :editable:.
Full changelog

0.5 (2024-08-31)#

Added on-click execution of exec blocks.
Added support for dependencies with {exec} :after:.
Added proper rendering of SQL errors in {exec} sql.
Fixed the handling of NULL values in {exec} sql.
Full changelog

0.4 (2024-08-22)#

Added checking for updates in the dev server.
Added install, use and development documentation.
Full changelog

0.3 (2024-08-19)#

Added automatic rebuilding on source file changes in the dev server.
Full changelog

0.2 (2024-08-17)#

First public release.