Universe

GitHub manifest version (path) GitHub Repo stars GitHub

This script provides a simple way to render text with ANSI escape sequences. Package ansi-render provides a function ansi-render, and a dictionary of themes terminal-themes.

contribution is welcomed!

Usage

#import "@preview/ansi-render:0.4.2": *

#ansi-render(
  string,
  font:       string,
  size:       length,
  width:      auto or relative length,
  height:     auto or relative length,
  breakable:  boolean,
  radius:     relative length or dictionary,
  inset:      relative length or dictionary,
  outset:     relative length or dictionary,
  spacing:    relative length or fraction,
  above:      relative length or fraction,
  below:      relative length or fraction,
  clip:       boolean,
  theme:      terminal-themes.theme,
)

Parameters

most parameters comes from block function, adjust the layout outmost block.

  • string - string with ANSI escape sequences
  • font - font name, default is Cascadia Code
  • size - font size, default is 9pt
  • theme - theme, default is vscode-light
  • parameters from block function with the same default value, change to adjust the outmost layout:
    • width
    • height
    • breakable
    • radius
    • inset
    • outset
    • spacing
    • above
    • below
    • clip

Themes

see themes

Demo

see demo.typ demo.pdf

#ansi-render(
"\u{1b}[38;2;255;0;0mThis text is red.\u{1b}[0m
\u{1b}[48;2;0;255;0mThis background is green.\u{1b}[0m
\u{1b}[38;2;255;255;255m\u{1b}[48;2;0;0;255mThis text is white on a blue background.\u{1b}[0m
\u{1b}[1mThis text is bold.\u{1b}[0m
\u{1b}[4mThis text is underlined.\u{1b}[0m
\u{1b}[38;2;255;165;0m\u{1b}[48;2;255;255;0mThis text is orange on a yellow background.\u{1b}[0m
",
theme: terminal-themes.vscode
)

1.png

#ansi-render(
"\u{1b}[38;5;196mRed text\u{1b}[0m
\u{1b}[48;5;27mBlue background\u{1b}[0m
\u{1b}[38;5;226;48;5;18mYellow text on blue background\u{1b}[0m
\u{1b}[7mInverted text\u{1b}[0m
\u{1b}[38;5;208;48;5;237mOrange text on gray background\u{1b}[0m
\u{1b}[38;5;39;48;5;208mBlue text on orange background\u{1b}[0m
\u{1b}[38;5;255;48;5;0mWhite text on black background\u{1b}[0m",
theme: terminal-themes.vscode
)

2.png

#ansi-render(
"\u{1b}[31;1mHello \u{1b}[7mWorld\u{1b}[0m

\u{1b}[53;4;36mOver  and \u{1b}[35m Under!
\u{1b}[7;90mreverse\u{1b}[101m and \u{1b}[94;27mreverse",
theme: terminal-themes.vscode
)

3.png

// uses the font that supports ligatures
#ansi-render(read("test.txt"), font: "CaskaydiaCove Nerd Font Mono", theme: terminal-themes.putty)

4.png