# LaTeX-Beratung

## Motivation

* Was erhoffen Sie sich von LaTeX?
* Wie würden Sie Ihre Computerkenntnisse einschätzen?

## Was erwartet Sie heute?

* Einen praxisorientierten Einblick in den Umgang mit LaTeX (keinen Geschichtsunterricht)!
* Weitergabe von langjähriger Erfahrung - jedoch kein echter Kurs!
* Die Gelegenheit Fragen zu stellen und die gemeinsame Erabreitung von Lösungsansätzen.
* Bitte schauen Sie sich jetzt die Links in MS Teams an.

## Einleitung

* LaTeX ist ein Textsatzsystem mit langer Geschichte und vielen "Seitenarmen". Es hat zum Ziel ein **druckfähiges** und **wohlgesetztes** Dokument auf dem Computer zu generieren.
* LaTeX ist eine Makrosammlung die auf TeX basiert und damit eine weitere Abstraktionsebene schaft (WYSIWYAF).
* Heute sind vorallem Weiterentwicklungen von LaTeX - vorallem das populäre *pdflatex* - im Einsatz (im folgenden "engine").
* Zusammen mit Paketen (die ein mehr an Funktionalität bieten) werden diese modernen Textsatzprogramme in Form von Distributionen vertrieben. Die beiden populärsten sind MiKTeX und TexLive.

## Wie arbeite ich mit LaTeX?

* Die Generierung von Dokumenten ähnelt in der Handhabung mehr dem Programmieren als dem Umgang mit einer Office-Suit (WYSIWYG).
* Neben dem "Inhalt des Dokuments" erfordert die Erstellung eines LaTeX-Dokuments auch die Angabe der Formatierung/Designs durch ausgeschriebene Befehle.

**HackMD ist ein Beispiel für ein Editor der die Auszeichnugnsprache Markdown nutzt - die sich in HTML übersetzt.**

* Eine oder mehrer Quelldateien werden von der Engine - über mehrere Zwischenschritte und ggf. mehrere Durchläufe - zu einem druckfähigen Dokument umgesetzt.
* Das bedeutet LaTeX-Dokumente können in jedem beliebigen Texteditor geschrieben und dann an die Engine übergeben werden.

Heute arbeiten wir mit dem Online-Editor ("Share-Latex") der [Academic-Cloud](https://academiccloud.de/home) - das spart uns die langwierige Installation einer Distribution auf dem Rechner. Außerdem bietet es und die Möglichkeit zur Versionierung und kooperativem Arbeiten!

* Für das lokale Arbeiten ist für den Einstieg ein spezieller LaTeX-Editor empfehlenswert. Dort finden sich viele Befehle in Form von Buttons - das erspart zu Anfang viel Recherchearbeit.

## Trennung von Inhalt und Design

### Vorteile von LaTeX

* Mit LaTeX lassen sich hochwertige (wissenschaftliche) Dokumente erstellen und Inhalt und Design sind weitgehend getrennt.
* LaTeX ist plattformübergreifend & kostenfrei & statbil & die Ergebnisse sind reproduzierbar.
* Im Internet finden sich viele Beispiele und Supportmöglichkeiten für alle möglichen und unmöglichen Problemfälle.

### Nachteile von Latex

* LaTeX hat eine steile Lernkurve!
* Kein offizieller Support - selbst kleine Änderungen bzw. Anpassungen können deshalb sehr zeitraubend sein!

## Los gehts!

Niemand fängt gerne ganz von vorne an: [cleanthesis](http://cleanthesis.der-ric.de/)

**LaTeX bietet viele Vorlagen und Dokumentenklassen - für das ganze Spektrum an Dokumenten**

1. Bitte die oben genannte Dokumentenvorlage herunterladen und NICHT entpacken.
2. In Latex-Editor der Academic Cloud -> New Project -> Upload Project (die ganze Zip-Datei).
3. Project aufrufen ... jetzt folgt der Rundgang durch die Oberfläche.

### LaTeX - Projektstruktur

* Linke Seite: Dateistruktur des Projekts. Jedes LaTeX-Projekt hat eine Hauptdatei - die Verknüpfungen zu weiteren LaTeX-Dateien oder anderen digitalen Objekten enthalten kann. Sie können jederzeit Bilder oder Graphen in das Projekt hochladen.
* Beim Kompilieren (so nennt man den Vorgang ein Dokument aus den Quelldateien zu erzeugen) entstehen ein oder mehrer Zwischendateien - diese dürfen nicht editiert werden!
* In der Mitte sehen Sie den eigentlichen Texteditor - mit einer Rechtschreibprüfung Ihres Browsers ... ggf. dekativieren.
* Das rechte Fenster ist eine Ansicht des zuletzt erstellten Ergebnisses - dazwischen findet sich der Button für das Kompilieren.

### LaTeX - Dokumentenstruktur

* Jedes LaTeX Dokument beginnt mit der Deklarierung der Dokumentenklasser und der Übergabe von Parametern.
* Dann folgt die Einbindung von Paketen und ggf. wieder eine Übergabe von Parametern. (Hier: **\input{my-thesis-setup.tex}**)
* Befehle in LaTeX werden immer durch einen Backslash eingeleitet und durch geschweifte Klammern begrenzt.

### LaTeX - Basis-Syntax

Das findet sich bereits gut erklärt an dieser Stelle: [Learn X in Y Minutes](https://learnxinyminutes.com/docs/latex/).

### Wie finde ich Hilfe? Was mache ich bei Problemen?

Beispiel: Wie binde ich eine Abbildung in mein LaTeX-Dokument ein?

[Stackoverflow](https://stackoverflow.com/questions/3134187/how-to-add-a-jpg-image-in-latex) via Google.

Tipp: Das funktioniert auch hervorragend mit Fehlermeldunden des Kompilers!

#### Übungen

1. Erstetzen Sie in *my-thesis-setup.tex* die persönlichen Angaben durch Ihre eigenen oder fiktive Daten.
2. Löschen Sie den Inhalt von *content/chapter-introduction.tex* und fügen Sie ein Bild und etwas Text aus dem [Wikipedia-Artikel der TiHo ein](https://de.wikipedia.org/wiki/Stiftung_Tier%C3%A4rztliche_Hochschule_Hannover).
**Achten Sie auf die korrekte Auszeichnung der Überschriften!**

## Wie geht es jetzt weiter?

* Machen Sie einen richtigen Kurs, z.B. [OER-Kurs für LaTeX](https://oer.alp.dillingen.de/course/view.php?id=47&section=2)

* Eine Vorlage dient auch zur Demonstration der grundlegenden Funktionen - die Sie immer anpassen und weiterverwenden dürfen!