summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/iwhdp/Anleitung.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/iwhdp/Anleitung.tex')
-rw-r--r--Master/texmf-dist/doc/latex/iwhdp/Anleitung.tex275
1 files changed, 275 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/iwhdp/Anleitung.tex b/Master/texmf-dist/doc/latex/iwhdp/Anleitung.tex
new file mode 100644
index 00000000000..4654c3a2c67
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/iwhdp/Anleitung.tex
@@ -0,0 +1,275 @@
+%=====================================================%
+% 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}
+%-----------------------------------------------------%
+%------------------- *** Bibliographische Angaben *** %
+\title{Die \LaTeX-Vorlage für IWH-Diskussionspapiere}% Papersprache
+\titlealt{The \LaTeX{} template for IWH discussion papers}% Alternativsprache
+%
+\author{Wilfried Ehrenfeld}%
+\department{Abteilung Strukturökonomik}%
+\tel{+49 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|\bibliography{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}+.
+
+
+\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}.
+%
+%
+%\clearpage% Seitenumbruch
+%
+\makebib% Literaturverzeichnis ausgeben
+%
+\end{document}
+%*** EOF ***% \ No newline at end of file