Tworzenie pakietów R oraz praca z system kontroli wersji Git i platformą GitHub

Autor
Opublikowano

2024-07-29

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.

Licencja Creative Commons
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


  1. Zmiana nazwy jest możliwa później.↩︎