Markdown

# Markdown
### <a href='https://dwulff.github.io/NLP_2020Autumn'> Natural language processing </a> <a href='https://dwulff.github.io/NLP_2020Autumn/menu/materials.html'> </a>  <a href='https://dwulff.github.io/NLP_2020Autumn'> </a>  <a href='mailto:dirk.wulff@unibas.ch'> 
### September 2020

---

<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://cdsbasel.github.io/dataanalytics/">
 
 
 cdsbasel.github.io/dataanalytics/
 
 
 </a>
 <a href="https://cdsbasel.github.io/dataanalytics/">
 
 Data Analytics for Psychology and Business | April 2019
 
 </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 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>

]

]

---

# 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">Für die Übersetzung 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 Webs</high>.</li>
 <li class="m3">Kann komfortabel durch <high>CSS</high> (Cascading Style Sheets) formartiert werden.</li>
</ul>

]

]

---

# R Markdown

]

]

---

# Ü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 ein <high>Code <mono>chunks</mono></high> beliebigen R Code enthalten.</li>
</ul>

]

]

---

# Chunks

]

]

---

# Chunks

<table style="cellspacing:0; cellpadding:0; border:none; padding-top:60px" width=100%>
 <col width="60%">
 <col width="40%">
<tr>
 <td bgcolor="white">
 Markdown
 </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> definiert werden vorgenommen werden.</li>
 <li class="m2">Weiterführende Funktionen verfügbar.</li>
</ul>

]

]

---

# 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

]

]

---

# 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 des .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")
```

]

]

---

<h1><a href=https://dwulff.github.io/NLP_2020Autumn/menu/materials.html>Materials</a></h1>