Inhaltsverzeichnis

Hands-on 3.Termin: R Markdown und PDF

Um R Markdown zu nutzen und Ergebnisse als PDF-Datei ausgeben zu können, benötigen Sie auf Ihrem Computer eine LaTeX-Installation. Sollten Sie keine haben, nutzen Sie die Minimalversion aus dem R Package "tinytex".

Wenn Sie R zu Beginn des Semesters neu installiert haben, sollte alles so funktionieren.
Falls Sie R jedoch vor einiger Zeit installiert haben, achten Sie darauf, dass Sie eine aktuelle R-Version benötigen, um TinyTeX verwenden zu können! –> https://cran.r-project.org/
Auch eine Aktualisierung aller installierten Packages kann zielführend sein.


TinyTeX installieren

Installieren Sie das Paket "tinytex" mit folgendem Befehl:

install.packages("tinytex")

Die Warnung: WARNING: Rtools is required to build R packages können Sie in diesem Fall ignorieren.

Achten Sie auf die Meldung: Paket ‘tinytex’ erfolgreich ausgepackt und MD5 Summen abgeglichen diese zeigt an, dass alles passt.

Installieren Sie "tinytex" mit folgendem Befehl:

tinytex::install_tinytex()

Schließen Sie nun RStudio, und starten Sie es neu.


R Markdown Dokument erstellen

Erstellen Sie ein neues Markdown-Dokument:

Geben Sie einen Titel für das Dokument ein, und wählen Sie 'PDF' als Standard-Ausgabe-Format:


PDF erstellen (Knitting)

Um aus einem Markdown-Dokument ein PDF-Dokument zu erstellen, verwenden Sie die Schaltfläche 'Knit'.

Probieren Sie mit dem Beispieldokument gleich aus, ob es technisch prinzipiell funktioniert.


HTML erstellen (Knitting)

Sollten sich bei der Ausgabe im PDF-Format unüberwindliche technische Probleme ergeben, können Sie für die Hausübung im Notfall auch eine HTML-Datei erstellen.


Markdown

Markdown ist eine sehr einfache Auszeichnungssprache. Sie können damit einfache Texte mit Überschriften, fett, kursiv etc. schreiben. Markdown kann dann in viele andere Formate konvertiert werden.

Sehen Sie sich dazu folgendes Beispiel an:

Mit Markdown formulieren und formatieren Sie den für Menschen lesbaren Text, mit dem Sie die Hausübung erstellen.

Mit R Code Chunks können Sie R-Befehle einbetten. Die Ergebnisse sind nach dem Knitten Teil des Ausgabedokuments. Das erspart Ihnen viel Copy-und-Paste-Arbeit in ein Word-Dokument.

Ein (leerer) R Code Chunk sieht folgendermaßen aus:

```{r}
 
```

Sie können dem R Code Chunk in den geschwungenen Klammern eine Beschreibung geben, damit Sie später besser nachvollziehen können, was dieser Code Chunk tut.
Danach folgen die R-Befehle.

```{r Summe einiger Zahlen bilden}
sum( 3, 7, 18.3, 15) 
```

Sie können nun in den Markdown-Text einen oder mehrere Code Chunks einbetten, mit denen Sie z.B. die Berechnungen der Hausübung durchführen. Mit 'Knit' wird dann ein Ausgabedokument erzeugt.

Weitere Informationen finden Sie in den Folien zur Vorlesung.