Qmd editieren

Um Inhalte zu editieren, öffnet ihr das entsprechende .Qmd file. Falls ihr mit einzelnen Quarto- / RMarkdown Files gearbeitet habt: Die Handhabung ist sehr ähnlich. Zu beachten ist lediglich folgendes:

Im folgenden wollen wir auf die wichtigsten Markdown Syntax Elemente eingehen:

Text

Kursiv, fett, durchgestrichen, Code, und Links können wie folgt erstellt werden:

Input Output
*kursiv* kursiv
**fett** fett
~~durchgestrichen~~ durchgestrichen
`Code` Code
[ZHAW](https://www.zhaw.ch) ZHAW
<https://www.zhaw.ch> https://www.zhaw.ch
Hinweis

Mehr zum Markdown Syntax: https://quarto.org/docs/authoring/markdown-basics.html

Überschriften

Überschriften werden mit vorangestelltem # erstellt

  • Kapitel: # Programmieren I
  • Unterkapitel: ## Komplexe Datentypen
  • Unter-Unterkapitel: ### Integer und Floats
  • … usw. (bis Stufe 6)

Querverweise

Um im Text einen Querverweis auf ein Kapitel zu machen, müsst ihr diesem Zuerst eine eindeutige “ID” geben. Zum Beispiel sieht der Titel dieses Kapitels folgendermassen aus:

## Querverweise {#sec-querverweise}

Nun kann ich auf dieses Kapitel mit @sec-querverweise verweisen.

Tabelle 6.1: Querverweise
Input: Output:
@sec-querverweise Kapitel 6.3
@fig-zhaw-logo Abbildung 6.1
@tbl-beispielstabelle siehe Tabelle 6.2

Das Verweisen funktioniert aber nur auf Nummerierte Kapitel und deren Unterkapitel. Wichtig ist auch, das ein sec- vorangestellt wird. Dieses sec- kommuniziert Quarto, dass es sich bei der Referenz um einen Kapitelverweis handelt. Bilder werden mit fig- referenziert und Tabellen mit tbl-. Mehr dazu später, in Kapitel 6.4 und Kapitel 6.5.

Hinweis

Mehr zu Querverweisen: https://quarto.org/docs/authoring/cross-references.html

Tabellen

Tabellen werden ebenfalls im Markdown-Syntax erstellt, und zwar folgendermassen:

| BMI         | Nutritional status       | 
|:------------|:-------------------------|
| Below 18.5  | Underweight              |
| 18.5–24.9   | Normal weight            |
| 25.0–29.9   | Pre-obesity              |
| 30.0–34.9   | Obesity class I          |
| 35.0–39.9   | Obesity class II         |
| Above 40    | Obesity class III        |

: WHO Nutritional status {#tbl-beispielstabelle}

Diese obige Markdown tabelle wird in eine html Tabelle umgewandelt. Diese Markdown Tabelle muss nicht von hand erstellt werden, auf tablesgenerator.com können bestehende Tabellen in den Markdown Syntax konvertiert werden.

Tabelle 6.2: WHO Nutritional status
BMI Nutritional status
Below 18.5 Underweight
18.5–24.9 Normal weight
25.0–29.9 Pre-obesity
30.0–34.9 Obesity class I
35.0–39.9 Obesity class II
Above 40 Obesity class III

Beachtet, dass man eine Tabellenüberschrift nach einen : anbringen kann. Nach der Tabellenüberschrift kann man einen “Key” erstellen, mit dem man diese Tabelle referenzieren kann. Der “Key” muss

  • nach der Tabellenüberschrift angebracht werden (mit leerschlag!)
  • sich in geschweiften Klammern ({ und }) befinden
  • mit #tbl- beginnen

Nun kann man sich im Text auf diese Tabelle beziehen (siehe Tabelle 6.1)

Hinweis

Mehr zum einfügen von Tabellen: https://quarto.org/docs/authoring/tables.html

Bilder

Um Bilder einzufügen muss man diese erstmals auf Github hochladen. Dafür wählt man auf Github.com den “Parent Folder” des Dokuments, wo das Bild hin soll und dort dann Add file > Upload file. Nun kann man das Bild folgendermasen einfügen:

  • Nur Bild: ![](bild.jpg)
  • Bild mit Bildunterschrift: ![Hier kommt die Bildunterschrift ](bild.jpg)
  • Bild mit Querverweis: ![Bildunterschrift](bild.jpg){#fig-test}
![Logo der ZHAW](zhaw_lsfm_iunr_blau.jpg){#fig-zhaw-logo}

Wird dann zu:

Siehe Tabelle 6.1

Hinweis

Mehr zum einfügen von Bildern: https://quarto.org/docs/authoring/figures.html

Hervorhebungen (Kästchen)

Die ganze Hinweis-kästchen in diesem Dokument werden mit folgendem Syntax erstellt:

:::{.callout-note}
Mehr zu diesen sogenannten *Callout Blocks*: <https://quarto.org/docs/authoring/callouts.html>
:::

Dies wir dann zu:

Hinweis

Mehr zu diesen sogenannten Callout Blocks: https://quarto.org/docs/authoring/callouts.html