vorlagen-muendliche-pruefungen

git clone git://source.orangerot.dev/university/vorlagen-muendliche-pruefungen.git
Log | Files | Refs | README

README.md (6563B)

      1 # Vorlagen mündliche Prüfung (Bachelor, Master, Diplom) in Typst
      2 
      3 Dieser Fragebogen gibt den KommilitonInnen, die nach Dir die Prüfung ablegen
      4 wollen, einen Einblick in Ablauf und Inhalt der Prüfung. Das erleichtert die
      5 Vorbereitung.
      6 
      7 Für Informationen zu dem Textsatzsystem Typst am besten in die [Dokumentation](https://typst.app/docs/)
      8 schauen.
      9 
     10 Die Vorlagen werden [hier](https://source.orangerot.dev/university/vorlagen-muendliche-pruefungen) entwickelt.
     11 
     12 ## Nutzung
     13 
     14 Es ist der Typst-Compiler nötig. Dieser ist für eine vielzahl an Betriebssystemen
     15 verfügbar.
     16 
     17 Zum Erstellen des Dokumentes müssen lediglich die Argumente in der Datei
     18 `main.typ` ausgefüllt werden.
     19 
     20 ```typst
     21 #import "lib.typ": exam-report, event, KIND
     22 
     23 #show: exam-report.with(
     24   study: "",                                 // Studiengang
     25   lecture: "",                               // Fach
     26   kind: KIND.NONE,                           // Prüfungsart KIND.{WAHLPFLICHT, VERTIEFUNGSFACH, ERGAENZUNGSFACH}
     27   date: datetime(year: 0, month: 1, day: 1), // Prüfungsdatum
     28   examiner: "",                              // PrüferIn (Prof)
     29   assistant: "",                             // BeisitzerIn
     30   grade_received: 0.0,                       // Note
     31   grade_reasonable: "",                      // War die Note angemessen?
     32   exam_duration: duration(minutes: 0),       // Prüfungsdauer
     33   attendance: (
     34   /* Veranstaltung, Dozent(in), Jahr, regelmäßig besucht? */
     35     event(name: "", lecturer: "", semester: "", did_attend: ""),
     36     event(name: "", lecturer: "", semester: "", did_attend: ""),
     37     event(name: "", lecturer: "", semester: "", did_attend: ""),
     38     event(name: "", lecturer: "", semester: "", did_attend: ""),
     39   ),
     40   attendance_worth: [
     41     // Hat sich der Besuch / Nichtbesuch der Veranstaltung für dich gelohnt?
     42     // Hier ist Platz für deinen Kommentar:
     43   ],
     44   preparation_time: [
     45     // Wie lange und wie hast du dich alleine oder mit anderen auf die Prüfung vorbereitet?
     46     // Hier ist Platz für deinen Kommentar:
     47   ],
     48   agreements: [
     49     // Fanden vor der Prüfung Absprachen zu Form oder Inhalt statt? Wurden sie eingehalten?
     50     // Hier ist Platz für deinen Kommentar:
     51   ],
     52   preparations: [
     53     // Welche Tipps zur Vorbereitung kannst du geben?
     54     // Hier ist Platz für deinen Kommentar:
     55   ],
     56   examiner_behavior: [
     57     // Wie war der Prüfungsstil des Prüfers / der Prüferin?
     58     // Hier ist Platz für deinen Kommentar:
     59   ],
     60   examiner_recommendation: (none, [          // true, false
     61     // Kannst du ihn / sie weiterempfehlen? Warum?
     62     // Hier ist Platz für deinen Kommentar:
     63   ]),
     64   examinee_behavior: [
     65     // Kannst Du Ratschläge für das Verhalten in der Prüfung geben?
     66     // Hier ist Platz für deinen Kommentar:
     67   ],
     68 )
     69 
     70 // Schreibe bitte möglichst viele Fragen und Antworten auf.
     71 // Hier ist Platz für deinen Kommentar:
     72 ```
     73 
     74 Um den Fragebogen schlussendlich zu bauen führt man folgenden Befehl aus:
     75 ```sh
     76 typst compile main.typ
     77 ```
     78 
     79 Für Personen, welche in die Struktur des Dokuments eintauchen wollen gibt es die
     80 Datei `muendliche-pruefung.typ`. Diese ist der Inspiration in TeX vom Aufbau
     81 ähnlich. Das befüllen des Fragebogens ist hier etwas schwerer, weil erst die
     82 richtige Stelle im Code gefunden werden muss.
     83 
     84 Um die Änderungen direkt beim Speichern zu sehen, kann man folgenden Befehl
     85 nutzen:
     86 ```sh
     87 typst watch muendliche-pruefung.typ
     88 ```
     89 
     90 ## Hintergrund
     91 
     92 Diese Vorlage ist stark Inspiriert von der [Protokollvorlage mündliche Prüfung
     93 (TeX)](https://legacy.fsmi.org/Pruefungen/Vorlagen/Info/muendlich-neu.tar.gz)
     94 von der Liste an [Protokollvorlagen](https://www.fsmi.org/studium/pruefungen/muendliche-pruefungen/#protokoll-vorlagen)
     95 der Fachschaft Mathematik/Informatik des KIT.
     96 
     97 Bei der Erstellung der Vorlage wurde darauf geachtet, dass die PDF-Ausgabe von
     98 Typst möglichst ähnlich zu der PDF-Ausgabe der Inspiration in TeX ist. Dabei
     99 werden diverse Layoutelemente von Typst verwendet, welche das Layout mit Tabellen in
    100 TeX ersetzen.
    101 
    102 ## Lizenz
    103 
    104 Das Projekt steht unter der MIT Lizenz.
    105 
    106 ```
    107 MIT License
    108 
    109 Copyright (c) 2025 Gero Beckmann <orangerot@orangerot.dev>
    110 
    111 Permission is hereby granted, free of charge, to any person obtaining a copy
    112 of this software and associated documentation files (the "Software"), to deal
    113 in the Software without restriction, including without limitation the rights
    114 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
    115 copies of the Software, and to permit persons to whom the Software is
    116 furnished to do so, subject to the following conditions:
    117 
    118 The above copyright notice and this permission notice shall be included in all
    119 copies or substantial portions of the Software.
    120 
    121 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
    122 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
    123 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
    124 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
    125 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
    126 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
    127 SOFTWARE.
    128 ```
    129 
    130 Die Dateien `muendliche-pruefung.typ` und `main.typ` stehen unter der
    131 MIT No Attribution Lizenz (MIT-0).
    132 
    133 ```
    134 MIT No Attribution
    135 
    136 Copyright (c) 2025 Gero Beckmann <orangerot@orangerot.dev>
    137 
    138 Permission is hereby granted, free of charge, to any person obtaining a copy
    139 of this software and associated documentation files (the "Software"), to deal
    140 in the Software without restriction, including without limitation the rights
    141 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
    142 copies of the Software, and to permit persons to whom the Software is
    143 furnished to do so.
    144 
    145 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
    146 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
    147 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
    148 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
    149 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
    150 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
    151 SOFTWARE.
    152 ```
    153 
    154 Das Logo der Fachschaft Mathematik/Informatik (FSMI) des KIT wird in diesem
    155 Projekt verwendet und ist deren urheberrechtliches Eigentum. Alle Rechte liegen
    156 bei der FSMI. Die Nutzung gilt nur in den von der FSMI festgelegten Bedingugen.
    157 
    158 ## Kontakt
    159 
    160 Gero Beckmann - orangerot@orangerot.dev
    161 
    162 Projekt: https://source.orangerot.dev/university/vorlagen-muendliche-pruefungen
    163