mxblocks-tex 0.1.0

Math messages for mxblocks: run the mxblocks-math renderer and build the m.image event (MSC2191 markup, caption)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

# mxblocks-tex

Math messages for [mxblocks](https://github.com/talaagent/mxblocks/blob/main/README.md): render a formula with the
`mxblocks-math` program (`packages/mxblocks-math/`) and build the `m.image` event that carries
it, with MSC2191 markup (`data-mx-maths`) for clients that render LaTeX and
the raw TeX as the plain body.

The renderer contract: `mxblocks-math render [--inline] --out PATH.png -`,
TeX on stdin; exit 0 with one JSON line on stdout
(`{"mimetype":"image/png","w":W,"h":H,"size":BYTES}`, `w`/`h` the display
size of a 2x PNG), or non-zero with the TeX error on stderr.

```no_run
# async fn render() -> Result<(), Box<dyn std::error::Error>> {
let r = mxblocks_tex::Renderer::new("mxblocks-math").render(r"e^{i\pi} + 1 = 0", true).await?;
// Upload r.png with your Matrix client, then pass its returned mxc URI.
let mxc = "mxc://example.org/rendered";
let content = mxblocks_tex::math_content(r"e^{i\pi} + 1 = 0", true, "", &r, &mxc, None);
assert_eq!(content["msgtype"], "m.image");
# Ok(())
# }
```

Apache-2.0.