From f20b039b80bbe73d2ca751dcafc6f1b6cbde170b Mon Sep 17 00:00:00 2001 From: Christian Kremitzl Date: Sun, 18 Jul 2021 23:02:49 +0200 Subject: [PATCH] Translate chapter 0. --- content/first-steps-with-latex.tex | 74 ++++++++++++++++-------------- 1 file changed, 39 insertions(+), 35 deletions(-) diff --git a/content/first-steps-with-latex.tex b/content/first-steps-with-latex.tex index 402b0dd..a00fe3c 100644 --- a/content/first-steps-with-latex.tex +++ b/content/first-steps-with-latex.tex @@ -1,44 +1,48 @@ -\chapter*{Erste Schritte mit \LaTeX} -\addcontentsline{toc}{section}{Erste Schritte mit \LaTeX} +\newpage +\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. -Viele Aufgaben erfordern es, das Skript selbst anzupassen. -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. +\chapter*{First steps with \LaTeX} +\addcontentsline{toc}{section}{First steps with \LaTeX} -Bevor wir ins Arbeiten mit \LaTeX{} einsteigen können, müssen wir es natürlich zunächst installieren. -Außerdem müssen wir einige Anpassungen vornehmen, um mit diesem Projekt arbeiten zu können. -Alle Schritte erläutern wir in den folgenden Kapiteln näher. -Nach und nach werdet ihr so ein Verständnis der Arbeitsweise mit \LaTeX{} aufbauen. -Für den Anfang folgt einfach der Anleitung. -Achtet bitte darauf, dass ihr \emph{zuerst} den Compiler und \emph{danach} einen Editor installiert. +This script serves as a short reference on handling \LaTeX{} and as exercise material für the \LaTeX{} workshop of the Fachschaft \acro{WIAI}. +Many tasks require you to modify the script on your own. +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}} + +Before we can dive into \LaTeX{}, we will obviously have to install it. +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} -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. +Let’s 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} -Sobald ihr das gemacht habt, könnt ihr euch auch schon einen Editor -herunterladen, in dem ihr eure \LaTeX-Dokumente gerne schreiben möchtet. Dafür -ist eigentlich jeder Editor geeignet (notepad++, Atom, VS Code, usw.). Wir -empfehlen für Anfänger jedoch ein Programm, das \LaTeX-spezfische Funktionen -besitzt, wie etwa TeXstudio.\footnote{Eine aktuelle Version findet ihr unter -\url{https://www.texstudio.org/}.} +As soon as you have installed the compiler, you can download an editor that you are going to use to write your \LaTeX{} documents. +Any editor will do (notepad++, Atom, VS Code, etc.). +However, for beginners, we do recommend to use a program that supports you with \LaTeX-specific features. +One of them is TeXstudio.\footnote{You find the latestt version on \url{https://www.texstudio.org/}.} -\section*{Compilerbefehl ändern} -Damit es beim Kompilieren dieses Dokuments nicht zu Fehlern kommt, müsst ihr -nun den Compilerbefehl ändern. Klickt dazu in TeXstudio zunächst auf die -Schaltfläche \emph{Optionen} und anschließend auf \emph{TeXstudio -konfigurieren \textellipsis}. Danach wird sich ein neues Fenster öffnen. Dort navigiert -ihr zum Bereich \emph{Befehle} und setzt bei \emph{PdfLaTeX} das Flag -\mintinline{bash}{-shell-escape}. In anderen Worten: Der Text bei -\emph{PdfLaTeX} sollte folgendermaßen lauten: -\mint{bash}{pdflatex -synctex=1 -interaction=nonstopmode -shell-escape -%.tex} +\section*{Changing the compiler command} +To prevent errors during the compilation of our document, you have to change the compiler command. +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 don’t apply)}. +A new window will open up. +Navigate to the \emph{commands} area and, at \emph{PdfLaTeX}, add the flag \mintinline{bash}{-shell-escape}. +In other words: The command for \emph{PdfLaTeX} should look like this: +\mint{bash}{pdflatex -synctex=1 -interaction=nonstopmode -shell-escape %.tex} -\section*{Das erste Mal kompilieren} -Öffnet nun die Datei \mintinline{bash}{main.tex} im Wurzelverzeichnis des -Projektes und kompiliert sie durch Druck auf \faForward. -In dem Ordner, in dem die Datei liegt, sollten verschiedene neue Dateien erschienen sein. -Die Datei \mintinline{bash}{main.pdf} enthält das kompilierte Dokument. -Außerdem sind einige Hilfsdateien aufgetaucht, die der Compiler zum Beispiel nutzt, um das Inhaltsverzeichnis zu generieren. -Damit seid ihr startklar! +\section*{Compiling for the first time} +Open up the file \mintinline{bash}{main.tex} in the root directory of the project and compile it by pressing \faForward. +Looking at the directory, you should see a few new files. +The \mintinline{bash}{main.pdf} file contains the compiled document. +The other files are auxiliary files that the compiler uses, for example, to generate the table of contents. +You are now ready to go! + +\newpage +\nopagecolor