summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/iwhdp/Anleitung.tex
blob: af06def5fc4da5c9b087a01e4b58316e78c41f0f (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
%=====================================================% 
%            IWH DISKUSSIONSPAPIER README             %
%                   Wilfried Ehrenfeld                %
%             Diese Version: Februar 2011             %
%=====================================================% 
%     ***** Dokumentklasse iwhdp   OPTIONEN *****     %
% english: englisches DP, german: deutsches DP        %
% harvard: harvard-kompatible Zitierbefehle,          %
% nobib: keine Literaturverwaltung                    % 
%               ! iwhdp Readme lesen !                %
%=====================================================%
\documentclass[german]{iwhdp}
%\usepackage{listings}
%\lstset{basicstyle=\ttfamily\small}

%-----------------------------------------------------%
%------------------- *** Bibliographische Angaben *** %
\title{IWH-Diskussionspapiere - Benutzeranweisung für die \LaTeX-Vorlage}% Papersprache
\titlealt{IWH discussion papers - The \LaTeX{} template user guide}% Alternativsprache
%
\author{Wilfried Ehrenfeld}%
\department{Abteilung Strukturökonomik}%
\tel{+49\,(0)\,345 7753-832}%
\email{wilfried.ehrenfeld@iwh-halle.de}%
%
\dpnumber{\TeX}%
\dpabstract{Dies ist die \LaTeX-Vorlage für IWH-Diskussionspapiere.}% Papersprache
\dpabstractalt{This is the \LaTeX{} template for IWH discussion papers.}% Alternativsprache
\keywords{IWH, \LaTeX, Vorlage}% Papersprache
\keywordsalt{IWH, \LaTeX, template}% Alternativsprache
\jel{Z0}% JEL-Klassifikation
%-------------- *** Ende Bibliographische Angaben *** %
%-----------------------------------------------------%
% Literaturdatenbank. Standard: {iwhdp_paper} -> Datei: iwhdp_paper.bib
\bibliography{Anleitung}
%-----------------------------------------------------%
\begin{document}
\makeiwhtitle% IWH DP Vorspann ausgeben
%-------------- *** Text des Papiers *** -------------%
%
\section{Benutzung der Vorlage}
%
Für Diskussionspapiere des IWH wurde die Dokumentenklasse \texttt{iwhdp} geschaffen, 
deren Benutzung jedem freisteht.
Die jeweils aktuelle Version kann im Intranet von \verb|L:\LaTeX\iwhdp| bezogen werden.
Von der Verwendung alter Versionen wird ausdrücklich abgeraten.

Die Klasse wird mit
\verb+\documentclass[+\emph{optionale Parameter}\verb+]{iwhdp}+
aufgerufen.
Dazu muss die Datei \texttt{iwhdp.cls} im Arbeitsverzeichnis liegen.
Die Dokumentenklasse besitzt optionale Parameter für 
die Sprache des Papiers sowie für den Umgang mit dem Literaturverzeichnis.

Optionale Parameter für die Sprache sind:
%
\begin{itemize}
\item \emph{german} für deutsche Diskussionspapiere
\item \emph{english} für englische Diskussionspapiere
\end{itemize}
Die Standardeinstellung (keine optionalen Parameter) ist \emph{german}. 

Optionale Parameter für die Literaturverwaltung sind:
\begin{itemize}
\item \emph{harvard} stellt Zitierbefehle zur Verfügung, welche zum \texttt{harvard}-Paket kompatibel sind (\emph{Beta-Version}).
\item \emph{nobib} schaltet die automatische Literaturverwaltung ganz aus.
Statt dessen wird die Hilfs-Umgebung \texttt{iwh\_ref} zur Verfügung gestellt.\\ 
Diese kann wie folgt benutzt werden:\\
\verb+\makebib% 'Literatur' bzw. 'References' ausgeben+\\
\verb+\begin{iwh_ref}% Umgebung für Literatur initialisieren+\\  
\verb+\item+ \emph{...eine Quellenangabe}\\
\verb+\end{iwh_ref}% Umgebung beenden+\\
\end{itemize}


\section{Typischer Aufbau eines Dokumentes}
%
Den Aufbau eines typischen DP-Projektes kann man im Quellcode zu dieser Anleitung sehen (\texttt{Anleitung.tex}).
Dieser sei hier kurz beschrieben. 
Die Benutzung der Datei \texttt{iwhdp\_paper.tex} als Vorlage für eigene Diskussionspapier ist ausdrücklich empfohlen.\\
Das Dokument beginnt mit der Deklarartion der Klasse:

\verb+\documentclass[german]{iwhdp}+

Dies wird also ein deutsches Papier ohne den "`harvard-Kompatibilitätsmodus"' aber mit automatisch generiertem Literaturverzeichnis aus der Datei \texttt{iwhdp\_paper.bib}.

Anschließend folgen die bibliographischen Angaben für den/die Autoren:

\verb|\author{Wilfried Ehrenfeld}|\\
\verb|\department{Department of Structural Economics}|\\
\verb|\tel{+49 345 7753 832}|\\
\verb|\email{wilfried.ehrenfeld@iwh-halle.de}|

Die Parameter für den (ersten) Koautor heißen:\\%
\texttt{cauthor, cdepartment, ctel und cemail}.\\
Für den zweiten Koautor:\\%
\texttt{ccauthor, ccdepartment, cctel und ccemail}.\\
Und schließlich für den dritten Koautor:\\%
\texttt{cccauthor, cccdepartment, ccctel und cccemail}.\\
Insgesamt können also vier Autoren erfasst werden.

Sämtliche Angaben für die Autoren sind bis auf den Namen des ersten Autoren \emph{optional}.
Falls sie nicht benötigt werden, können Sie aus dem Papier-Quelltext entfernt werden.
Alternativ dazu besteht die Möglichkeit, die Angaben für einen Koautor blockweise komplett stillzulegen.
Dazu trägt man für den Namen des Koautors (\texttt{cauthor, ccauthor, cccauthor}) einfach \texttt{NN} ein.

Als nächstes besteht die Möglichkeit den Publikationsmonat des Papiers anzugeben.
Dies ist aber nur dann nötig, falls dieser vom aktuellen Monat abweicht.
Dazu trägt man das gewünschte Datum im Zahlenformat 
\verb|\dpdate{|\emph{Monat}\verb|}{|\emph{Jahr}\verb|}| ein.
\verb|\dpdate{03}{2010}| bezeichnet also den März 2010.

Die Nummer des Diskussionspapier wird mit \verb|\dpnumber{|\emph{Nummer}\verb|}| angegeben.
Diese Nummer wird von Frau Dede zugeteilt.

IWH-Diskussionspapiere werden prinzipiell entweder in Deutsch oder in Englisch geschrieben.
Ein Merkmal der Diskussionspapiere ist die Existenz einer doppelten dritten Seite.
Dies führt dazu, dass Angaben wie Zusammenfassungen, Stichwörter und Titelfußnoten jeweils 
in der Sprache des Papiers (hier: deutsch) angegeben werden müssen und zusätzlich in der
\emph{Alternativsprache} (hier also englisch).

Deshalb folgen nun die Zusammenfassung und der Abstract des Papiers
zuerst in der Sprache des Papiers:
\verb|\dpabstract{|\emph{Text der Zusammenfassung}\verb|}|,
danach in der Alternativsprache:
\verb|\dpabstractalt{|\emph{Text des Abstracts}\verb|}|.
Bei einem deutschen Text ist also \texttt{dpabstract} in Deutsch zu verfassen 
und \texttt{dpabstractalt} in Englisch - und umgekehrt.

Analog hierzu werden die Schlagwörter mit \verb|\keywords{|\emph{Schlagwörter}\verb|}| in der Sprache des Papers angegeben.
Die einzelnen Schlagwörter sind mit je einem Komma zu trennen.
In der Alternativsprache werden diese mit \verb|\keywordsalt{|\emph{Keywords}\verb|}| angegeben.

Die JEL-Klassifikation wird mit \verb|\jel{|\emph{Klasse}\verb|}| eingetragen. 
Mehrere Klassen sollten mit je einem Komma getrennt werden.

Als letzte bibliographische Daten können nun noch die Titelfußnoten angelegt werden.
Anwendungsbeispiele sind Hinweise (Drittmittelförderung) oder Danksagungen.
In der Sprache des Papiers werden diese mit \verb|\thanks{|\emph{Dankeschön!}\verb|}| verfasst,
in der Alternativsprache mit \verb|\thanksalt{|\emph{Thanks!}\verb|}| verfasst.

Die Literaturdatenbank \texttt{iwhdp\_paper.bib} wird mit \verb|\addbibresource{iwhdp_paper}| geladen.

Das Dokument wird nun mit
\verb+\begin{document}+
initialisiert.
 
Der IWH-spezifische Vorspann wird anschließend mit
\verb+\makeiwhtitle+
ausgegeben.
Zum Entwickeln der Papiere kann man diesen Befehl gut mit einem "`\texttt{\%}"' vor dem Befehl auskommentieren.

Nun folgt der Text des Diskussionspapiers, beispielsweise beginnend mit\\
\verb+\section{Einführung}+.

Das Papier endet mit dem Literaturverzeichnis. 
Dazu kann mit
\verb+\clearpage+
eine neue Seite begonnen werden.
Das Literaturverzeichnis wird mit
\verb+\makebib+
ausgegeben.
Das Dokument endet mit
\verb+\end{document}+.

Der Aufbau eines typisches Diskussionspapiers sieht dann ungefähr so aus:

%
%%
%%%
\newpage
{\small
\begin{verbatim}
%=====================================================% 
%               IWH DISKUSSIONSPAPIER                 %
%     Vorlage: Wilfried Ehrenfeld (2011-03)           %
%=====================================================% 
%     ***** Dokumentklasse iwhdp   OPTIONEN *****     %
% english: englisches DP, german: deutsches DP        %
% harvard: harvard-kompatible Zitierbefehle,          %
% nobib: keine Literaturverwaltung                    % 
%               ! iwhdp Readme lesen !                %
%=====================================================%
\documentclass{iwhdp}% default: german
%-----------------------------------------------------%
%------------------- *** Bibliographische Angaben *** %
%* Titel *--------------------------------------------%
\title{Eine \LaTeX-Vorlage für IWH-Diskussionspapiere}% Papersprache
\titlealt{A \LaTeX{} template for IWH discussion papers}% Alternativsprache
%* Autor *--------------------------------------------%
\author{Wilfried Ehrenfeld}%
\department{Abteilung Strukturökonomik}%
\tel{+49\,(0)\,345 7753 832}%
\email{wilfried.ehrenfeld@iwh-halle.de}%
%* Koautor *------------------------------------------%
\cauthor{NN}% NN: Kein Koautor
\cdepartment{}%
\ctel{}%
\cemail{}%
%* Zweiter Koautor *----------------------------------%
\ccauthor{NN}% NN: Kein zweiter Koautor
\ccdepartment{}%
\cctel{}%
\ccemail{}%
%* Dritter Koautor *----------------------------------%
\cccauthor{NN}% NN: Kein dritter Koautor
\cccdepartment{}%
\ccctel{}%
\cccemail{}%
%* Erscheinungsmonat und DP-Nummer -------------------%
%\dpdate{05}{1984}% {Monat}{Jahr} - nur nötig, wenn abeichend.
%\dpnumber{1}% Nach Zuteilung aktivieren und eintragen.
%* Abstract/Zusammenfassung *-------------------------%
\dpabstract{Dies ist eine \LaTeX-Vorlage für IWH-Diskussionspapiere.}% Papersprache
\dpabstractalt{This is a \LaTeX{} template for IWH discussion papers.}% Alternativsprache
%* Keywords, Schlagwörter, JEL -----------------------%
\keywords{IWH, \LaTeX, Vorlage}% Papersprache
\keywordsalt{IWH, \LaTeX, template}% Alternativsprache
\jel{Z0}% JEL-Klassifikation
%* Titelfussnote: Danksagung, Bemerkungen etc. *------%
\thanks{NN}% Papersprache. NN: Keine 
\thanksalt{NN}% Papersprache. NN: Keine 
%-------------- *** Ende Bibliographische Angaben *** %
%-----------------------------------------------------%
% Literaturdatenbank. Standard: {iwhdp_paper} -> Datei: iwhdp_paper.bib
\addbibresource{Anleitung}
-----------------------------------------------------%
\begin{document}
\makeiwhtitle% IWH DP Vorspann ausgeben
%-------------- *** Text des Papiers *** -------------%
\section{Einleitung}
 ...

%----------------- *** Textende *** ------------------%
\clearpage% Seitenumbruch
\makebib% Literaturverzeichnis ausgeben
\end{document}

% *** EOF iwhdp_paper.tex *** 
\end{verbatim}
}%Gruppe
\newpage
%%%
%%
%

\section{Zitierstil}
%
Die Vorlage benutzt das \texttt{biblatex}-Paket (aktuell in der Version 0.9) für die Erstellung von Zitaten:\\
\url{http://www.ctan.org/tex-archive/macros/latex/exptl/biblatex/}.\\
Die Zitierbefehle richten sich hiernach.

Für die beiden häufigsten Zitierweisen wurden Kurzformen geschaffen:\\
\verb|\zit{demmig2004}{13ff.}| $\rightarrow$ \zit{demmig2004}{13ff.}\\
und\\
\verb|\tzit{demmig2004}{13ff.}| $\rightarrow$ \tzit{demmig2004}{13ff.}

Die danach gebräuchlichsten Zitierbefehle sind \texttt{parencite} und \texttt{textcite}:\\
\verb+\parencite{demmig2004}+ $\rightarrow$ \parencite{demmig2004}\\
\verb+\parencite[13ff.]{demmig2004}+ $\rightarrow$ \parencite[13ff.]{demmig2004}\\
\verb+\parencite[siehe][]{demmig2004}+ $\rightarrow$ \parencite[siehe][]{demmig2004}\\
\verb+\parencite[siehe][13ff.]{demmig2004}+ $\rightarrow$ \parencite[siehe][13ff.]{demmig2004}\\
und\\
\verb+\textcite{demmig2004}+ $\rightarrow$ \textcite{demmig2004}.\\
\verb+\textcite[13ff.]{demmig2004}+ $\rightarrow$ \textcite[13ff.]{demmig2004}.\\
\verb+\textcite[siehe][]{demmig2004}+ $\rightarrow$ \textcite[siehe][]{demmig2004}.\\
\verb+\textcite[siehe][13ff.]{demmig2004}+ $\rightarrow$ \textcite[siehe][13ff.]{demmig2004}.

Daneben existieren eine Reihe weiterer Zitierbefehle:\\
\verb+\cite{demmig2004}+ $\rightarrow$ \cite{demmig2004}\\
\verb+\cite[13ff.]{demmig2004}+ $\rightarrow$ \cite[13ff.]{demmig2004}\\
\verb+\cite[siehe][13ff.]{demmig2004}+ $\rightarrow$ \cite[siehe][13ff.]{demmig2004}

\verb+\cite*{demmig2004}+ $\rightarrow$ \cite*{demmig2004}\\
\verb+\cite*[13ff.]{demmig2004}+ $\rightarrow$ \cite*[13ff.]{demmig2004}

\verb+\parencite*[13ff.]{demmig2004}+ $\rightarrow$ \parencite*[13ff.]{demmig2004}

\verb+\parencites[13ff.]{demmig2004}[sowie][123]{schlager2005}+ $\rightarrow$\\ \parencites[13ff.]{demmig2004}[sowie][123]{schlager2005}

\verb+\footcite[siehe][13ff.]{demmig2004}+ $\rightarrow$ \footcite[siehe][13ff.]{demmig2004}

Auch einzelne Felder können angesprochen werden:\\
\verb+\citeauthor{demmig2004}+ $\rightarrow$ \citeauthor{demmig2004}\\
\verb+\citetitle{demmig2004}+ $\rightarrow$ \citetitle{demmig2004}\\
\verb+\citeyear{demmig2004}+ $\rightarrow$ \citeyear{demmig2004}\\
\verb+\citeurl{demmig2004}+ $\rightarrow$ \citeurl{demmig2004}


\section{Tips für die Literaturdatenbank}
%

Für die Einstellungen von dem hier benutzten Paket \texttt{biblatex}, 
sollte die Datenbank im Encoding \emph{ISO8859-15} vorliegen.
Diese Kodierung entspricht in etwa \texttt{latin9} bzw. \texttt{ansinew} unter \LaTeX.
Unter \texttt{JabRef} stellt man dies unter \texttt{Optionen / Einstellungen / Standard-Zeichenkodierung} ein.
Mit der Kodierung \texttt{CP1252} gab es bereits Probleme.
Bei dieser Gelegenheit sollte man auch bei "`Neue Einträge mit Datum versehen. Datumsformat:"'
\texttt{yyyy-MM-dd} eintragen. 
So kann man später diesen "`timestamp"' in andere Datumsfelder (z.\,B. urldate) übernehmen.
Datumsangaben müssen in der sog. ISO-8602-Notierung (JJJJ-MM-TT) vorliegen. 
Ein Beispiel: Das Datum, an dem eine Internetquelle abgerufen wurde (\texttt{urldate}) ist: 
2010-02-16 für den 16. Februar 2010.

Das Eingabeformat für Autoren ist: "`\emph{Vorname Nachname}"'.
Verschiedene Autoren werden mit \texttt{and} getrennt.
Für weitere Autoren z.\,B. "`u.a."' schreibt man \texttt{and others}.
den Namen von Institutionen schreibt man am besten in geschweifte Klammern, 
so wird die automatische Erkennung von Vornamen und Nachnamen ausgeschaltet und der Name nicht getrennt.
Nicht nötig ist es, den ersten Buchstaben von Autoren oder Titeln in geschweifte Klammern zu schreiben.

Artikel, Bücher, und Beiträge aus Sammelbänden werden (wie gewohnt) als 
\texttt{article}, \texttt{book} und \texttt{inbook} eingetragen.
Die Felder \texttt{url} und \texttt{urldate} können verwendet werden.
Der Ort des Verlages heisst "`\texttt{location}"'.

Diskussionspapiere und ähnliche Dokumente sollten als \texttt{report} eingetragen werden.
Die Felder \texttt{author}, \texttt{title} und \texttt{year} sind obligatorisch.
Vermerke wie "`IWH Diskussionspapier 04/2010"' werden als \texttt{type} eingetragen.
Die Felder \texttt{url} und \texttt{urldate} können verwendet werden.

Quellen aus dem Internet, welche keiner anderen Dokumentenklasse zugeordnet werden können, 
werden als \texttt{electronic} eingetragen.
Die Felder \texttt{url} und \texttt{urldate} gelten hierbei als Mindestanforderungen.

\texttt{JabRef} bietet die Möglichkeit, zu jeder Quelle in der Datenbank einen \emph{Review} anzulegen.
Die können Textstellen und Bemerkungen eingetragen werden. 
Später kann die Datenbank mit der Volltextsuche nach Begriffen durchsucht werden.
Den \texttt{abstract} einer Quelle sollte man nicht hier, sondern in das Feld \texttt{Abstract} eingeben bzw. kopieren.



%\section{Hinweis zur "`doppelten zweiten Seite"'}
%%
%Die zweite Seite des IWH-Vorspanns wird zwei Mal ausgegeben - einmal mit ISSN und einmal ohne ISSN.
%Beide Male trägt sie auch die Seitennummer \emph{2}.
%Dies ist eine Vorgabe von Frau Dede, die anschließend hieraus zum einen 
%die Online-Version und zum anderen eine Kopiervorlage erstellt.
%
%Hiermit hängt auch die Warnung\\
%\verb+pdfTeX warning (ext4):+\newline \verb+destination with the same identifier (name{page.2})+\\
%zusammen. Diese kann ignoriert werden.



\section{Literaturhinweise für Anfänger}
%
Wer kein Geld für Bücher ausgeben will, dem seien die einführenden Skripte "`\citetitle{Hagen1}"' und "`\citetitle{Hagen2}"' der FernUni Hagen ans Herz gelegt \parencites{Hagen1}{Hagen2}.

Gute einführende Bücher zum Thema \LaTeX{} sind z.\,B. "`\citetitle{schlager2005}"' \parencite{schlager2005} und "`\citetitle{demmig2004}"' \parencite{demmig2004}.
%
%
\section{\TeX nische Hinweise}
%
Die häufigsten Nachfragen:

1. Wie können die Absatzzwischenräume geändert werden?\\
A: Dazu dient der Befehl:
\verb+\setlength{\parskip}+
Aktuell ist dieser wie folgt definiert:
\verb+\setlength{\parskip}{8pt plus0pt minus2pt}% Absatzzwischenraum+\\
\verb+parkip+ ist ein sog. elastisches Maß: 
Das \verb+plus+ gibt an, um wieviel der Parameter notfalls gedehnt werden kann -
\verb+minus+ gibt an, um wieviel der Parameter gestaucht werden darf.
Der Parameter sollte nach \verb+\makeiwhtitle+ gesetzt werden.

2. Wie kann die (einzeilige) Tabellen- bzw. Abbildungsüberschrift zentriert werden.\\
A: Dazu dient der Befehl:\\
\verb+\KOMAoption{captions}{nooneline}%oneline: zentriert. nooneline: links+\\
\verb+oneline+ zentriert die einzeilige Überschrift.
\verb+nooneline+ setzt sie wie mehrzeilige - also linksbündig.
Der Parameter sollte vor \verb+\begin{document}+ gesetzt werden.

%\clearpage% Seitenumbruch
%
\makebib% Literaturverzeichnis ausgeben
%
\end{document}
%*** EOF ***%