Auf Deutsch lesen: README.de.md — the German version is the one most users of this package will want.

Single-page training record sheet (Ausbildungsnachweis) for the German apprenticeship system (Ausbildung) — as a weekly report (Wochenbericht), a daily report (Tagesbericht), or a cover sheet (Deckblatt).

Every chamber of commerce (IHK), employer and vocational school (Berufsschule) wants the record book (Berichtsheft) slightly differently: with or without hours (Stunden), one row per day or one bullet list per week, two signature fields or four, “Tätigkeitsbericht” here and “Betriebliche Tätigkeiten” there. So instead of one fixed form, this package gives you the parts: every field is optional and appears only once filled, every label can be overridden, and fonts, colours and spacing are exposed as parameters. Adapt the sheet to whatever your employer expects without rebuilding the layout — for any apprentice (Azubi), in any trade.

Sections size themselves to their content: where there is text, the box is exactly as tall as the text; where there is none, a fixed-height writing area is left for filling in by hand.

A note on language. The output, the labels and the parameter names are all German, because the document itself is a German administrative form. English renderings below are explanations, not names — the German term in parentheses is the actual thing, and it is what appears on the page and in your code.

Quick start

#import "@preview/azubinachweis:0.1.0": nachweis

#show: nachweis.with(
  name: "Max Mustermann",
  ausbildungsjahr: "1. Ausbildungsjahr",
  kalenderwoche: "37",
  jahr: "2026",
  schulbericht: (
    "Erstes Musterthema des Berufsschulunterrichts wurde behandelt",
    "Zweites Musterthema mit praktischen Übungen am Musterbeispiel",
  ),
)

- Einführung in den ersten Musterbereich des Ausbildungsbetriebs
- Bearbeitung einer Musteraufgabe zur Einschätzung der Vorkenntnisse
- Teilnahme an einer Musterbesprechung des Musterteams

The document body becomes the activity report (Tätigkeitsbericht). Every other section is passed as an argument.

Sections as content blocks

If you would rather write ordinary Typst markup than strings in arrays, append the sections as content blocks to the call, in the order they appear in the document:

#nachweis(name: "Max Mustermann", kalenderwoche: "38", jahr: "2026")[
  + Erste Mustertätigkeit mit *Auszeichnung*
  + Zweite Mustertätigkeit
][
  - Erstes Musterthema
  - Zweites Musterthema
]

This gives you numbering, emphasis, links, footnotes and code inside the report text, with nothing to escape. An empty block [] skips a section, and named arguments still work alongside:

#nachweis(taetigkeiten: ("From an array",))[][
  - This school report comes from the second block
]

Both spellings are equivalent; #show: acts as a single first block. So what nachweis receives as the document body is the activity report (Tätigkeitsbericht).

That is also the minimal setup: title line, name and training year (Ausbildungsjahr), the activity report (Tätigkeitsbericht), the school report (Schulbericht), an empty area for the trainer’s remarks (Bemerkungen) and two signature fields. Nothing more is needed — everything else (hours, instruction periods, employer, trainer, further signatures) appears only once passed. For even less, drop ausbildungsjahr; to lose the header table entirely, drop name too and set the title with titel.

What the package provides

The three document functions can be called either with #show: ….with(..) or directly with content blocks — both are equivalent.

Examples

Each example is available as source and as a finished PDF in examples/.

Minimal

The base layout with no extras: name, training year (Ausbildungsjahr), calendar week (Kalenderwoche) and year, plus the three sections. A weekly report (Wochenbericht) needs no more than this.

minimal.typ · PDF

Content blocks

The same four entries, but with the sections as content blocks after the call — with numbering, emphasis and code inside the report text.

content-blocks.typ · PDF

Weekly report with everything

All header rows, per-section hours (Stunden), the additional section for instruction periods and in-house lessons (Unterweisungen, betrieblicher Unterricht) and four signature fields — including the legal guardian (Gesetzlicher Vertreter) and the vocational school (Berufsschule). The two-column header (kopfspalten: 2) keeps it all on one page.

weekly-report.typ · PDF

Daily report

One table row per date, with weekday (Tag), hours column (Stunden) and a total row (Gesamt).

daily-report.typ · PDF

Cover sheet

Title page of the record book (Berichtsheft) with all master data.

cover-sheet.typ · PDF

Custom appearance

Same structure, different design: serif font, blue borders, coloured header cells, larger writing areas and custom labels.

custom-style.typ · PDF

nachweis — weekly report (Wochenbericht)

Header data (Kopfdaten)

Empty fields do not appear in the table.

Content

Every content parameter accepts three forms:

schulbericht: "No school this week",                  // a single sentence
schulbericht: ("First point", "Second point"),        // a bullet list
schulbericht: [Arbitrary #strong[markup]],            // your own content

Or as a content block after the call — see Sections as content blocks.

Structure and labels

Appearance

tagesbericht — daily report (Tagesbericht)

Recommended by the chambers for the skilled trades and technical occupations (gewerblich-technische Ausbildungsberufe), where the weekly report (Wochenbericht) is the usual choice for commercial ones (kaufmännische).

Takes every parameter of nachweis (except unterweisungen) plus:

Each day is a dictionary. tag (weekday) and stunden (hours) are optional — if no day has them, that column is dropped.

tage: (
  (
    datum: "07.09.2026",      // date
    tag: "Montag",            // weekday
    inhalt: ("Erste Mustertätigkeit", "Zweite Mustertätigkeit"),   // activities
    stunden: 8,               // hours
  ),
  (datum: "08.09.2026", tag: "Dienstag", inhalt: "Eine Mustertätigkeit", stunden: 8),
)

deckblatt — cover sheet (Deckblatt)

Labels and appearance as for nachweis; titelgroesse is 22pt here.

Overriding labels

standard-bezeichnungen holds every piece of text in the layout. Individual entries are replaced via bezeichnungen:

#show: nachweis.with(
  bezeichnungen: (
    taetigkeiten: "Betriebliche Tätigkeiten",
    schule: "Themen des Berufsschulunterrichts",
    bemerkungen: "Sichtvermerk",
    stunden: "Stunden",
  ),
)

Keys: name, ausbildungsjahr, zeitraum, abteilung, beruf, fachrichtung, betrieb, ausbilder, heft, adresse, geburtsdatum, beginn, ende, taetigkeiten, unterweisungen, schule, bemerkungen, weiteres, datum, tag, taetigkeit, stunden, summe, unterschrift-zusatz, deckblatt-titel.

This is also the way to run the sheet in another language: replace the labels and keep the layout.

Glossary

Fonts

The layout is designed for a humanist sans-serif and looks, in order, for Arial, Helvetica, Liberation Sans, DejaVu Sans. If none of them is present — in the web app, for instance — Typst silently falls back to Libertinus Serif; the document stays correct but looks different. Fonts cannot be shipped inside a package, so either install one of those families (or upload it to your web app project), or pick a family you already have:

#show: nachweis.with(
  schrift: ("Inter", "Libertinus Serif"),
  // … the remaining arguments
)

Managing several weeks

One file per week (kw36.typ, kw37.typ, … for Kalenderwoche), each with its own #show call. Build one:

typst compile kw37.typ

Or all of them:

for f in kw*.typ; do typst compile "$f"; done

When it does not fit on one page

Adjust in this order:

1. kopfspalten: 2 — halves the height of the header table
2. luft: 0.6cm — tighter spacing between sections
3. mindesthoehe: 1.5cm and unterschrifthoehe: 1.5cm — smaller writing areas
4. schriftgroesse: 9.5pt

Licence

MIT — see LICENSE.