diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/iwhdp/Anleitung.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/iwhdp/Anleitung.tex | 275 |
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 |