Markdown

# Markdown
### Reporting mit R <a href='https://therbootcamp.github.io'> The R Bootcamp </a> <a href='https://therbootcamp.github.io/RmR_2021Feb/'> </a>  <a href='https://therbootcamp.github.io'> </a>  <a href='mailto:therbootcamp@gmail.com'> </a>  <a href='https://www.linkedin.com/company/basel-r-bootcamp/'> </a>
### Februar 2021

---

<div class="my-footer">
 
 
 <img src="https://raw.githubusercontent.com/therbootcamp/therbootcamp.github.io/master/_sessions/_image/by-sa.png" height=14 style="vertical-align: middle"/>
 
 <a href="https://therbootcamp.github.io/">
 
 
 www.therbootcamp.com
 
 
 </a>
 <a href="https://therbootcamp.github.io/">
 
 Reporting mit R | Februar 2021
 
 </a>
 
 </div>

---

# Was ist Markdown?

<ul>
 <li class="m1">Entwickelt von John Gruber and Aaron Swartz in 2004. 
 "<high>easy-to-read</high> and <high>easy-to-write</high> plain text format, [...] convert it to structurally valid XHTML (or HTML)"</li> 
 <li class="m2">Einfache <high>Syntax für die Gestaltung</high> von Dokumenten.</li> 
 <ul>
 <li>Text in fett und kursiv</li> 
 <li>Listen</li> 
 <li>Überschriften</li> 
 <li>Links</li>
 <li>Bilder</li>
 </ul>
</ul>

]

<img src="image/markdown.png" width=400px> 
 from <a href="https://de.wikipedia.org/wiki/Markdown">wikipedia.org</a>

]

---

# Was ist R Markdown?

<ul>
 <li class="m1">Verwendet Markdown zum <high>Gestalten dynamischer Dokumente</high> mit eingebetteten ...</li> 
 <ul>
 <li>R code chunks</li>
 <li>R inline Code</li> 
 <li>Statistischen Outputs</li>
 <li>Tabellen</li>
 <li>Visualisierungen</li>
 <li>etc.</li>
 </ul>
</ul>

]

<img src="image/hex.png" height=300> 
 from <a href="https://rmarkdown.rstudio.com/docs/">rmarkdown.rstudio.com</a>

]

---

# Arten des Berichts

<ul>
 <li class="m1">RMarkdown ermöglicht die Erstellung und Gestaltung unterschiedlicher <high>Berichttypen</high>.</li> 
 <ul>
 <li>Dokumente</li>
 <li>Präsentationen</li> 
 <li>Dashboards (Cockpits)</li>
 <li>Bücher</li>
 <li>Webseiten</li>
 <li>etc.</li>
 </ul>
</ul>

]

]

---
.pull-left3[

# Arten des Berichts

<ul>
 <li class="m1">RMarkdown ermöglicht die Erstellung und Gestaltung unterschiedlicher <high>Berichttypen</high>.</li> 
 <ul>
 <li><high>Dokumente</high></li>
 <li>Präsentationen</li> 
 <li>Dashboards (Cockpits)</li>
 <li>Bücher</li>
 <li>Webseiten</li>
 <li>etc.</li>
 </ul>
</ul>

]

]

---

# Arten des Berichts

<ul>
 <li class="m1">RMarkdown ermöglicht die Erstellung und Gestaltung unterschiedlicher <high>Berichttypen</high>.</li> 
 <ul>
 <li>Dokumente</li>
 <li><high>Präsentationen</high></li> 
 <li>Dashboards (Cockpits)</li>
 <li>Bücher</li>
 <li>Webseiten</li>
 <li>etc.</li>
 </ul>
</ul>

]

]

---

# Arten des Berichts

<ul>
 <li class="m1">RMarkdown ermöglicht die Erstellung und Gestaltung unterschiedlicher <high>Berichttypen</high>.</li> 
 <ul>
 <li>Dokumente</li>
 <li>Präsentationen</li> 
 <li><high>Dashboards (Cockpits)</high></li>
 <li>Bücher</li>
 <li>Webseiten</li>
 <li>etc.</li>
 </ul>
</ul>

]

]

---

# R Markdown Komponenten

<ul>
 <li class="m1">RMarkdown Skripte bestehen aus mehreren <high>Komponenten</high>.</li>
</ul>

<table style="cellspacing:0; cellpadding:0; border:none; padding-top:10px" width=100%>
 <col width="40%">
 <col width="60%">
<tr>
 <td bgcolor="white">
 Komponente
 </td>
 <td bgcolor="white">
 Beschreibung
 </td> 
</tr>
<tr>
 <td bgcolor="white">
 <mono>YAML</mono>
 </td>
 <td bgcolor="white">
 YAML Ain't Markup Language 
 <high>Dokumenteinstellungen</high>
 </td> 
</tr>
<tr>
 <td bgcolor="white">
 <mono>Setup chunk</mono>
 </td>
 <td bgcolor="white">
 <high>Chunks</high> einstellen 
 <high>Pakete</high> laden 
 <high>Daten</high> laden
 </td> 
</tr>
<tr>
 <td bgcolor="white">
 <mono>Markdown</mono>
 </td>
 <td bgcolor="white">
 <high>Überschriften</high> 
 <high>Text</high> mit Hervorhebungen
 </td> 
</tr>
<tr>
 <td bgcolor="white">
 <mono>Code chunk</mono>
 </td>
 <td bgcolor="white">
 R <high>Code</high> 
 R <high>Outputs<high>
 </td> 
</tr>
</table>

]

]

---

# Pipeline

<ul>
 <li class="m1">RMarkdown kann in verschiedene <high>Dateitypen</high> übersetzt werden.</li> 
 <ul>
 <li>PDF</li>
 <li>HTML</li> 
 <li>Word</li>
 <li>PowerPoint</li>
 </ul> 
 <li class="m2">In diesem Prozess wird <high>RMarkdown mehrfach übersetzt</high>, was gewisse Einschränkungen mit sich bringt.</li> 
</ul>

]

]

---

# HTML Pipeline

<ul>
 <li class="m1">HTML ist der <high>universelle Framework</high> für Dokumente, Präsentationen, und v.a. Dashboards.</li>
 <li class="m2"><high>Export zu PDF</high> ist, mit minimalen Einschränkungen, möglich.</li> 
</ul>

]

]

---

# HTML

<ul>
 <li class="m1">HyperText Markup Language.</li>
 <li class="m2">Das Format des <high>World Wide Web</high>s.</li>
 <li class="m3">Kann komfortabel durch <high>CSS</high> (Cascading Style Sheets) formatiert werden.</li>
</ul>

]

]

---

# Rendern

<ul>
 <li class="m1">HTML wird interpretiert von RStudio (oder Browsern) in ein wohl formatiertes Dokument.</li>
 <li class="m2"><high>Rstudio</high> zeigt ein gerendertes Dokument im Viewer an. </li> 
</ul>

]

]

---

# Überschriften

<ul>
 <li class="m1">Überschriften verschiedener <high>Ebenen</high> werden durch verschieden viele <mono>#</mono> ausgedrückt.</li>
</ul>

<table style="cellspacing:0; cellpadding:0; border:none; padding-top:20px" width=100%>
 <col width="40%">
 <col width="60%">
<tr>
 <td bgcolor="white">
 Markdown
 </td>
 <td bgcolor="white">
 Beschreibung
 </td> 
</tr>
<tr>
 <td bgcolor="white">
 <mono># text</mono>
 </td>
 <td bgcolor="white">
 Ebene 1
 </td> 
</tr>
<tr>
 <td bgcolor="white">
 <mono>## text</mono>
 </td>
 <td bgcolor="white">
 Ebene 2
 </td> 
</tr>
<tr>
 <td bgcolor="white">
 <mono>...</mono>
 </td>
 <td bgcolor="white">
 ...
 </td> 
</tr>
<tr>
 <td bgcolor="white">
 <mono>##### txt</mono>
 </td>
 <td bgcolor="white">
 Ebene 5
 </td> 
</tr>
</table>

]

]

---

# Überschriften

<ul>
 <li class="m1">Überschriften verschiedener <high>Ebenen</high> werden durch verschieden viele <mono>#</mono> ausgedrückt.</li>
</ul>

]

]

---

# Hervorhebung

<ul>
 <li class="m1">Verschiedene Zeichen erlauben <high>text- und code-bezogene</high> Hervorhebungen.</li>
</ul>

<table style="cellspacing:0; cellpadding:0; border:none; padding-top:20px" width=100%>
 <col width="50%">
 <col width="50%">
<tr>
 <td bgcolor="white">
 Markdown
 </td>
 <td bgcolor="white">
 Beschreibung
 </td> 
</tr>
<tr>
 <td bgcolor="white">
 &ast;<mono>text</mono>&ast;
 </td>
 <td bgcolor="white">
 Kursiv
 </td> 
</tr>
<tr>
 <td bgcolor="white">
 &ast;&ast;<mono>text</mono>&ast;&ast;
 </td>
 <td bgcolor="white">
 Fett
 </td> 
</tr>
<tr>
 <td bgcolor="white">
 &ast;&ast;&ast;<mono>text</mono>&ast;&ast;&ast;
 </td>
 <td bgcolor="white">
 Kursiv und Fett 
 </td> 
</tr>
<tr>
 <td bgcolor="white">
 &grave;<mono>text</mono>&grave;
 </td>
 <td bgcolor="white">
 Code
 </td> 
</tr>
<tr>
 <td bgcolor="white">
 &grave;<mono>r "text"</mono>&grave;
 </td>
 <td bgcolor="white">
 inline Code
 </td> 
</tr>
</table>

]

]

---

# Hervorhebung

<ul>
 <li class="m1">Verschiedene Zeichen erlauben <high>text- und code-bezogene</high> Hervorhebungen.</li>
</ul>

]

]

---

# Hervorhebung

<ul>
 <li class="m1">Verschiedene Zeichen erlauben <high>text- und code-bezogene</high> Hervorhebungen.</li>
</ul>

]

]

---

# Inline Code

<ul>
 <li class="m1"><high>Zahlen und Wörter</high> im Text können durch inline Code parametrisiert werden.</li>
 <li class="m2">inline Code kann, wie <high>Code <mono>chunks</mono></high>, beliebigen R Code enthalten.</li>
</ul>

]

]

---

# Chunks

<ul>
 <li class="m1">Ein <high>code <mono>chunk</mono></high> enthält beliebigen R Code.</li>
 <li class="m2">Code chunks werden mit <high>zusätzlichen Argumenten</high> definiert.</li>
</ul>

]

]

---

# Chunks

<table style="cellspacing:0; cellpadding:0; border:none; padding-top:60px" width=100%>
 <col width="60%">
 <col width="40%">
<tr>
 <td bgcolor="white">
 Argument
 </td>
 <td bgcolor="white">
 Beschreibung
 </td> 
</tr>
<tr>
 <td bgcolor="white">
 <mono>echo=T/F</mono>
 </td>
 <td bgcolor="white">
 Zeige/Verstecke <high>Code</high>
 </td> 
</tr>
<tr>
 <td bgcolor="white">
 <mono>eval=T/F</mono>
 </td>
 <td bgcolor="white">
 <high>Code</high> ausführen/nicht-ausf.
 </td> 
</tr>
<tr>
 <td bgcolor="white">
 <mono>include=T/F</mono>
 </td>
 <td bgcolor="white">
 Inkludiere/exkludiere <high>allen Output</high> 
 </td> 
</tr>
<tr>
 <td bgcolor="white">
 <mono>message=T/F</mono>
 </td>
 <td bgcolor="white">
 Inkludiere/exkludiere <highm>messages</highm> im Output
 </td> 
</tr>
<tr>
 <td bgcolor="white">
 <mono>warning=T/F</mono>
 </td>
 <td bgcolor="white">
 Inkludiere/exkludiere <highm>warnings</highm> im Output
 </td> 
</tr>
</table>

<mono>T/F = TRUE/FALSE</mono>

]

]

---

# Chunks

<mono>T/F = TRUE/FALSE</mono>

]

]

---

# Chunks

<mono>T/F = TRUE/FALSE</mono>

]

]

---

# Setup-Chunk

<ul>
 <li class="m1">Im Setup-Chunk können <high>Settings für alle Chunks</high> vorgenommen werden.</li>
 <li class="m2">Weiterführende Funktionen verfügbar.</li>
</ul>

]

]

---

# Setup-Chunk

]

]

---

# Setup-Chunk

]

]

---

# Setup-Chunk

]

]

---

# Setup-Chunk

]

]

---

# Relativer Pfad

<ul>
 <li class="m1">Markdown Dokumente greifen nicht auf das übliche <high>working directory</high> zu.</li> 
 <li class="m2">Pfade in RMarkdown müssen <high>relativ zur Position der .Rmd</high> Datei definiert werden.</li>
</ul>

```R
# Lese Daten
read_csv("../1_Data/daten.csv")

# Lese CSS (mehr dazu später)
css: "../2_Assets/styling.csv")
```

]

]

---

# Ziel

<ul>
 <li class="m1">Erstellt einen <high>Airbnb-Bericht</high> für Berlin für die Jahre 2018 und 2019.</li>
 <li class="m2">Evaluiert</li>
 <ul>
 <li>Wohnungs-<high>Neueinstellungen</high> über die Zeit und Stadtteile.</li>
 <li>Entwicklung der <high>Preise</high>.</li>
 <li>Einfluss von <high>Ausstattungsmerkmalen</high> auf den Preis.</li>
 </ul>
</ul>

]

]

---

<h1><a href="https://www.dropbox.com/s/xaq2crnw86mmy9t/TheRBootcamp.zip?dl=1">Projekt</a></h1>

---

<h1><a href="https://therbootcamp.github.io/RmR_2021Feb/_sessions/Markdown/Markdown_practical.html">Practical</a></h1>