Completed the Rstudio resource webpage.

Replacing the lengthy Rstudio/github by an Rstudio/GitLab video would
be nice.

module2/ressources/rstudio.org

@@ -5,11 +5,41 @@
 #+STARTUP: overview indent
 #+OPTIONS: num:nil toc:t
 
+
+If you have never used git with Rstudio, *we strongly advise that you
+follow the [[https://swcarpentry.github.io/git-novice/14-supplemental-rstudio/index.html][step-by-step explanations from Software Carpentry]]*. It comes
+with many screenshots and is quite progressive. Alternatively, you
+may want to watch this video:
+#+BEGIN_EXPORT html
+<iframe width="854" height="480" src="https://www.youtube.com/embed/uHYcDQDbMY8" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
+#+END_EXPORT
+
+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
+[[https://www.rstudio.com/resources/cheatsheets/][Cheat sheets webpage]]. In particular you want to have look at the ones
+on:
+- [[https://github.com/rstudio/cheatsheets/raw/master/rstudio-ide.pdf][The Rstudio IDE]],
+- [[https://github.com/rstudio/cheatsheets/raw/master/rmarkdown-2.0.pdf][R Markdown]],
+- The [[https://www.rstudio.com/wp-content/uploads/2015/03/rmarkdown-reference.pdf][R Markdown Reference guide]],
+- [[https://github.com/rstudio/cheatsheets/raw/master/data-visualization-2.1.pdf][Data visualization with ggplot2]],
+- [[https://github.com/rstudio/cheatsheets/raw/master/data-transformation.pdf][Data transformation with dplyr]]
+
+In case it helps, here are some (sometimes outdated) French versions
+of these documents: 
+- [[https://github.com/rstudio/cheatsheets/raw/master/translations/french/rstudio-IDE-cheatsheet.pdf][L'IDE Rstudio]]
+- [[https://github.com/rstudio/cheatsheets/raw/master/translations/french/ggplot2-french-cheatsheet.pdf][Visualisation de données avec ggplot2]]
+- [[https://github.com/rstudio/cheatsheets/raw/master/translations/french/data-wrangling-french.pdf][Transformation de données avec dplyr]]
+- [[https://www.fun-mooc.fr/c4x/UPSUD/42001S02/asset/RMarkdown.pdf][Un court document sur R Markdown]]
+
 * Installing Rstudio
 ** Linux (debian, ubuntu)
 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.n redhat, fedora).
+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:
@@ -71,7 +101,7 @@ install.packages("ggplot2")
 ** Linux (debian, ubuntu)
 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.n redhat, fedora).
+for other distributions (e.g., redhat, fedora).
 
 Run (as root):
 #+begin_src sh :results output :exports both
@@ -84,32 +114,35 @@ apt-get update ; apt-get install git
   - [[https://www.sourcetreeapp.com/][SourceTree]]
   - [[https://desktop.github.com/][GitHub Desktop]] 
     #+BEGIN_QUOTE
-    [[https://github.com/desktop/desktop/issues/852][Apparently]], this works with gitlab and https.
+    [[https://github.com/desktop/desktop/issues/852][Apparently]], this works with GitLab and https.
     #+END_QUOTE
-* Rstudio and git/github/gitlab
-#+BEGIN_QUOTE
-We may want to redo a screencast in French for this
-#+END_QUOTE
-- [[https://www.rstudio.com/resources/webinars/rstudio-essentials-webinar-series-managing-part-2/][This video on using git/githugb/gitlab from Rstudio]] (starting at time 9:09)
-
-Alternatively, we can point to:
-http://www.geo.uzh.ch/microsite/reproducible_research/post/rr-rstudio-git/
-- Part 1/item 2: Setup Git in RStudio
-- Part 2 (to adapt to gitlab)
-- Part 3
-* Cheat Sheets
-The Rstudio team has created a lot of good material and tutorials. You
-should definitively look at the [[https://www.rstudio.com/resources/cheatsheets/][Cheat sheets webpage]]. In particular
-you want to have look at the ones on:
-- [[https://github.com/rstudio/cheatsheets/raw/master/rstudio-ide.pdf][the Rstudio IDE]],
-- [[https://github.com/rstudio/cheatsheets/raw/master/rmarkdown-2.0.pdf][R Markdown]],
-- the [[https://www.rstudio.com/wp-content/uploads/2015/03/rmarkdown-reference.pdf][R Markdown Reference guide]],
-- [[https://github.com/rstudio/cheatsheets/raw/master/data-visualization-2.1.pdf][data visualization with ggplot2]],
-- [[https://github.com/rstudio/cheatsheets/raw/master/data-transformation.pdf][data transformation with dplyr]]
+* Setting up SSH
+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.
+** Installation
+*** Linux (debian, ubuntu)
+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).
 
-In case it helps, here are some (sometimes outdated) French versions
-of these documents: 
-- [[https://github.com/rstudio/cheatsheets/raw/master/translations/french/rstudio-IDE-cheatsheet.pdf][L'IDE Rstudio]]
-- [[https://github.com/rstudio/cheatsheets/raw/master/translations/french/ggplot2-french-cheatsheet.pdf][Visualisation de données avec ggplot2]]
-- [[https://github.com/rstudio/cheatsheets/raw/master/translations/french/data-wrangling-french.pdf][Transformation de données avec dplyr]]
-- [[https://www.fun-mooc.fr/c4x/UPSUD/42001S02/asset/RMarkdown.pdf][Un court document sur R Markdown]]
+Run (as root):
+#+begin_src sh :results output :exports both
+apt-get update ; apt-get install openssh-client
+#+end_src
+*** Mac OSX
+You do not have anything to do as it is installed by default.
+*** Windows
+You should install the [[https://www.ssh.com/ssh/putty/windows/][Putty]] client. Once it is installed, look for
+the section on [[https://www.ssh.com/ssh/putty/windows/puttygen][generating an SSH key]].
+** Setting up SSH on Framagit
+Here are [[https://docs.gitlab.com/ee/ssh/][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:
+#+BEGIN_EXPORT html
+<iframe width="560" height="315" src="https://www.youtube.com/embed/54mxyLo3Mqk" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
+#+END_EXPORT