@slide(layout=chapter-slide)

@title
How does <br/>L<sup style="font-weight: bold; font-size: 73%; margin-left: -.25em; margin-right: -.05em; position: relative; top: .2em">A</sup>T<sub style="font-size: 100%; margin-left: -.1em">E</sub>X work?


@slide(layout=content-and-preview)

@title
WYSIWhat?

@content
### What You See Is What You Get {data-category=Word}

* Formatting with immediate visual feedback

<div class="fragment">
### What You See Is What You Mean {data-category=LaTeX}

* Separation of content and structure
* Formatting only visible afterwards
</div>

<p style="margin-top:calc(.25 * var(--square));">
    Image source: <a href="https://xkcd.com/1341/">xkcd</a>
</p>

@preview
![](svg/chapter-02/xkcd-types-of-editors.png)


@slide(layout=preview-only)

@preview
![How to get the final document](svg/chapter-02/wysiwyg.svg){}


@slide(layout=two-columns)

@title
What do we need?

@column-one
### Editor
writing our source code including all the commands that structure the text semantically

[TeXstudio](http://www.texstudio.org/), [TeXMaker](https://www.xm1math.net/texmaker/)

@column-two
### Compiler
takes the source code and creates a PDF document ready for publication

[MiKTeX](http://miktex.org/), [MacTeX](http://tug.org/mactex/), [TeX Live](https://tug.org/texlive/)


@slide(layout=wide-content)

@title
Commands

@content
General structure of a command:

``` {.lang-tex .tex .hljs}
\<command>[<optional_parameters>]{<obligatory_parameters>}
```

++ A few examples:

``` {.lang-tex .tex .hljs .fragment}
\newpage % inserts a new page
\textbf{<text>} % formats the text bold
\usepackage[utf8]{inputenc} % configures the character encoding
\frac{<numerator>}{<denominator>} % inserts a mathematical fraction
```


@slide(layout=content-only)

@title
Backslash

@content
You get the backslash by pressing

<kbd>AltGr</kbd>&nbsp;+&nbsp;<kbd>ß</kbd>&nbsp;(Windows/Linux)

<kbd>Alt</kbd>&nbsp;+&nbsp;<kbd>Shift</kbd>&nbsp;+&nbsp;<kbd>7</kbd>&nbsp;(MacOS)


@slide(layout=wide-content)

@title
Optional parameters

@content
Square brackets may contain different numbers of optional parameters:

``` {.lang-tex .hljs}
\usepackage[utf8]{inputenc}
% configures the text encoding

\documentclass[a4paper,12pt]{article}
% configures the document class

\includegraphics[width=12cm,height=4cm]{image.png}
% embeds the image file "image.png"
```

@slide(layout=content-and-preview)

@title
Comments

@content
After a percent sign, the rest of the line is ignored by the compiler. It is called a comment and does not appear in the resulting document.

``` {.lang-tex .hljs}
% profile start
Name: Donald Knuth \\
Geburtsdatum: \\ % TODO: insert
Geburtsort: Milwaukee, Wisconsin
% profile end
```

Shortcuts: <kbd>Ctrl</kbd> + <kbd>T</kbd> and <kbd>Ctrl</kbd> + <kbd>U</kbd>

@preview
![](svg/chapter-02/comments-crop.svg)


@slide(layout=content-only)

@title
Software installation

@content
Please install **the compiler first** (MikTeX on Windows, MacTeX on MacOS, TeX Live on Linux), **followed by the editor.** In this workshop, we use TeXstudio.

* MikTeX (Windows): <https://miktex.org/>
* MacTeX (MacOS): <http://tug.org/mactex/>
* TeX Live (Linux/all OS): <https://tug.org/texlive/>
* TeXstudio: <https://www.texstudio.org/>


@slide(layout=task)

@task-number
2

@title
First steps with LaTeX

@content
* ++ If necessary: Install now!
* ++ Download the project archive from the VC. Unzip the archive.
* ++ Open the file `main.tex` in TeXstudio. It is located in the root directory of the archive.
* ++ Navigate to the command settings of TeXstudio: Options -> Configure TeXstudio... -> Commands
* ++ Change the compiler command for PdfLaTeX to: `pdflatex -synctex=1 -interaction=nonstopmode  -shell-escape %.tex`. 
* ++ Compile `main.tex` by pressing <span class="emoji">⏩</span>.
* ++ What happened to the folder that contains the file?