Der Aufbau einer R Markdown-Datei
Eine .Rmd-Datei besteht aus drei Teilen:
- Kopfzeile: Der Text am Anfang des Dokuments, geschrieben im YAML-Format.
- Markdown-Abschnitte: Text, der Ihren Arbeitsablauf beschreibt, geschrieben in Markdown-Syntax.
- Code-Chunks: Chunks von R-Code, die ausgeführt werden können und auch mit knitr in ein Ausgabedokument gerendert werden können.
YAML-Header (Vorspann)
Eine R-Markdown-Datei beginnt immer mit einem Header, der in YAML-Syntax geschrieben ist. Dieser Header wird manchmal auch als Frontmatter bezeichnet.
Im YAML-Header von RStudio gibt es vier Standardelemente:
- Titel: Der Titel Ihres Dokuments. Beachten Sie, dass dies nicht mit dem Dateinamen identisch ist.
- Autor: Wer hat das Dokument geschrieben.
- Datum: Standardmäßig ist dies das Datum, an dem die Datei erstellt wurde.
- Ausgabe: In welchem Format soll die Ausgabe erfolgen. Sie werden html verwenden.
Beachten Sie, dass ein YAML-Header mit drei Bindestrichen beginnt und endet ---. Beachten Sie auch, dass der Wert für jedes Element, also Titel, Autor usw., in Anführungszeichen "value-here" neben dem Element steht. Ein YAML-Header kann je nach Verwendungszweck unterschiedlich aufgebaut sein.
R Markdown Text & Markdown Blöcke
Der zweite Teil eines R Markdown-Dokuments ist der eigentliche Markdown-Text, mit dem Sie Ihre Datei (oder Ihren Report) dokumentieren können. Sie werden Markdown im nächsten Tutorial kennenlernen.
So erstellen Sie eine neue R Markdown-Datei in RStudio
Um Ihre .Rmd-Datei zu erstellen, gehen Sie wie folgt vor:
- Erstellen Sie eine neue R Markdown-Datei und wählen Sie html als gewünschtes Ausgabeformat.
- Geben Sie einen Titel und einen Autorennamen (Ihren Namen) ein. Klicken Sie dann auf OK.
- Speichern Sie die Datei unter Verwendung des folgenden Formats: VornameNachname-Dokument-Ihr-Name/.Rmd HINWEIS: Der Dokumententitel ist nicht identisch mit dem Dateinamen.
- Klicken Sie auf die Dropdown-Schaltfläche `Knit HTML` in RStudio
Wenn alles gut gelaufen ist, sollten Sie eine Ausgabe im HTML-Format (Webseite) haben, nachdem Sie die Schaltfläche "Knit" gedrückt haben. Beachten Sie, dass diese HTML-Ausgabe aus einer Kombination aus Code und Textdokumentation besteht, die mit der Markdown-Syntax geschrieben wurde.
Wie man ein PDF aus R Markdown erstellt
Um ein PDF-Dokument aus R Markdown zu erstellen, geben Sie in den YAML-Metadaten das Ausgabeformat pdf_document an:
---
Titel: "Gewohnheiten"
Autor: John Doe
Datum: 22. März 2005
Ausgabe: pdf_document
---
In R Markdown-Dokumenten, die eine PDF-Ausgabe erzeugen, können Sie rohes LaTeX verwenden und sogar LaTeX-Makros definieren.