📘 HTLium

A clean, modern Typst template for school protocols and reports.
Built for the HTL Salzburg — adaptable to any school or course.

✨ Features

• 🎨 Eye-catching cover page with a geometric, color-themed design that you can switch off with a single flag.
• 🌈 Any color scheme — pass any Typst color and the whole document (headings, accents, tables, cover) adapts.
• 🌍 Bilingual — built-in German (de) and English (en) labels for the cover, outlines and bibliography.
• 📑 Automatic front matter — table of contents, list of figures, list of tables and an IEEE bibliography, each toggleable.
• 💬 Ready-made callout boxes — info, warning, note, tip and important, plus a fully custom box.
• 🎯 Styled tables & code — striped, rounded tables out of the box and syntax highlighting via codly.
• 🖼️ Custom logo & header — drop in your school logo; it appears on the cover and in the running header.

🚀 Quick start

Create a new project from the template:

typst init @preview/htlium:1.6.0

Or import it into an existing document:

#import "@preview/htlium:1.6.0": *

#show: body => template(
  body,
  author: "Your Name",
  title: "Sorting Algorithms",
  subtitle: "A comparison of common approaches",
  logo: image("logo.png"),
  class: "3AHIF",
  subject: "Software Engineering",
  school: "HTL Salzburg",
  department: "Computer Science",
)

= My first heading
#lorem(40)

Sensible defaults are set for every option, so the template compiles even with no arguments — but you’ll want to fill in your own details.

⚙️ Configuration

template accepts the following named arguments:

🌈 Color schemes

The color-scheme argument accepts any Typst color and re-themes the entire document — cover graphics, headings, accent bar, and table striping all follow it. Pass a built-in color, build one with rgb("#..."), or use any color expression.

#show: body => template(body, color-scheme: blue)

red (default)	blue	green
purple	orange	teal

Want a school-branded look? Try a custom color such as color-scheme: rgb("#0a5c36").

💬 Callout boxes

The template ships with a set of ready-to-use callouts:

#info-box([Helpful background information.])
#warning-box([Watch out for this!])
#note-box([A small note.])
#tip-box([A handy tip.])
#important-box([Don't miss this.])

Need your own? Build one with custom-box:

#custom-box(
  icon("star", solid: false),  // any heroic icon, or none
  purple,                      // the box color
  "My custom box",             // the title
  [Your content goes here.],   // one or more content blocks
  [$a^2 + b^2 = c^2$],
)

🖼️ Gallery

Cover	Contents	Figures & tables

The full example lives in example/main.typ. Compile it yourself with:

typst compile --root . example/main.typ "example/preview-{p}.png"

📦 Local installation

To use the template without publishing it, copy all files into your Typst local package directory:

~/AppData/Local/typst/packages/local/htlium/1.6.0/   # Windows
~/.local/share/typst/packages/local/htlium/1.6.0/    # Linux
~/Library/Application Support/typst/packages/local/htlium/1.6.0/  # macOS

Then import it with the @local namespace:

#import "@local/htlium:1.6.0": *
#show: body => template(body)

📚 Resources

• Typst documentation
• Typst compiler download
• Typst Universe

📄 License

Released under the MIT License © 2026 Elias Pöschl.