Render Theme Elements with MiTeX-Converted LaTeX Math

element_math_mitex() is the LaTeX-input companion to element_math_typst(). It accepts LaTeX-style math, converts it to Typst math through MiTeX, and renders the converted result as the element's visual representation. It will normalize the outer $...$ or $$...$$ delimiters automatically.

This allows you to use LaTeX math syntax in your plot, which you may be more familiar with :).

Usage

element_math_mitex(
  hjust = NULL,
  vjust = NULL,
  scale = NULL,
  size = NULL,
  size.unit = "pt",
  color = NULL,
  colour = NULL,
  alpha = NULL,
  face = NULL,
  fontface = NULL,
  angle = NULL,
  lineheight = NULL,
  math_family = NULL,
  inline = FALSE,
  margin = NULL,
  debug = NULL,
  inherit.blank = FALSE
)

Arguments

hjust, vjust: Horizontal and vertical justification for the rendered grob (0 = bottom, 0.5 = center, 1 = top).
scale: A positive scaling factor applied to the rendered Typst size.
size: Optional font size.
size.unit: The unit of size. Defaults to points ("pt"). Use "mm" for ggplot2-style text sizes.
color, colour: Optional text color. RGB or color name are supported.
alpha: Optional color alpha multiplier in [0, 1].
face, fontface: Optional math face. Only "plain" and "bold" are supported, because math text in Typst is italic by default.
angle: Optional text rotation angle in degrees.
lineheight: Optional line height value. May be negative.
math_family: Optional font family for math content. The default math font is New Computer Modern Math. To render a math expression, you don't need to set this and even don't need to have New Computer Modern Math installed on your system. Typst has embedded this font by default.
inline: Whether to render inline math. Default FALSE renders display-style math.
margin: Optional text margins created with ggplot2::margin().
debug: If TRUE, draw a coloured rectangle behind each label for debugging layout.
inherit.blank: If TRUE, element_blank() parents suppress this element.

Value

A ggplot2 theme element.

Details

MiTeX is a LaTeX-to-Typst converter. It should be stable and reliable for typical LaTeX math expressions. If you find any LaTeX math that MiTeX fails to convert properly, you can report an issue to ggtypst first.

Examples

ggplot(mtcars, aes(wt, mpg)) +
  geom_point() +
  labs(x = r"(\eta = \frac{mpg}{wt}, \text{written in LaTeX math})") +
  theme_minimal() +
  theme(axis.title.x = element_math_mitex(size = 14))