# Quickstart This page takes you from nothing to a live figure on your own web page, in four steps. ## 1. Get mtp mtp is not yet published as a package, so you build it from its repository. You need [git](https://git-scm.com), [uv](https://docs.astral.sh/uv/), [Node](https://nodejs.org) with [pnpm](https://pnpm.io), and [just](https://just.systems). ```sh git clone https://github.com/aris-pub/mathterpiece cd mathterpiece uv sync cd web && pnpm install && cd .. just build-web ``` `uv sync` installs the compiler, which gives you the `mtp` command through `uv run mtp`. `just build-web` builds the runtime, the file `web/dist/mathterpiece.js` that draws figures on a page. ## 2. Write a figure Save this as `circle.mtp` in the `mathterpiece` folder: ```{mtp-example} ; a point on the unit circle, with cos in red and sin in green (real theta 40 (wrap 0 360)) (scene s (circle rim (r 1) (fill none) (stroke 'gray')) (line cos (from [0 0]) (to [(cosd theta) 0]) (stroke 'crimson') (stroke-width 4)) (line sin (from [(cosd theta) 0]) (to (polar 1 theta)) (stroke 'seagreen') (stroke-width 4)) (circle p (r 0.07) (pos (polar 1 theta)) (fill 'slateblue'))) (canvas v (x -1.25) (y -1.25) (width 2.5) (height 2.5) s (on-drag p (move theta (to (. (or? (to-polar pointer) [1 theta]) 1))))) (slider turn (move theta (from 0) (to 360)) (label 'θ')) ``` The figure above is live: drag the point or move the slider. The file declares one variable, `theta`, an angle that wraps around at 360. The scene draws a circle, a point at angle `theta`, and the two lines whose lengths are its cosine and its sine. The canvas `v` shows the scene, and dragging the point moves `theta`. The slider `turn` moves `theta` too. ## 3. Check and compile it ```sh uv run mtp check circle.mtp uv run mtp compile circle.mtp ``` `mtp check` reports the first error, with its line and column, and writes nothing. When the figure is right, `mtp compile` writes `circle.mtpc`, the compiled figure. To see the figure while you edit it, run `uv run mtp serve circle.mtp` and open the address that it prints. The page reloads each time you save the file. ## 4. Put it on a page Copy `web/dist/mathterpiece.js` and `circle.mtpc` into the folder of your page, and write: ```html

Turn the point:

``` `` loads the figure. `` and `` place its canvas and its slider anywhere in the text, by the names that the source gives them. The browser reads `circle.mtpc` over HTTP, so open the page through a web server, not as a file. For a quick test, run `uv run --no-project python -m http.server` in the page's folder and open .