Tworzenie pakietów R oraz praca z system kontroli wersji Git i platformą GitHub
1 Wprowadzenie
1.1 O materiałach
Niniejsze materiały online mają na celu zapoznanie użytkowników z możliwościami systemu kontroli wersji Git oraz platformy GitHub, ze szczególnym uwzględnieniem ich zastosowania w tworzeniu pakietów R. Materiały rozpoczynają się od przedstawienia podstaw tworzenia pakietów R, a następnie pokazują, jak umieścić stworzone pakiety na platformie GitHub przy użyciu podstawowych komend systemu Git. W kolejnych sekcjach omówione zostaną możliwości i ograniczenia platformy GitHub, ze szczególnym uwzględnieniem specyfiki pracy badawczej. Materiały obejmują również średnio-zaawansowane kwestie związane z tworzeniem pakietów R, w tym dostosowanie ich do wymagań repozytorium CRAN. Istotną część materiałów stanowi omówienie aspektów współpracy wielu osób na platformie GitHub, wraz z analizą często spotykanych problemów i sposobów ich rozwiązywania. Na zakończenie przedstawione zostaną zaawansowane zagadnienia dotyczące tworzenia pakietów i używania systemów kontroli wersji.
Materiały zawierają praktyczne wskazówki, przykłady i studia przypadków, które pomogą w rozwiązywaniu problemów związanych ze współpracą przy użyciu systemu kontroli wersji Git oraz z tworzeniem pakietów R. Zostały one przygotowane z myślą o zapewnieniu wiedzy i praktycznych umiejętności w zakresie omawianych tematów.
Te materiały są dostępne na licencji Creative Commons Uznanie autorstwa 4.0 Międzynarodowe.
1.2 Wsparcie autora
Jeśli znajdujesz te materiały przydatne, rozważ wsparcie autora przez Ko-fi: .
1.3 Wymagania wstępne
Do odtworzenia przykładów oraz do wykonania zadań zawartych w tym dokumencie konieczne jest posiadanie aktualnej wersji R. Pod adresem https://cloud.r-project.org/ można znaleźć instrukcje instalacji R dla systemów Windows, Mac OS i Linux.
W niektórych rozdziałach użyte zostanie zintegrowane środowisko programistyczne RStudio. Można je zainstalować korzystając ze strony https://posit.co/download/rstudio-desktop/#download.
Aspekty dotyczące kontroli wersji zostaną omówione używając oprogramowania Git. Zalecanym sposobem instalacji Git na Windows jest wersja ze strony https://gitforwindows.org/. Instrukcja instalacji na system Mac OS znajduje się pod adresem https://happygitwithr.com/install-git.html#macos. Wersję Linuxową można zainstalować używając poniższej linii kodu:
# Ubuntu
sudo apt install git
# Fedora
sudo dnf install git
Należy również posiadać konto na platformie GitHub. Warto wtedy zastanowić się nad wyborem nazwy użytkownika, ponieważ jest ona sposobem identyfikacji oraz kontaktu z innymi użytkownikami na GitHubie.1
Zmiana nazwy jest możliwa później.↩︎