Połączenie języka R lub Python z językiem znaczników markdown z wykorzystaniem Quarto umożliwia tworzenie plików zawierających zarówno kod, jak i tekst oraz wyniki obliczeń, które można eksportować do plików:
Pliki źródłowe mają zawsze rozszerzenie .qmd.
Połączenie języka R lub Python z językiem znaczników markdown z wykorzystaniem Quarto umożliwia tworzenie plików zawierających zarówno kod, jak i tekst oraz wyniki obliczeń, które można eksportować do plików:
Pliki źródłowe mają zawsze rozszerzenie .qmd.
Poprzednikiem Quarto był R Markdown, który działa na bardzo podobnej zasadzie.
Podstawowa
---title: "Pierwszy raport"---
Rozszerzona
---title: "Pierwszy raport"author: "Łukasz"format: htmllang: plself-contained: truetoc: true---
pole format
może przyjmować różne wartości:
pliki html możemy publikować na wiele różnych sposobów
pole self-contained
z wartością true
tworzy tylko jeden plik wynikowy, co ułatwia dystrybucję np. przez wiadomość e-mail
pole toc
z wartością true
dodaje spis treści
Raport zwykle zawiera opisy, które można formatować w następujący sposób:
Kod
To jest zwykły tekst._Kursywa_ i __pogrubienie__.Enter nie wystarczy, żeby przejść do nowej linii - trzeba wstawić co najmniej __dwie spacje__.
Wynik
To jest zwykły tekst.
Kursywa i pogrubienie.
Enter nie wystarczy, żeby przejść
do nowej linii - trzeba wstawić
co najmniej dwie spacje.
Struktura dokumentu definiowa jest przez nagłówki.
Kod
# Nagłówek pierwszego stopnia## Nagłówek drugiego stopnia### Nagłówek trzeciego stopnia
Wynik
Kod
1. Pozycja 11. Pozycja 21. Pozycja 3 - Pozycja 3a - Pozycja 3b
Wynik
Adresy stron internetowych automatycznie zamieniają się na linki. Można też stworzyć tekst, który będzie prowadził do strony.
Kod
https://cdv.pl/[Collegium Da Vinci](https://cdv.pl/)
Wynik
Kod
| abc | def | ghi ||-----|----:|:---:|| 1 | 2 | 3 || 4 | 5 | 6 || 7 | 8 | 9 |
Wynik
abc | def | ghi |
---|---|---|
1 | 2 | 3 |
4 | 5 | 6 |
7 | 8 | 9 |
Kod
$\frac{1}{2} \cdot \sqrt{4}=1$$$\sigma \sim N(0,1)$$
Wynik
12⋅√4=1
σ∼N(0,1)
Oprogramowanie do zautomatyzowanego składu tekstu, a także związany z nim język znaczników, służący do formatowania dokumentów tekstowych i tekstowo-graficznych.
praca lokalnie na komputerze wymaga zainstalowania programu MikTeX oraz edytora składni: TeXworks (domyślny), TeXstudio, TeXnicCenter.
edytor online: overleaf - podpowiadanie składni, dostęp przez przeglądarkę, dzielenie się projektami, dużo samouczków
wstawienie chunka (kawałek, klocek, blok): ctrl + alt + i
(jak insert)
wyniki pojawiają się poniżej chunka, a nie w konsoli lub dedykowanych zakładkach
trzeba pamiętać o spójności kodu, ponieważ w trakcie generowania dokumentu kod jest po kolei wykonywany
zaczyna się i kończy trzema grawisami (znak po lewej stronie klawisza 1 na klawiaturze)
Opcje można ustawiać globalnie (dla całego dokumentu) lub lokalnie (dla konkretnego chunka).
true
, wartość false
jedynie wyświetla kodUstawienia lokalne
#| echo: false#| fig-height: 4
Ustawienia globalne
---execute: echo: false warning: false---
Quarto umożliwia także dodawanie odnośników do tabel, rysunków, kodu, sekcji i wzorów.
Tabela
#| label: tbl-iris#| tbl-cap: "6 obserwacji ze zbioru irysy"
@tbl-iris przedstawia dane ze zbioru irysy.
Rysunek
#| label: fig-sepal-len-width#| fig-cap: "Wykres"
Na wykresie [-@fig-sepal-len-width] przedstawiono...
Należy pamiętać o odpowiednich przedrostkach, więcej informacji na temat odnośników znajduje się na stronie quarto.
Funkcja kable()
z pakietu knitr przekazuje zbiór do formatu html.
iris %>% head() %>% # pierwsze 6 obserwacji ze zbioru knitr::kable()
Sepal.Length | Sepal.Width | Petal.Length | Petal.Width | Species |
---|---|---|---|---|
5.1 | 3.5 | 1.4 | 0.2 | setosa |
4.9 | 3.0 | 1.4 | 0.2 | setosa |
4.7 | 3.2 | 1.3 | 0.2 | setosa |
4.6 | 3.1 | 1.5 | 0.2 | setosa |
5.0 | 3.6 | 1.4 | 0.2 | setosa |
5.4 | 3.9 | 1.7 | 0.4 | setosa |
Dodanie następującej opcji do preambuły:
format: html: df-print: paged
umożliwia stworzenie przeglądarki do większych zbiorów danych. Wówczas w chunku wystarczy wpisać nazwę zbioru dla którego chcemy stworzyć taki element.
W zwykłym tekście poza chunkiem można wstawiać wyniki obliczone przez R wstawiając grawisy, literę r
oraz kod, który ma wyświetlić pożądany wynik.
Kod
Średnia długość płatków irysów wynosi
` r round(mean(iris$Petal.Length),2) ˋ
centymetry.
Wynik
Średnia długość płatków irysów wynosi 3.76 centymetry.
RStudio będzie sugerował błędy w słowach w języku polskim poprzez czerwone podkreślenie. W celu poprawy komfortu pracy można dodać słownik języka polskiego. Z repozytorium LibreOffice pobieramy plik pl_PL.dic i dodajemy go do programu: Tools -> Global options -> Spelling
Dodaj do dokumentu dowolny wykres stworzony na podstawie zbioru pracownicy. Nie wyświetlaj kodu tego wykresu.
W raporcie umieść zdanie Średni wiek pracowników wynosi X lat, gdzie X to wartość obliczona na podstawie zbioru danych.
Umieść w raporcie tabelę zawierającą średnie wynagrodzenia (początkowe i bieżące) w grupach kategorii pracownika.
10:00
Keyboard shortcuts
↑, ←, Pg Up, k | Go to previous slide |
↓, →, Pg Dn, Space, j | Go to next slide |
Home | Go to first slide |
End | Go to last slide |
Number + Return | Go to specific slide |
b / m / f | Toggle blackout / mirrored / fullscreen mode |
c | Clone slideshow |
p | Toggle presenter mode |
t | Restart the presentation timer |
?, h | Toggle this help |
Esc | Back to slideshow |