Jak oddajemy pracę domową - podstawy Quarto

Prace domowe przygotowujemy w Quarto. Pobierz arkusz .qmd udostępniony przy zadaniu, uzupełnij wskazane miejsca kodem R oraz odpowiedziami, a następnie wygeneruj dokument HTML. Na stronie zadania prześlij plik .qmd i wynikowy .html, chyba że polecenie wymaga innej formy odpowiedzi.

Pierwsze renderowanie

1. Otwórz plik .qmd w RStudio. Do sprawdzenia instalacji możesz użyć przykładowego dokumentu dołączonego poniżej.
2. Kliknij Render nad edytorem. Quarto wykona kod i utworzy plik .html obok pliku źródłowego.
3. Otwórz HTML i sprawdź tekst, wyniki oraz wykresy. Samo poprawne wykonanie pojedynczych komórek nie wystarczy: cały dokument musi się renderować.
4. Zapisz źródło i prześlij oba pliki na stronie zadania. Możesz zaznaczyć je razem w oknie wyboru plików.

Renderowanie uruchamia kod w osobnej sesji R. Dokument musi zawierać wszystkie potrzebne polecenia: wczytanie pakietów, danych i utworzenie używanych obiektów. Obiekty pozostawione w konsoli RStudio nie wystarczą.

Z czego składa się dokument?

Quarto łączy tekst zapisany w Markdown, kod R oraz wyniki jego wykonania. Na początku pliku znajduje się nagłówek YAML:

---
title: "Moja praca domowa"
author: "Imię i nazwisko lub pseudonim"
format:
  html:
    embed-resources: true
lang: pl
---

Opcja embed-resources: true umieszcza wykresy i pozostałe zasoby w jednym pliku HTML, który można przesłać i otworzyć na innym komputerze.

Tekst zapisujemy na przykład tak:

# Nagłówek pierwszego poziomu
## Nagłówek drugiego poziomu

*Tekst pochylony*, **tekst pogrubiony**.

1. Pierwszy punkt.
2. Drugi punkt.

- Punkt wypunktowania.

Kod R umieszczamy w komórkach:

```{r}
set.seed(12345)
hist(rnorm(200))
```

Komórkę otwierają i zamykają trzy znaki ` (backticki), a nie apostrofy. W RStudio można też wstawić ją skrótem Ctrl+Alt+I (Windows/Linux) albo Cmd+Option+I (macOS).

Pliki, pakiety i kodowanie

• Trzymaj arkusz i dane w folderze zadania. Przy renderowaniu udostępnianych tutaj pojedynczych dokumentów katalogiem roboczym jest folder pliku .qmd. Korzystaj ze ścieżek względnych, np. read.csv("dane.csv") albo read.csv("data/dane.csv"), zgodnie z układem folderów. Nie używaj ścieżek do własnego katalogu użytkownika.
• Pakiety instaluj raz w konsoli RStudio, np. install.packages("ggplot2"). W dokumencie umieszczaj library(ggplot2), a nie polecenia instalacji.
• Zapisuj pliki w UTF-8. Jeśli polskie znaki wyglądają nieprawidłowo, użyj File → Reopen with Encoding → UTF-8.
• Po ostatniej zmianie ponownie kliknij Render. Przesyłany HTML powinien odpowiadać przesyłanemu źródłu .qmd.

Więcej informacji

Oficjalne wprowadzenie do Quarto w RStudio.