% Die .bm-Datei wird von powerdot erzeugt.
% rubber: clean $base.bm $base.vrb
% rubber: watch $base.bm $base.toc

\RequirePackage[ngerman]{babel}

\documentclass[mode=present,display=slides,style=fyma]{powerdot}
  % mode=present: generate a presentation
  % mode=handout: generate a handout (no visual effect)
  % mode=print: generate a document for printing with the slides
  % nopagebreak: allow more than two slides per page on handout
  % display=slidesnotes: include slides + notes in output
  % display=slides: output only slides
  % display=notes: output only notes
  % clock: insert a clock on slides

\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{textcomp}
\usepackage{amssymb}
\usepackage{marvosym}

\usepackage{fixltx2e}
\usepackage{fancyvrb}

\let\checkmark\relax            % checkmark is already defined somewhere else
\usepackage{dingbat}
\usepackage{booktabs}
\usepackage{array}

\pdsetup{lf={-- Erstellt mit Jörg's\LaTeX{}mode -- Schiftsatz und Effekte
  von powerdot und \LaTeX{} --}}

\newcommand*{\ltxcmd}[1]{\texttt{\textbackslash{}#1}}
\newcommand*{\todo}[1]{\textcolor{red}{todo: #1}}

% alle Verbatim mit kleiner Schrift
\fvset{fontsize=\small}

\DefineVerbatimEnvironment{dokument}{Verbatim}%
                          {label=Dokument,frame=lines,numbers=left}
\DefineVerbatimEnvironment{fehler}{Verbatim}{label=Fehlermeldung,frame=lines}

\begin{document}

\title{Arbeiten mit \LaTeX{}}
\author{Jörg Sommer
  \href{mailto:joerg@alea.gnuu.de}{\nolinkurl{<joerg@alea.gnuu.de>}}\\
  \url{http://www.lug-jena.de/tex/}}
\date{3.\,Mai~2007}

\maketitle

\section{Dokumentation}

\begin{slide}{Dokumentation}
  \begin{itemize}
   \item zu (fast) allen Paketen existiert eine Dokumentation
   \item Nachteil/Vorteil: großteils in Englisch \pause
   \item Google, typische Schlagworte: „latex“ mit Befehl, Paket oder Umgebung
    \pause
    % enumerate, textit, tableofcontents, author, tabular, acronym
   \item für Pakete gut geeigenet: \texttt{texdoc} auf der Kommandozeile
    (Eingabeaufforderung) mit/ohne Option \texttt{-l}/\texttt{-s}; für
    Mik\TeX{} gibt es zusätzlich \texttt{mthelp} \pause
    % acronym, apacite, booktabs
   \item Hilfe im TeXnicCenter oder info-Seite unter Linux
  \end{itemize}
\end{slide}

\begin{slide}[toc={typ.\,Dokumentation}]{Typische Dokumentationen}
  \begin{description}
   \item[Symbole \textnormal{(\S, \textvisiblespace, \checkmark, \IroningI):}]
    symbols-a4 \pause
   \item[KOMA-Script \textnormal{(scrartcl, scrreprt):}] scrguide \pause
    % Inhaltsverzeichnis, Kapitel 3, Abschnitt 3.6.4
   \item[Bilder:] l2picfaq
   \item[Typographie \textnormal{(Striche, Punkte, Leerzeichen):}] typokurz
   \item[Mathematik:] Mathmode und amsldoc
   \item[\textsc{Bib}\TeX{}:] btxdoc
  \end{description}
\end{slide}

\begin{slide}[toc={Weitere Hilfe}]{Weiterführende Hilfe und Beantwortung von Fragen}
  \begin{itemize}
   \item Google, speziell Google Groups \url{http://groups.google.de} \pause
   \item Deutsche TeX-FAQ: \url{http://www.dante.de/faq/de-tex-faq/} \pause
   \item The visual \LaTeX{} FAQ: \texttt{texdoc} visualFAQ \pause
    % Seite 11
   \item Die Newsgroup \href{news:de.comp.text.tex}{de.comp.text.tex}, bei
    Google \url{http://groups.google.de/group/de.comp.text.tex}
  \end{itemize}
\end{slide}

\section{Fehlermeldungen}

\begin{slide}{Fehlermeldungen}
  \begin{itemize}
   \item sind oft kryptisch \pause
   \item immer Zeile genannt, in der Fehler erkannt wurde; aber Fehler kann
    auch davor sein! \pause
   \item verschiedene Arten von Meldungen:
    \begin{description}
     \item[Fehler:] \TeX{} konnte nicht fortsetzen
     \item[Warnungen:] Hinweise auf Probleme, die aber nicht kritisch sind
     \item[Boxen:] wenn Text über Rand hinausragt oder große Lücken im Text
      sind, entstehen über-/untervolle Boxen; können mit Klassenoption
      \texttt{draft} als schwarze Balken sichbar gemacht werden; beseitigen
      durch Umstrukturierung des Textes
    \end{description}
  \end{itemize}
\end{slide}

\begin{slide}[method=direct,toc={Fehler 1}]{Beispiele für Fehlermeldungen I.}
  \begin{dokument}[gobble=2]
  \documentclass{scrartcl}
  \begin{document}
  In dieser Zeile steckt \emph{ein Fehler.
  \end{document}
  \end{dokument}

  \begin{fehler}[gobble=2]
  Runaway argument?
  {ein Fehler. \end {document}
  ! File ended while scanning use of \emph .
  <inserted text>
                  \par

  I suspect you have forgotten a `}', causing me
  to read past where you wanted me to stop.
  I'll try to recover; but if the error is serious,
  you'd better type `E' or `X' now and fix your file.
  \end{fehler}
\end{slide}

\begin{slide}[method=direct,toc={Fehler 2}]{Beispiele für Fehlermeldungen II.}
  \begin{dokument}[gobble=2]
  \documentclass{scrartcl}
  \begin{document}
  In dieser Zeile steckt ein $\alpha-Fehler.
  \end{document}
  \end{dokument}

  \begin{fehler}[gobble=2]
  ! Missing $ inserted.
  <inserted text>
                  $
% l.4 \end{document}

  I've inserted a begin-math/end-math symbol since I think
  you left one out. Proceed, with fingers crossed.
  \end{fehler}
\end{slide}

\begin{slide}[method=direct,toc={Fehler 3}]{Beispiele für Fehlermeldungen III.}
  \begin{dokument}[gobble=2]
  \documentclass{scrartcl}
  \begin{document}
  Wo ist der Fehler in $\alpah+\beta$?
  \end{document}
  \end{dokument}

  \begin{fehler}[gobble=2]
  ! Undefined control sequence.
  <recently read> \alpah

  l.3 Wo ist der Fehler in $\alpah
                                  +\beta$?
  The control sequence at the end of the top line
  of your error message was never \def'ed. If you have
  misspelled it (e.g., `\hobx'), type `I' and the correct
  spelling (e.g., `I\hbox'). Otherwise just continue,
  and I'll forget about whatever was undefined.
  \end{fehler}
\end{slide}

\begin{slide}[method=direct,toc={Fehler 4}]{Beispiele für Fehlermeldungen IV.}
  \begin{dokument}[gobble=2,fontsize=\footnotesize]
  \documentclass{scrartcl}
  \usepackage{amsmath}
  \begin{document}
  \begin{align*}
    a &= 12 + 2\cdot\zi\\
    &= 14 - 2 + 2\cdot\xi\\
    &= 14 - 2\cdot(1-\xi)
  \end{align*}
  \end{document}
  \end{dokument}

  \begin{fehler}[gobble=2,fontsize=\footnotesize]
  ! Undefined control sequence.
  <argument>  a &= 12 + 2\cdot \zi
                                   \\ &= 14 - 2 + 2\cdot...
% l.8 \end{align*}

  The control sequence at the end of the top line
  of your error message was never \def'ed. If you have
  \end{fehler}
\end{slide}

\begin{slide}[method=direct,toc={Fehler 5}]{Beispiele für Fehlermeldungen V.}
  \begin{dokument}[gobble=2]
  \documentclass{scrartcl}
  \usepackage{ngerman}
  \begin{document}
  Die Wahrscheinlichkeit $P("`x=12"')$ ist zu berechnen.
  \end{document}
  \end{dokument}

  \begin{fehler}[gobble=2,label=Warnung,commandchars=+\{\}]
  LaTeX Warning: Command \grqq invalid in math mode on +carriagereturn{}
    input line 4.
  \end{fehler}
\end{slide}

\begin{slide}[method=direct,toc={Fehler 6}]{Beispiele für Fehlermeldungen VI.}
  \begin{dokument}[gobble=2]
  \documentclass{scrartcl}
  \begin{document}
  Die\hspace{1.1\linewidth}se Zeile ist zu voll
  \end{document}
  \end{dokument}

  \begin{fehler}[gobble=2,label=Boxmeldung,commandchars=+\{\}]
  Overfull \hbox (103.95688pt too wide) in paragraph +carriagereturn{}
    at lines 3--4
  []\OT1/cmss/m/n/10.95 Die se
   []
  \end{fehler}
\end{slide}

\begin{slide}{Hinweise}
  \begin{itemize}
   \item nicht löschen, mit Kommentaren (\%\ldots Zeilenende) arbeiten;
    kritischen Bereich kommentieren, übersetzen, stückweise wieder den
    Bereich freigeben und probieren, in welcher Zeile der Fehler genau steckt \pause

   \item manchmal notwendig, alle Hilfsdateien (\texttt{.aux}, \texttt{.toc}, \ldots)
    zu löschen, weil der Fehler darin steckt
  \end{itemize}
\end{slide}

\section{Fortgeschrittene Anwendungen}
\begin{slide}[method=file]{Eigene Befehle I.}
  Für regelmäßig auftretende Konstrukte ist es praktisch, sich eigene Befehle
  zu definieren, da man so leicht alle Stellen im Dokument anpassen kann und
  man erreicht eine \emph{Vereinheitlichung}. Dies geht mit
  \ltxcmd{newcommand*}. \pause

  Beispiel:
  \begin{Verbatim}[gobble=2]
  \newcommand*{\help}[1]{\textcolor{green}{help: #1}}
  \newcommand*{\todo}[1]{\textcolor{red}{todo: #1}}
  \end{Verbatim}
  \begin{enumerate}
   \item hinter \ltxcmd{newcommand*} steht in \texttt{\{\}} der Name des neuen
    Befehls
   \item danach \emph{kann} in \texttt{[]} die Anzahl der Argumente angegeben
    werden
   \item als letztes steht in \texttt{\{\}} was der Befehl machen soll; dabei
    ist \texttt{\#N} das $N$.~Argument
  \end{enumerate}
\end{slide}

\begin{slide}[method=direct]{Eigene Befehle II.}
  Wenn man in einem Text wichtige Wörter hervorheben und gleichzeitig dafür
  einen Indexeintrag erzeugen will, kann man sich einen eigenen Befehl
  schreiben, der genau dies macht:
  \begin{Verbatim}[gobble=2]
  \documentclass{scrartcl}
  ...
  \newcommand*{\begriff}[1]{\textbf{#1}\index{#1}}
  ...
  \begin{document}
  ...
  Als den \begriff{Schmutztitel} eines Buches bezeichnet
  man eine dem eigentlichen Titel vorangestellte Seite.
  Bei KOMA-Script erzeugt man diese zweite Titelseite mit
  \extratitle.
  ...
  \end{document}
  \end{Verbatim}
\end{slide}

\begin{slide}[method=direct]{Eigene Befehle III.}
  Betragsstriche, Floorklammern sollten immer im Paar auftreten. Damit man
  nicht den zweiten Teil vergisst, kann man sich einen Befehl dafür schaffen.
  \begin{Verbatim}[gobble=2]
  \documentclass{scrartcl}
  ...
  \newcommand*{\abs}[1]{|#1|}
  \newcommand*{\norm}[1]{||#1||}
  \newcommand*{\floor}[1]{\lfloor#1\rfloor}
  ...
  \begin{document}
  $\abs{-2} = 2$
  $\floor{\frac{12}{7}} = 1$
  $\norm{x}_{\infy} = \sup_i x_i$
  \end{document}
  \end{Verbatim}
\end{slide}

\section{Sonstiges}

\begin{slide}[toc={Arbeit mit Schablonen}]{Arbeit mit Schablonen (1)}
  \begin{itemize}
   \item \emph{Text mit \ltxcmd{emph}} $\leftrightarrow$ \textit{Text mit
    \ltxcmd{textit}}\\
    -- Wo ist der Unterschied? \pause

   \item Definition von \ltxcmd{emph}:\\
    \qquad \ltxcmd{newcommand*\{emph\}[1]\{\ltxcmd{textit\{\#1\}}\}}\\
    -- Was ist \ltxcmd{emph}? \pause

   \item in der Wirkung (noch) gleich, aber die Bedeutung ist eine andere

   \item Idee von LaTeX: Autor kümmert sich um den Inhalt -- die Bedeutung --,
    der Setzer um das Aussehen -- die Wirkung
  \end{itemize}
\end{slide}

\begin{slide}[toc=]{Arbeit mit Schablonen (2)}
  \begin{itemize}
   \item Autor = Setzer? $\rightarrow$ dennoch Vorteil, da die Aufgaben
    getrennt werden; erst in Ruhe den Text schreiben, später sich mit dem
    Aussehen beschäftigen und Aussehen zentral an einer Stelle beeinflussbar

   \item daher:\vspace{-2ex}
    \begin{itemize}
     \item für oft auftretende Konstrukte (z.\,B. Dateinamen, Personennamen,
      Ergänzungen in Zitaten, Lemmata) sich eigene Befehle und Umgebungen
      schaffen

     \item beim Schreiben nicht über das Aussehen grübeln $\rightarrow$~einen
      Befehl dafür definieren und später anpassen (das Grübeln auf später
      verschieben)
    \end{itemize}
    \pause

   \item \ltxcmd{textit} ist Befehl für Setzer, \ltxcmd{emph} ist Befehl für
    Autor; z.\,B.~in einigen Präsentationen schaltet \ltxcmd{emph} auf farbig
    und nicht kursiv -- dem Autor "`egal"' er wollte hervorgehoben
  \end{itemize}
\end{slide}

\begin{note}{Verdeutlichung der Trennung Autor"=Setzer}
  Modell an der Tafel:
  \begin{center}
    \begin{tabular}{l@{\quad}>{\raggedright\arraybackslash}p{.6\linewidth}}
      \toprule
      Ebene& \multicolumn{1}{c}{Schablone}\\
      \midrule
      Autor& \ltxcmd{emph}, \ltxcmd{unit}, \ltxcmd{medskip},
         \ltxcmd{section}\\
      Setzer& \ltxcmd{textit}, \ltxcmd{textcolor}, \ltxcmd{vspace}\\
      \bottomrule
    \end{tabular}
  \end{center}
\end{note}

\begin{slide}[toc=Gestaltung]{Hinweis zur Gestaltung (1)}
  \begin{itemize}
   \item Abkürzungen sparsam verwenden; innerhalb von Abkürzungen steht ein
    \ltxcmd{,} (Spatium); Editor kann vervollständigen/ersetzen
   \item Bindestriche sparsam verwenden; Bindestriche problematisch beim
    Trennen, Bindestrich = Erklärung des Lesers für unfähig lange Wörter zu
    lesen
  \end{itemize}
  \pause

  Festlegungen treffen und am Besten niederschreiben, typische Fragen:
  \begin{itemize}
   \item Kodierung der Datei: UTF-8 oder Latin1
   \item Einsatz von Zeichen: „“ direkt oder
    \texttt{\dq{}\textasciigrave{}\dq{}\textquotesingle{}},
    äöü oder \texttt{\dq{}a\dq{}o\dq{}u}
   \item Satzzeichen (Komma, Punkt) innerhalb von abgesetzen Gleichungen oder
    Auszählungen
   \item Stil der Indexeinträge: Einzahl
   \item Stil von Tabellen: nur horizontale Linien verwenden?
   \item Rechtschreibung: nicht sichtbar oder nichtsichtbar
  \end{itemize}
\end{slide}

\begin{note}{Probleme mit Bindestrichen}
  \begin{itemize}
   \item bei Worttrennungen sieht anfang-en-\ltxcmd{\textbackslash{}}de
    (das zweite ist die automatische Trennstelle) nicht gut aus

   \item ein \texttt{-} unterbindet automatische Trennung; \texttt{\dq{}=},
    \texttt{\dq{}~} verwenden; \texttt{texdoc} babel, Abschnitt~22
  \end{itemize}
\end{note}

\begin{note}{Vor"~/""Nachteile Kodierung}
  \begin{itemize}
   \item Vorteil bei direkter Eingabe: Breitere Unterstützung durch Programme,
    eine Korrektur für "`Brüke"' findet jedes Rechtschreibprogramm, aber für
    "`Br\dq{}ucke"' bedarf es gewisser Unterstützung

   \item UTF-8 wird nicht von allen Editoren unterstützt

   \item mit UTF-8 \emph{sollte} es keine Probleme beim Austausch zwischen
    Plattformen geben
  \end{itemize}
\end{note}

\begin{slide}[toc=]{Hinweis zur Gestaltung (2)}
  Wer nicht so recht weiß, wie er etwas gestalten soll -- ob kursive oder
  serifenlose Schrift zur Auszeichnung, ob die Seitenzahl unten in der Mitte
  oder oben rechts, ob das Abbildungsverzeichnis hinten oder vorn --, kann
  einfach mal ein Buch aufschlagen und darin etwas blättern, wie es dort
  gelöst wurde.
\end{slide}

\begin{slide}[toc={Dokumente teilen}]{Aufteilen des Dokuments}
  \begin{itemize}
   \item man kann große Dokumente in Teile (Kapitel) zerlegen und diese in
    einer Hauptdatei mit \ltxcmd{input\{\}} zusammenführen
   \item mehrere Leute können so an einem Dokument arbeiten, ohne sich in
    einer Datei ständig zu stören
   \item \ltxcmd{input\{dateiname\}} (relative Pfade verwenden)
   \item Hauptdokument beinhaltet den Kopf mit allen Paketen und Definitionen
    und im Rumpf stehen nur noch \ltxcmd{input}s \pause
   \item aber \LaTeX{} kann gut mit Dateien mit über 15\,000 Zeilen umgehen
  \end{itemize}
\end{slide}

\begin{slide}{Eine andere Vorlage}
  Mit dem Paket \texttt{classicthesis} kommt die Vorlage
  \texttt{Classicthesis.tex}, die wesentlich mehr Möglichkeiten (andere
  Schrift, andere Inhaltsverzeichnisgestaltung, andere Seitengestaltung,
  Farbe) von \LaTeX{} ausnutzt. Jedoch erfordert ihre Verwendung und Anpassung
  an die eigenen Bedürfnisse einiges Können. Daher ist dies nur ein
  (Geheim"~)""Tipp für Fortgeschrittene oder Leute, die ins ganz eiskalte
  Wasser springen wollen. (Tipp: Der Autor spricht Deutsch und ist nett.)

  \begin{description}
   \item[Auf der DVD:]
    {\small\nolinkurl{/ctan/macros/latex/contrib/classicthesis/}}
   \item[Im Internet:]
    {\small\href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/classicthesis/}
      {\nolinkurl{ftp://dante.ctan.org/tex-archive/macros/}\carriagereturn}
      \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/classicthesis/}
      {\nolinkurl{latex/contrib/classicthesis/}}}
  \end{description}
\end{slide}

\begin{slide}[toc=nag]{nag im Mik\TeX{} korrigieren}
  \begin{itemize}
   \item \LaTeX{} ist auch nur Software; Veränderungen, neue Konzepte,
    Alternativen
   \item Folge: es gibt Dinge, die in der Vergangenheit korrekt waren, es aber
    jetzt nicht mehr sind
   \item \texttt{texdoc l2tabu} beschreibt Konstrukte, die nicht mehr
    verwendet werden sollen
   \item Pakete \texttt{nag}, \texttt{fixltx2e}; für Mathematik
    \texttt{onlyamsmath}, \texttt{fixmath}
   \item \texttt{nag} funktioniert im Mik\TeX{} nicht, daher die
    \texttt{zip}-Datei von \url{http://www.absatzen.de/nag.html} holen und
    deren Inhalt in das Verzeichnis \nolinkurl{C:\Programme\MikTeX\texmf}
    installieren
  \end{itemize}
\end{slide}

\section{Abspann}

\begin{slide}[toc=Ende]{}
  \centering
  \Large
  \vspace{5ex}
  Viel Spaß beim \makebox[2.8em]{\onslide*{2}{\ldots}\onslide*{3}{\TeX{}en}}\\
  \vspace{3ex}
  \onslide*{2}{Halt, da war doch noch was}%
  \onslide*{3}{\url{http://www.lug-jena.de/tex/}}
\end{slide}

\end{document}