Taliesin

When you save, the page does not reload. The scene below keeps turning where you left it, and the Python kernel keeps the variables it has already computed.

This scene is live WebGL. Drag to orbit it. It is the {js} cell above plus a shared makeScene3D helper that {{< include >}} pulls in from _includes/three-scene.tmd, which loads Three.js from esm.sh, so the scene needs network access. More of them, and the source, on the showcase.

taliesin preview post.tmd   # http://127.0.0.1:4321, updating as you save

What it builds

One .tmd file is a post. A directory with a _site.yml is a website, and a chapters: list in it makes a book. They share one renderer, so what you learn for one applies to the others.

Executed code

A {python} cell runs against a warm kernel. Change a parameter and only that cell (and the figure it produced) re-renders. The rest of the page does not move, and the kernel stays warm between saves.

Figure 1 is the output of a cell in this page’s source, executed by the same build that wrote the HTML you are reading.

import numpy as np
import matplotlib.pyplot as plt

cycles = 6
t = np.linspace(0, 1, 600)
fig, ax = plt.subplots(figsize=(8, 3))
ax.plot(t, np.sin(2 * np.pi * cycles * t) * np.exp(-2.2 * t), lw=2)
ax.set_xlabel("t")
ax.set_ylabel("amplitude")
plt.show()

Editing and publishing

This page and the documentation book are built by Taliesin from plain .tmd files in one repository.