If you have never used git with Rstudio, we strongly advise that you follow the step-by-step explanations from Software Carpentry. It comes with many screenshots and is quite progressive. Alternatively, you may want to watch this video:
The next sections provide information on how to install Rstudio, Git (to interact with GitLab), and SSH (to avoid typing your password every time you synchronize with GitLab).
Finally, you need to know that the Rstudio team has created a lot of very good material and tutorials. You should definitively look at the Cheat sheets webpage. In particular you want to have look at the ones on:
In case it helps, here are some (sometimes outdated) French versions of these documents:
We provide here only instructions for debian-based distributions. Feel free to contribute to this document to provide up-to-date information for other distributions (e.g., redhat, fedora).
Today, the stable versions of the most common distributions provide recent enough versions of emacs and org-mode:
If your distribution is older than this, well, it may be a good time for upgrading…
Beforehand, you need to install the R language and convenient packages by running (as root):
apt-get update ; sudo apt-get install r-base r-cran-knitr r-cran-ggplot2
Alternatively, if the installation of r-cran-gplot2 or r-cran-knitr
fails, you may want to install them locally (through the R packaging
system) and manually by running the following commands in R (or
Rstudio):
install.packages("knitr") install.packages("ggplot2")
If you plan to export pdf documents with LaTeX, you probably also want to run (as root):
apt-get update ; apt-get install texlive-base
Rstudio is unfortunately not packaged within debian so the easiest is to download the corresponding debian package on the Rstudio webpage and then to install it manually (depending on when you do this, you can obviously change the version number). Here is how to install it:
cd /tmp/ wget https://download1.rstudio.org/rstudio-xenial-1.1.453-amd64.deb sudo dpkg -i rstudio-xenial-1.1.453-amd64.deb sudo apt-get update ; sudo apt-get -f install # to fix possibly missing dependencies
Some instructions on installing R and knitr must be missing. This should be tested and improved.
Download and install rstudio from the Rstudio webpage by choosing the right operating system.
Then open Rstudio and type the following commands in the console to install knitr and ggplot2:
install.packages("knitr") install.packages("ggplot2")
We provide here only instructions for debian-based distributions. Feel free to contribute to this document to provide up-to-date information for other distributions (e.g., redhat, fedora).
Run (as root):
apt-get update ; apt-get install git
Apparently, this works with GitLab and https.
There are two ways of synchronizing your local repository with GitLab: through HTTPS or through SSH. The first one does not require any particular configuration but you will be regularly prompted for your GitLab password, which can be quite tedious. To avoid this, the best solution is to set install SSH, to create a pair or private/public keys, and to upload your SSH public key on GitLab. This section provides with information on how to do this.
We provide here only instructions for debian-based distributions. Feel free to contribute to this document to provide up-to-date information for other distributions (e.g., redhat, fedora).
Run (as root):
apt-get update ; apt-get install openssh-client
You do not have anything to do as it is installed by default.
You should install the Putty client. Once it is installed, look for the section on generating an SSH key.
Here are all the official explanations on how to set up your SSH key on GitLab. Alternatively, you may also want to have a look at this video: