Skip to content

M
mooc-rr-ressources
Commit 16cd34ce authored by Arnaud Legrand's avatar Arnaud Legrand
Browse files
Options

Auto-generated files

parent 7fb737f5
Expand all Hide whitespace changes
Inline Side-by-side
Showing with 400 additions and 284 deletions
module2/ressources/emacs_orgmode.html
View file @ 16cd34ce
This diff is collapsed.
module2/ressources/gitlab.html 0 → 100644
View file @ 16cd34ce
<div id="content">
<h1 class="title">Git and GitLab</h1>
<div id="table-of-contents">
<h2>Table of Contents</h2>
<div id="text-table-of-contents">
<ul style="margin:0 0;">
<li style="margin-bottom:0;"><a href="#org65282e3">Installing Git</a>
<ul style="margin:0 0;">
<li style="margin-bottom:0;"><a href="#orgfbf6964">Linux (debian, ubuntu)</a></li>
<li style="margin-bottom:0;"><a href="#orgb9333af">Mac OSX and Windows</a></li>
</ul>
</li>
<li style="margin-bottom:0;"><a href="#orgc0ecb74">Authenticating on GitLab</a>
<ul style="margin:0 0;">
<li style="margin-bottom:0;"><a href="#org368a2a9">Option 1: HTTPS</a>
<ul style="margin:0 0;">
<li style="margin-bottom:0;"><a href="#orgadea060">Configuring your GitLab password</a></li>
<li style="margin-bottom:0;"><a href="#orgd0479e2">Making sure git remembers your password</a></li>
</ul>
</li>
<li style="margin-bottom:0;"><a href="#org572d681">Option 2: SSH</a>
<ul style="margin:0 0;">
<li style="margin-bottom:0;"><a href="#orge91383b">Installing SSH</a></li>
<li style="margin-bottom:0;"><a href="#org0dfb09b">Setting up SSH on Framagit</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
</div>
<p>
So far, you only used git via the web interface from the GitLab we
deployed for the MOOC.
</p>
<div class="org-center">
<p>
<a href="https://app-learninglab.inria.fr/gitlab/">https://app-learninglab.inria.fr/gitlab/</a>
</p>
</div>
<p>
If you access this link from the FUN platform, you do not have to
authenticate and you can readily read and modify all your files. This
is very convenient but in most cases, you will want to have your own
local copy of the repository and you will have to synchronize your
local copy with the remote GitLab one. To propagate your
modifications, you will obviously have to authenticate yourself on
GitLab. This document describes the software you need to have
installed on your machine and how to handle authentification. Please
read these instructions carefully.
</p>
<div id="outline-container-org65282e3" class="outline-2">
<h2 id="org65282e3">Installing Git</h2>
<div class="outline-text-2" id="text-org65282e3">
</div>
<div id="outline-container-orgfbf6964" class="outline-3">
<h3 id="orgfbf6964">Linux (debian, ubuntu)</h3>
<div class="outline-text-3" id="text-orgfbf6964">
<p>
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).
</p>
<p>
Run (as root):
</p>
<div class="org-src-container">
<pre style="padding-left: 30px; background-color: #f6f8fa;" class="src src-sh">apt-get update ; apt-get install git
</pre>
</div>
</div>
</div>
<div id="outline-container-orgb9333af" class="outline-3">
<h3 id="orgb9333af">Mac OSX and Windows</h3>
<div class="outline-text-3" id="text-orgb9333af">
<ul class="org-ul">
<li style="margin-bottom:0;">Download and install Git from the <a href="https://git-scm.com/downloads">Git website</a>.</li>
<li style="margin-bottom:0;">Optional Git clients (should not be needed if you work within
Rstudio):
<ul class="org-ul">
<li style="margin-bottom:0;"><a href="https://www.sourcetreeapp.com/">SourceTree</a></li>
<li style="margin-bottom:0;"><p>
<a href="https://desktop.github.com/">GitHub Desktop</a>
</p>
<blockquote>
<p>
<a href="https://github.com/desktop/desktop/issues/852">Apparently</a>, this works with GitLab and https.
</p>
</blockquote></li>
</ul></li>
</ul>
</div>
</div>
</div>
<div id="outline-container-orgc0ecb74" class="outline-2">
<h2 id="orgc0ecb74">Authenticating on GitLab</h2>
<div class="outline-text-2" id="text-orgc0ecb74">
<p>
There are two ways of authenticating and synchronizing your local
repository with GitLab: through HTTPS or through SSH. The first one
does not require any particular software installation on your machine
so this is what I recommend for this MOOC. Yet, I also describe the
second one as it is the one I prefer (once it is well configured, it
never asks me for any password anymore and I don't have to remember
anything).
</p>
</div>
<div id="outline-container-org368a2a9" class="outline-3">
<h3 id="org368a2a9">Option 1: HTTPS</h3>
<div class="outline-text-3" id="text-org368a2a9">
</div>
<div id="outline-container-orgadea060" class="outline-4">
<h4 id="orgadea060">Configuring your GitLab password</h4>
<div class="outline-text-4" id="text-orgadea060">
<p>
In this video, I explain how to change your password on our GitLab.
</p>
<div class="org-center">
<p>
Youtube Video
</p>
</div>
</div>
</div>
<div id="outline-container-orgd0479e2" class="outline-4">
<h4 id="orgd0479e2">Making sure git remembers your password</h4>
<div class="outline-text-4" id="text-orgd0479e2">
<p>
My GitLab id is <code>3211ac4f2fb71deaeff9252764c368e7</code>. Say I've configured
my password to be <code>tototutu</code> (what a weak password&#x2026;) and I want to
clone my <code>mooc-rr</code> repository. If you clone your repos by simply pasting
the GitLab url (e.g., with the following command line) you will be
prompted for your login and your password every time you want to
propagate your local modifications.
</p>
<div class="org-src-container">
<pre style="padding-left: 30px; background-color: #f6f8fa;" class="src src-shell">git clone https://app-learninglab.inria.fr/gitlab/3211ac4f2fb71deaeff9252764c368e7/mooc-rr
</pre>
</div>
<p>
This can be quite painful, which is why you can also provide them once
and for all when cloning, as follows:
</p>
<div class="org-src-container">
<pre style="padding-left: 30px; background-color: #f6f8fa;" class="src src-shell">git clone https://3211ac4f2fb71deaeff9252764c368e7:tototutu@app-learninglab.inria.fr/gitlab/3211ac4f2fb71deaeff9252764c368e7/mooc-rr
</pre>
</div>
<p>
This is very convenient but there is one drawback to understand. This
means your password is stored, unencrypted on your hard drive. If
anyone ever gets an access to your machine, he will gain access rights
to all your repos, which can be problematic. This is why the really
good way to do this is to follow <a href="https://stackoverflow.com/questions/5343068/is-there-a-way-to-skip-password-typing-when-using-https-on-github">these instructions</a>:
</p>
<div class="org-src-container">
<pre style="padding-left: 30px; background-color: #f6f8fa;" class="src src-shell">git config --global credential.helper cache <span style="font-weight: bold; font-style: italic;"># </span><span style="font-weight: bold; font-style: italic;">remember my password</span>
git config --global credential.helper <span style="font-style: italic;">"cache --timeout=3600"</span> <span style="font-weight: bold; font-style: italic;"># </span><span style="font-weight: bold; font-style: italic;">for one hour at most</span>
</pre>
</div>
<p>
With this setup, you will be prompted for your password but it will be
cached in memory and they will not be asked again before an hour.
</p>
</div>
</div>
</div>
<div id="outline-container-org572d681" class="outline-3">
<h3 id="org572d681">Option 2: SSH</h3>
<div class="outline-text-3" id="text-org572d681">
<p>
My prefered (although more technical) solution is to 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.
</p>
</div>
<div id="outline-container-orge91383b" class="outline-4">
<h4 id="orge91383b">Installing SSH</h4>
<div class="outline-text-4" id="text-orge91383b">
</div>
<ul class="org-ul">
<li style="margin-bottom:0;"><a id="orgebe8852"></a>Linux (debian, ubuntu)<br />
<div class="outline-text-5" id="text-orgebe8852">
<p>
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).
</p>
<p>
Run (as root):
</p>
<div class="org-src-container">
<pre style="padding-left: 30px; background-color: #f6f8fa;" class="src src-sh">apt-get update ; apt-get install openssh-client
</pre>
</div>
</div>
</li>
<li style="margin-bottom:0;"><a id="orgd6eebe7"></a>Mac OSX<br />
<div class="outline-text-5" id="text-orgd6eebe7">
<p>
You do not have anything to do as it is installed by default.
</p>
</div>
</li>
<li style="margin-bottom:0;"><a id="orgf3737c4"></a>Windows<br />
<div class="outline-text-5" id="text-orgf3737c4">
<p>
You should install the <a href="https://www.ssh.com/ssh/putty/windows/">Putty</a> client. Once it is installed, look for
the section on <a href="https://www.ssh.com/ssh/putty/windows/puttygen">generating an SSH key</a>.
</p>
</div>
</li>
</ul>
</div>
<div id="outline-container-org0dfb09b" class="outline-4">
<h4 id="org0dfb09b">Setting up SSH on Framagit</h4>
<div class="outline-text-4" id="text-org0dfb09b">
<p>
Here are <a href="https://docs.gitlab.com/ee/ssh/">all the official explanations on how to set up your SSH key
on GitLab</a>. Alternatively, you may also want to have a look at this
video:
</p>
<iframe width="560" height="315" src="https://www.youtube.com/embed/54mxyLo3Mqk" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
</div>
</div>
</div>
</div>
</div>
module2/ressources/jupyter.html
View file @ 16cd34ce
...@@ -4,34 +4,34 @@ ...@@ -4,34 +4,34 @@
<h2>Table of Contents</h2> <h2>Table of Contents</h2>
<div id="text-table-of-contents"> <div id="text-table-of-contents">
<ul style="margin:0 0;"> <ul style="margin:0 0;">
<li style="margin-bottom:0;"><a href="#org8ad7af5">Additional Jupyter resources or tricks</a> <li style="margin-bottom:0;"><a href="#orgf3b7782">Additional Jupyter resources or tricks</a>
<ul style="margin:0 0;"> <ul style="margin:0 0;">
<li style="margin-bottom:0;"><a href="#org22d89f4">Tips and tricks</a></li> <li style="margin-bottom:0;"><a href="#orgfb5fa97">Tips and tricks</a></li>
<li style="margin-bottom:0;"><a href="#org0420686">Running R and Python in the same notebook</a></li> <li style="margin-bottom:0;"><a href="#org38d49d6">Running R and Python in the same notebook</a></li>
<li style="margin-bottom:0;"><a href="#org468b24f">Exporting a notebook</a></li> <li style="margin-bottom:0;"><a href="#org1344be3">Exporting a notebook</a></li>
</ul> </ul>
</li> </li>
<li style="margin-bottom:0;"><a href="#org2c7ad73">Installing Jupyter on your own machine</a> <li style="margin-bottom:0;"><a href="#org98dba69">Installing Jupyter on your own machine</a>
<ul style="margin:0 0;"> <ul style="margin:0 0;">
<li style="margin-bottom:0;"><a href="#orgb4b3874">Installing jupyter</a></li> <li style="margin-bottom:0;"><a href="#orgded5168">Installing jupyter</a></li>
<li style="margin-bottom:0;"><a href="#orgf5ae3b1">Using R</a></li> <li style="margin-bottom:0;"><a href="#orga71105f">Using R</a></li>
<li style="margin-bottom:0;"><a href="#orgf90bf40">Exporting your notebooks with latex</a></li> <li style="margin-bottom:0;"><a href="#org2babeac">Exporting your notebooks with latex</a></li>
<li style="margin-bottom:0;"><a href="#org77f31cb">Interacting with gitlab</a></li> <li style="margin-bottom:0;"><a href="#org5699094">Interacting with gitlab</a></li>
<li style="margin-bottom:0;"><a href="#org0c2d49c">Interesting extensions to improve notebook readability</a></li> <li style="margin-bottom:0;"><a href="#org20763cb">Interesting extensions to improve notebook readability</a></li>
</ul> </ul>
</li> </li>
<li style="margin-bottom:0;"><a href="#orgacebcf9">Installing JupyterHub&#xa0;&#xa0;&#xa0;<span class="tag"><span class="Benoit">Benoit</span></span></a></li> <li style="margin-bottom:0;"><a href="#org1e7464c">Installing JupyterHub&#xa0;&#xa0;&#xa0;<span class="tag"><span class="Benoit">Benoit</span></span></a></li>
</ul> </ul>
</div> </div>
</div> </div>
<div id="outline-container-org8ad7af5" class="outline-2"> <div id="outline-container-orgf3b7782" class="outline-2">
<h2 id="org8ad7af5">Additional Jupyter resources or tricks</h2> <h2 id="orgf3b7782">Additional Jupyter resources or tricks</h2>
<div class="outline-text-2" id="text-org8ad7af5"> <div class="outline-text-2" id="text-orgf3b7782">
</div> </div>
<div id="outline-container-org22d89f4" class="outline-3"> <div id="outline-container-orgfb5fa97" class="outline-3">
<h3 id="org22d89f4">Tips and tricks</h3> <h3 id="orgfb5fa97">Tips and tricks</h3>
<div class="outline-text-3" id="text-org22d89f4"> <div class="outline-text-3" id="text-orgfb5fa97">
<p> <p>
The following <a href="https://www.dataquest.io/blog/jupyter-notebook-tips-tricks-shortcuts/">webpage</a> lists several Jupyter tricks (in particular, it The following <a href="https://www.dataquest.io/blog/jupyter-notebook-tips-tricks-shortcuts/">webpage</a> lists several Jupyter tricks (in particular, it
illustrates many <code>Ipython magic</code> commands) that should improve your illustrates many <code>Ipython magic</code> commands) that should improve your
...@@ -41,17 +41,23 @@ now). ...@@ -41,17 +41,23 @@ now).
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-org0420686" class="outline-3"> <div id="outline-container-org38d49d6" class="outline-3">
<h3 id="org0420686">Running R and Python in the same notebook</h3> <h3 id="org38d49d6">Running R and Python in the same notebook</h3>
<div class="outline-text-3" id="text-org0420686"> <div class="outline-text-3" id="text-org38d49d6">
<p> <p>
The best solution to this is to install rpy2. On my machine, I have The best solution to this is to install rpy2. On my machine, I have
installed the <code>python3-rpy2</code> debian package with <code>apt-get install</code>. An installed the <code>python3-rpy2</code> debian package with <code>apt-get install</code>. E.g.,
other alternative consists in going through the python package manager
with
</p> </p>
<div class="org-src-container"> <div class="org-src-container">
<pre style="padding-left: 30px; background-color: #f6f8fa;" class="src src-python">pip install rpy2 <pre style="padding-left: 30px; background-color: #f6f8fa;" class="src src-shell">sudo apt-get install python3-rpy2 python3-tzlocal
</pre>
</div>
<p>
An other (not really recommanded) alternative consists in going
through the python package manager with
</p>
<div class="org-src-container">
<pre style="padding-left: 30px; background-color: #f6f8fa;" class="src src-python">pip3 install rpy2
</pre> </pre>
</div> </div>
<p> <p>
...@@ -85,9 +91,9 @@ plot(df) ...@@ -85,9 +91,9 @@ plot(df)
</ol> </ol>
</div> </div>
</div> </div>
<div id="outline-container-org468b24f" class="outline-3"> <div id="outline-container-org1344be3" class="outline-3">
<h3 id="org468b24f">Exporting a notebook</h3> <h3 id="org1344be3">Exporting a notebook</h3>
<div class="outline-text-3" id="text-org468b24f"> <div class="outline-text-3" id="text-org1344be3">
<p> <p>
Obviously, you can convert to html or pdf using the using the <code>File &gt; Obviously, you can convert to html or pdf using the using the <code>File &gt;
Download as &gt; HTML</code> (or <code>PDF</code>) menu option. This can also be done from Download as &gt; HTML</code> (or <code>PDF</code>) menu option. This can also be done from
...@@ -114,13 +120,13 @@ taste. ...@@ -114,13 +120,13 @@ taste.
</div> </div>
</div> </div>
</div> </div>
<div id="outline-container-org2c7ad73" class="outline-2"> <div id="outline-container-org98dba69" class="outline-2">
<h2 id="org2c7ad73">Installing Jupyter on your own machine</h2> <h2 id="org98dba69">Installing Jupyter on your own machine</h2>
<div class="outline-text-2" id="text-org2c7ad73"> <div class="outline-text-2" id="text-org98dba69">
</div> </div>
<div id="outline-container-orgb4b3874" class="outline-3"> <div id="outline-container-orgded5168" class="outline-3">
<h3 id="orgb4b3874">Installing jupyter</h3> <h3 id="orgded5168">Installing jupyter</h3>
<div class="outline-text-3" id="text-orgb4b3874"> <div class="outline-text-3" id="text-orgded5168">
<p> <p>
Here is what you should install: Here is what you should install:
</p> </p>
...@@ -151,15 +157,15 @@ The ipython notebook can then be run with the following command: ...@@ -151,15 +157,15 @@ The ipython notebook can then be run with the following command:
</div> </div>
</div> </div>
</div> </div>
<div id="outline-container-orgf5ae3b1" class="outline-3"> <div id="outline-container-orga71105f" class="outline-3">
<h3 id="orgf5ae3b1">Using R</h3> <h3 id="orga71105f">Using R</h3>
<div class="outline-text-3" id="text-orgf5ae3b1"> <div class="outline-text-3" id="text-orga71105f">
<p> <p>
If you want to use the R kernel in jupyter, follow <a href="https://github.com/IRkernel/IRkernel#installation">these instructions</a>. If you want to use the R kernel in jupyter, follow <a href="https://github.com/IRkernel/IRkernel#installation">these instructions</a>.
</p> </p>
<p> <p>
Alternatively, you can install <code>rpy2</code> (see the <a href="#org0420686">Running R and Python in Alternatively, you can install <code>rpy2</code> (see the <a href="#org38d49d6">Running R and Python in
the same notebook</a> section). the same notebook</a> section).
</p> </p>
<div class="org-src-container"> <div class="org-src-container">
...@@ -168,9 +174,9 @@ the same notebook</a> section). ...@@ -168,9 +174,9 @@ the same notebook</a> section).
</div> </div>
</div> </div>
</div> </div>
<div id="outline-container-orgf90bf40" class="outline-3"> <div id="outline-container-org2babeac" class="outline-3">
<h3 id="orgf90bf40">Exporting your notebooks with latex</h3> <h3 id="org2babeac">Exporting your notebooks with latex</h3>
<div class="outline-text-3" id="text-orgf90bf40"> <div class="outline-text-3" id="text-org2babeac">
<p> <p>
Here is what I had to install on my recent debian machine to make sure Here is what I had to install on my recent debian machine to make sure
the notebook export via latex works: the notebook export via latex works:
...@@ -182,9 +188,9 @@ sudo apt-get install texlive-xetex ...@@ -182,9 +188,9 @@ sudo apt-get install texlive-xetex
</div> </div>
</div> </div>
</div> </div>
<div id="outline-container-org77f31cb" class="outline-3"> <div id="outline-container-org5699094" class="outline-3">
<h3 id="org77f31cb">Interacting with gitlab</h3> <h3 id="org5699094">Interacting with gitlab</h3>
<div class="outline-text-3" id="text-org77f31cb"> <div class="outline-text-3" id="text-org5699094">
<p> <p>
Here is our <a href="https://github.com/brospars/nb-git">jupyter extension that allows to git push/pull from the Here is our <a href="https://github.com/brospars/nb-git">jupyter extension that allows to git push/pull from the
notebooks</a>: notebooks</a>:
...@@ -196,9 +202,9 @@ jupyter nbextension enable nb-git ...@@ -196,9 +202,9 @@ jupyter nbextension enable nb-git
</div> </div>
</div> </div>
</div> </div>
<div id="outline-container-org0c2d49c" class="outline-3"> <div id="outline-container-org20763cb" class="outline-3">
<h3 id="org0c2d49c">Interesting extensions to improve notebook readability</h3> <h3 id="org20763cb">Interesting extensions to improve notebook readability</h3>
<div class="outline-text-3" id="text-org0c2d49c"> <div class="outline-text-3" id="text-org20763cb">
<p> <p>
Here are two interesting extensions that can improve readability: Here are two interesting extensions that can improve readability:
</p> </p>
...@@ -225,9 +231,9 @@ jupyter-serverextension enable --py hide_code ...@@ -225,9 +231,9 @@ jupyter-serverextension enable --py hide_code
</div> </div>
</div> </div>
</div> </div>
<div id="outline-container-orgacebcf9" class="outline-2"> <div id="outline-container-org1e7464c" class="outline-2">
<h2 id="orgacebcf9">Installing JupyterHub&#xa0;&#xa0;&#xa0;<span class="tag"><span class="Benoit">Benoit</span></span></h2> <h2 id="org1e7464c">Installing JupyterHub&#xa0;&#xa0;&#xa0;<span class="tag"><span class="Benoit">Benoit</span></span></h2>
<div class="outline-text-2" id="text-orgacebcf9"> <div class="outline-text-2" id="text-org1e7464c">
<blockquote> <blockquote>
<p> <p>
Benoit may give a few hints on this. Benoit may give a few hints on this.
......
module2/ressources/rstudio.html
View file @ 16cd34ce
...@@ -4,33 +4,15 @@ ...@@ -4,33 +4,15 @@
<h2>Table of Contents</h2> <h2>Table of Contents</h2>
<div id="text-table-of-contents"> <div id="text-table-of-contents">
<ul style="margin:0 0;"> <ul style="margin:0 0;">
<li style="margin-bottom:0;"><a href="#org6a08c55">Installing Rstudio</a> <li style="margin-bottom:0;"><a href="#org996bb6e">Installing Rstudio</a>
<ul style="margin:0 0;"> <ul style="margin:0 0;">
<li style="margin-bottom:0;"><a href="#org2204883">Linux (debian, ubuntu)</a> <li style="margin-bottom:0;"><a href="#org47dc640">Linux (debian, ubuntu)</a>
<ul style="margin:0 0;"> <ul style="margin:0 0;">
<li style="margin-bottom:0;"><a href="#org9e7e4df">Installing R</a></li> <li style="margin-bottom:0;"><a href="#org5b5cfe0">Installing R</a></li>
<li style="margin-bottom:0;"><a href="#orge261910">Installing rstudio</a></li> <li style="margin-bottom:0;"><a href="#orgfebba3b">Installing rstudio</a></li>
</ul> </ul>
</li> </li>
<li style="margin-bottom:0;"><a href="#org0f1374d">Mac OSX and Windows</a></li> <li style="margin-bottom:0;"><a href="#org697af62">Mac OSX and Windows</a></li>
</ul>
</li>
<li style="margin-bottom:0;"><a href="#orgd743f10">Installing Git</a>
<ul style="margin:0 0;">
<li style="margin-bottom:0;"><a href="#org194d7d9">Linux (debian, ubuntu)</a></li>
<li style="margin-bottom:0;"><a href="#orga033592">Mac OSX and Windows</a></li>
</ul>
</li>
<li style="margin-bottom:0;"><a href="#org3890548">Setting up SSH</a>
<ul style="margin:0 0;">
<li style="margin-bottom:0;"><a href="#org8fce29e">Installation</a>
<ul style="margin:0 0;">
<li style="margin-bottom:0;"><a href="#org24a337f">Linux (debian, ubuntu)</a></li>
<li style="margin-bottom:0;"><a href="#orgd8eb69c">Mac OSX</a></li>
<li style="margin-bottom:0;"><a href="#org02c1827">Windows</a></li>
</ul>
</li>
<li style="margin-bottom:0;"><a href="#orgfaac61e">Setting up SSH on Framagit</a></li>
</ul> </ul>
</li> </li>
</ul> </ul>
...@@ -45,9 +27,8 @@ may want to watch this video: ...@@ -45,9 +27,8 @@ may want to watch this video:
<iframe width="854" height="480" src="https://www.youtube.com/embed/uHYcDQDbMY8" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe> <iframe width="854" height="480" src="https://www.youtube.com/embed/uHYcDQDbMY8" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
<p> <p>
The next sections provide information on how to install Rstudio, Git The next sections provide information on how to install Rstudio. Before
(to interact with GitLab), and SSH (to avoid typing your password proceeding, make sure you have read the "Git and GitLab" instructions.
every time you synchronize with GitLab).
</p> </p>
<p> <p>
...@@ -58,7 +39,7 @@ on: ...@@ -58,7 +39,7 @@ on:
</p> </p>
<ul class="org-ul"> <ul class="org-ul">
<li style="margin-bottom:0;"><a href="https://github.com/rstudio/cheatsheets/raw/master/rstudio-ide.pdf">The Rstudio IDE</a>,</li> <li style="margin-bottom:0;"><a href="https://github.com/rstudio/cheatsheets/raw/master/rstudio-ide.pdf">The Rstudio IDE</a>,</li>
<li style="margin-bottom:0;"><a href="https://github.com/rstudio/cheatsheets/raw/master/rmarkdown-2.0.pdf">R Markdown</a>,</li> <li style="margin-bottom:0;"><a href="https://github.com/rstudio/cheatsheets/raw/master/rmarkdown-2.0.pdf">R Markdown</a> (here is also a <a href="https://rmarkdown.rstudio.com/">nice step-by-step presentation of Rmarkdown</a>),</li>
<li style="margin-bottom:0;">The <a href="https://www.rstudio.com/wp-content/uploads/2015/03/rmarkdown-reference.pdf">R Markdown Reference guide</a>,</li> <li style="margin-bottom:0;">The <a href="https://www.rstudio.com/wp-content/uploads/2015/03/rmarkdown-reference.pdf">R Markdown Reference guide</a>,</li>
<li style="margin-bottom:0;"><a href="https://github.com/rstudio/cheatsheets/raw/master/data-visualization-2.1.pdf">Data visualization with ggplot2</a>,</li> <li style="margin-bottom:0;"><a href="https://github.com/rstudio/cheatsheets/raw/master/data-visualization-2.1.pdf">Data visualization with ggplot2</a>,</li>
<li style="margin-bottom:0;"><a href="https://github.com/rstudio/cheatsheets/raw/master/data-transformation.pdf">Data transformation with dplyr</a></li> <li style="margin-bottom:0;"><a href="https://github.com/rstudio/cheatsheets/raw/master/data-transformation.pdf">Data transformation with dplyr</a></li>
...@@ -75,13 +56,13 @@ of these documents: ...@@ -75,13 +56,13 @@ of these documents:
<li style="margin-bottom:0;"><a href="https://www.fun-mooc.fr/c4x/UPSUD/42001S02/asset/RMarkdown.pdf">Un court document sur R Markdown</a></li> <li style="margin-bottom:0;"><a href="https://www.fun-mooc.fr/c4x/UPSUD/42001S02/asset/RMarkdown.pdf">Un court document sur R Markdown</a></li>
</ul> </ul>
<div id="outline-container-org6a08c55" class="outline-2"> <div id="outline-container-org996bb6e" class="outline-2">
<h2 id="org6a08c55">Installing Rstudio</h2> <h2 id="org996bb6e">Installing Rstudio</h2>
<div class="outline-text-2" id="text-org6a08c55"> <div class="outline-text-2" id="text-org996bb6e">
</div> </div>
<div id="outline-container-org2204883" class="outline-3"> <div id="outline-container-org47dc640" class="outline-3">
<h3 id="org2204883">Linux (debian, ubuntu)</h3> <h3 id="org47dc640">Linux (debian, ubuntu)</h3>
<div class="outline-text-3" id="text-org2204883"> <div class="outline-text-3" id="text-org47dc640">
<p> <p>
We provide here only instructions for debian-based distributions. Feel We provide here only instructions for debian-based distributions. Feel
free to contribute to this document to provide up-to-date information free to contribute to this document to provide up-to-date information
...@@ -103,9 +84,9 @@ for upgrading&#x2026; ...@@ -103,9 +84,9 @@ for upgrading&#x2026;
</p> </p>
</div> </div>
<div id="outline-container-org9e7e4df" class="outline-4"> <div id="outline-container-org5b5cfe0" class="outline-4">
<h4 id="org9e7e4df">Installing R</h4> <h4 id="org5b5cfe0">Installing R</h4>
<div class="outline-text-4" id="text-org9e7e4df"> <div class="outline-text-4" id="text-org5b5cfe0">
<p> <p>
Beforehand, you need to install the R language and convenient packages Beforehand, you need to install the R language and convenient packages
by running (as root): by running (as root):
...@@ -138,9 +119,9 @@ to run (as root): ...@@ -138,9 +119,9 @@ to run (as root):
</div> </div>
</div> </div>
<div id="outline-container-orge261910" class="outline-4"> <div id="outline-container-orgfebba3b" class="outline-4">
<h4 id="orge261910">Installing rstudio</h4> <h4 id="orgfebba3b">Installing rstudio</h4>
<div class="outline-text-4" id="text-orge261910"> <div class="outline-text-4" id="text-orgfebba3b">
<p> <p>
Rstudio is unfortunately not packaged within debian so the easiest is Rstudio is unfortunately not packaged within debian so the easiest is
to download the corresponding debian package on the <a href="https://www.rstudio.com/products/rstudio/download/#download">Rstudio webpage</a> to download the corresponding debian package on the <a href="https://www.rstudio.com/products/rstudio/download/#download">Rstudio webpage</a>
...@@ -158,9 +139,9 @@ sudo apt-get update ; sudo apt-get -f install <span style="font-weight: bold; fo ...@@ -158,9 +139,9 @@ sudo apt-get update ; sudo apt-get -f install <span style="font-weight: bold; fo
</div> </div>
</div> </div>
</div> </div>
<div id="outline-container-org0f1374d" class="outline-3"> <div id="outline-container-org697af62" class="outline-3">
<h3 id="org0f1374d">Mac OSX and Windows</h3> <h3 id="org697af62">Mac OSX and Windows</h3>
<div class="outline-text-3" id="text-org0f1374d"> <div class="outline-text-3" id="text-org697af62">
<blockquote> <blockquote>
<p> <p>
Some instructions on installing R and knitr must be missing. This Some instructions on installing R and knitr must be missing. This
...@@ -184,113 +165,4 @@ install.packages(<span style="font-style: italic;">"ggplot2"</span>) ...@@ -184,113 +165,4 @@ install.packages(<span style="font-style: italic;">"ggplot2"</span>)
</div> </div>
</div> </div>
</div> </div>
<div id="outline-container-orgd743f10" class="outline-2">
<h2 id="orgd743f10">Installing Git</h2>
<div class="outline-text-2" id="text-orgd743f10">
</div>
<div id="outline-container-org194d7d9" class="outline-3">
<h3 id="org194d7d9">Linux (debian, ubuntu)</h3>
<div class="outline-text-3" id="text-org194d7d9">
<p>
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).
</p>
<p>
Run (as root):
</p>
<div class="org-src-container">
<pre style="padding-left: 30px; background-color: #f6f8fa;" class="src src-sh">apt-get update ; apt-get install git
</pre>
</div>
</div>
</div>
<div id="outline-container-orga033592" class="outline-3">
<h3 id="orga033592">Mac OSX and Windows</h3>
<div class="outline-text-3" id="text-orga033592">
<ul class="org-ul">
<li style="margin-bottom:0;">Download and install Git from the <a href="https://git-scm.com/downloads">Git website</a>.</li>
<li style="margin-bottom:0;">Optional Git clients (should not be needed if you work within
Rstudio):
<ul class="org-ul">
<li style="margin-bottom:0;"><a href="https://www.sourcetreeapp.com/">SourceTree</a></li>
<li style="margin-bottom:0;"><p>
<a href="https://desktop.github.com/">GitHub Desktop</a>
</p>
<blockquote>
<p>
<a href="https://github.com/desktop/desktop/issues/852">Apparently</a>, this works with GitLab and https.
</p>
</blockquote></li>
</ul></li>
</ul>
</div>
</div>
</div>
<div id="outline-container-org3890548" class="outline-2">
<h2 id="org3890548">Setting up SSH</h2>
<div class="outline-text-2" id="text-org3890548">
<p>
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.
</p>
</div>
<div id="outline-container-org8fce29e" class="outline-3">
<h3 id="org8fce29e">Installation</h3>
<div class="outline-text-3" id="text-org8fce29e">
</div>
<div id="outline-container-org24a337f" class="outline-4">
<h4 id="org24a337f">Linux (debian, ubuntu)</h4>
<div class="outline-text-4" id="text-org24a337f">
<p>
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).
</p>
<p>
Run (as root):
</p>
<div class="org-src-container">
<pre style="padding-left: 30px; background-color: #f6f8fa;" class="src src-sh">apt-get update ; apt-get install openssh-client
</pre>
</div>
</div>
</div>
<div id="outline-container-orgd8eb69c" class="outline-4">
<h4 id="orgd8eb69c">Mac OSX</h4>
<div class="outline-text-4" id="text-orgd8eb69c">
<p>
You do not have anything to do as it is installed by default.
</p>
</div>
</div>
<div id="outline-container-org02c1827" class="outline-4">
<h4 id="org02c1827">Windows</h4>
<div class="outline-text-4" id="text-org02c1827">
<p>
You should install the <a href="https://www.ssh.com/ssh/putty/windows/">Putty</a> client. Once it is installed, look for
the section on <a href="https://www.ssh.com/ssh/putty/windows/puttygen">generating an SSH key</a>.
</p>
</div>
</div>
</div>
<div id="outline-container-orgfaac61e" class="outline-3">
<h3 id="orgfaac61e">Setting up SSH on Framagit</h3>
<div class="outline-text-3" id="text-orgfaac61e">
<p>
Here are <a href="https://docs.gitlab.com/ee/ssh/">all the official explanations on how to set up your SSH key
on GitLab</a>. Alternatively, you may also want to have a look at this
video:
</p>
<iframe width="560" height="315" src="https://www.youtube.com/embed/54mxyLo3Mqk" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
</div>
</div>
</div>
</div> </div>
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment