Fix nonce typo
[exsheet.git] / README.markdown
index dcccc4ea22ada40d555f50b848b37044ce1c4858..f5d8c6ef9a2499bbc60110fe3517000ba5d72d38 100644 (file)
@@ -16,11 +16,19 @@ Ich verwende die Klasse für zwei Kategorien von Anwendungsfällen:
 
 ## Installation
 
+Die einfache Lösung ist, dass man `exsheet2.cls` lokal in jedes Verzeichnis
+gibt, wo es verwendet wird, d.h. wo die betreffenden LaTeX Dokumente liegen.
+
 Die nachhaltige Lösung ist das Kopieren der Datei `exsheet2.cls` in ein
 [TEXINPUTS](https://www2.ph.ed.ac.uk/~wjh/tex/documents/environmental.pdf)
-Verzeichnis. Die schlechtere Alternativ ist, dass man `exsheet2.cls` lokal in
-jedes Verzeichnis gibt, wo es verwendet wird, d.h. wo die betreffenden LaTeX
-Dokumente liegen.
+Verzeichnis. Alternativ bietet sich das Klonen dieses Repositories und das
+Verlinken von `exsheet2.cls` in ein Verzeichnis in `TEXINPUTS` an. Das macht
+ein Update über git einfacher.
+
+Das originale Repository findet sich auf
+[git.sthu.org](https://git.sthu.org/?p=exsheet.git;a=summary). Ein Klon auf
+[github.com/shuber2/exsheet](https://github.com/shuber2/exsheet) macht das
+Verwalten von Issues und Pull Requests einfacher.
 
 
 ## Allgemeine Features
@@ -72,10 +80,10 @@ das Datum im ISO-Format erhalten, also yyyy-mm-dd. Wenn kein Datum gesetzt
 wird, dann wird das aktuelle Datum verwendet.
 
 
-## Aufgsabenblätter
+## Aufgabenblätter
 
 Die Klassse `exsheet2` erzeugt ohne weitere Optionen einfache Aufgabenblätter.
-Es werden zwei Sprachen unterstützt und notwendige Packete entsprechend geladen:
+Es werden zwei Sprachen unterstützt und notwendige Pakete entsprechend geladen:
 
 * american
 * german, ngerman
@@ -142,3 +150,22 @@ Zwei Beispiele befinden sich als Demo im Repository:
 
 * [exsheet2-demo-klausur.tex](exsheet2-demo-klausur-en.tex) ist eine deutsche Klausur
 * [exsheet2-demo-klausur-en.tex](exsheet2-demo-klausur-en.tex) ist eine englische Klausur
+
+
+## Abschlussprüfungen
+
+Abschlussprüfungen, etwa eine Bachelorprüfung, ist ähnlich zu einer Klausur,
+mit wenigen Unterschieden. Da die Prüfung in unserer Anwendung für
+Student·innen individualisiert ist, ist der Studierendenname im Titel. Die
+Formularelement für die Benotung und die Studierendeninformationen sind
+obsolet. Die Dauer ist durch den Prüfungsprozess vorgegeben und muss nicht am
+Deckblatt angegeben werden. Auch die Semesterangabe hat keine Bedeutung.
+
+Um diesen Fall abzubilden werden folgende Features unterstützt:
+* Wenn `\duration` oder `\semester` nicht gesetzt werden, dann wird die
+  Information nicht angezeigt.
+* Durch die Option `nostudentinfo` und `nogradeinfo` werden die jeweiligen
+  Formularelemente auf dem Deckblatt nicht angezeigt.
+
+Ein Beipsiel [exsheet2-demo-bapruefung.tex](exsheet2-demo-bapruefung.tex)
+befindet sich im Repository.