168 lines
5.4 KiB
Markdown
168 lines
5.4 KiB
Markdown
@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
|
||
|
||
|
||
@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/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
|
||
|
||
|
||
|
||
@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. 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** — and you can see that in the texts it produces.
|
||
5. ++ Complex documents typeset in LaTeX **facilitate collaboration** enormously (e. 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).
|
||
|
||
<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
|
||
|
||
|
||
|
||
@slide(layout=preview-only)
|
||
|
||
@preview
|
||
{}
|
||
|
||
|
||
@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 the first 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 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. |