vorlagen-muendliche-pruefungen/muendliche-pruefung/README.md

# Vorlagen mündliche Prüfung (Bachelor, Master, Diplom) in Typst

Dieser Fragebogen gibt den KommilitonInnen, die nach Dir die Prüfung ablegen
wollen, einen Einblick in Ablauf und Inhalt der Prüfung. Das erleichtert die
Vorbereitung.

Für Informationen zu dem Textsatzsystem Typst am besten in die [Dokumentation](https://typst.app/docs/)
schauen.

## Nutzung

Es ist der Typst-Compiler nötig. Dieser ist für eine vielzahl an Betriebssystemen
verfügbar.

Zum Erstellen des Dokumentes müssen lediglich die Argumente in der Datei
`main.typ` ausgefüllt werden.

```typst
#import "lib.typ": exam-report, event, KIND

#show: exam-report.with(
  study: "",                                 // Studiengang
  lecture: "",                               // Fach
  kind: KIND.NONE,                           // Prüfungsart KIND.{WAHLPFLICHT, VERTIEFUNGSFACH, ERGAENZUNGSFACH}
  date: datetime(year: 0, month: 1, day: 1), // Prüfungsdatum
  examiner: "",                              // PrüferIn (Prof)
  assistant: "",                             // BeisitzerIn
  grade_received: 0.0,                       // Note
  grade_reasonable: "",                      // War die Note angemessen?
  exam_duration: duration(minutes: 0),       // Prüfungsdauer
  attendance: (
  /* Veranstaltung, Dozent(in), Jahr, regelmäßig besucht? */
    event(name: "", lecturer: "", semester: "", did_attend: ""),
    event(name: "", lecturer: "", semester: "", did_attend: ""),
    event(name: "", lecturer: "", semester: "", did_attend: ""),
    event(name: "", lecturer: "", semester: "", did_attend: ""),
  ),
  attendance_worth: [
    // Hat sich der Besuch / Nichtbesuch der Veranstaltung für dich gelohnt?
    // Hier ist Platz für deinen Kommentar:
  ],
  preparation_time: [
    // Wie lange und wie hast du dich alleine oder mit anderen auf die Prüfung vorbereitet?
    // Hier ist Platz für deinen Kommentar:
  ],
  agreements: [
    // Fanden vor der Prüfung Absprachen zu Form oder Inhalt statt? Wurden sie eingehalten?
    // Hier ist Platz für deinen Kommentar:
  ],
  preparations: [
    // Welche Tipps zur Vorbereitung kannst du geben?
    // Hier ist Platz für deinen Kommentar:
  ],
  examiner_behavior: [
    // Wie war der Prüfungsstil des Prüfers / der Prüferin?
    // Hier ist Platz für deinen Kommentar:
  ],
  examiner_recommendation: (none, [          // true, false
    // Kannst du ihn / sie weiterempfehlen? Warum?
    // Hier ist Platz für deinen Kommentar:
  ]),
  examinee_behavior: [
    // Kannst Du Ratschläge für das Verhalten in der Prüfung geben?
    // Hier ist Platz für deinen Kommentar:
  ],
)

// Schreibe bitte möglichst viele Fragen und Antworten auf.
// Hier ist Platz für deinen Kommentar:
```

Um den Fragebogen schlussendlich zu bauen führt man folgenden Befehl aus:
```sh
typst compile main.typ
```

Für Personen, welche in die Struktur des Dokuments eintauchen wollen gibt es die
Datei `muendliche-pruefung.typ`. Diese ist der Inspiration in TeX vom Aufbau
ähnlich. Das befüllen des Fragebogens ist hier etwas schwerer, weil erst die
richtige Stelle im Code gefunden werden muss.

Um die Änderungen direkt beim Speichern zu sehen, kann man folgenden Befehl
nutzen:
```sh
typst watch muendliche-pruefung.typ
```

## Hintergrund

Diese Vorlage ist stark Inspiriert von der [Protokollvorlage mündliche Prüfung
(TeX)](https://legacy.fsmi.org/Pruefungen/Vorlagen/Info/muendlich-neu.tar.gz)
von der Liste an [Protokollvorlagen](https://www.fsmi.org/studium/pruefungen/muendliche-pruefungen/#protokoll-vorlagen)
der Fachschaft Mathematik/Informatik des KIT.

Bei der Erstellung der Vorlage wurde darauf geachtet, dass die PDF-Ausgabe von
Typst möglichst ähnlich zu der PDF-Ausgabe der Inspiration in TeX ist. Dabei
werden diverse Layoutelemente von Typst verwendet, welche das Layout mit Tabellen in
TeX ersetzen.