diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/changes/userdoc/changes.de.tex')
-rw-r--r-- | Master/texmf-dist/source/latex/changes/userdoc/changes.de.tex | 642 |
1 files changed, 642 insertions, 0 deletions
diff --git a/Master/texmf-dist/source/latex/changes/userdoc/changes.de.tex b/Master/texmf-dist/source/latex/changes/userdoc/changes.de.tex new file mode 100644 index 00000000000..6c71c9cbe0c --- /dev/null +++ b/Master/texmf-dist/source/latex/changes/userdoc/changes.de.tex @@ -0,0 +1,642 @@ +%^^A ---- introduction +\section{Einleitung} + +Dieses Paket dient dazu, manuelle Änderungsmarkierung zu ermöglichen. + +Verbesserungsvorschläge, Gedanken oder Kritik sind willkommen. +Das Paket wird auf \emph{sourceforge} gehalten, bitte gehen Sie zu + +\input{userdoc/url} + +für Quellcodezugang, Fehler- und Featuretracker, Forum etc. +Wenn Sie mich direkt kontaktieren wollen, mailen Sie bitte an \input{userdoc/email}. +Bitte starten Sie Ihr Mail-Subject mit \texttt{[changes]}. + +\begin{quote} + \small\textsc{README:} + Das changes-Paket dient zur manuellen Markierung von geändertem Text, insbesondere Einfügungen, Löschungen und Ersetzungen. + Der geänderte Text wird farbig markiert und, bei gelöschtem Text, durchgestrichen. + Das Paket ermöglicht die freie Definition von Autoren und deren zugeordneten Farben. + Es erlaubt zusätzlich die Änderung des Änderungs-, Autor- und Anmerkungsmarkups. +\end{quote} + + +%^^A ---- usage +\section{Benutzung des \chpackage{changes}-Pakets} +\label{sec:usage} + +In diesem Kapitel wird die Nutzung des \chpackage{changes}-Pakets beschrieben. +Dabei wird ein typischer Anwendungsfall geschildert. +Die ausführliche Beschreibung der Paketoptionen und neuen Befehle finden Sie nicht hier, sondern in \autoref{sec:user}. + +Ausgangslage ist ein Text, an dem Änderungen vorgenommen werden sollen. +Diese Änderungen sollen markiert werden, und zwar für jeden Autor einzeln. +Eine solche Änderungsmarkierung ist z.\,B.\ von WYSIWYG-Textprogrammen wie \emph{LibreOffice}, \emph{OpenOffice} oder \emph{Word} bekannt. + +Zu diesem Zweck wurde das \chpackage{changes}-Paket entwickelt. +Das Paket stellt Befehle zur Verfügung, um verschiedene Autoren zu definieren und Text als zugefügt, gelöscht oder geändert zu markieren. +Um das Paket zu nutzen, müssen Sie folgende Schritte ausführen: +\begin{enumerate} + \item \chpackage{changes}-Paket einbinden + \item Autoren definieren + \item Textänderungen markieren + \item Dokument mit \LaTeX\ setzen + \item Liste von Änderungen anzeigen lassen + \item Markierungen entfernen +\end{enumerate} + +\minisec{\chpackage{changes}-Paket einbinden} + +Um die Änderungsverfolgung zu aktivieren, ist das \chpackage{changes}-Paket wie folgt einzubinden: + +\chcommand{usepackage\{changes\}} + +bzw. + +\chcommand{usepackage[<optionen>]\{changes\}} + +Mit den verfügbaren Optionen bestimmen Sie hauptsächlich das Aussehen der Änderungsmarkierungen. +Sie können das Aussehen der Änderungsmarkierungen auch nach Einbinden des \chpackage{changes}-Pakets verändern. + +Für Details lesen Sie bitte \autoref{sec:user:options} und \autoref{sec:user:customizingoutput}. + +\minisec{Autoren definieren} + +Das \chpackage{changes}-Paket stellt einen vordefinierten anonymen Autor zur Verfügung. +Wenn Sie jedoch die Änderungen per AutorIn verfolgen wollen, müssen Sie die entsprechenden AutorInnen definieren. +Dies geht wie folgt: + +\chcommand{definechangesauthor[<optionen>]\{ID\}} + +Über die ID werden der/die AutorIn und die zugehörigen Textänderungen eindeutig identifiziert. +Optional können Sie einen Namen angeben und dem/der AutorIn eine eigene Farbe zuweisen. + +Für Details lesen Sie bitte \autoref{sec:user:authormanagement}. + +\minisec{Textänderungen markieren} + +Jetzt ist alles vorbereitet, um den geänderten Text zu markieren. +Benutzen Sie bitte je nach Änderung die folgenden Befehle: + +für neu zugefügten Text:\\ +\chcommand{added[<ID>][<Anmerkung>]\{Text\}} + +für gelöschten Text:\\ +\chcommand{deleted[<ID>][<Anmerkung>]\{Text\}} + +für geänderten Text:\\ +\chcommand{replaced[<ID>][<Anmerkung>]\{neuer Text\}\{alter Text\}} + +Die Angabe von Autoren-ID und einer Anmerkung ist optional. + +Für Details lesen Sie bitte \autoref{sec:user:changemanagement}. + +\minisec{Dokument mit \LaTeX\ setzen} + +Nachdem Sie die Änderungen im \LaTeX-Text markiert haben, können Sie sie im erzeugten Dokument sichtbar machen, indem Sie das Dokument ganz normal übersetzen. +Durch die Übersetzung wird der geänderte Text so markiert, wie Sie das mittels der Optionen bzw.\ speziellen Befehle eingestellt haben. + +\minisec{Liste von Änderungen anzeigen lassen} + +Sie können sich eine Liste der Änderungen ausgeben lassen. +Dies erfolgt mit dem Kommando: + +\chcommand{listofchanges} + +Die Ausgabe ist gedacht als Analogon zur Liste von Tabellen oder Abbildungen. +Sie dient dazu, einen schnellen Überblick über Art und Anzahl der Änderungen abhängig von dem/der AutorIn zu bekommen. + +Bei jedem \LaTeX-Lauf werden die Daten für diese Liste in eine Hilfsdatei geschrieben. +Beim nächsten \LaTeX-Lauf werden dann diese Daten genutzt, um die Änderungsliste anzuzeigen. +Daher sind nach jeder Änderung zwei \LaTeX-Läufe notwendig, um eine aktuelle Änderungsliste anzuzeigen. + +\minisec{Markierungen entfernen} + +Oft ist es der Fall, dass die Änderungen eines Dokuments angenommen oder abgelehnt werden und nach diesem Prozess die Änderungsmarkierungen entfernt werden sollen. +Sie können die Ausgabe der Änderungsmarkierungen per Option beim Einbinden des \chpackage{changes}-Pakets unterdrücken: + +\input{userdoc/option_final} + +Für die Entfernung der Markierungen aus dem Quelltext steht ein Script von Silvano Chiaradonna zur Verfügung. +Das Script liegt im Verzeichnis: + +\input{userdoc/path_scripts} + +Das Script entfernt alle Markierungen, es ist nicht möglich, die zu entfernenden Markierungen zu selektieren. + +%^^A ---- limitations +\section{Einschränkungen und Erweiterungsmöglichkeiten} +\label{sec:limitations} + +Das \chpackage{changes}-Paket ist sorgfältig programmiert und getestet worden. +Dennoch kann es vorkommen, dass Fehler im Paket sind, dass die Benutzung problematisch ist oder dass eine Funktion fehlt, die Sie gerne hätten. +In diesem Fall gehen Sie bitte zu + +\input{userdoc/url.tex} + +Dort können Sie Fehler melden, im Forum um Hilfe fragen oder Tips einstellen. +Sie können dort den Quellcode ansehen und nach Ihren Wünschen ändern bzw.\ erweitern. +Ich werde mich dann bemühen, Ihre Änderungen einzuarbeiten. +Sie können als Co-Autor am Paket mitarbeiten, wenn Sie bei \emph{sourceforge} angemeldet sind. + +Sie können mir auch eine Mail schreiben an \href{mailto:ekleinod@edgesoft.de}{ekleinod@edgesoft.de}, in diesem Fall starten Sie bitte Ihr Mail-Subject mit \texttt{[changes]}. + +Die Änderungsmarkierung von Text funktioniert recht gut, es können auch ganze Absätze markiert werden. +Die Markierung von mehreren Absätzen gleichzeitig, von Bildern und Tabellen ist nicht möglich. + +Fußnoten (die standardmäßige Auszeichnung von Anmerkungen) werden in bestimmten Umgebungen, z.\,B.\ Tabellen oder der \emph{tabbing}-Umgebung, nicht korrekt gesetzt, dort erscheinen also Anmerkungen nicht. +Das kann gelöst werden, indem eine andere Annotation von Anmerkungen definiert wird. + +Das Paket bietet Raum für Erweiterungen, die ich ich jedoch nicht selbst programmieren werde (weil mir Zeit und oft auch die Fähigkeit fehlt). +Ich liste hier einige Möglichkeiten auf, eine komplettere Liste finden Sie auf der \emph{sourceforge}-Seite: +\begin{itemize} + \item Auswahl der anzunehmenden/abzulehnenden Änderungen mit entsprechendem Löschen des Textes + \item Markierung von mehreren Absätzen + \item Markierung von Bildern und Tabellen + \item automatische Markierung anhand von diff-Informationen (unter Berücksichtigung der Einschränkungen bzgl.\ Absätzen, Bildern, etc.) + \item Übersetzung der sprachabhängigen Texte und der Nutzerdokumentation in andere Sprachen +\end{itemize} + + + +%^^A ---- user interface +\section{Die Benutzerschnittstelle des \chpackage{changes}-Pakets} +\label{sec:user} + +In diesem Kapitel wird die Nutzerschnittstelle des \chpackage{changes}-Pakets vorgestellt, d.\,h.\ alle Optionen und Kommandos. +Jede Option bzw. jedes neue Kommando werden beschrieben. +Wenn Sie die Optionen und Kommandos im Beispiel sehen wollen, sehen Sie bitte in das Beispielverzeichnis unter + +\input{userdoc/path_examples} + +Die Beispieldateien sind mit der benutzten Option bzw. dem benutzten Kommando benannt. + +Eine Vorbemerkung zum Setzen von ersetztem Text: ersetzter Text wird immer wie folgt gesetzt: \meta{neuer Text}\meta{alter Text}. +Daher gibt es keine Möglichkeit, die Ausgabe ersetzten Texts direkt zu beeinflussen, sondern nur über die Änderung der Ausgabe neuen bzw.\ gelöschten Texts. + +%^^A -- options +\subsection{Paketoptionen} +\label{sec:user:options} + +\subsubsection{draft} + +Die \choption{draft}-Option bewirkt, dass alle Änderungen markiert werden. +Die Änderungsliste kann durch \chcommand{listofchanges} ausgegeben werden. +Diese Option ist automatisch voreingestellt. + +Die Angabe von \choption{draft} in \chcommand{documentclass} wird vom \chpackage{changes}-Paket mitgenutzt. +Die lokale Angabe von \choption{final} überstimmt die Angabe von \choption{draft} in \chcommand{documentclass}. + +\input{userdoc/option_draft} + +\subsubsection{final} + +Die \choption{final}-Option bewirkt, dass alle Änderungsmarkierungen ausgeblendet werden und nur noch der korrekte Text ausgegeben wird. +Die Änderungsliste wird ebenfalls unterdrückt. + +Die Angabe von \choption{final} in \chcommand{documentclass} wird vom \chpackage{changes}-Paket mitgenutzt. +Die lokale Angabe von \choption{draft} überstimmt die Angabe von \choption{final} in \chcommand{documentclass}. + +\input{userdoc/option_final} + +\subsubsection{markup} + +Die \choption{markup}-Option wählt ein vordefiniertes visuelles Markup für geänderten Text. +Das default-Markup wird gewählt, wenn die Option nicht gesetzt wird. +Das mit \choption{markup} gewählte Markup kann mit den spezielleren Optionen \choption{addedmarkup} und/oder \choption{deletedmarkup} geändert werden. + +Die folgenden Werte sind erlaubt: +\begin{description} + \item [\choption{default}] farbige Markierung von zugefügtem Text, gelöschter Text wird durchgestrichen (default-Markup) + \item [\choption{underlined}] zugefügter Text wird unterstrichen, gelöschter Text wird durchgestrichen + \item [\choption{bfit}] fetter zugefügter Text, schräger gelöschter Text + \item [\choption{nocolor}] es werden keine Farben verwendet, zugefügter Text wird unterstrichen, gelöschter Text wird durchgestrichen +\end{description} + +\input{userdoc/option_markup} + +\subsubsection{addedmarkup, deletedmarkup} + +Die \choption{addedmarkup}-Option wählt ein vordefiniertes visuelles Markup für zugefügten Text. +Die \choption{deletedmarkup}-Option wählt analog ein vordefiniertes visuelles Markup für gelöschten Text. +Das default-Markup wird gewählt, wenn die Option nicht gesetzt wird. +Die Optionen \choption{addedmarkup} und \choption{deletedmarkup} überschreiben das mit \choption{markup} gewählte Markup. + +Die folgenden Werte sind erlaubt: +\begin{description} + \item [\choption{none}] kein Markup -- Beispiel (default-Markup für zugefügten Text) + \item [\choption{uline}] unterstrichener Text -- \uline{Beispiel} + \item [\choption{uuline}] doppelt unterstrichener Text -- \uuline{Beispiel} + \item [\choption{uwave}] gewellt unterstrichener Text -- \uwave{Beispiel} + \item [\choption{dashuline}] gestrichelt unterstrichener Text -- \dashuline{Beispiel} + \item [\choption{dotuline}] gepunktet unterstrichener Text -- \dotuline{Beispiel} + \item [\choption{sout}] durchgestrichener Text -- \sout{Beispiel} (default-Markup für gelöschten Text) + \item [\choption{xout}] schräg durchgestrichener Text -- \xout{Beispiel} + \item [\choption{bf}] fetter Text -- \textbf{Beispiel} + \item [\choption{it}] italic Text -- \textit{Beispiel} + \item [\choption{sl}] schräger Text -- \textsl{Beispiel} + \item [\choption{em}] hervorgehobener Text -- \emph{Beispiel} +\end{description} + +\input{userdoc/option_addedmarkup} +\input{userdoc/option_deletedmarkup} + + +\subsubsection{authormarkup} + +Die \choption{authormarkup}-Option wählt ein vordefiniertes visuelles Markup für die Autor-Identifizierung. +Das default-Markup wird gewählt, wenn die Option nicht gesetzt wird. + +Die folgenden Werte sind erlaubt: +\begin{description} + \item [\choption{superscript}] hochgestellter Text -- Text\textsuperscript{Beispiel} (default-Markup) + \item [\choption{subscript}] tiefgestellter Text -- Text\textsubscript{Beispiel} + \item [\choption{brackets}] Text in Klammern -- Text(Beispiel) + \item [\choption{footnote}] Text in einer Fußnote -- Text\footnote{Beispiel} +\end{description} + +\input{userdoc/option_authormarkup} + + +\subsubsection{authormarkupposition} + +Die \choption{authormarkupposition}-Option gibt an, wo die Autor-Identifizierung gesetzt wird. +Der default-Wert wird gewählt, wenn die Option nicht gesetzt wird. + +Die folgenden Werte sind erlaubt: +\begin{description} + \item [\choption{right}] rechts vom Text -- Text\textsuperscript{Beispiel} (default value) + \item [\choption{left}] links vom Text -- \textsuperscript{Beispiel}Text +\end{description} + +\input{userdoc/option_authormarkupposition} + + +\subsubsection{authormarkuptext} + +Die \choption{authormarkuptext}-Option gibt an, was für die Autor-Identifizierung genutzt wird. +Der default-Wert wird gewählt, wenn die Option nicht gesetzt wird. + +Die folgenden Werte sind erlaubt: +\begin{description} + \item [\choption{id}] Autoren-ID -- Text\textsuperscript{ID} (default-Wert) + \item [\choption{name}] Autorenname -- Text\textsuperscript{Autorenname} +\end{description} + +\input{userdoc/option_authormarkuptext} + + +\subsubsection{ulem} + +Optionen für das \chpackage{ulem}-Paket können als Parameter der \choption{ulem}-Option angegeben werden. +Zwei oder mehr Optionen müssen in geschweifte Klammern gesetzt werden. + +\input{userdoc/option_ulem} + + +\subsubsection{xcolor} + +Optionen für das \chpackage{xcolor}-Paket können als Parameter der \choption{xcolor}-Option angegeben werden. +Zwei oder mehr Optionen müssen in geschweifte Klammern gesetzt werden. + +\input{userdoc/option_xcolor} + + +%^^A ---- change management + +\subsection{Änderungsmanagement} +\label{sec:user:changemanagement} + +\subsubsection{\chcommand{added}} +\DescribeMacro{\added} + +Der Befehl \chcommand{added} markiert zugefügten Text. +Der neue Text wird als notwendiges Argument in geschweiften Klammern übergeben. +Optional können eine Autor-ID sowie eine Anmerkung übergeben werden. +Die Autor-ID muss mit einer mit dem \chcommand{definechangesauthor}-Befehl definierten ID übereinstimmen. +Soll nur eine Anmerkung (ohne Autor) eingegeben werden, so ist statt des Autors ein leeres Argument zu übergeben. + +\begin{chusage} + \>\chcommand{added[\meta{Autor-ID}][\meta{Anmerkung}]\{\meta{neuer Text}\}}\\ + \usageexample + \>\texttt{Das ist \chcommand{added}[EK]\{neuer\} Text.}\\ + \>Das ist \added[EK]{neuer} Text.\\ + \>\texttt{Das ist \chcommand{added}[EK][muss rein]\{neuer\} Text.}\\ + \>Das ist \added[EK][muss rein]{neuer} Text.\\ + \>\texttt{Das ist \chcommand{added}[][anonym]\{neuer\} Text.}\\ + \>Das ist \added[][anonym]{neuer} Text. +\end{chusage} + + +\subsubsection{\chcommand{deleted}} +\DescribeMacro{\deleted} + +Der Befehl \chcommand{deleted} markiert gelöschten Text. +Argumente: siehe \chcommand{added}. + +\begin{chusage} + \>\chcommand{deleted[\meta{Autor-ID}][\meta{Anmerkung}]\{\meta{gelöschter Text}\}}\\ + \usageexample + \>\texttt{Das ist \chcommand{deleted}[][obsolet]\{schlechter\} Text.}\\ + \>Das ist \deleted[][obsolet]{schlechter} Text. +\end{chusage} + + +\subsubsection{\chcommand{replaced}} +\DescribeMacro{\replaced} + +Der Befehl \chcommand{replaced} markiert geänderten Text. +Notwendige Argumente sind der neue sowie der alte Text. +Optionale Argumente: siehe \chcommand{added}. + +\begin{chusage} + \>\chcommand{replaced[\meta{Autor-ID}][\meta{Anmerkung}]\{\meta{neuer Text}\}\{\meta{alter Text}\}}\\ + \usageexample + \>\texttt{Das ist \chcommand{replaced}[EK]\{schöner\}\{schlechter\} Text.}\\ + \>Das ist \replaced[EK]{schöner}{schlechter} Text. +\end{chusage} + + +\subsubsection{\chcommand{listofchanges}} +\DescribeMacro{\listofchanges} + +Der Befehl \chcommand{listofchanges} gibt eine Liste der Änderungen aus. +Im ersten \LaTeX-Lauf wird eine Hilfsdatei angelegt, deren Daten im zweiten Durchlauf eingebunden werden. +Für eine aktuelle Liste der Änderungen sind daher zwei \LaTeX-Läufe notwendig. + +\input{userdoc/command_listofchanges} + + +%^^A ---- Author management + +\subsection{Autorenverwaltung} +\label{sec:user:authormanagement} + +\subsubsection{\chcommand{definechangesauthor}} +\DescribeMacro{\definechangesauthor} + +Der Befehl \chcommand{definechangesauthor} definiert einen neuen Autor/eine neue Autorin für Änderungen. +Es muss eine eindeutige Autor-ID angegeben werden, die keine Sonder- oder Leerzeichen enthalten darf. +Optional kann eine Farbe und ein Name angegeben werden. +Wird keine Farbe angegeben, wird schwarz genutzt. +Der AutorInnenname wird in der Änderungsliste sowie im Markup benutzt, im Markup jedoch nur, wenn die entsprechende Option gesetzt ist. + +\input{userdoc/command_definechangesauthor} + + +%^^A ---- Adaptation of the output +\subsection{Anpassung der Ausgabe} +\label{sec:user:customizingoutput} + +\subsubsection{\chcommand{setaddedmarkup}} +\DescribeMacro{\setaddedmarkup} + +Der Befehl \chcommand{setaddedmarkup} legt fest, wie neuer Text ausgezeichnet wird. +Ohne andere Definition gilt, dass der Text farbig oder je nach Option \choption{markup} bzw.\ \choption{addedmarkup} erscheint. + +Werte für Definition: beliebige \LaTeX-Befehle, der neue Text wird mit "`\#1"' eingesetzt. + +\input{userdoc/command_setaddedmarkup} + + +\subsubsection{\chcommand{setdeletedmarkup}} +\DescribeMacro{\setdeletedmarkup} + +Der Befehl \chcommand{setdeletedmarkup} legt fest, wie gelöschter Text ausgezeichnet wird. +Ohne andere Definition gilt, dass der Text durchgestrichen oder je nach Option \choption{markup} bzw.\ \choption{deletedmarkup} erscheint. + +Werte für Definition: beliebige \LaTeX-Befehle, der gelöschte Text wird mit "`\#1"' eingesetzt. + +\input{userdoc/command_setdeletedmarkup} + + +\subsubsection{\chcommand{setauthormarkup}} +\DescribeMacro{\setauthormarkup} + +Der Befehl \chcommand{setauthormarkup} legt fest, wie der Autortext im Text angezeigt wird. +Ohne andere Definition gilt, dass der Autor hochgestellt erscheint. + +Werte für Definition: beliebige \LaTeX-Befehle, der Autortext wird mit "`\#1"' eingesetzt. + +\input{userdoc/command_setauthormarkup} + + +\subsubsection{\chcommand{setauthormarkupposition}} +\DescribeMacro{\setauthormarkupposition} + +Der Befehl \chcommand{setauthormarkupposition} legt fest, auf welcher Seite der Autor im Text angezeigt wird. +Ohne andere Definition gilt, dass der Autor rechts von den Änderungen erscheint. + +Mögliche Werte: \emph{left} == links von den Änderungen; alles andere: rechts + +\input{userdoc/command_setauthormarkupposition} + + +\subsubsection{\chcommand{setauthormarkuptext}} +\DescribeMacro{\setauthormarkuptext} + +Der Befehl \chcommand{setauthormarkuptext} legt fest, welche Information des Autors im Text angezeigt wird. +Ohne andere Definition gilt, dass die Autor-ID genutzt wird. + +Mögliche Werte: \emph{name} == Autorenname; alles andere: Autor-ID + +\input{userdoc/command_setauthormarkuptext} + + +\subsubsection{\chcommand{setremarkmarkup}} +\DescribeMacro{\setremarkmarkup} + +Der Befehl \chcommand{setremarkmarkup} legt fest, wie die Anmerkungen im Text angezeigt werden. +Ohne andere Definition gilt, dass die Anmerkungen als Fußnote gesetzt werden. + +Werte für Definition: beliebige \LaTeX-Befehle, die Autor-ID wird mit "`\#1"' benutzt, der Anmerkungstext mit "`\#2"'. +Über die Autor-ID kann mit \texttt{Changes@Color\#1} die Farbe des Autors benutzt werden. + +\input{userdoc/command_setremarkmarkup} + + +\subsubsection{\chcommand{setlocextension}} +\DescribeMacro{\setlocextension} + +Der Befehl \chcommand{setlocextension} legt das Suffix der Hilfsdatei für die Änderungsliste (loc-Datei\footnote{% + "`loc"' steht dabei für "`list of changes"'. +}) fest. +Ohne andere Definition gilt das Suffix "`\texttt{loc}"'. +Im unten angegebenen Beispiel würde für "`\texttt{foo.tex}"' eine Hilfsdatei erzeugt werden, die "`\texttt{foo.changes}"' statt des Standardnamens "`\texttt{foo.loc}"' hieße. + +\input{userdoc/command_setlocextension} + + +%^^A ---- other +\subsection{Sonstige neue Befehle} +\label{sec:user:other} + +\subsubsection{\chcommand{textsubscript}} +\DescribeMacro{\textsubscript} + +\LaTeX\ stellt den Befehl \chcommand{textsuperscript} zur Verfügung, nicht jedoch dessen Gegenstück \chcommand{textsubscript}. +Falls der Befehl nicht bereits definiert ist, wird er durch das \chpackage{changes}-Paket zur Verfügung gestellt. +Ist er bereits definiert, wird er nicht geändert. +\begin{chusage} + \>\chcommand{textsubscript\{\meta{Text}\}}\\ + \usageexample + \>\texttt{Jetzt kommt ein \chcommand{textsubscript\{tiefgestellter\}} Text.}\\ + \>Jetzt kommt ein \textsubscript{tiefgestellter} Text. +\end{chusage} + + +%^^A ---- packages +\subsection{Benötigte Pakete} +\label{sec:user:packages} + +Das \chpackage{changes}-Paket bindet bereits Pakete ein, die für die Funktion des Pakets notwendig sind. +Eine genauere Beschreibung der einzelnen Pakete ist in der Dokumentation der Pakete selbst zu finden. + +Die folgenden Pakete sind zwingend notwendig und müssen für die Nutzung des \chpackage{changes}-Pakets installiert sein: +\begin{description} + \item [xifthen] stellt eine verbesserte \texttt{if}-Abfrage sowie eine \texttt{while}-Schleife zur Verfügung + \item [xkeyval] Eingabe von Optionen mit Werteübergabe +\end{description} + +Die folgenden Pakete sind manchmal notwendig und müssen installiert sein, wenn sie über die entsprechende Option genutzt werden: +\begin{description} + \item [pdfcolmk] wird geladen, wenn farbiger Text genutzt wird (default Markup); löst das Problem farbigen Texts über Seitenumbrüche hinweg (bei pdflatex) + \item [ulem] wird geladen, wenn Text durchgestrichen oder ausge-x-t wird (default Markup) + \item [xcolor] wird geladen, wenn farbiger Text genutzt wird (default Markup) +\end{description} + + +%^^A ---- Authors +\section{Autoren} +\label{sec:authors} + +Am \chpackage{changes}-Paket haben mehrere Autoren mitgewirkt. +Dies sind in alphabetischer Reihenfolge: +\input{userdoc/authors} + + +%^^A ---- Versions +\section{Versionen} +\label{sec:versions} + +\minisec{Version 0.6.0} + +Datum: 11.\,01.~2012 +\begin{itemize} + \item Italienische Übersetzungen der captions von Daniele Giovannini + \item neues Nutzerinterface für das Setzen von Optionen sowie die Definition von Markup und Autoren + \item Restrukturierung und Codeverbesserung + \item verbesserte Dokumentation mit typischem Anwendungsfall + \item Beispieldateien für alle Optionen und Befehle + \item Anmerkunge sind per Default nicht mehr farbig +\end{itemize} + +\minisec{Version 0.5.4} + +Datum: 25.\,04.~2011 +\begin{itemize} + \item Auslagerung der Nutzerdokumentation in eigene Datei + \item Änderung der default-Sprache zu Englisch + \item neues Script, um die \chpackage{changes}-Befehle zu löschen von Silvano Chiaradonna +\end{itemize} + +\minisec{Version 0.5.3} + +Datum: 22.\,11.~2010 +\begin{itemize} +\item Dokumentoptionen von \chcommand{documentclass} werden ebenfalls genutzt (Vorschlag und Code von Steve Wolter) +\end{itemize} + +\minisec{Version 0.5.2} + +Datum: 10.\,10.~2007 +\begin{itemize} + \item Paketoptionen der Pakete \chpackage{ulem} und \chpackage{xcolor} werden weitergeleitet +\end{itemize} + +\minisec{Version 0.5.1} + +Datum: 27.\,08.~2007 +\begin{itemize} + \item gelöschter Text wieder durchgestrichen, Paket \chpackage{ulem} funktioniert; ausgrauen hat nicht funktioniert +\end{itemize} + +\minisec{Version 0.5} + +Datum: 26.\,08.~2007 +\begin{itemize} + \item keine Nutzung des \chpackage{arrayjob}-Pakets mehr, dadurch Fehler im Zusammenspiel mit \chpackage{array} behoben + \item auf UTF-8-encoding umgestellt + \item keine Nutzung des \chpackage{soul}-Pakets mehr, dadurch Fehler im Zusammenspiel UTF-8-encoding behoben + \item gelöschter Text durch grauen Hintergrund visualisiert (es gibt bisher kein ordentliches Durchstreichen bei UTF-8-Nutzung) + \item neues optionales Argument für Autorenname + \item farbige Liste der Änderungen + \item loc-Format geändert + \item englische Doku verbessert +\end{itemize} + +\minisec{Version 0.4} + +Datum: 24.\,01.~2007 +\begin{itemize} + \item \chpackage{pdfcolmk} eingebunden, um Problem mit farbigem Text bei Seitenumbrüchen zu lösen + \item \chcommand{setremarkmarkup} um Autor-ID erweitert, um Anmerkung farbig setzen zu können + \item Anmerkungen werden in der Fußnote farbig gesetzt + \item erste Version für das CTAN +\end{itemize} + +\minisec{Version 0.3} + +Datum: 22.\,01.~2007 +\begin{itemize} + \item englische Nutzerdokumentation + \item Befehl \chcommand{changed} ersetzt durch \chcommand{replaced} + \item verbesserte \choption{final}-Option: kein zusätzlicher Leerraum +\end{itemize} + +\minisec{Version 0.2} + +Datum: 17.\,01.~2007 +\begin{itemize} + \item Bezeichnungen auch bei fehlendem \chpackage{babel}-Paket eingeführt + \item \chcommand{setauthormarkup}, \chcommand{setlocextension}, \chcommand{setremarkmarkup} für Einstellungen + \item Beispieldateien generiert + \item LPPL eingefügt +\end{itemize} +Beseitigte Fehler +\begin{itemize} + \item Fehler mit \chpackage{ifthen}-Paketplazierung behoben + \item bei Liste war immer "`Eingefügt"' eingestellt, behoben + \item Autorausgabe war buggy (\chcommand{if}-Abfrage nicht einwandfrei) +\end{itemize} + +\minisec{Version 0.1} + +Datum: 16.\,01.~2007 +\begin{itemize} + \item initiale Version + \item Befehle \chcommand{added}, \chcommand{deleted} und \chcommand{changed} +\end{itemize} + + +%^^A ---- copyright, license +\section{Weitergabe, Copyright, Lizenz} + +\input{userdoc/copyright} + +Dieses Paket darf unter der "`\LaTeX\ Project Public License"' Version~1.3 oder jeder späteren Version weitergegeben und/oder geändert werden. +Die neueste Version dieser Lizenz steht auf \url{http://www.latex-project.org/lppl.txt} Version~1.3 und spätere Versionen sind Teil aller \LaTeX-Distributionen ab Version~2005/12/01. + +Dieses Paket besitzt den Status "`maintained"' (verwaltet). +Der aktuelle Verwalter dieses Pakets ist Ekkart Kleinod. + +Dieses Paket besteht aus den Dateien + +\input{userdoc/files_original} + +und den generierten Dateien + +\input{userdoc/files_generated} + +%^^A end of user documentation + |