latex-wochenende/slides/intro.en.md
2025-11-16 18:17:35 +01:00

168 lines
5.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

@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://git.stuve-bamberg.de/latex/latex-skript/).
* 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/intro/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**, 19771986: 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/intro/knuth.jpg" style="height: 13em"/><figcaption>Donald Knuth</figcaption></figure>
<figure><img src="svg/intro/lamport.jpg" style="height: 13em"/><figcaption>Leslie Lamport</figcaption></figure>
:::
@preview
![](svg/intro/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, 82598273 (2021).
<p 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.)</p>
:::
@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/intro/xkcd-types-of-editors.png)
@slide(layout=preview-only)
@preview
![How to get the final document](svg/intro/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://git.stuve-bamberg.de/latex/latex-skript/src/branch/master/docs/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 `install-verification/main.tex` in T<sub style="font-size: 100%; margin-left: -.1em">E</sub>Xstudio.
* Compile the file by pressing <span class="emoji"></span>
* Have a look at the new files that 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 website impressively demonstrates the role played by fonts and font sizes, line spacing and many other factors:
[https://legibility.info/legible-readable](https://legibility.info/legible-readable)
The best thing about it: LaTeX does most of this manual work for us.