Szablon pracy dyplomowej
Jak pobrać repozytorium i rozpocząć pisanie pracy magisterskiej w RStudio przy uzyciu formatu Markdown (Quarto)?
1. Pobranie wybranych plików
Opcja A: Pobieranie wybranego pliku ZIP
- Kliknij w wybrany plik (Quarto lub LaTeX oraz UAM lub UZ)
- Po kliknięciu pobierz go klikając ikonkę downloadu (strzałka w dół) lub napis Zobacz czysty
Opcja B1: Pobieranie przez Git
Jeśli masz zainstalowany Git:
# przejdź do katalogu, w którym chcesz umieścić projekt w terminal/cmd
git clone http://150.254.88.90:3000/PKleka/Szablon-pracy-dylomowej.git
cd "Szablon pracy dyplomowej"
::: Kopia repozytorium zawiera wszystkie pliki, dlatego zacznij pracę od usunięcia tych niepotrzebnych. :::
Opcja B2: Pobieranie repozytorium jako ZIP
- Kliknij niebieski przycisk Code na stronie repozytorium
- Wybierz Download ZIP
- Rozpakuj archiwum w wybranej lokalizacji na dysku
- Przejdź do folderu z rozpakowanymi plikami
- Usuń zbędne pliki
2. Instalacja oprogramowania do renderowania pracy do formatu PDF
2.1. Instalacja R
- Przejdź na stronę: https://cran.r-project.org/
- Wybierz wersję dla swojego systemu operacyjnego:
- Windows: kliknij "Download R for Windows" → "base" → pobierz instalator
- macOS: kliknij "Download R for macOS" → wybierz odpowiednią wersję dla swojego procesora (Intel/Apple Silicon)
- Linux: postępuj zgodnie z instrukcjami dla swojej dystrybucji
- Uruchom pobrany instalator i postępuj zgodnie z instrukcjami
- Zalecana wersja: R 4.3.0 lub nowsza
2.2. Instalacja RStudio
- Przejdź na stronę: https://posit.co/download/rstudio-desktop/
- Przewiń w dół do sekcji "2: Install RStudio"
- Pobierz wersję RStudio Desktop dla swojego systemu operacyjnego
- Uruchom instalator i postępuj zgodnie z instrukcjami
2.3. Sprawdzenie instalacji
- Uruchom RStudio
- W konsoli R (dolne lewe okno) wpisz:
version
- Powinieneś zobaczyć informacje o zainstalowanej wersji R
3. Instalacja niezbędnych pakietów
Po uruchomieniu RStudio, musisz zainstalować pakiety potrzebne do pracy z tym szablonem.
3.1. Pakiety podstawowe
W konsoli R wykonaj następujące komendy (jedna po drugiej):
# Instalacja menedżera pakietów (jeśli nie jest zainstalowany)
install.packages("nazwa_pakietu")
# Instalacja pakietów do pracy z Quarto i RMarkdown
install.packages("quarto")
install.packages("rmarkdown")
install.packages("knitr")
# Pakiety do bibliografii i cytowań
install.packages("knitcitations")
install.packages("bibtex")
Więcej o języku R na stronie https://kleka.web.amu.edu.pl/nauka/wprowadzenie_do_R.html
3.2. TinyTeX - instalacja LaTeX-a
LaTeX jest niezbędny do generowania dokumentów PDF. Najłatwiejszym sposobem instalacji jest użycie pakietu tinytex:
# Instalacja pakietu tinytex
install.packages("tinytex")
# Instalacja dystrybucji TinyTeX
tinytex::install_tinytex()
Uwaga: Instalacja TinyTeX może potrwać kilka minut. Po zakończeniu uruchom ponownie RStudio.
3.3. Weryfikacja instalacji TinyTeX
Po ponownym uruchomieniu RStudio sprawdź, czy TinyTeX został poprawnie zainstalowany:
tinytex::is_tinytex()
Jeśli wynik to TRUE, instalacja przebiegła pomyślnie.
3.4. Dodatkowe pakiety LaTeX (w razie potrzeby)
Jeśli podczas kompilacji dokumentu pojawią się błędy związane z brakującymi pakietami LaTeX, możesz je doinstalować:
# Instalacja konkretnego pakietu LaTeX
tinytex::tlmgr_install("nazwa_pakietu")
# Przykłady często potrzebnych pakietów:
tinytex::tlmgr_install("babel-polish")
tinytex::tlmgr_install("csquotes")
tinytex::tlmgr_install("caption")
tinytex::tlmgr_install("fancyhdr")
4. Rozpoczęcie pracy
- Otwórz plik
dyplom.Rproj- uruchomi on RStudio (podwójne kliknięcie) - Otwórz plik
_START.qmd- to główny plik Twojej pracy. Możesz zmienić jego nazwę. - Edytuj zawartość zgodnie z postępami pracy dyplomowej
- Aby wygenerować PDF:
- Kliknij przycisk Render (lub naciśnij
Ctrl+Shift+K/Cmd+Shift+K) - Poczekaj na zakończenie kompilacji
- Dokument PDF pojawi się w tym samym folderze
- Kliknij przycisk Render (lub naciśnij
5. Struktura projektu
_START.qmd- główny plik pracy dyplomowejanaliza.qmd- przykładowy rozdział z analizą danychporadnik.qmd- poradnik formatowania i pisania pracyliteratura.bib- baza danych bibliograficznych (format BibTeX)dyplUAM.cls- klasa LaTeX dla formatu pracyheader.tex- dodatkowe ustawienia LaTeXbefore-body.tex- strona tytułowa i deklaracje
6. Rozwiązywanie problemów
Problem: Błąd podczas generowania PDF
- Sprawdź, czy TinyTeX jest zainstalowany:
tinytex::is_tinytex() - Sprawdź komunikaty błędów - często wskazują na brakujące pakiety LaTeX
- Zainstaluj brakujące pakiety używając
tinytex::tlmgr_install()
Problem: Encoding/znaki polskie się nie wyświetlają
- Upewnij się, że plik jest zapisany w kodowaniu UTF-8
- W RStudio: Tools → Global Options → Code → Saving → Default text encoding: UTF-8
Problem: Bibliografia się nie generuje
- Sprawdź, czy plik
literatura.bibistnieje i jest poprawnie sformatowany - Upewnij się, że w nagłówku YAML dokumentu jest podana ścieżka do pliku bibliografii
Pomoc
W razie problemów skontaktuj się z promotorem