<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">\part{Allgemeines}

\section{Allgemeines zum Paket}

\subsection{Wichtiger Hinweis zur neuen Version}
	Das Schule-Paket wurde vollstÃ¤ndig Ã¼berarbeitet. Diese
	Version enthÃ¤lt grundlegende, strukturelle VerÃ¤nderungen.
	So wird unter anderem die Vielzahl an Dokumentenklassen
	stark reduziert und die Konfiguration erfolgt nun Ã¼ber
	Paketoptionen.

	Dies fÃ¼hrt zu groÃŸen VerÃ¤nderungen der Schnittstelle. Die
	neue Version ist damit \textbf{nicht kompatibel} zu allen
	vorhergehenden Versionen. Es besteht allerdings ein
	\textbf{KompatibilitÃ¤tsmodus}, der automatisch fÃ¼r alle alten
	Dokumentenklassen aktiv ist. Alte Dokumente lassen sich somit
	weiterhin setzen, die Schnittstelle wird aber nicht
	weiterentwickelt. Bestehende Fehler werden in der alten
	Version nicht behoben.

	Diese Ã„nderungen ermÃ¶glichen die LÃ¶sung einiger bestehender
	Probleme (u.\,a. Quelltexte in Aufgaben und LÃ¶sungen).
	ZusÃ¤tzlich wurde die Nutzung des Pakets vereinheitlicht und
	die Nutzung in anderen Dokumentenklassen ermÃ¶glicht, sodass
	etwa die Aufgabenumgebungen auch in Beamer-PrÃ¤sentationen
	Ã¼bernommen werden kÃ¶nnen. Klausuren unterstÃ¼tzen nun die
	automatische Erzeugung von Erwartungshorizonten.

	Eine weitere groÃŸe VerÃ¤nderung ist die Ausgliederung der
	ausbildungsrelevanten Teile (Unterrichtsbesuche,
	StundenverlÃ¤ufe etc.) des Pakets. In der
	Vergangenheit hat sich gezeigt, dass sich die Anforderungen der
	verschiedenen, an der Lehrerbildung beteiligten Stellen
	stark voneinander unterscheiden.
	Daher werden die entsprechenden Funktionen des Pakets
	ausgegliedert, sodass sie einfach in eigenen Dokumenten
	genutzt werden kÃ¶nnen. Die bestehenden Vorlagen werden
	als eigenstÃ¤ndige Klassen mitgeliefert.

\subsection{Manuelle Installation}
	Um die Pakete und Klassen nutzen zu kÃ¶nnen, gibt es drei
	Varianten. In der folgenden Beschreibung dieser MÃ¶glichkeiten
	wird von einer standardisierten \LaTeX-Installation
	ausgegangen -- weitere Hinweise kÃ¶nnen der Dokumentation der
	jeweiligen \TeX-Distribution entnommen werden:

\begin{description}
\item[Global]
	FÃ¼r die globale/systemweite Installation der Pakete und
	Klassen	mÃ¼ssen diese in das globale \LaTeX-Verzeichnis der
	\TeX-Installation kopiert werden: unter Linux in der Regel
	\texttt{/usr/share/texmf/tex/latex/}. In diesem kann ein
	weiteres Verzeichnis wie z.\,B. \texttt{schule} angelegt
	werden, in das alle Dateien des Schulepakets
	kopiert werden.

	Damit die Quellen anschlieÃŸend dem System bekannt sind, muss
	der Cache von \LaTeX{} neu aufgebaut werden. Bei den meisten
	Linux-Installationen geschieht dieses durch den Aufruf von
	\texttt{texhash}.

\item[Benutzer]
	Damit ein Nutzer auf die Quellen zugreifen kann,
	mÃ¼ssen diese im Benutzerverzeichnis (Home directory)
	abgelegt werden. Dies geschieht durch das Kopieren der
	Pakete und Klassen in das Verzeichnis
	\texttt{texmf/tex/latex/} im Benutzerverzeichnis, das ggf.
	erst angelegt werden muss. Auch hier sollte -- wie bei der
	globalen Installation -- ein eigenes Unterverzeichnis
	angelegt werden.

\item[Lokal]
	Um die Klassen und Pakete ohne weitere Installation
	nutzen zu kÃ¶nnen, ist es darÃ¼ber hinaus mÃ¶glich, die
	benÃ¶tigten Dateien in das Verzeichnis zu kopieren, in dem
	die Datei liegt, die Ã¼bersetzt werden soll. Dies ist jedoch
	aufgrund des Umfangs des Schulepakets weniger empfehlenswert.
\end{description}

\subsubsection{Voraussetzungen}
Ein Grund fÃ¼r die Nutzung des Schule-Pakets und der damit
verbundenen speziellen Klassen und Pakete liegt
darin, viele der hÃ¤ufig  benÃ¶tigten Pakete zusammen zu fassen.
Daher mÃ¼ssen diese fÃ¼r die Benutzung vorhanden sein. Die meisten
sind Standardpakete, die mit jeder normalen Installation
mitgeliefert sind.
Es folgt eine Aufstellung der Voraussetzungen
fÃ¼r das Paket \pkg{schule} und die vorhandenen Module.
Mit einem Stern (*) markierte Pakete sind im Paket
\pkg{schule} bereits enthalten:
\begin{multicols}{4}
	\begin{smallitemize}
		\item \pkg{amsmath}
		\item \pkg{babel}
		\item \pkg{environ}
		\item \pkg{fontenc}
		\item \pkg{forarray}
		\item \pkg{graphicx}
		\item \pkg{hyperref}
		\item \pkg{ifthen}
		\item \pkg{inputenc}
		\item \pkg{pgfopts}
		\item \pkg{schulealt} *
		\item \pkg{tikz}
		\item \pkg{xcolor}
		\item \pkg{xparse}
		\item \pkg{xstring}
		\item \pkg{zref-totpages}
	\end{smallitemize}
\end{multicols}

Folgende Pakete werden zusÃ¤tzlich fÃ¼r das Fach \enquote{Informatik} benÃ¶tigt:
\begin{multicols}{4}
	\begin{smallitemize}
		\item \pkg{listings}
		\item \pkg{pgf-umlcd}
		\item \pkg{pgf-umlsd}
		\item \pkg{relaycircuit} *
		\item \pkg{struktex}
		\item \pkg{syntaxdi}
	\end{smallitemize}
\end{multicols}

Folgende TikZ-Bibliotheken werden fÃ¼r das Fach \enquote{Informatik} benÃ¶tigt:
\begin{smallitemize}
	\item er
\end{smallitemize}

Folgende Pakete werden zusÃ¤tzlich fÃ¼r das Fach \enquote{Physik} benÃ¶tigt:
\begin{multicols}{4}
	\begin{smallitemize}
	\item \pkg{circuittikz}
	\item \pkg{units}
	\item \pkg{mhchem}
	\end{smallitemize}
\end{multicols}

Folgende Pakete werden zusÃ¤tzlich fÃ¼r das Fach \enquote{Geschichte} benÃ¶tigt:
\begin{multicols}{4}
	\begin{smallitemize}
		\item \pkg{uni-wtal-ger}
		\item \pkg{marginnote}
	\end{smallitemize}
\end{multicols}

Folgende Pakete werden zusÃ¤tzlich fÃ¼r das Modul \enquote{Aufgaben} benÃ¶tigt:
\begin{multicols}{4}
	\begin{smallitemize}
		\item \pkg{xsim}
		\item \pkg{utfsym} *
	\end{smallitemize}
\end{multicols}

Folgende Pakete werden zusÃ¤tzlich fÃ¼r das Modul \enquote{Format} benÃ¶tigt:
\begin{multicols}{4}
	\begin{smallitemize}
		\item \pkg{amssymb}
		\item \pkg{array}
		\item \pkg{colortbl}
		\item \pkg{csquotes}
		\item \pkg{ctable}
		\item \pkg{enumitem}
		\item \pkg{eurosym}
		\item \pkg{graphicx}
		\item \pkg{longtable}
		\item \pkg{multicol}
		\item \pkg{multirow}
		\item \pkg{setspace}
		\item \pkg{tikz}
		\item \pkg{ulem}
		\item \pkg{utfsym} *
		\item \pkg{xspace}
	\end{smallitemize}
\end{multicols}

Folgende Pakete werden zusÃ¤tzlich fÃ¼r das Modul \enquote{Symbole} benÃ¶tigt:
\begin{multicols}{4}
	\begin{smallitemize}
		\item \pkg{utfsym} *
	\end{smallitemize}
\end{multicols}

Folgende Pakete werden zusÃ¤tzlich fÃ¼r das Modul \enquote{Texte} benÃ¶tigt:
\begin{multicols}{4}
	\begin{smallitemize}
		\item \pkg{lineno}
		\item \pkg{multicol}
	\end{smallitemize}
\end{multicols}

Folgende Pakete werden zusÃ¤tzlich fÃ¼r das Modul \enquote{Texte} benÃ¶tigt:
\begin{multicols}{4}
    \begin{smallitemize}
        \item \pkg{standalone}
    \end{smallitemize}
\end{multicols}


Folgende TikZ-Bibliotheken werden fÃ¼r das Zusatzpaket \pkg{relaycircuit} benÃ¶tigt:
\begin{multicols}{4}
	\begin{smallitemize}
		\item arrows
		\item scopes
		\item shadows
		\item shapes.misc
	\end{smallitemize}
\end{multicols}

\subsection{BegriffsklÃ¤rungen}
	\label{sec:begriffe}
	\begin{description}
		\item[Zusatzpaket]
			Das Paket \pkg{schule} liefert einige \LaTeX-Pakete mit,
			die fÃ¼r das Paket entwickelt wurden, aber von diesem
			unabhÃ¤ngig nutzbar sind.

			Diese Pakete werden im Folgenden als Zusatzpaket
			bezeichnet.

		\item[Modul]
			Im Gegensatz zu einem Zusatzpaket ist ein Modul
			enger mit dem Hauptpaket verzahnt. Es lÃ¤sst sich nicht
			unabhÃ¤ngig von diesem nutzen.

			Module bestehen aus einer oder mehreren
			\LaTeX-Quelldateien, die in das Paket eingebunden werden.

			Siehe auch die Beschreibung in der
			Entwicklungsdokumentation im
			\prettyref{sec:devmoduleModul}.

		\item[Fachmodul]
			Ein Fachmodul ist Ã¤hnlich aufgebaut wie ein	normales
			Modul fÃ¼r das Schulepaket, wird allerdings fÃ¼r
			fachspezifische Erweiterungen genutzt und erfÃ¼llt somit
			einen anderen Zweck.

			Siehe auch die Beschreibung in der
			Entwicklungsdokumentation im
			\prettyref{sec:devmoduleFachmodul}.

		\item[Dokumenttyp]
			Ein Dokumenttyp ist Ã¤hnlich aufgebaut wie ein normales
			Modul fÃ¼r das Schulepaket, wird allerdings fÃ¼r
			typspezifische Erweiterungen genutzt und erfÃ¼llt somit
			einen anderen Zweck.

			Siehe auch die Beschreibung in der
			Entwicklungsdokumentation im
			\prettyref{sec:devDokumenttyp}.

	\end{description}

\subsection{Arten der Nutzung}
	\subsubsection{Nutzung fÃ¼r Dokumente}
		Wenn zumindest ein \option{typ} in den Paketoptionen angegeben
		wird, werden viele Module und mit diesen auch viele externe
		Pakete geladen und konfiguriert, von denen einige auch die
		grundlegende Struktur der zu setzenden Dokumente verÃ¤ndern.

		AuÃŸerdem werden Entscheidungen fÃ¼r das Aussehen der Dokumente
		getroffen. Man hat hier noch viele Freiheiten, ist jedoch auf
		die grundlegenden Vorgaben des Schule-Pakets festgelegt.

		Dies kann auch zu InkompatibilitÃ¤ten mit bestimmten
		Dokumentenklassen oder externen Paketen fÃ¼hren, \zB\space
		kÃ¶nnten Option-Clashes auftreten.

	\subsubsection{Eingebettete Nutzung}
		Es trat immer wieder der Wunsch auf, dass Funktionen aus dem
		Schulepaket auch in anderen Dokumenten oder gar in
		Dokumentenklassen oder anderen Paketen nutzen zu kÃ¶nnen.

		Das war aus den oben genannten GrÃ¼nden schwierig. Inzwischen
		ist dies mÃ¶glich, in dem man beim Laden des Pakets die Option
		\keyis{typ}{ohne} angibt.

		Damit wird das Paket in einen \enquote{minimalinvasiven} Modus
		geschaltet, der nur die nÃ¶tigsten Module lÃ¤dt und so wenig
		Vorgaben macht wie mÃ¶glich.

		Weitere Module kÃ¶nnen dann natÃ¼rlich geladen werden.

	\subsubsection{Nutzung Ã¼ber die Dokumentenklassen}
		Die Nutzungsvariante mit den wenigsten Freiheiten ist die
		Ã¼ber eine der Dokumentenklassen. Anpassungen sind hier nur
		sehr eingeschrÃ¤nkt mÃ¶glich und es werden sehr viele Vorgaben
		gemacht. Sie ist allerdings gleichzeitig die Variante, bei
		der man am wenigsten konfigurieren und eigene Einstellungen
		vornehmen muss. Siehe auch \prettyref{subsubsec:paketoptionen}.

\subsection{Kompilieren der Dokumente}
	Das Schulepaket ist fÃ¼r die Nutzung von \texttt{pdflatex}
	optimiert und wurde nur damit getestet.

	Aufgrund des komplexen Aufbaus kann es besonders bei der Nutzung
	des Moduls \module{Aufgaben} notwendig sein, mindestens zwei
	LÃ¤ufe von \texttt{pdflatex} durchzufÃ¼hren. Dies liegt daran, das
	eine Menge Zwischendateien mit Punkten und anderen Metadaten zu
	den Aufgaben erstellt werden mÃ¼ssen und dann damit Berechnungen
	durchgefÃ¼hrt werden.

	Es kann deshalb passieren, dass nach der Ã„nderung der Anzahl der
	Aufgaben der erste Durchlauf mit sehr vielen Fehlern fehlschlÃ¤gt.
</pre></body></html>