summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/udesoftec/udesoftec-doc.tex
blob: 25578415ca8abf5ba8a2e8cbeab09039bb97bd3b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
% !Mode:: "TeX:UTF-8"
%% udesoftec-doc.tex
%% Copyright 2014 J. Peter M. Schuler
%% 2014/05/13 v1.3.8 udesoftec
\documentclass[omit-aen,omit-lof,omit-lot,omit-sd,final]{udesoftec} 
\usepackage{udesoftec-extra}

\usepackage{lipsum}

\typeofdoc{Dokumentation zu}
\title{udesoftec}
\subtitle{\LaTeX{}-Formatvorlage  \linebreak für Qualifikationsarbeiten am  \linebreak Lehrstuhl für  \linebreak Wirtschaftsinformatik und Softwaretechnik}
\author{J. Peter M. Schuler}
\entitle{[\hyperref[sec:abstract]{English summary available}]}
\city{Essen}
\labelPreTopic{}
\institution{Universität Duisburg-Essen}
\semester{}                                                                               
\date{Version: \input{VERSION.}}
\authorbox{
\begin{tabularx}{.7\linewidth}{ll}
  Maintainer:&J. Peter M. Schuler\\
	    &j.peter.m.schuler@uni-due.de\\
	\\
\end{tabularx}
}

\abstract{
This LaTeX package provides a documentclass for use in written theses at the University of Duisburg-Essen, Research Group for Business Informatics and Software Engineering. It is based on pdflatex and bibtex using KOMA-Script and natbib and  many other popular packages. The current documentation is only available in german. However the  \hyperref[sec:classoptions]{class options in section \ref*{sec:classoptions}} and \hyperref[sec:variables]{configuration variables for the titlepage in section \ref*{sec:variables}} should be quite understandable and the \hyperref[sec:paketlist]{package listing in the appendix} shows where to look for further information. A \hyperref[sec:exampleproject]{MWE and a download of an example project is also available in section \ref*{sec:exampleproject}.}


\section*{Installation}
  Install with MikTeX or if using TeX Live (e.g. BasicTeX) with \lstinline!tlmgr! using the command mentioned in section \ref{sec:classinstall}.

	An alternative, in case you run into problems: just install the documentclass and bibstyle from ctan. Afterwards 
	download the appropiate cover from \url{http://mirror.ctan.org/macros/latex/contrib/udesoftec} and place it next to 
	your document's \lstinline!main.tex!.}


\renewcommand{\udesoftecoverride}{
    \renewcaptionname{ngerman}{\labelabstracttitle}{English summary for this document}
}					
%%%%%%%%%%%%%%%%%%%%%%%% DOCUMENT %%%%%%%%%%%%%%%%%%%%%%%%
\begin{document}
			

	
%%%%%%%%%%%%%%%%%%%%%%%%%%% METADATA %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\newacronym[description={User Interface, \entode{Benutzeroberfläche}}]{ui}{UI}{User Interface}
\newacronym[description={Business-to-Customer, \entode{Unternehmen-zu-Kunde}, beschreibt den Zielmarkt für Transaktionen}]{b2c}{B2C}{Business-to-Customer}
\newglossaryentry{Pattern}{name=Pattern, description={TODO:Pattern Definition}}
\newglossaryentry{Pattern-Kategorie}{name=Pattern-Kategorie, description={Die Einteilung eines \gls{Pattern} in einem Pattern-Katalog}}


%%%%%%%%%%%%%%%%%%%%%%%% CONTENT %%%%%%%%%%%%%%%%%%%%%%%
\mainmatter
\chapter{Einführung}
\section{Grundidee}
Dieses Template stellt eine professionelle Lösung für die Nutzung von \LaTeX{} bereit, die an einigen Stellen von den Quick'and'Dirty und den Plattformübergreifenden Lösungen aus gutem Grund abweicht. Dementsprechend wird über das Template hinaus eine eher spezifische Konfiguration der \LaTeX{}-Umgebung empfohlen. Ein paar Beispiele dafür:

\begin{itemize}
	\item es werden direkt und ausschließlich PDF-Dokumente generiert und kein DVI oder PS als Ergebnis.
	\item durchgehende UTF-8-Nutzung (trotz \LaTeX{} statt XeLaTeX)
	\item eingebettete Grafiken liegen ausschließlich im PDF-Format vor
	\item alle temporär generierten Dateien liegen so gut es geht in einem Unterordner, um die Übersichtlichkeit zu erhöhen
	\item es wird keine Acrobat-Lösung für die PDFs benutzt, da diese für den Anwendungsfall \LaTeX{} nicht geeignet ist
\end{itemize}

\section{Beispiel-Projekt}\label{sec:exampleproject}
Ein funktionierendes Dokument lässt sich durch folgendes Beispiel (MWE - minimum working example) erstellen:
\begin{lstlisting}[language={[LaTeX]TeX}]
\documentclass{udesoftec}
\begin{document}
Inhalt
\end{document}
\end{lstlisting}
Grundsätzlich sind kaum Einstellungen und Konfigurationen notwendig. Lediglich Dinge wie der Inhalt und die bib-Datenbank sind einzufügen.
Ein Beispielprojekt mit echten Inhalten findet sich unter\newline \url{http://udue.de/udesoftecexample}


\section{Software-Empfehlungen}
Diese Dokumentation gibt Hinweise für eine \LaTeX{}-Konfiguration unter Windows mit
\begin{itemize}
	\item MikTeX >= 2.9
	\item TeXnicCenter >= 2.0.2
	\item SumatraPDF >= 2.4
	\item Citavi >= 4.1
\end{itemize}
Unter anderen Systemumgebungen funktioniert dieses Template natürlich genauso, hier müssen Sie lediglich die zusätzlichen Compile-Aufrufe für das Paket "`glossaries"' selbst konfigurieren.

Eine vollständige Konfigurationsanleitung für diese Software findet sich in \autoref{sec:software}.

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section{Klassenparameter und Konstanten}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\subsection{Optionen der Klasse}\label{sec:classoptions}
\begin{description}[leftmargin=2.5cm,style=sameline] 
	\item[en]{Wechselt die primäre Dokumentsprache von Deutsch auf Englisch. Ändert einzelne Überschriften und andere sprachabhängige Labels.}
	\item[printlayout]{Wechselt auf doppelseitiges Druck-Layout ("`Buchlayout"') und Serien-Schrift. Nützlich, wenn die Arbeit ausgedruckt wird und beidseitiger Druck möglich ist. Kapitel beginnen auf rechten Seiten, dadurch werden Leerseiten eingefügt.}
	\item[confidential]{Erstellt einen Sperrvermerk, vgl. \autoref{sec:sperrvermerk}.}
	\item[proposal]{Bspw. für ein Exposé. Setzt alle omit-* Optionen.}
	\item[final]{Setzt die Standard-Werte für die omit-Optionen (nur omit-todos) und beschleunigt einige Ausgaben.}
	\item[vawiessen]{Passt einzelne Ausgaben an die Vorgaben von VAWi (Standort Essen) an.}
	\item[vawibamberg]{Passt einzelne Ausgaben an die Vorgaben von VAWi (Standort Bamberg) an.}
	\item[long-a]{Für deutsche Dokumente: Wenn die beiden Abstracts so lang sind, dass sie nicht auf eine Seite passen, fangen Sie jeweils auf einer neuen Seite an}
	\item[omit-a]{Abstract entfernen.}s
	\item[omit-lot]{Tabellenverzeichnis entfernen.}
	\item[omit-lof]{Abbildungsverzeichnis entfernen.}
	\item[omit-loa]{Abkürzungsverzeichnis entfernen.}
	\item[omit-sd]{Eidesstattliche Versicherung entfernen.}
	\item[omit-toc]{Inhaltsverzeichnis entfernen.}
	\item[omit-todos]{TODO-Liste am Ende des Dokuments entfernen.}
\end{description}

\subsection{Anpassen des Deckblatts}\label{sec:variables}
Neben den Paket-Optionen \lstinline!vawiessen! und \lstinline!vawibamberg! können die folgenden Kommandos vor dem \lstinline!\begin{document}! genutzt werden:

		\begin{multicols}{2}
\begin{itemize}
	\item city
\item typeofdoc
\item academicfield
\item institution
\item semester
\item confidentialitySource
\item authorbox
\item entitle
\end{itemize}
		\end{multicols}
        
        
Darüber hinaus gibt es natürlich noch die Standard-Kommandos:
		\begin{multicols}{3}
\begin{itemize}
\item title
\item author
\item date
\end{itemize}

		\end{multicols}
Die Nutzung ist wie bei den Standard-LaTeX-Kommandos üblich:
\begin{lstlisting}
\title{Meine Bachelorarbeit}
\entitle{My Bachelor Thesis}
\end{lstlisting}


\chapter{Nutzung der Formatvorlage und übliche Kommandos}

\section{Beispiele für Zitationen}

Die häufigsten Zitationsarten sind hier vermerkt, eine komplette Liste der Möglichkeiten findet sich bspw. im \href{http://merkel.zoneo.net/Latex/natbib.php}{Natbib Cheat Sheet}

\subsection{Absatz-Zitate}

Zitate als Absätze machen vor allem bei vollständigen Aussagen oder umfangreichen Definitionen Sinn:

\begin{lstlisting}[language={[LaTeX]TeX},morekeywords=citequotepar]
\citequotepar[<Seite>]{<Quelle>}{<Text>}
\end{lstlisting}
\citequotepar[xix]{Tidwell.2011}{The text that started it all dealt with physical buildings, not software. Christopher Alexander’s
A Pattern Language and its companion book The Timeless Way of Building established the
concept of patterns and described a 250-pattern multilayered pattern language.}

\subsection{Quellenangaben im Fließtext}
Für Quellenangaben im Fließtext wird folgende Variante genutzt:
\begin{lstlisting}[language={[LaTeX]TeX}]
\cite[<Seite>]{<Quelle>}
\end{lstlisting}
Merkmale von Patterns sind bspw. Abstraktionsgrad, Domänenbezug und Sprache \cite[541]{Fettke.et.al.2009}.

\subsection{Quellenangaben und Autorennamen im Text}
\begin{lstlisting}[language={[LaTeX]TeX}]
\citet[<Seite>]{<Quelle>}
\end{lstlisting}
Systemakzeptanz ist nach \citet[24]{Nielsen.1993} die grundlegende Frage dahingehend, [...]. \par
\begin{lstlisting}[language={[LaTeX]TeX}]
\citeauthor{<Quelle>}
\end{lstlisting}
Dabei unterteilt \citeauthor{Nielsen.1993} diese Akzeptanz in verschiedene Bereiche.

\subsection{Mehrere Werke in Quellenangaben}
\begin{lstlisting}[language={[LaTeX]TeX}]
\citetext{<prefix>\citealp[<Seite1>]{<Quelle1>}...}
\end{lstlisting}
Dementsprechen wird für die Usability mit dem Fokus auf das Web, in der Literatur entsprechend der Begriff der Web Usability verwendet \citetext{vgl. z.~B. \citealp[146]{Matera.2006}; \citealp[xix]{Nielsen.et.al.2006}; \citealp[11]{Schweibenz.et.al.2003}}.

\section{Abbildungen}

Abbildungen werden ausschließlkich als PDF eingefügt. Dadurch sind Sie einfacher wartbar und die Chance, dass beim Erstellen eine Vektorgrafik produziert wird steigt gegenüber anderen Vorgehensweisen. Jedes Programm kann grundsätzlich PDF exportieren (selbst MS Powerpoint) und ein PDF-Drucker wie \href{http://www.dopdf.com/de/}{doPDF} versorgt die restlichen Programme. 

Im Gegensatz zur anderen Textprogrammen ist folgendes wichtig zu wissen: Die Position der Abbildung bestimmt LaTeX, nicht der Autor. Daher sollten Abbildungen so im Text genutzt werden, dass es egal ist, ob Sie an der geplanten Stelle, auf der selben Seite darüber, oder erst einzelne Seiten später plaziert wird.

\begin{lstlisting}[language={[LaTeX]TeX},morekeywords={\begin,\citeauthor,\autoref,\includegraphics,\imagewidth},breaklines=true]
Dabei unterteilt \citeauthor{Nielsen.1993} diese Akzeptanz in verschiedene Bereiche (vgl. \autoref{fig:Nielsen_1993_Acceptability}).

%%%%%%%%%%%%%%%%%%% FIGURE %%%%%%%%%%%%%%%%%%%%%%
\begin{figure}
\centering{
  \includegraphics[width=.95\imagewidth,keepaspectratio=true]{udesoftec-doc-exampleimage}
  \caption[System Akzeptanz nach \citeauthor{Nielsen.1993}]{System Akzeptanz nach \citet[25]{Nielsen.1993}}%
  \label{fig:Nielsen_1993_Acceptability}%
}%
\end{figure}%
%%%%%%%%%%%%%%%%%%% FIGURE %%%%%%%%%%%%%%%%%%%%%%
\end{lstlisting}

Dabei unterteilt \citeauthor{Nielsen.1993} diese Akzeptanz in verschiedene Bereiche (vgl. \autoref{fig:Nielsen_1993_Acceptability}).

%%%%%%%%%%%%%%%%%%% FIGURE %%%%%%%%%%%%%%%%%%%%%%
\begin{figure}
  	\centering{
			\includegraphics[width=.95\imagewidth,keepaspectratio=true]{udesoftec-doc-exampleimage}
			\caption[System Akzeptanz nach \citeauthor{Nielsen.1993}]{System Akzeptanz nach \citet[25]{Nielsen.1993}}%
			\label{fig:Nielsen_1993_Acceptability}%
		}%
\end{figure}%
%%%%%%%%%%%%%%%%%%% FIGURE %%%%%%%%%%%%%%%%%%%%%%

\section{Sperrvermerke}\label{sec:sperrvermerk}
Durch die Klassenoption "`confidential"' wird der Sperrvermerk aktiviert und durch die Neudefinition des Firmennamens über den folgenden Befehl, kann Sie entsprechend angepasst werden:
\begin{lstlisting}[language={[LaTeX]TeX}]
\confidentialitySource{Name der Firma}
\end{lstlisting}

\section{Abkürzungen}

Über das folgende Kommando können Abkürzungen angelegt werden:
\begin{lstlisting}[language={[LaTeX]TeX},morekeywords={\newacronym}]
\newacronym[<Erlaeuterung>]{<intern>}{<Abkuerzung>}{<Ausgeschrieben>}
\end{lstlisting}
Als Wert für \lstinline!<intern>! hat sich die Kleinschreibung der Abkürzung bewährt, also bspw.:
\begin{lstlisting}[language={[LaTeX]TeX},morekeywords={\newacronym}]
\newacronym{din}{DIN}{Deutsches Institut für Normung}
\end{lstlisting}
Über die folgenden Kommandos können Abkürzungen genutzt werden, wobei \lstinline!\acr! bei erster Verwendung ausschreibt:
\begin{lstlisting}[language={[LaTeX]TeX},morekeywords={\acr,\acrshort}]
\acr{<intern>} oder \acrshort{<intern>}
\end{lstlisting}
Bspw.: Abkürzungen wie \acr{b2c} können eingeführt und danach kurz als \acr{b2c} genutzt werden, oder wie bei \acrshort{ui} trotz erstmaliger Verwendung kurzgeschrieben werden.

\section{Aufzählungslisten unnummeriert}
Beschreibungslisten können auch mit festem Einschub gesetzt werden:
\parExample{
\begin{itemize}
	\item{Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.}
	\item{Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.}
\end{itemize}
}
\begin{lstlisting}[language={[LaTeX]TeX}]
\begin{itemize}[leftmargin=3.5cm]
	\item{Lorem ipsum dolor...}
	\item{Stet clita kasd...}
\end{itemize}
\end{lstlisting}

\section{Aufzählungslisten nummeriert}
Nummerierte Aufzählungslisten sind auch möglich.
\begin{enumerate}
	\item{Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.}
	\item{Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.}
\end{enumerate}
\begin{lstlisting}[language={[LaTeX]TeX}]
\begin{enumerate}
	\item{Lorem ipsum dolor...}
	\item{Stet clita kasd...}
\end{enumerate}
\end{lstlisting}
Für eine Anpassung der Form (beispielsweise aufzählen mit Buchstaben, Text vor den Zahlen etc.) sei auf die \lstinline!\label!-Option verwiesen, die bspw. unter \url{http://de.wikibooks.org/wiki/LaTeX-Wörterbuch:_enumitem} erklärt ists.

\section{Merkmal-Aufzählungen mit festem Einschub}
Beschreibungslisten können auch mit festem Einschub gesetzt werden:
\begin{description}[leftmargin=2.5cm,style=sameline]
	\item[Merkmal]{Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.}
	\item[Element]{Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.}
\end{description}
\begin{lstlisting}[language={[LaTeX]TeX}]
\begin{description}[leftmargin=2.5cm,style=sameline]
	\item[Merkmal]{Lorem ipsum dolor...}
	\item[Element]{Stet clita kasd...}
\end{description}
\end{lstlisting}

\section{Merkmal-Aufzählungen mit Umbruch}
Beschreibungslisten können auch mit festem Umbruch gesetzt werden:
\begin{description}[style=nextline]
	\item[Merkmal]{Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.}
	\item[Element]{Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.}
\end{description}
\begin{lstlisting}[language={[LaTeX]TeX}]
\begin{description}[style=nextline]
	\item[Merkmal]{Lorem ipsum dolor...}
	\item[Element]{Stet clita kasd...}
\end{description}
\end{lstlisting}


\section{TODOs}
Über \lstinline!\todo{<Text>}! und \lstinline!\inlinetodo{<Text>}! gibt es die Möglichkeit TODOs zu verwalten. \inlinetodo{Diese können innerhalb des Textes stehen wie hier.} Aber Sie können auch am Rand \todo{Absatz überarbeiten} stehen. Am Ende des Dokuments wird eine Gesamtliste angefügt, sofern ein TODO existiter und das Dokument nicht mit der Option \lstinline!final! oder \lstinline!omit-todos! kompiliert wird.
\chapter{FAQ}

\section{Bei kursiver Serifenschrift ist das "`a"' und das "`\&"' komisch}
Das tritt bei Serifenschrift (also mit der Option "`printlayout"') auf und ist korrekt. Bei kursiver Schrift wird bspw. in MS Word oftmals einfach der normale Font schräg gestellt. In professionellen Systemen werden extra \emph{Schriftschnitte} erstellt. Die in dieser Vorlage bei Serifenschrift benutzte Schriftart ist "`Latin Modern"'. Hierbei existiert ein solcher Schriftschnitt. Da das kleine "`a"' und das Und-Zeichen "`\&"' in "`schräg"' aber sehr merkwürdig aussehen würden, sind Sie leicht anders entworfen.

\section{Im Literaturverzeichnis steht manchmal "`Auflage"' statt "`Aufl."'}
Das Literaturverzeichnis-Feld Auflage (bzw. Edition) sollte als Wert in aller Regel nur eine Zahl enthalten, bspw. "`3"'. Dann erstellt der Zitierstil je nach Sprache automatisch ein "`3. Aufl."' oder "`3\textsuperscript{rd} edn."'. In seltenen Fällen kann es sein, dass eine Zahl nicht korrekt ist (bspw. "`Reprint 2008"'). Sollte der Zitierstil keine Zahl finden, wird einfach der gesamte Inhalte des Feldes genutzt.

\section{LaTeX Error: File `udesoftec-cover-ude-de' not found.}
Anscheinend kann die \TeX{}-Distribution die Cover-Dateien nicht finden. Das lässt auf eine veraltete Version der Klasse schließen. In diesem Fall (nach einem Update der packages)einfach das passende Cover von der \href{http://mirror.ctan.org/macros/latex/contrib/udesoftec}{Paket-Seite auf CTAN} heruntergeladen und in den selben Ordner wie die Hauptdatei des Projektes (z.B. \lstinline!main.tex!) gelegt werden.

\section{Das Abkürzungsverzeichnis ist doppelt}

vgl. \autoref{sec:updateinstructions}

\section{LaTeX Error: Error: Undefied control sequence - Package enumitem Error: undefined.}

vgl. \autoref{sec:updateinstructions}

\section{LaTeX Error: Error: Undefied control sequence - Package enumitem Error:1,5cm unde-
fined.}

vgl. \autoref{sec:updateinstructions}
\section{LaTeX Error: File '****.sty' not found.}
Wahrscheinlich wird in einer neueren Version der Klasse ein zusätzliches Paket genutzt, das noch nicht installiert ist. Das sollte vor allem nicht-MikTeX-(Windows)-Konfigurationen betreffen. Hierfür einfach das aktualisierte Kommando unter 
vgl. \autoref{sec:classinstall} nutzen.

%%%%%%%%%%%%%%%%%%%%%%%% APPENDIX %%%%%%%%%%%%%%%%%%%%%%%
\appendix% \addcontentsline{toc}{chapter}{Anhang}
\def\chapterAuthor{ }
\chapter{Appendix}
\section{Installation und Konfiguration der Software}\label{sec:software}
		
\subsection{LaTeX-Umgebung: MikTeX (Windows) oder BasicTeX (OSX)}\label{sec:classinstall}
Unter Windows wird ausdrücklich \href{http://miktex.org}{MikTeX} empfohlen, da dieses selbständig und On-Demand fehlende Dinge nachinstalliert. 

Unter MacOS kann beispielsweise ein minimales \TeX{}-Live-System wie \href{http://tug.org/mactex/morepackages.html}{BasicTeX} genutzt werden. Die notwendigen Pakete lassen sich wie folgt installieren:
\begin{lstlisting}[language=bash,breaklines=true]
sudo tlmgr install udesoftec chngcntr hyphenat nag footmisc placeins advdate expdlist todonotes type1cm wallpaper marginnote glossaries xfor datatool substr varwidth collection-fontsrecommended tikz mdframed libertine cm-super helvetic ec bookmark
\end{lstlisting}
Sollte es zu Problemen kommen, sollten die Fehlermeldungen und die \hyperref[sec:paketlist]{Liste der Pakete im Anhang} genügend Informationen bieten.

\subsection{Citavi}
Citavi erlaubt nur noch manuelle BibTeX-Exporte, die \href{http://support.citavi.de/forum/viewtopic.php?f=156&t=7295&p=24152}{Funktion für automatischen Export ist entfernt worden}. Der Export funktioniert einfach über das Datei Menü (\href{http://www.citavi.com/sub/manual4/de/exporting_to_bibtex.html}{Anleitung zum BibTeX-Export in der Citavi-Hilfe}).
		

\subsection{Sumatra PDF}
\href{http://blog.kowalczyk.info/software/sumatrapdf/download-free-pdf-viewer-de.html}{SumatraPDF} herunterladen (Portable Version genügt, am besten direkt neben die TeXnixCenter.exe legen).

\subsection{TeXnicCenter}
Die aktuelle Version ist \href{http://www.texniccenter.org/}{TeXnicCenter 2.02 }.

Im TeXnicCenter unter Ausgabeprofile (Ausgabe -> Ausgabeprofile definieren) das vorhandene PDF-Profil (pdflatex) kopieren und die Kopie wie beschrieben anpassen um folgende Dinge zu erreichen:~\par
\begin{enumerate}
\item alle temporären Dateien in einem Unterordner .tmp/ erstellt.
\item Der Glossar und das Abkürzungsverzeichnis werden aktiviert
\item Die Vorwärtssuche und die Rückwärtssuche im PDF ermöglicht.~\par
	\begin{itemize}
					\item Vorwärtssuche: das PDF öffnet sich an der Textstelle an der man im TeXnicCenter den Cursor hatte
	\item Rückwärtssuche: Doppelklick im PDF öffnet die Textstelle im TeXnicCenter
	\end{itemize}
\end{enumerate}
\unnumberedsection{Ordner für temporäre Dateien nutzen}
Im Ausgabeprofil im Karteireiter (La)TeX:~\par
				\begin{itemize}
					\item Argumente für Compiler:
						\par\lstinline!-src-specials -synctex=1 -aux-directory .tmp -output-format pdf! 
						\par\lstinline!-interaction=nonstopmode %Wm!
					\item Argumente für BibTex: \lstinline!"\%dm/.tmp/%tm"!
					\item Argumente für MakeIndex: \lstinline!".tmp/%tm.tex"!
				\end{itemize}

\unnumberedsection{Abkürzungen und Glossare einbeziehen}
Im Ausgabeprofil im Karteireiter Nachbearbeitung einen neuen Postprozessoren anlegen: "`Acronyms"':
				\begin{itemize}
					\item Anwendung: \lstinline!C:\Program Files (x86)\MiKTeX 2.9\miktex\bin\makeindex.exe!
					\item Argumente: \lstinline!-s .tmp\%tm.ist -t .tmp\%tm.alg -o .tmp\%tm.acr .tmp\%tm.acn!
				\end{itemize}
Im Ausgabeprofil im Karteireiter Nachbearbeitung einen neuen Postprozessoren anlegen: "`Glossaries"':
				\begin{itemize}
					\item Anwendung: \lstinline!C:\Program Files (x86)\MiKTeX 2.9\miktex\bin\makeindex.exe!
					\item Argumente: \lstinline!-s .tmp\%tm.ist -t .tmp\%tm.glg -o .tmp\%tm.gls .tmp\%tm.glo!
				\end{itemize}
				
\unnumberedsection{Sumatra PDF mit Vorwärts- und Rückwärtssuche}
 Im Ausgabeprofil im  Karteireiter Viewer:~\par
				\begin{itemize}
					\item Pfad der Anwendung: 
					\par\lstinline!<Pfad zu Sumatra>\SumatraPDF.exe  -inverse-search!
                    \par\lstinline!"\"<Pfad zu TeXnicCenter>\TeXnicCenter.exe\" /ddecmd \"[goto('%f','%l')]\""!
					\item Projektausgabe betrachten:~\par  [X] Kommandozeile, Kommando: \lstinline!"%bm.pdf"!
					\item Suche in Ausgabe:~\par  [X] DDE-Kommando, Server: \lstinline!SUMATRA!, Thema: \lstinline!control! \par
							Kommando: \lstinline![ForwardSearch("\%bm.pdf","\%Wc",\%l,0,0,1)]!
					
					\item Vor Compilierung Ausgabe schließen:~ [X] nicht schließen
						
				\end{itemize}


Nun das \hyperref[sec:exampleproject]{Beispielprojekt oder das Minimal Working Example} öffnen und einmal rendern lassen, dadurch sollten alle benötigten Pakete automatisch installiert werden.
Im TeXnicCenter mit Strg+Alt+R die "`Erstellung Ergebnis"'-Ansicht anzeigen lassen, diese fasst die LaTeX-Kompiler-Ausgaben sinnvoll zusammen.


\unnumberedsection{Zusätzliche Dateiendungen für das Aufräumen angeben}
		Im TeXnicCenter unter Optionen und Aufräumen neue Dateiendungen hinzufügen (Aktion: löschen; [X] Unterverzeichnisse einbeziehen und als Pattern jeweils)~\par
		\begin{multicols}{3}
		\begin{itemize}
	\item *.synctex.gz
	\item *.acn
	\item *.acr
	\item *.alg
	\item *.glg
	\item *.glo
	\item *.gls
	\item *.ist
			\item *.pdfsync
		\end{itemize}
		\end{multicols}




\section{Update Instructions}\label{sec:updateinstructions}
This documentclass is as downwards compatible as possible. Any change in the version number according the third digit (e.g. from 1.2.1 to 1.2.8) creates no compile or display errors.
Some changes however cannot be catched, so that in case of major version changes some LaTeX errors and warnings may occure. The following list shows some changes to the document one should do in order to remove the errors and warnings.
\subsection{Update to 1.3.0}
\begin{description}[style=nextline]
  \item[Change in document configuration sets main page to default values]{All configuration labels like \lstinline!\def \institution{University of Duisburg-Essen}! are not working anymore and need to be replaced with real commands like \lstinline!\institution{University of Duisburg-Essen}!. }
	\item[Error: Undefied control sequence - Package enumitem]{Happens while using \lstinline!\begin{description}[\breaklabel]!. \newline{} Due to a new package the option is now "`style=nextline"', so use\newline{} \lstinline!\begin{description}[style=nextline]! instead.

Happens while using \lstinline!\begin{description}[\setleftmargin{1.5cm}]]!.\newline{} Due to a new package the option is now "`leftmargin=1,5cm"', so use\newline{} \lstinline!\begin{description}[leftmargin=1.5cm,style=sameline]! instead.
}
	
\end{description}
\subsection{Update to 1.2.1}
\lstinline!\printacronyms! not necessary any more - the documentclass takes care of this.



\section{List of used packages}\label{sec:paketlist}
The base documentclass is \emph{scrbook}, which is part of KOMA-Script. Other used packages:
\begin{multicols}{4}
\begin{itemize}[labelindent=0px,itemindent=0em,leftmargin=1em]
\item \ctanlink{babel}
\item \ctanlink{chngcntr}
\item \ctanlink{enumitem}
\item \ctanlink{fix-cm}
\item \ctanlink{fixltx2e}
\item \ctanlink{fontenc}
\item \ctanlink{footmisc}
\item \ctanlink{geometry}
\item \ctanlink{glossaries}
\item \ctanlink{graphicx}
\item \ctanlink{helvet}
\item \ctanlink{hypcap}
\item \ctanlink{hyperref}
\item \ctanlink{hyphenat}
\item \ctanlink{inputend}
\item \ctanlink{libertine}
\item \ctanlink{listings}
\item \ctanlink{lmodern}
\item \ctanlink{marginnote}
\item \ctanlink{mdframed}
\item \ctanlink{microtype}
\item \ctanlink{multicol}
\item \ctanlink{natbib}
\item \ctanlink{placeins}
\item \ctanlink{ragged2e}
\item \ctanlink{scrhack}
\item \ctanlink{scrpage2}
\item \ctanlink{setspace}
\item \ctanlink{tabularx}
\item \ctanlink{tikz}
\item \ctanlink{todonotes}
\item \ctanlink{type1cm}
\item \ctanlink{verbatim}
\item \ctanlink{wallpaper}
\item \ctanlink{xcolor}
\end{itemize}
\end{multicols}


\section{Changelog}
\begingroup
    \fontsize{8pt}{10pt}\selectfont
  \verbatiminput{CHANGELOG.}
\endgroup

\bibliography{udesoftec-doc-examplebib} % output Literature and use this file as bibtext catalogue
\end{document}