@slide(layout=content-and-preview)

@title
Procedure of this workshop

@content
**Goal:** You are going to build your own little <br />LaTeX manual based on our [LaTeX Script](https://github.com/fs-wiai/latex-script/).

* learning by doing
* understanding how LaTeX works
* details can be looked up later

::: {.fragment}
**Outline:**

1. What is LaTeX?
2. Basic LaTeX documents
3. More complex projects
4. Lots of features
5. Reference management
6. Outlook
:::

@preview
![](svg/chapter-01/cover-script.jpeg)

@slide(layout=chapter-slide)

@number
1

@title
What is 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?


@slide(layout=content-and-preview)

@title
Origin

@content
* Donald **Knuth**, 1977–1986: typesetting system **TeX**<span class="bubble fragment" style="margin-top: -3em;">τεχ → /tɛç, tɛx, tɛk/</span> for The Art of Computer Programming
* Leslie **Lamport**, from 1980s: software package **LaTeX** made TeX easier to use

:::{style="display: flex; justify-content: space-between; align-items: stretch;"}
<figure><img src="svg/chapter-01/knuth.jpg" style="height: 13em"/><figcaption>Donald Knuth</figcaption></figure>
<figure><img src="svg/chapter-01/lamport.jpg" style="height: 13em"/><figcaption>Leslie Lamport</figcaption></figure>
:::

@preview
![](svg/chapter-01/taocp.jpg)


@slide(layout=content-only)

@title
5 Reasons for LaTeX

@content
1. Besides Word, LaTeX is **one of the two dominant typesetting systems** in the academic world.
2. ++ **Mathematical formulas** feel most at home in LaTeX. This is why the LaTeX formula notation has been integrated into numerous other tools (e.&thinsp;g. OneNote, Word, Wikipedia, …).
3. ++ There are **countless packages** for the most diverse areas of application.
4. ++ LaTeX was developed to produce **aesthetically pleasing typesetting**&thinsp;—&thinsp;and you can see that in the texts it produces.
5. ++ Complex documents typeset in LaTeX **facilitate collaboration** enormously (e.&thinsp;g. through versioning, proper document structuring, templates, reliable undo, …).


@slide(layout=content-only)

@title 
LaTeX' Shortcomings

@content
* Typesetting text can be **cumbersome**, especially for short documents.
* **Layout adjustments** are only possible within certain limits.

::: {.box .warning .fragment}
The “LaTeX vs. Word” debate is very old. If you are interested in tracing it, we can recommend the following article as a starting point:

Moorhead, A.V. [**Is LaTeX use correlated with the number of equations in a manuscript?**](https://doi.org/10.1007/s11192-021-04119-2) Scientometrics 126, 8259–8273 (2021).

<small style="font-size: 60%; line-height: 1.5em">(TL;DR: LaTeX users make more errors, they need more time except when it comes to formulas, but they are happier with their tool.)</small>
:::

@slide(layout=content-and-preview)

@title
WYSIWhat?

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

* Formatting with immediate visual feedback

::: {.fragment}
### What You See Is What You Mean {data-category=LaTeX}

* Separation of content and structure
* Formatting only visible afterwards
:::

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

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


@slide(layout=preview-only)

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


@slide(layout=two-columns)

@title
What do we need?

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

[MiKTeX](http://miktex.org/) (Windows), [MacTeX](http://tug.org/mactex/) (macOS)  
[TeX Live](https://tug.org/texlive/) (Linux, preferably `texlive-full`)

::: {.box .warning .fragment}
On **Windows**, please open the MikT<sub style="font-size: 100%; margin-left: -.1em">E</sub>X Console once and search for updates.
:::

@column-two
::: {.fragment}
### Editor
writing our source code including all the commands that structure the text semantically

[TeXstudio](http://www.texstudio.org/) (recommended), [VS Codium](https://vscodium.com) (for advanced users, instructions on [Github](https://github.com/fs-wiai/latex-script/blob/github/vs-code-instructions.md))
:::

@slide(layout=task)

@task-number
1

@title
Compile the script for&nbsp;the&nbsp;first&nbsp;time

@content
* Download the project archive from the VC. 
* Unzip the archive.
* Open the file `main-exercises.tex` in T<sub style="font-size: 100%; margin-left: -.1em">E</sub>Xstudio. It is located in the root directory of the archive.
* Compile `main-exercises.tex` by pressing <span class="emoji">⏩</span>
* A few new files will be generated by the compilation.

::: {.box .warning}
**Windows**: In order to enable file endings, click the view tab in the file explorer, and select *file name extensions*. This helps differentiating the different ``main`` files.
:::

@slide(layout=extra-content-only)

@title 
Micro- and Macrotypography

@content
Text typesetting is particularly good when it is not conspicuous. Or to put it another way: Good typesetting makes for effortless reading. This (German) website impressively demonstrates the role played by fonts and font sizes, line spacing and many other factors:

[https://leserlich.info/leserlich-und-lesbar](https://leserlich.info/leserlich-und-lesbar)

The best thing about it: LaTeX does most of this manual work for us.