0.0.1 • Published 8 years ago

@miguelfranken/tutorial v0.0.1

Weekly downloads
-
License
GPL-3.0
Repository
github
Last release
8 years ago

Anfertigung von Übungsblättern oder deren Bearbeitung

Die Dokumentenklasse tutorial ermöglicht die unkomplizierte Anfertigung von Übungsblättern oder deren Bearbeitung. Nach dem Prinzip DRY (don't repeat yourself) werden statische Informationen, die in jedem Übungsblatt oder deren Bearbeitung vorkommen, zentral in einer Konfigurationsdatei gespeichert. Die Dokumentenklasse liest diese Informationen aus und formatiert das Übungsblatt oder deren Bearbeitung ohne den Aufruf eines einzigen Kommandos. Neben statischen Informationen wie Name der Lehrveranstaltung, gibt es die Möglichkeit vorbereitete Stylesheets auszuwählen. Diese formatieren die statischen Informationen ansprechend oder eigene zu erstellen.

Beispiel

Siehe pdf für ein gerendertes Übungsblatt.

Siehe Unterordner example für ein beispielhaften Workspace.

Installation

Vorbereitung

Lehrveranstaltungsinformationen wie Titel der Lehrveranstaltung oder Liste aller Gruppenmitglieder werden in einer Datei lv.tex gespeichert. Für jede Lehrveranstaltung ex. genau eine solche Datei, welche stets im selben Verzeichnis wie die tex-Dateien für die Übungsblätter liegen oder im übergeordneten Ordner. Empfehlenswert ist es zusätzlich die tex-Dateien für die Übungsblättern oder deren Bearbeitung in eigene Ordner zu speichern, da bei der Kompilierung der tex-Dateien sehr viel output entsteht.

Empfohlene Ordnerstruktur:

.
+-- tutorial.cls
+-- lv.tex
|
+-- styles
|   +-- solution1.tex
|   +-- answer1.tex
|
|
+-- u1
|   +-- blatt01.tex
|   +-- blatt01.pdf
|
+-- u2
    +-- blatt02.tex
    +-- blatt02.pdf

Konfiguration

Statische Informationen und Konfigurationen werden in einer Datei lv.tex gespeichert. Die Möglichkeiten der Konfiguration sind den folgenden Tabelle zu entnehmen.

Konfiguration von statischen Inhalten

Beide Modi

KommandoBeschreibung
\moduletitle{<string>}Lehrveranstaltungstitel
\addauthor{<name>}Fügt einen Autor ein ohne Matrikelnr.
\addauthor{<name>}{<matrikelnr>} Fügt einen Autor ein mit Matrikelnr. und Trennzeichen studentnumberdelimiter
\university{<str>}Universität

Modus answer

KommandoBeschreibung
\tutoriumnumber{<number>}Nummer des Tutoriums
\tutorium{<name>}Name des Tutors

Modus question

KommandoBeschreibung
\chair{<str>}Lehrstuhl
Konfiguration der Formatierung
KommandoBeschreibung
\authordelimiter{<delimiter>}Trennstring zwischen Autoren
\studentnumberdelimiter{<delimiter>}Trennstringzwischen Name und Matrikelnr eines Autors
\heading{<string>}Überschrift
\subheading{<string>}Unterüberschrift. Beinhaltet oft \@moduletitle.
\answernumber{\roman{answernumber}}Ändert nur die Darstellung der Aufgabennummer
\answerlabel{<str>}Ändert die Darstellung der Aufgabenlabels
\answernumber{\xxx{answernumber}}Ausgabe der Nummern für Aufgaben
\answerlabel{<str>}Label für Aufgaben. Beinhaltet oft \@answernumber

Erstellen von Übungsblättern

Wie oben geschildert erzeugen wir für jedes neue Übungsblatt bzw. deren Bearbeitung einen neuen Ordner. Diesen nennen wir beispielsweise u3, wenn wir eine Bearbeitung für die dritte Übung in unserem Workspace erstellen wollen. Wir erzeugen eine in diesem Ordner befindliche neue tex-Datei blatt03.tex.

Skelett:

\documentclass[12pt]{../../tutorial}

\begin{document}
  % Inhalt
\end{document}

Erstellen eigener Stylesheets

Kommandos zur Ausgabe von Konfiguration

Zu fast jedem Kommando \xxx{<args>} zur Konfiguration von Inhalt oder zur Konfiguration der Formatierung gibt es ein äquivalent \@xxx um die Informationen, die ein Benutzer definiert hat, oder die Standardeinstellungen, welche die Dokumentenklasse liefert, auszulesen.

KommandoBeschreibung
\@authorsAusgabe der Autoren als Zeichenkette formatiert als vertikale Liste
\@authors[horizontal]Ausgabe der Autoren als Zeichenkette formatiert als horizontale Liste
\@moduletitleAusgabe des Lehrveranstaltungstitels
\@answernumberAusgabe der aktuellen Aufgabennummer
\@answerlabelAusgabe des aktuellen Aufgabenlabels

Aufbau eines Sytlesheets