summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/schule/doc/allgemeines.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/schule/doc/allgemeines.tex')
-rw-r--r--macros/latex/contrib/schule/doc/allgemeines.tex108
1 files changed, 54 insertions, 54 deletions
diff --git a/macros/latex/contrib/schule/doc/allgemeines.tex b/macros/latex/contrib/schule/doc/allgemeines.tex
index 23b8234935..bce613ed24 100644
--- a/macros/latex/contrib/schule/doc/allgemeines.tex
+++ b/macros/latex/contrib/schule/doc/allgemeines.tex
@@ -5,10 +5,10 @@
\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
+ 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
@@ -16,7 +16,7 @@
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.
+ Version nicht behoben.
Diese Änderungen ermöglichen die Lösung einiger bestehender
Probleme (u.\,a. Quelltexte in Aufgaben und Lösungen).
@@ -43,7 +43,7 @@
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
@@ -52,8 +52,8 @@
\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.
-
+ 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
@@ -85,8 +85,8 @@ 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
+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}
@@ -109,7 +109,7 @@ Mit einem Stern (*) markierte Pakete sind im Paket
\end{smallitemize}
\end{multicols}
-Folgende Pakete werden zusätzlich für das Fach \enquote{Informatik} benötigt:
+Folgende Pakete werden zusätzlich für das Fach \enquote{Informatik} benötigt:
\begin{multicols}{4}
\begin{smallitemize}
\item \pkg{listings}
@@ -117,7 +117,7 @@ Folgende Pakete werden zusätzlich für das Fach \enquote{Informatik} benötigt:
\item \pkg{pgf-umlsd}
\item \pkg{relaycircuit} *
\item \pkg{struktex}
- \item \pkg{syntaxdi} *
+ \item \pkg{syntaxdi}
\end{smallitemize}
\end{multicols}
@@ -143,7 +143,7 @@ Folgende Pakete werden zusätzlich für das Fach \enquote{Geschichte} benötigt:
\end{smallitemize}
\end{multicols}
-Folgende Pakete werden zusätzlich für das Modul \enquote{Aufgaben} benötigt:
+Folgende Pakete werden zusätzlich für das Modul \enquote{Aufgaben} benötigt:
\begin{multicols}{4}
\begin{smallitemize}
\item \pkg{xsim}
@@ -151,7 +151,7 @@ Folgende Pakete werden zusätzlich für das Modul \enquote{Aufgaben} benötigt:
\end{smallitemize}
\end{multicols}
-Folgende Pakete werden zusätzlich für das Modul \enquote{Format} benötigt:
+Folgende Pakete werden zusätzlich für das Modul \enquote{Format} benötigt:
\begin{multicols}{4}
\begin{smallitemize}
\item \pkg{amssymb}
@@ -173,14 +173,14 @@ Folgende Pakete werden zusätzlich für das Modul \enquote{Format} benötigt:
\end{smallitemize}
\end{multicols}
-Folgende Pakete werden zusätzlich für das Modul \enquote{Symbole} benötigt:
+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:
+Folgende Pakete werden zusätzlich für das Modul \enquote{Texte} benötigt:
\begin{multicols}{4}
\begin{smallitemize}
\item \pkg{lineno}
@@ -212,78 +212,78 @@ Folgende TikZ-Bibliotheken werden für das Zusatzpaket \pkg{relaycircuit} benöt
\subsection{Begriffsklärungen}
\label{sec:begriffe}
\begin{description}
- \item[Zusatzpaket]
+ \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
+
+ 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
+ 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
+
+ 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
+ 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
+
+ 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
+
+ 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
@@ -291,17 +291,17 @@ Folgende TikZ-Bibliotheken werden für das Zusatzpaket \pkg{relaycircuit} benöt
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
+ 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
+ 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
+
+ Es kann deshalb passieren, dass nach der Änderung der Anzahl der
Aufgaben der erste Durchlauf mit sehr vielen Fehlern fehlschlägt.