---
title: "Praca z dokumentem Quarto"
author: Anna Dmowska
format: html
editor: visual
---

## Tworzenie nowego dokumentu

Aby utworzyć dokument Quarto należy wybrać: **File - New File - Quarto Document**.

Dokument Quarto umożliwia łączenie treści i kodu w celu utworzenia gotowego dokumentu, który można wyeksportować do formatu HTML, PDF lub MS Word. Kod umieszcza się w tzw. blokach kodu, które można dodać za pomocą skrótu ***Ctrl + Alt + I***

Na początku każdego dokumentu znajduje się nagłówek tzw. *YAML header* składający się m.in z następujących informacji:

-   title: w ty miejscu podajemy tytuł dokumentu.
-   format: html - w tym miejscu definiujemy w jakim formacie ma być przechowywany weeksportowany raport (html, pdf, docx)

Więcej: <https://quarto.org/docs/get-started/hello/rstudio.html>

### Tworzenie raportów

Domyślnie dokument Quarto zapisywany jest z rozszerzeniem .qmd Używając opcji Render można go wyeksportować np. do pliku HTML. Aby wyeksportowany dokument otworzył się prawidłowo na innym komputerze, należy przekopiować plik HTML oraz folder o tej samej nazwie co dokument np. cwiczenie1_files.

## Pakiety

Pierwszym etapem pracy jest wczytanie pakietów, które będą używane wewnątrz dokumentu. Pakiety te muszą być wczytane w dokumencie używając funkcji `library(nazwa_pakietu)`. W dokumencie Quarto powinniśmy tylko wczytywać pakiety. Należy unikać polecenia `install.packages()`, służącego do ich instalacji.

Oznaczenie ***#\|*** pozwala na zdefiniowanie dodatkowych opcji dla każdego bloku kodu. Przy wczytywaniu pakietów należy pamiętać o ustawieniu **#\| message: false** oraz **#\| warning: false**, które oznaczają ukrycie ostrzeżeń i komunikatów związanych z wczytywaniem pakietów.

```{r}
#| message: false
#| warning: false

library(gapminder)
library(ggplot2)
```

## Dane

W poniższym przykładzie wykorzystamy dane ***gapminder*** z pakietu **gapminder**. Po wczytaniu danych w zakładce Środowisko (*Environment*) kliknij na <Promise>, aby wczytać i podejrzeć dane. Dane automatycznie zostaną przypisane do obiektu o nazwie ***gapminder***.

```{r}
data(gapminder, package = 'gapminder')
```

## Podstawowe informacje o danych.

Funkcja `str()` wyświetla podstawowe informacje o danych. Zbiór danych gapminder to tabela składająca się z 1704 obserwacji (tj. wierszy) oraz 6 zmiennych (tj. kolumn).

```{r}
str(gapminder)
```

Funkcja `summary()` wyświetla podstawowe statystyki opisowe.

```{r}
summary(gapminder)
```

## Podstawowe wykresy

```{r}
ggplot(gapminder, aes(x = lifeExp)) + 
  geom_histogram() + 
  labs(x = "Oczekiwana długość trwania życia", y = "Liczność") 
```
