Translate chapter 0.

This commit is contained in:
Kremitzl 2021-07-18 23:02:49 +02:00
parent 5de5d729c1
commit f20b039b80

View File

@ -1,44 +1,48 @@
\chapter*{Erste Schritte mit \LaTeX} \newpage
\addcontentsline{toc}{section}{Erste Schritte mit \LaTeX} \definecolor{latexblue}{rgb}{0.9,0.925,0.95}
\pagecolor{latexblue}
Dieses Skript dient als kurze Referenz zum Umgang mit LateX und als Übungsbeispiel für das LaTeX-Tutorium der Fachschaft WIAI. \chapter*{First steps with \LaTeX}
Viele Aufgaben erfordern es, das Skript selbst anzupassen. \addcontentsline{toc}{section}{First steps with \LaTeX}
Das dafür benötigte Projektarchiv mit allen Quelltextdateien sowie die aktuellste Version dieses Skriptes sind auf Github\footnote{\url{https://github.com/fs-wiai/latex-script/releases}} zu finden.
Bevor wir ins Arbeiten mit \LaTeX{} einsteigen können, müssen wir es natürlich zunächst installieren. This script serves as a short reference on handling \LaTeX{} and as exercise material für the \LaTeX{} workshop of the Fachschaft \acro{WIAI}.
Außerdem müssen wir einige Anpassungen vornehmen, um mit diesem Projekt arbeiten zu können. Many tasks require you to modify the script on your own.
Alle Schritte erläutern wir in den folgenden Kapiteln näher. The project material with all of the source files and the lastest version of this script can be found on Github.\footnote{\url{https://github.com/fs-wiai/latex-script/releases}}
Nach und nach werdet ihr so ein Verständnis der Arbeitsweise mit \LaTeX{} aufbauen.
Für den Anfang folgt einfach der Anleitung. Before we can dive into \LaTeX{}, we will obviously have to install it.
Achtet bitte darauf, dass ihr \emph{zuerst} den Compiler und \emph{danach} einen Editor installiert. We will also need to do some configuration to be able to work with this project.
All of this will be explained in more detail in the following chapters.
Bit by bit, you will get an understanding of how to work with \LaTeX{}.
For now, just follow our instructions.
Please, make sure to install the \emph{compiler first} and the the \emph{editor afterwards}\textit{.}
\section*{Compiler} \section*{Compiler}
Zunächst zum Compiler. Ihn brauchen wir, um den Quelltext, den wir schreiben, in ein \acro{PDF} umzuwandeln. Hier gibt es für verschiedene Betriebssysteme unterschiedliche Compiler, wie etwa MikTeX für Windows,\footnote{\url{https://miktex.org/download}} MacTex für MacOS\footnote{\url{http://tug.org/mactex/}} und TeXLive für Linux-Distributionen.\footnote{Sofern ihr eine debianbasierte Linux-Distribution verwendet, kann der Compiler mittels \mintinline{bash}{sudo apt install texlive-full} installiert werden. Für andere Distributionen findet ihr eine Anleitung unter \url{https://tug.org/texlive/doc/texlive-en/texlive-en.html\#installation}.} Bestenfalls installiert ihr die volle Version mit allen Paketen. Lets start with the compiler.
We will need it to convert the source code that we are going to write into a \acro{PDF}.
There are different compilers for different operating systems;
for example, MikTeX for Windows,\footnote{\url{https://miktex.org/download}} MacTex for MacOS\footnote{\url{http://tug.org/mactex/}} and TeXLive for Linux distributions.\footnote{If you are using a Debian-based Linux distribution, you can install the compiler by executing \mintinline{bash}{sudo apt install texlive-full}. For other distributions, you find instructions on \url{https://tug.org/texlive/doc/texlive-en/texlive-en.html\#installation}.} In case you get to choose, it is best to install the full version with all packages.
\section*{Editor} \section*{Editor}
Sobald ihr das gemacht habt, könnt ihr euch auch schon einen Editor As soon as you have installed the compiler, you can download an editor that you are going to use to write your \LaTeX{} documents.
herunterladen, in dem ihr eure \LaTeX-Dokumente gerne schreiben möchtet. Dafür Any editor will do (notepad++, Atom, VS Code, etc.).
ist eigentlich jeder Editor geeignet (notepad++, Atom, VS Code, usw.). Wir However, for beginners, we do recommend to use a program that supports you with \LaTeX-specific features.
empfehlen für Anfänger jedoch ein Programm, das \LaTeX-spezfische Funktionen One of them is TeXstudio.\footnote{You find the latestt version on \url{https://www.texstudio.org/}.}
besitzt, wie etwa TeXstudio.\footnote{Eine aktuelle Version findet ihr unter
\url{https://www.texstudio.org/}.}
\section*{Compilerbefehl ändern} \section*{Changing the compiler command}
Damit es beim Kompilieren dieses Dokuments nicht zu Fehlern kommt, müsst ihr To prevent errors during the compilation of our document, you have to change the compiler command.
nun den Compilerbefehl ändern. Klickt dazu in TeXstudio zunächst auf die In TeXstudio, click on the \emph{options} button and then on \emph{Configure TeXstudio \textellipsis}\todo{Need to find out what they are actually called in English. Maybe also add the correct steps for Mac (these dont apply)}.
Schaltfläche \emph{Optionen} und anschließend auf \emph{TeXstudio A new window will open up.
konfigurieren \textellipsis}. Danach wird sich ein neues Fenster öffnen. Dort navigiert Navigate to the \emph{commands} area and, at \emph{PdfLaTeX}, add the flag \mintinline{bash}{-shell-escape}.
ihr zum Bereich \emph{Befehle} und setzt bei \emph{PdfLaTeX} das Flag In other words: The command for \emph{PdfLaTeX} should look like this:
\mintinline{bash}{-shell-escape}. In anderen Worten: Der Text bei \mint{bash}{pdflatex -synctex=1 -interaction=nonstopmode -shell-escape %.tex}
\emph{PdfLaTeX} sollte folgendermaßen lauten:
\mint{bash}{pdflatex -synctex=1 -interaction=nonstopmode -shell-escape
%.tex}
\section*{Das erste Mal kompilieren} \section*{Compiling for the first time}
Öffnet nun die Datei \mintinline{bash}{main.tex} im Wurzelverzeichnis des Open up the file \mintinline{bash}{main.tex} in the root directory of the project and compile it by pressing \faForward.
Projektes und kompiliert sie durch Druck auf \faForward. Looking at the directory, you should see a few new files.
In dem Ordner, in dem die Datei liegt, sollten verschiedene neue Dateien erschienen sein. The \mintinline{bash}{main.pdf} file contains the compiled document.
Die Datei \mintinline{bash}{main.pdf} enthält das kompilierte Dokument. The other files are auxiliary files that the compiler uses, for example, to generate the table of contents.
Außerdem sind einige Hilfsdateien aufgetaucht, die der Compiler zum Beispiel nutzt, um das Inhaltsverzeichnis zu generieren. You are now ready to go!
Damit seid ihr startklar!
\newpage
\nopagecolor