Merge branch '2021-translate-script' of git.stuve-bamberg.de:latex/latex-skript into 2021-translate-script

content/literature.tex

@@ -1,74 +1,75 @@
-\chapter{Literaturverwaltung}
+\chapter{Reference management}
 \label{sec:literature}
 
-Um die ersten Studien- oder Abschlussarbeiten in \LaTeX\ zu setzen, fehlt uns jetzt nur noch eine Möglichkeit, Literatur zu referenzieren.
-Unsere Literatursammlung liegt in der sogenannten .bib-Datei.
-Wenn wir aus unserem \LaTeX-Dokument darauf verweisen, kann uns das Programm Bib\TeX{} (ähnlich zum Compiler \acro{PDF}\LaTeX) an der richtigen Stelle die richtigen Zitationen in einem vorher festgelegten Bibliografiestil einfügen.
+For typesetting our first theses in \LaTeX{}, the last core functionality to learn is citing literature.
+Our references are gathered in a bibliography file.
+Once we reference one of its entries from our \LaTeX{} document, Bib\TeX{} (a program similar to the standard \acro{PDF}\LaTeX{} compiler) can insert automatically generated citations.
+It will format them in a bibliography style of our choice.
 
-\section{Die Bibliografie-Datei}
-In der .bib-Datei sammeln wir unsere Literatureinträge in einem Format, das durch Bib\TeX{} verarbeitbar ist.
-Einen beispielhaften Eintrag aus einer .bib-Datei zeigt \cref{lst:bibfile-sample-entry}.
+\section{The bibliography file}
+Our \textbf{bibliography collection} consists of multiple literature entries in a pre-defined format, such that they can be processed by Bib\TeX{}.
+An exemplary item can be seen in \cref{lst:bibfile-sample-entry}.
 
 \begin{figure}[H]
   \begin{minted}[autogobble]{latex}
-  @article{turing1990, % Dokumentenart und Bezeichner für den \cite-Befehl
-    title={The chemical basis of morphogenesis}, % Titel
-    author={Turing, Alan Mathison}, % Autor
-    journal={Bulletin of mathematical biology}, % Titel des Journals
-    volume={52}, % Band des Journals
-    pages={153--197}, % Seitenzahl im Journal
-    year={1990}, % Erscheinungsjahr
-    publisher={Springer} % Verleger des Journals
+  @article{turing1990,
+    title={The chemical basis of morphogenesis},
+    author={Turing, Alan Mathison},
+    journal={Bulletin of mathematical biology},
+    volume={52},
+    pages={153--197},
+    year={1990},
+    publisher={Springer}
   }
   \end{minted}
-  \caption{Beispielhafter Eintrag einer .bib-Datei}
+  \caption{Exemplary bibliography entry}
   \label{lst:bibfile-sample-entry}
 \end{figure}
 
-Nach einem \texttt{@}-Zeichen wird die Art des Literaturverzeichniseintrags angegeben (z.\,B. article, book, proceedings).
-Es folgt eine Auflistung wichtiger Attribute wie Titel, Autor:in und – abhängig vom Eintragstyp – weiterer Felder.
-Der erste Eintrag nach der öffnenden geschwungenen Klammer ist der wichtigste: 
-Unter diesem Kürzel wird der Eintrag später in \LaTeX{} angesprochen.
-Diese sogenannten Bib\TeX-Keys müssen eindeutig sein und können frei vergeben werden.
-Üblich sind Kombinationen aus Autor:innen, Publikationsjahren und Themen.
+The type of the bibliography entry is specified after the opening \texttt{@} sign (e.\,g., article, book, proceedings, …).
+What follows is a list of important attributes like title and author.
+Whether they are required or not depends on the entry type.
+In any case, we will need the first entry after the opening braces: the Bib\TeX{} key.
+This is the identifier that we will use to reference the entry in our \LaTeX{} document.
+Bib\TeX{} keys can be chosen freely, but have to be unique.
+Typically, they will consist of a combination of authors, publication dates, and topics.
 
-Die .bib-Datei kann manuell zusammengetragen werden.
-Viel häufiger allerdings werden dafür Programme wie JabRef,\footnote{Vgl. \url{https://www.jabref.org/}.} Zotero\footnote{Vgl. \url{https://www.zotero.org/}.} oder das weit verbreitete Citavi\footnote{Vgl. \url{https://www.citavi.com/de}.} verwendet.
-Während JabRef direkt eine .bib-Datei als Datenbank verwendet, lassen sich Zotero- und Citavi-Projekte\footnote{Vgl. \url{https://www1.citavi.com/sub/manual5/de/exporting_to_bibtex.html}.} in .bib-Dateien exportieren.
+\textbf{Bibliography files} can be compiled manually, yet it is more common to use programs like JabRef,\footnote{Cf. \url{https://www.jabref.org/}.} Zotero\footnote{Cf. \url{https://www.zotero.org/}.} or the widely-used software Citavi\footnote{Vgl. \url{https://www.citavi.com/de}.}.
+While JabRef operates directly on your bibliography file, Zotero and Citavi projects\footnote{Vgl. \url{https://www1.citavi.com/sub/manual5/de/exporting_to_bibtex.html}.} can be exported to bibliography files to use them in \LaTeX{} documents.
 
-.bib-Datei-Einträge werden unter anderem auch von Google Scholar zur Verfügung gestellt (vgl. \cref{fig:google-scholar-bibtex}).
-Hierbei ist es wichtig, darauf zu achten, dass die Einträge einheitlich und möglichst vollständig sind.
-Als hochwertige (wenn auch leider nicht vollständige) Quelle für Bib\TeX-Einträge kann die dblp Computer Science Library\footnote{Verfügbar unter \url{https://dblp.org/search}.} dienen.
+\textbf{Bibliography entries} are provided by many academic search engines, including Google Scholar (cf. \cref{fig:google-scholar-bibtex}).
+When using them, make sure that the entries are cohesive across your reference collection and complete with regard to their attributes.
+A high-quality (although, unfortunately, incomplete) source for Bib\TeX{} entries is the dblp Computer Science Library\footnote{Available at \url{https://dblp.org/search}.}.
 
 \begin{figure}[H]
   \includegraphics[width=\textwidth]{graphics/google_bibtex1.jpg}  
   \includegraphics[width=\textwidth]{graphics/google_bibtex2.jpg}  
-  \caption{Bib\TeX-Einträge in Google Scholar abrufen}
+  \caption{Loading Bib\TeX{} entries from Google Scholar}
   \label{fig:google-scholar-bibtex}
 \end{figure}
 
-\section{Zitieren}
-Durch Bib\TeX{} wird \LaTeX{} um einige Befehle zum Zitieren erweitert (vgl. \cref{tbl:bibtex-commands}). 
-Zusätzlich benötigt wird das Paket \mintinline{sh}{natbib}.
+\section{Citing}
+Bib\TeX{} extends \LaTeX{} by several commands (cf. \cref{tbl:bibtex-commands}). 
+Make sure to include the \mintinline{sh}{natbib} package for this purpose.
 
 \begin{table}[H]
   \centering
   \begin{tabular}{ll}
   \toprule
-  Funktion                 & Befehl \\ \midrule
-  Quelle zitieren          & \mintinline{latex}{\cite{<quelle>}} \\
-  Seite zitieren           & \mintinline{latex}{\cite[S. 15]{<quelle>}} \\
-  Weitere Zusätze zitieren & \mintinline{latex}{\cite[<präfix>][<suffix>]{<quelle>}} \\
-  .bib-Datei einbinden     & \mintinline{latex}{\bibliography{<.bib-datei>}} \\
-  Zitierstil ändern        & \mintinline{latex}{\bibliographystyle{<zitierstil>}} \\ \bottomrule
+  Function                 & Command \\ \midrule
+  Citing sources           & \mintinline{latex}{\cite{<source>}} \\
+  Citing pages             & \mintinline{latex}{\cite[p. 15]{<source>}} \\
+  Custom citations         & \mintinline{latex}{\cite[<prefix>][<suffix>]{<source>}} \\
+  Including the bibliography     & \mintinline{latex}{\bibliography{<bibliographyfile>}} \\
+  Setting the bibliography style & \mintinline{latex}{\bibliographystyle{<style>}} \\ \bottomrule
   \end{tabular}
-  \caption{Befehle zum Zitieren von Literatur}
+  \caption{Commands for citations}
   \label{tbl:bibtex-commands}
 \end{table}
 
-Als \mintinline{latex}{<quelle>} einer Zitation wird immer der Bib\TeX-Key angegeben.
-Verfügbare Zitierstile\footnote{Eine vollständigere Liste ist bei Overleaf zu finden: \url{https://www.overleaf.com/learn/latex/Biblatex_citation_styles}} sind zum Beispiel alpha, natdin und apa.
-Das Literaturverzeichnis erscheint immer an der Stelle, an der der Befehl \mintinline{latex}{\bibliography{…}} aufgerufen wurde.
-Zum Befehl \mintinline{latex}{\cite} existieren zahlreiche weitere Varianten.\footnote{Vgl. \url{https://www.economics.utoronto.ca/osborne/latex/BIBTEX.HTM.}}
+The \mintinline{latex}{<source>} of a citation is always a Bib\TeX key.
+The list of available citation styles\footnote{Head to Overleaf for a rather complete list: \url{https://www.overleaf.com/learn/latex/Biblatex_citation_styles}} includes alpha, natdin, and apa.
+The table of references will always appear where the \mintinline{latex}{\bibliography{…}} command was put.
+The \mintinline{latex}{\cite} command comes with many variants.\footnote{Cf. \url{https://www.economics.utoronto.ca/osborne/latex/BIBTEX.HTM.}}
 
-\Example{lst:natdin-example}{literature/natdin-example}{literature/natdin-example_bib}{Beispiel für Zitationen im Stil \mintinline{latex}{natdin}.}
+\Example{lst:natdin-example}{literature/natdin-example}{literature/natdin-example_bib}{Examplery citations in the \mintinline{latex}{natdin} style.}

exercises/literature/literature.done.tex

@@ -1,10 +1,10 @@
 \inputminted[breaklines]{bibtex}{exercises/literature/literature.done.bib}
 
 \begin{minted}[breaklines]{latex}
-Das erstgenannte Buch \citep{lamport1994} wurde vom Schöpfer von LaTeX, Leslie Lamport, selbst verfasst.
-Da es bereits etwas betagter ist, geben wir euch mit \glqq{}\LaTeX\ in 24 Hours\grqq{} \citep{datta2017} noch ein aktuelleres Buch in die Hand.
-Es gibt eine Unmenge weiterer Handbücher \citep*[u.\thinspace a.][]{goossensmittelbach2002}.
+The first-mentioned book \citep{lamport1994} has been written by the creator of \LaTeX{}, Leslie Lamport himself.
+A more recent publication is \glqq{}\LaTeX\ in 24 Hours\grqq{} \citep{datta2017}.
+There is a plethora of further handbooks \citep*[e.\,g.,][]{goossensmittelbach2002}.
 
 \bibliographystyle{natdin}
 \bibliography{exercises/literature/literature.done.bib}
-\end{minted}
+\end{minted}

exercises/literature/literature.raw.tex

@@ -1,6 +1,6 @@
-Das erstgenannte Buch (Lamport, 1994) wurde vom Schöpfer von LaTeX, Leslie Lamport, selbst verfasst.
-Da es bereits etwas betagter ist, geben wir euch mit \glqq{}\LaTeX\ in 24 Hours\grqq{} (Datta, 2017) noch ein aktuelleres Buch in die Hand.
-Es gibt eine Unmenge weiterer Handbücher (u.\thinspace a. Goossens, Mittelbach u. Samarin, 2002).
+The first-mentioned book (Lamport, 1994) has been written by the creator of \LaTeX{}, Leslie Lamport himself.
+A more recent publication is \glqq{}\LaTeX\ in 24 Hours\grqq{} (Datta, 2017).
+There is a plethora of further handbooks (e.\,g., Goossens, Mittelbach and Samarin, 2002).
 
 ~\\
 

exercises/literature/task.tex

@@ -1,18 +1,19 @@
 \begin{enumerate}
-  \item Sucht bei Google Scholar die Bib\TeX-Einträge für folgende \LaTeX"=Handbücher:
+  \item Use Google Scholar to retrieve Bib\TeX{} entries for the following \LaTeX{}
+  handbooks:
   \begin{itemize}
     \item Leslie Lamport (1994): \LaTeX. A Document Preparation System.
     \item Dilip Datta (2017): \LaTeX\ in 24 Hours. A Practical Guide for Scientific Writing.
     \item Frank Mittelbach / Michel Goossens (2002): Der \LaTeX-Begleiter.
   \end{itemize}
-  \item Vergleicht die Einträge mit den Ergebnissen, die euch \url{dblp.org} für dieselben Bücher liefert.
-  \item Erstellt im Ordner \mintinline{latex}{exercises/literature} eine neue Bib\TeX-Datei mit dem Namen \mintinline{sh}{literature.bib}.
-  \item Fügt die Bib\TeX-Einträge in die Bib\TeX-Datei ein. Wählt hierfür aus Google Scholar und dblp die aus eurer Sicht geeigneteren Einträge.
-  \item Vergebt aussagekräftige Bib\TeX-Keys.
-  \item Bindet die Bib\TeX-Datei an einer geeigneten Stelle ein, an der später auch das Literaturverzeichnis zu sehen sein soll.
-  \item Zitiert die drei Handbücher in der Datei\\\mintinline{sh}{exercises/literature/literature.tex}.
-  \item Wählt den Bibliographiestil \mintinline{sh}{natdin}.
-  \item \textbf{Hinweis}: Sollte das Kompilieren fehlschlagen, kann es hilfreich sein, einmal alle Hilfsdateien (\mintinline{sh}{main.aux/bbl/blg/loc/out/pdf/soc/toc}) zu löschen und neu zu kompilieren.
+  \item Compare the entries with the results that \url{dblp.org} finds for the same titles.
+  \item Create a new Bib\TeX{} file called \mintinline{sh}{literature.bib} in the \mintinline{latex}{exercises/literature} folder.
+  \item Add the Bib\TeX{} entries to the newly created Bib\TeX{} files. For this, select your preferred source among Google Scholar and dblp.
+  \item Assign unique and meaningful Bib\TeX{} keys.
+  \item Include the Bib\TeX{} file in a suitable location, where later on the references should be listed.
+  \item Cite the three handbooks in the file\\\mintinline{sh}{exercises/literature/literature.tex}.
+  \item Make use of the \mintinline{sh}{natdin} biliography style.
+  \item \textbf{Note}: If compiling fails, it may help to remove all auxiliary files \\(\mintinline{sh}{main.aux/bbl/blg/loc/out/pdf/soc/toc}) before compiling again.
 \end{enumerate}
 
 \exercisematerial{exercises/literature/literature}

listings/literature/natdin-example.tex

@@ -1,3 +1,3 @@
-Dieser Text lebt von prominent platzierten Zitaten \cite[u.\thinspace a.][]{Frank1957} noch viel prominenterer literarischer Werke \cite[vgl.][S. 7]{Orwell1957}, derer \cite{Hawking1988} nur eines ist.
+This text thrives on prominently-placed citations \cite[e.\,g.,][]{Frank1957} of much more prominent literary works \cite[cf.][p. 7]{Orwell1957}, of which \cite{Hawking1988} is only one.
 \bibliographystyle{natdin}
 \bibliography{collection}

listings/literature/natdin-example_bib.tex

@@ -1,12 +1,12 @@
 \documentclass[a5paper, pdftex, 12pt]{scrartcl}
 \usepackage[utf8]{inputenc}
 \usepackage[T1]{fontenc}
-\usepackage[ngerman]{babel}
+\usepackage[english]{babel}
 \usepackage{natbib}
 \begin{document}
 \thispagestyle{empty}
 
-Dieser Text lebt von prominent platzierten Zitaten \cite[u.\thinspace a.][]{Frank1957} noch viel prominenterer literarischer Werke \cite[vgl.][S. 7]{Orwell1957}, derer \cite{Hawking1988} nur eines ist.
+This text thrives on prominently-placed citations \cite[e.\,g.,][]{Frank1957} of much more prominent literary works \cite[cf.][p. 7]{Orwell1957}, of which \cite{Hawking1988} is only one.
 \bibliographystyle{natdin}
 \bibliography{listings/literature/collection}