summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/changes/userdoc/changes.de.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/changes/userdoc/changes.de.tex')
-rw-r--r--Master/texmf-dist/doc/latex/changes/userdoc/changes.de.tex75
1 files changed, 58 insertions, 17 deletions
diff --git a/Master/texmf-dist/doc/latex/changes/userdoc/changes.de.tex b/Master/texmf-dist/doc/latex/changes/userdoc/changes.de.tex
index 63825f9cc29..f63ad7309d4 100644
--- a/Master/texmf-dist/doc/latex/changes/userdoc/changes.de.tex
+++ b/Master/texmf-dist/doc/latex/changes/userdoc/changes.de.tex
@@ -199,6 +199,9 @@ In diesem Fall gehen Sie bitte zu
Dort finden Sie Links, wie Fehler oder Verbesserungen gemeldet werden können, wie Tips für andere Nutzerinnen angegeben werden können oder wie Sie bei der Entwicklung des Pakets mithelfen können.
+Eine Übersicht über alle mir bekannten Probleme und eventuell vorhandenen Lösungen finden Sie in \autoref{sec:known-problems}.
+Bitte sehen Sie dort zunächst nach, ob Ihr Problem schon bekannt ist und es eine Lösung gibt.
+
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.
@@ -212,25 +215,10 @@ Die Markierung ist eingeschränkt oder nicht möglich für:
\item mehrere Absätze (manchmal)
\end{itemize}
-
Sie können versuchen, solchen Text in eine eigene Datei auszulagern, und diese mit \texttt{input} einzubinden.
Manchmal hilft das, oft ist es einen Versuch wert.
Danke an Charly Arenz für diesen Tip.
-Fußnoten oder Randnotizen werden in bestimmten Umgebungen, \zB Tabellen oder der \emph{tabbing}-Umgebung, nicht korrekt gesetzt.
-Vermeiden Sie das Markup, wenn Sie diese Umgebungen benutzen.
-
-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, die aktuelle Liste finden Sie im Issue-Tracker auf \emph{gitlab}:
-
-\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
@@ -331,6 +319,7 @@ Die Ausgabe ersetzten Texts ist ein Kombination von zugefügtem und gelöschten
\subsubsection{deletedmarkup}
+\label{sec:ui:options:deletedmarkup}
\chinline{usepackage_deletedmarkup_changes}
@@ -505,7 +494,6 @@ Mehrere Optionen oder Angaben mit Sonderzeichen müssen in geschweifte Klammern
\localtableofcontents
\chnewcmd{added}
-\label{sec:ui:cmd:added}
\chinline{added}
@@ -874,6 +862,59 @@ Die folgenden Pakete sind manchmal notwendig und müssen installiert sein, wenn
\end{description}
+%^^A ---- Known problems and solutions
+\cleardoublepage
+\section{Bekannte Probleme und Lösungen}
+\label{sec:known-problems}
+
+In diesem Kapitel sammle ich die häufigsten Probleme und mir dazu bekannte Lösungen.
+Wenn Ihr Problem hier nicht aufgeführt ist, sehen Sie bitte im Issue-Tracker auf gitlab nach, ob das Problem dort beschrieben ist (es gibt eine Suche):
+
+\url{https://gitlab.com/ekleinod/changes/issues}
+
+Wenn das alles zu nichts führt, öffnen Sie bitte ein neues Issue für das Problem, beschreiben Sie das Problem genau und liefern Sie, wenn möglich, eine kleine Beispieldatei mit dem problematischen Verhalten mit.
+
+\subsection{Besondere Inhalte}
+
+Die Änderungsmarkierung von Text funktioniert recht gut, es können auch ganze Absätze markiert werden.
+Die Markierung ist eingeschränkt oder nicht möglich für:
+
+\begin{itemize}
+ \item Abbildungen
+ \item Tabellen
+ \item Überschriften
+ \item manche Kommandos
+ \item mehrere Absätze (manchmal)
+\end{itemize}
+
+Sie können versuchen, solchen Text in eine eigene Datei auszulagern, und diese mit \texttt{input} einzubinden.
+Manchmal hilft das, oft ist es einen Versuch wert.
+Danke an Charly Arenz für diesen Tip.
+
+\subsection{Fußnoten und Randnotizen}
+
+Fußnoten oder Randnotizen werden in bestimmten Umgebungen, \zB Tabellen oder der \emph{tabbing}-Umgebung, nicht korrekt gesetzt.
+Vermeiden Sie das Markup, wenn Sie diese Umgebungen benutzen.
+
+\subsection{Das \chpackage{ulem}-Paket}
+
+Ich verwende standardmäßig das \chpackage{ulem}-Paket für das Durchstreichen von Text.
+Das führt bei manchen Befehlen und Umgebungen zu Problemen, \zB
+
+\begin{itemize}
+ \item im Mathemodus
+ \item bei Verwendung des \chpackage{siunitx}-Pakets
+ \item bei Nutzung der \chcommand{citet}- oder \chcommand{citep}-Befehle
+\end{itemize}
+
+In dem Fall gibt es wenig gute Möglichkeiten, am besten ist es, das Markup für Löschungen selbst zu definieren und das \chpackage{ulem}-Paket zu vermeiden.
+Siehe
+
+\begin{itemize}
+ \item \autoref{sec:ui:options:deletedmarkup}
+ \item \autoref{sec:ui:cmd:setdeletedmarkup}
+\end{itemize}
+
%^^A ---- Authors
\cleardoublepage
\section{Autorinnen und Autoren}
@@ -937,7 +978,7 @@ Dieses Paket besteht aus den Dateien
\>\texttt{source/latex/changes/README}\\
\>\texttt{source/latex/changes/userdoc/*.tex}\\
- \>\texttt{scripts/changes/delcmdchanges.bash}
+ \>\texttt{scripts/changes/pyMergeChanges.py}
\end{tabbing}