<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">\section{Aufgaben}
\label{modul:aufgaben}
Das Modul \module{Aufgaben} ist das umfangreichste Modul des Schule-Pakets. Es umfasst alles, was zum Setzen von verschiedenen ArbeitsblĂ¤ttern, Klausuren, Klassenarbeiten, Lernzielkontrollen\usw. notwendig ist.

Im Kern baut das Modul auf dem Paket \pkg{xsim} auf, sodass alle Funktionen dieses Pakets nutzbar sind.

Die vom Schulepaket gemachten ErgĂ¤nzungen sind voll kompatibel zu \pkg{xsim}, so werden die Hinweise etwa in den Eigenschaften der Aufgaben gespeichert.

\subsection{Aufgaben}

\subsubsection{Befehle}
\begin{commands}
    \command{setzeSymbol}[\marg{Symbol}] kann nur innerhalb der Aufgabenumgebung genutzt werden und stellt der jeweiligen Aufgabe ein Symbol voran. Dies kann etwa genutzt werden, um die Arbeitsform oder bestimmte Aufgabentypen zu kennzeichnen.

    Eine Kombination mit dem Modul \module{Symbole} bietet sich an. So kĂ¶nnte etwa zur Kennzeichnung von HĂ¶raufgaben \verbcode|\setzeSymbol{\symOhr}| genutzt werden.

    Alternativ lĂ¤sst sich das Symbol auch als Eigenschaft der Aufgabe direkt setzen. Dieses erfolgt z.\,B. durch \verbcode|\begin{aufgabe}[symbol=\symOhr]|.

    \command{punkteAufgabe} liefert die Punkte der aktuellen Aufgabe inkl. der Bezeichnung.

    \command{punkteTotal} liefert die Gesamtpunktezahl aller Aufgaben inkl. der Bezeichnung.

    \command{punktuebersicht\sarg}[\oarg{Darstellungsart}]\Default{kurz} setzt eine Ăśbersichtstabelle ĂĽber die in allen Aufgaben erreichbaren Punkte und Zusatzpunkte, sowie einer Leerzeile fĂĽr die erreichten Punkte. Als optionalen Parameter kann zwischen verschiedenen Darstellungen gewĂ¤hlt werden. Alternativ zur Standardoptionen ist \verbcode{default}. Ist die Ăśbersicht als letztes auf den Aufgabenseiten, so kann der optionale Stern gesetzt werden. Dann wird diese Seite als letzte mit Inhalt angenommen.
\end{commands}

\subsubsection{Umgebungen}
\begin{environments}
    \environment{aufgabe\sarg}[\oarg{Optionen}]\envidx{aufgabe}%
        setzt eine Aufgabe. Alle Aufgaben werden automatisch durchnummeriert. Wird der optionale Stern angegeben, wird die Aufgabe als Zusatzaufgabe gesetzt.

        Bei den optionales Argument kĂ¶nnen alle von \pkg{xsim} bereitgestellen Optionen angegeben werden. Dazu gehĂ¶ren unter anderem folgende:
        \begin{options}
            \keyval-{points}{Punkte} legt die Punkte der Aufgabe fest.
            \keyval-{bonus-points}{Zusatzaufgabe} legt die Punkte der Aufgabe fest.
            \keyval{subtitle}{Titel} setzt den Title der Aufgabe.
        \end{options}
\end{environments}

\subsubsection{Aufgabentemplates}
    Die Darstellung der Aufgaben erfolgt auf der Grundlage verschiedener Templates. Das Paket \pkg{schule} liefert dabei folgende Templates mit, die in darunter dargestellt sind.
    \begin{itemize}
        \item \verbcode|schule-binnen|
        \item \verbcode|schule-default|
        \item \verbcode|schule-keinenummer|
        \item \verbcode|schule-keinepunkte|
        \item \verbcode|schule-keintitel|
        \item \verbcode|schule-randpunkte|
        \item \verbcode|schule-tcolorbox|
    \end{itemize}

    \includepdfpage[page=1, scale=0.6, trim={3cm, 16cm, 1cm, 2.5cm}, clip] {beispiel-aufgabentemplates}

    \begin{commands}
        \command{setzeAufgabentemplate}[\marg{Templatename}] setzt das Template mit dem die folgenden Aufgaben dargestellt werden.
        \command{setzeLoesungentemplate}[\marg{Templatename}] setzt das Template mit dem die folgenden LĂ¶sungen dargestellt werden. Diese sind identisch mit denen der Aufgaben.
    \end{commands}

\subsection{Teilaufgaben}

\subsubsection{Befehle}
\begin{commands}
    \command{teilaufgabe}[\oarg{Punkte}] leitet innerhalb einer \env{teilaufgaben}-Umgebung eine Teilaufgabe ein. Teilaufgaben werden mit den Kleinbuchstaben von \textit{a} bis \textit{z} gekennzeichnet.

    Ăśber den optionalen Parameter kann eine Punktzahl angegeben werden.

    \command{teilaufgabeOhneLoesung} Dient als Platzhalter bei Teilaufgaben, bei den keine LĂ¶sung angegeben wird. Die entsprechende Nummer wird bei den LĂ¶sungen nicht aufgefĂĽhrt und die folgende Teilaufgaben bekommt den nĂ¤chsten Buchstaben, so dass es ĂĽbereinstimmt mit der Aufgabenstellung.
\end{commands}

\subsubsection{Umgebung}
\begin{environments}
    \environment{teilaufgaben} bietet die MĂ¶glichkeit, eine Aufgabe in verschiedene Teilaufgaben zu unterteilen.
    \begin{sourcecode}[gobble=8]
        \begin{aufgabe}
            Inhalt...
            \begin{teilaufgaben}
                \teilaufgabe Erstens.
                \teilaufgabe[5] Zweitens.
            \end{teilaufgaben}
        \end{aufgabe}
    \end{sourcecode}
    \hinweis{Teilaufgaben kĂ¶nnen auch in einer \env{loesung}- und \env{bearbeitungshinweis}-Umgebung verwendet werden!}
\end{environments}

\subsection{LĂ¶sungen}

\subsubsection{Paketoptionen}\label{subsubsec:paketoptionen}
\begin{options}
    \keychoice{loesungen}{folgend, keine, seite}\Default{keine}
        legt fest, ob die LĂ¶sungen direkt hinter die Aufgaben, als eigenstĂ¤ndige LĂ¶sungsseite oder gar nicht gesetzt werden.

        \achtung{Die Option \keyis{loesungen}{seite} ist nur fĂĽr eigenstĂ¤ndige Dokumente, \zB\space mit der Dokumentenklasse \cls{scrartcl} gedacht. Sie greift tief in den Ăśbersetzungsprozess ein und ist geeignet Fehler im Zusammenspiel mit anderen Paketen zu provozieren.}
\end{options}

\begin{commands}
    \command{printsolutions} Wenn keine der Standardoptionen genutzt wird, kann der Befehl zur Ausgabe der LĂ¶sungen aus dem \pkg{xsim}-Paket genutzt werden.
\end{commands}

\subsubsection{Umgebungen}
\begin{environments}
    \environment{loesung\sarg}[] wird innerhalb oder direkt hinter einer \env{aufgabe} verwendet, um eine LĂ¶sung dazu anzugeben. Die Inhalte dieser Umgebung werden standardmĂ¤Ăźig nicht gesetzt, sondern durch die entsprechende Konfiguration von \option{loesungen} an der entsprechenden Stelle gesetzt. Wichtig ist, dass bei Zusatzaufgaben auch bei der LĂ¶sung der Stern gesetzt werden muss.

    \begin{sourcecode}[gobble=8]
        \begin{aufgabe}
            Inhalt...
            \begin{teilaufgaben}
                \teilaufgabe Erstens.
                \teilaufgabe[5] Zweitens.
            \end{teilaufgaben}
            \begin{loesung}
                \begin{teilaufgaben}
                    \teilaufgabe Erste LĂ¶sung.
                    \teilaufgabe Zweite LĂ¶sung.
                \end{teilaufgaben}
            \end{loesung}
        \end{aufgabe}
    \end{sourcecode}
\end{environments}

\subsection{LĂĽckentexte}

\subsubsection{Befehle}
\begin{commands}
    \command{luecke}[\oarg{Optionen fĂĽr blank}\marg{LĂ¤nge}]
        Setzt eine LĂĽcke mit der angegebenen LĂ¤nge. Der Befehl nutzt dazu den \cs{blank}-Befehl aus \pkg{xsim}. Mit dem optionalen Parameter kĂ¶nnen zusĂ¤tzliche Optionen an diesen weitergereicht werden, \zB\space kann mit \texttt{style = \choices{line,wave,dline,dotted,dashed}} der Stil der Unterstreichung festgelegt werden.
    \command{textluecke}[\oarg{Optionen fĂĽr blank}\marg{Text}]
        Setzt eine LĂĽcke fĂĽr den angegebenen Text, die LĂ¤nge wird durch den angegebenen Text vorgegeben. StandardmĂ¤Ăźig wird als Korrekturfaktor fĂĽr das handschriftliche AusfĂĽllen $2$ genutzt.

        Der Befehl nutzt dazu den \cs{blank}-Befehl aus \pkg{xsim}. Mit dem optionalen Parameter kĂ¶nnen zusĂ¤tzliche Optionen an diesen weitergereicht werden, \zB\space kann mit \verbcode|style=\dashuline{#1}| eine unterstrichelte Linie gesetzt werden. Mit \texttt{scale = 3} lieĂźe sich der Korrekturfaktor auf $3$ anpassen. Wird als Option \texttt{nichts} angegeben, so wird die LĂĽcke ohne Inhalt und Weite eingesetzt.

        Innerhalb von LĂ¶sungsumgebungen wird der Text in die LĂĽcke eingesetzt.

        %%%%% Mit xsim nicht mĂ¶glich
%     \command{aufgabeLueckentext}[\oarg{Punkte}\marg{LĂĽckentext} \marg{Extras}\oarg{Symbol}\oarg{Optionen fĂĽr die Aufgabenumgebung}]
%         Um LĂĽckentexte mit LĂ¶sungen anzugeben, mĂĽsste der gesamte Text mit den LĂĽcken zweimal im Dokument stehen: einmal in der Aufgaben- und einmal in der LĂ¶sungsumgebung. Um dies einfacher zu gestalten, wurde als AbkĂĽrzung dieser Befehl eingefĂĽhrt, der intern eine entsprechende Aufgaben- und LĂ¶sungsumgebung erzeugt.
%
%         Der Parameter \enquote{Extras} dient dem AnhĂ¤ngen von Inhalten an den Aufgabentext und kann somit etwa fĂĽr Erwartungen und Hinweise genutzt werden.

% \begin{sourcecode}
% \aufgabeLueckentext[4]{
%     Das ist ein total verrĂĽckter \textluecke{LĂĽckentext}. FĂĽr alle
%     \textluecke{Menschen}, die \textluecke{LĂĽcken} lieben.
% }{
%     \begin{erwartungen}
%         \erwartung{fĂĽllt die LĂĽcken richtig aus.}{4}
%     \end{erwartungen}
% }[\symBleistift][name=LĂĽckentext]
% \end{sourcecode}
\end{commands}

\subsection{Multiple-Choice}
Zwar ist es ĂĽber das \module{Format}-Modul mĂ¶glich, einzelne KĂ¤stchen zum Ankreuzen zu setzen. In der Regel sollten allerdings echte Multiple-Choice-Aufgaben vorgezogen werden, da diese besser formatiert werden kĂ¶nnen und sich auch direkt LĂ¶sungen angeben lassen.

\achtung{Die direkte Nutzung der LĂ¶sung funktioniert nur dann, wenn innerhalb einer Aufgabe nur eine einzige Multiple-Choice-Umgebung genutzt wird.}

\subsubsection{Befehle}
\begin{commands}
    \command{choice}[\oarg{richtig}] Innerhalb einer \env{mcumgebung} kĂ¶nnen mit \cs{choice} die einzelnen WahlmĂ¶glichkeiten angegeben werden.

        Falls im optionalen Parameter \cs{mcrichtig} steht, wird die WahlmĂ¶glichkeit als richtig markiert und in LĂ¶sungsumgebungen entsprechend gesetzt.

    \command{mcrichtig} markiert innerhalb einer \env{mcumgebung} eine WahlmĂ¶glichkeit als richtig.

    \command{mcloesung}\sinceversion{0.8.2} kann in einer LĂ¶sung angegeben werden, damit in dieser die Multiple-Choice-Aufgabe mit den korrekten LĂ¶sungen aufgefĂĽhrt wird.
\end{commands}

\subsection{Umgebungen}
    \begin{environments}
        \environment{mcumgebung}[\darg{Spaltenzahl}] ermĂ¶glicht es Multiple-Choice-Aufgaben zu setzen. Wird die Spaltenzahl nicht explizit angegeben, so ist 3 als Default-Wert gesetzt.
    \end{environments}

    \begin{sourcecode}[gobble=8]
        \begin{aufgabe}
            \begin{mcumgebung}(4)
                \choice[\mcrichtig] Erstens
                \choice Zweitens
                \choice[\mcrichtig] Drittens
            \end{mcumgebung}
        \end{aufgabe}
        \begin{loesung}
            \mcloesung
        \end{loesung}
    \end{sourcecode}

\subsection{Bearbeitungshinweise}
Die Bearbeitungshinweise sind dazu gedacht, dass man den Lernenden Tipps zu den Aufgaben mitgibt. Dieses ist z.\,B. bei der Bearbeitung von Leitprogrammen (siehe \ref{typ:Leitprogramm}) der Fall. Dabei ist es angedacht, diese nicht direkt bei den Aufgaben stehen zu haben, sondern an einer anderen Stelle, damit sie nur bei Bedarf genutzt werden.

\subsubsection{Umgebungen}
\begin{environments}
    \environment{bearbeitungshinweis} erlaubt es, zu einzelnen Aufgaben Hinweise anzugeben. Der Hinweis kann dabei fast beliebigen \LaTeX-Code enthalten. Verbatim-Elemente, wie z.\,B. die Verwendung von Quellcode machen an Probleme. Es kann aber \cs{lstinputlisting} genutzt werden.
\end{environments}

\subsubsection{Befehle}
\begin{commands}
    \command{bearbeitungshinweisZuAufgabe}[\oarg{Aufgabentyp}\marg{AufgabenId}]\Default{aufgabe} Setzt die Bearbeitungshinweise fĂĽr die angegebene Aufgabe. Die ID ist dabei fortlaufend ĂĽber alle Aufgabentypen. Der optionale Parameter erlaubt es auch fĂĽr andere Aufgabentypen wie der Zusatzaufgabe mit \verbcode|aufgabe*| den Hinweis direkt auszugeben. Wird als AufgabenId nichts angegeben, so wird die aktuelle Aufgabe genommen.
    \command{bearbeitungshinweisliste} Setzt die Bearbeitungshinweise zu allen Aufgaben als Liste.
\end{commands}</pre></body></html>