vorlagen-muendliche-pruefungen

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

README.md (5980B)

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