modify first version of translated basic-document-structure

This commit is contained in:
Fradtschuk 2021-06-24 18:15:57 +02:00
parent fd9336f7f5
commit 2c2f6090fc

View File

@ -1,11 +1,11 @@
\chapter{Basic Document Structure} \chapter{Basic Document Structure}
\label{sec:basic-document-structure} \label{sec:basic-document-structure}
How does a \LaTeX document really look like? How does a \LaTeX{} document look like?
In essence, every \LaTeX document is composed of two parts: the first part is In essence, every \LaTeX{} document is composed of two parts: the first part is
the preamble which is followed by the second part, the document environment. the preamble which is followed by the second part, the document environment.
The \emph{preamble} are the first commands within our \LaTeX document and it We call the first commands within our \LaTeX{} document a \emph{preamble}. It
contains global information about our document, such as the document class that contains global information about our document, such as the document class that
we want to use, the encoding, the language, the page format, and additional we want to use, the encoding, the language, the page format, and additional
packages that we use. packages that we use.
@ -14,7 +14,7 @@ of our document, that is, the things that we will later see in our generated
\acro{PDF} file. \acro{PDF} file.
\Example{lst:latex-document-basic-structure}{basic-document-structure/hello-world}{basic-document-structure/hello-world_crop}{Beispielhafter \Example{lst:latex-document-basic-structure}{basic-document-structure/hello-world}{basic-document-structure/hello-world_crop}{Beispielhafter
Structure of a simple \LaTeX document with preamble and document Structure of a simple \LaTeX{} document with preamble and document
environment} environment}
\section{Preamble} \section{Preamble}
@ -28,7 +28,7 @@ commonly used document classes that are supported by default are
\mintinline{latex}{article} for short documents, and \mintinline{latex}{report} \mintinline{latex}{article} for short documents, and \mintinline{latex}{report}
for longer ones. Futhermore you can use \mintinline{latex}{book} for books, for longer ones. Futhermore you can use \mintinline{latex}{book} for books,
\mintinline{latex}{beamer}\footnote{We do not cover making presentations in \mintinline{latex}{beamer}\footnote{We do not cover making presentations in
\LaTeX in this tutorial. However, if you are interested in the topic, we \LaTeX{} in this tutorial. However, if you are interested in the topic, we
recommend this introduction on Overleaf: recommend this introduction on Overleaf:
\url{https://www.overleaf.com/learn/latex/Beamer}} for presentations, and \url{https://www.overleaf.com/learn/latex/Beamer}} for presentations, and
\mintinline{latex}{letter}\footnote{We also do not cover letters in this \mintinline{latex}{letter}\footnote{We also do not cover letters in this
@ -55,7 +55,7 @@ Each \mintinline{latex}{\documentclass} command can hold optional parameters in
square brackets. square brackets.
\mintinline{latex}{\documentclass[10pt,a5paper,landscape]{scrartcl}}, for \mintinline{latex}{\documentclass[10pt,a5paper,landscape]{scrartcl}}, for
instance, configures a \acro{KOMA} script article ans specifies its font size instance, configures a \acro{KOMA} script article ans specifies its font size
to 10,\pt\footnote{The standard font size is 12,pt.}, sets the page size to to 10\,pt\footnote{The standard font size is 12,pt.}, sets the page size to
A5\footnote{The default case would be A4} and the orientation of the page to A5\footnote{The default case would be A4} and the orientation of the page to
landscape. The language can be passed as an optional parameter, too (cf. landscape. The language can be passed as an optional parameter, too (cf.
\cref{sec:language}). \cref{sec:language}).
@ -66,11 +66,11 @@ landscape. The language can be passed as an optional parameter, too (cf.
\usepackage[<optionen>]{<paketname>} \usepackage[<optionen>]{<paketname>}
\end{minted} \end{minted}
Packages provide additional commands and functionalities that we can use within Packages provide additional commands and functionalities that we can use within
our \LaTeX source code. There are numerous packages for different use cases our \LaTeX{} source code. There are numerous packages for different use cases
(e.\,g. typesetting forumlas, lists, \textellipsis). (e.\,g. typesetting forumlas, lists, \textellipsis).
In order make use of a package, it must be included within the preamble. To do In order make use of a package, it must be included within the preamble. To do
so, the above-mentioned command is used. so, the above-mentioned command is used.
The most important \LaTeX packages can be found n the Comprehensive \TeX\ The most important \LaTeX{} packages can be found n the Comprehensive \TeX\
Archive Network,\footnote{Available at: \url{https://www.ctan.org/}}, short: Archive Network,\footnote{Available at: \url{https://www.ctan.org/}}, short:
\acro{CTAN}. You can also find the documentations for the packages there. \acro{CTAN}. You can also find the documentations for the packages there.
@ -80,11 +80,11 @@ Archive Network,\footnote{Available at: \url{https://www.ctan.org/}}, short:
\usepackage[t1] \usepackage[t1]
\end{minted} \end{minted}
One use case for packages is specifying the encoding of our \LaTeX document. One use case for packages is specifying the encoding of our \LaTeX{} document.
The character encoding\footnote{Vgl. The character encoding\footnote{Vgl.
\url{https://en.wikipedia.org/wiki/Character_encoding}} determines the \url{https://en.wikipedia.org/wiki/Character_encoding}} determines the
available character set. available character set.
The standard encoding in \LaTeX is \acro{ASCII}. \footnote{cf. The standard encoding in \LaTeX{} is \acro{ASCII}. \footnote{cf.
\url{https://de.wikipedia.org/wiki/American_Standard_Code_for_Information_Interchange}} \url{https://de.wikipedia.org/wiki/American_Standard_Code_for_Information_Interchange}}
It is an American character encoding and therefore does, for instance, not It is an American character encoding and therefore does, for instance, not
contain German umlauts, or other special characters, which makes it unsuitable contain German umlauts, or other special characters, which makes it unsuitable
@ -94,7 +94,7 @@ As a consequence, \acro{UTF-8}footnote{cf.
character character
encoding. encoding.
In \LaTeX we need to specify two character encodings: In \LaTeX{} we need to specify two character encodings:
The input encoding (short: \mintinline{latex}{inputenc})) which refers to our The input encoding (short: \mintinline{latex}{inputenc})) which refers to our
source code. The font encoding (short: \mintinline{latex}{fontenc}) concerncs source code. The font encoding (short: \mintinline{latex}{fontenc}) concerncs
the choice of the file that is used to portray the content of our document the choice of the file that is used to portray the content of our document
@ -137,7 +137,7 @@ The actual content of your \acro{PDF} document needs to be put between
\subsection{Continuous Text} \subsection{Continuous Text}
The easiest that you can integrate into the document environment is continuous The easiest that you can integrate into the document environment is continuous
text. You can directly write it into your source code. Line breaks and multiple text. You can directly write it into your source code. Line breaks and multiple
spaces are ignored by \LaTeX. Blank lines create a new paragraph, which are spaces are ignored by \LaTeX{}. Blank lines create a new paragraph, which are
indented by default. \footnote{The automatic indentation of new paragraphs can indented by default. \footnote{The automatic indentation of new paragraphs can
be prevented by using the command \mintinline{latex}{\noindent}.} be prevented by using the command \mintinline{latex}{\noindent}.}
Manual linebreaks can be forced with two backslashes Manual linebreaks can be forced with two backslashes
@ -161,7 +161,7 @@ additional special characters can be found in \cref{sec:special-characters}.}
\subsection{Sections and Chapters} \subsection{Sections and Chapters}
Continuous text can be structured by headings that divide the document into Continuous text can be structured by headings that divide the document into
sections and chapters. Needless to say, \LaTeX provides us with commands for sections and chapters. Needless to say, \LaTeX{} provides us with commands for
that. that.
The commands that are depicted in \cref{lst:headlines} can be used with any The commands that are depicted in \cref{lst:headlines} can be used with any
document class. document class.
@ -207,7 +207,7 @@ table of contents of it (like in \cref{lst:main-file} on
The numbering style, the depth of the numbering and many other options can, of The numbering style, the depth of the numbering and many other options can, of
course, be adapted. \footnote{We recommend the following blogpost: course, be adapted. \footnote{We recommend the following blogpost:
\url{https://texblog.org/2011/09/09/10-ways-to-customize-tocloflot/}} \url{https://texblog.org/2011/09/09/10-ways-to-customize-tocloflot/}}
For \LaTeX to create your table of contents, the project has to be compiled For \LaTeX{} to create your table of contents, the project has to be compiled
twice. twice.
Besides the table of contents, you can also generate a Besides the table of contents, you can also generate a