diff --git a/howTo/sve.md b/howTo/sve.md index d53cb13572fe1badb353597a13ee42a662b985ba..e45ef66a573dca1977bd3d97decb18801e338c0a 100644 --- a/howTo/sve.md +++ b/howTo/sve.md @@ -25,17 +25,30 @@ But: ## Git -Git is installed - yay! It does however have some weird behaviour on the SVE to be aware of ... +Git is installed on the SVE - yay! You do know how to use Git, right? No? [try starting here](https://happygitwithr.com/index.html). ### Git authentication -You will need to create your RSA key so that git (inside or outside RStudio) can talk to github/gitlab etc. This RSA key should now be persistent (it didn't used to be before the SVE upgrade). Alternatively, use https and enter your username and password each session (not a big deal). +HTTPS vs SSH? It's up to you but [some argue](https://happygitwithr.com/https-pat.html#https-vs-ssh) that HTTPS is easy to get you going. + +Whatever, you will need to authenticate the SVE (local machine) with Gitlab/GitHub. You can do this via HTTPS, entering your username and password in each session on the SVE (not a big deal)... or by using an RSA key. This RSA key should now be persistent on the SVE (it didn't used to be before the SVE upgrade). ## RStudio in SVE +### Packages +See note above re persistence. + +If you need to add new packages use the install.packages() function. This seems to be able to bypass a permissons issue in C:/Apps/RLibraries which causes the normal the RStudio GUI/tab method to fail. + +Better yet use the [loadPackages() function](https://git.soton.ac.uk/SERG/workflow/-/blob/master/R/loadLibraries.R) developed at SERG :-) + +Even better, consider using the `renv` package. More on this coming soon. + ### Using Git within RStudio -If storing local repositories within your [Documents folder]() on the university filestore. The correct operation of Git witin RStudio on the University network requires some careful working practices with respect to file paths when creating and loading projects. +We recommend storing your local (working) project repositories within your `Documents` folder on the university filestore as [storing Git repositories within cloud-synced folders may cause problems.](https://andreashandel.github.io/MADAcourse/Tools_Github_Introduction.html#GitGitHub_and_other_cloud_based_sync_options) + +Git does seem to have some weird behaviour on the SVE to be aware of ... the correct operation of Git witin RStudio on the University network requires some careful working practices with respect to file paths. Using the University filestore for project (working) files requires use of the mapped file path `filestore (H:)` _<u>not</u>_ the `Documents` shortcut in the `Quick access` group of Windows Explorer. @@ -55,10 +68,3 @@ This problem seems to be limited to the Environment pane within the RStudio IDE So using Git through the Terminal is unaffected by the path used to open the project. -### Packages -See note above re persistence. - -If you need to add new packages use the install.packages() function. This seems to be able to bypass a permissons issue in C:/Apps/RLibraries which causes the normal the RStudio GUI/tab method to fail. - -Better yet use the [loadPackages() function](https://git.soton.ac.uk/SERG/workflow/-/blob/master/R/loadLibraries.R) developed at SERG :-) -