codly.language

Defines the displayed name, color, and optional icon for a language badge in a code block.

Signature

codly.language(
  name: str | content,
  color: paint | none = none,
  icon: str | content | none = none,
)

name is required and named. Fields expecting this type also accept a string as shorthand for name, or a dictionary. Unknown fields are retained.

Fields

The declaration preserves additional, unknown fields. They can provide language-specific overrides to codly.lang fields, such as radius or fill.

Behavior

Use language definitions as values in the languages dictionary passed to codly.lang-set_. The dictionary key must match the raw block’s language tag. The settings apply within the show rule’s scope. A definition’s name, icon, and color customize the badge; an omitted definition falls back to the raw language tag. A definition’s matching codly.lang style fields override the corresponding settings supplied to codly.lang-set_.

Example: Basic Usage

</> Typst source

#import "@preview/codly:2.0.0" as codly

#show: codly.lang-set_(languages: (
  rs: (name: [Rust], color: rgb("b7502a"), icon: "⚙️"),
))
#show raw.where(block: true): codly.new

```rs
fn main() {
    println!("Hello, Rust!");
}
```

Edit & run on your device

Editable Typst source#import "@preview/codly:2.0.0" as codly #show: codly.lang-set_(languages: ( rs: (name: [Rust], color: rgb("b7502a"), icon: "⚙️"), )) #show raw.where(block: true): codly.new ```rs fn main() { println!("Hello, Rust!"); } ```

The highlighted source and output update after you stop typing. Copy code includes your edits.

Run Reset example

OUTPUTPre-rendered default