| ... | ... | @@ -32,7 +32,7 @@ Double-click on the installer, then follow the instructions. Choose the default |
|
|
|
|
|
|
|

|
|
|
|
|
|
|
|
Choose one editor that you know well instead of vim (e.g. NotePad++ on Windows).
|
|
|
|
Choose one editor that you know well instead of vim (e.g. [NotePad++](https://notepad-plus-plus.org/) on Windows).
|
|
|
|
|
|
|
|
## Configure git
|
|
|
|
|
| ... | ... | @@ -40,13 +40,15 @@ On Windows, you can use "git" by right-clicking on a folder in the windows explo |
|
|
|
|
|
|
|
On the other systems (Linux/macOS), open a terminal.
|
|
|
|
|
|
|
|
Then type these commands.
|
|
|
|
Then, on any system (Windows/linux/macOS), type these commands.
|
|
|
|
```
|
|
|
|
git config --global user.name "Your Name"
|
|
|
|
git config --global user.email "your_email@student.uliege.be"
|
|
|
|
```
|
|
|
|
Git must know your name and e-mail address. All your personal work will be identified on GitLab with these 2 strings.
|
|
|
|
|
|
|
|
This configuration step should be done once per computer.
|
|
|
|
|
|
|
|
## Configure SSH keys
|
|
|
|
|
|
|
|
The GitLab of ULiège does not allow you to use your student-ID / password for git commands. It uses a pair of "SSH keys" (one "private key" that should never be shared with anyone and a "public key" which can be given to anyone who wants to check that you own the "private key").
|
| ... | ... | @@ -59,7 +61,7 @@ Then choose "SSH keys" on the menu on the left. |
|
|
|
|
|
|
|
Follow the [procedure](https://gitlab.uliege.be/help/ssh/README#generating-a-new-ssh-key-pair) to create a SSH-key pair (in a "git-bash" terminal on Windows, or a terminal on the other platforms).
|
|
|
|
|
|
|
|
Use the RSA type, which is more compatible with older machines (such as NIC4).
|
|
|
|
Use the RSA type, which is more compatible with older machines.
|
|
|
|
```
|
|
|
|
$ ssh-keygen -o -t rsa -b 4096 -C "demo"
|
|
|
|
Generating public/private rsa key pair.
|
| ... | ... | @@ -79,7 +81,7 @@ Open the public key (file `.ssh/id_rsa.pub`) in an editor... |
|
|
|
|
|
|
|

|
|
|
|
|
|
|
|
...and copy/paste its contents to the box in the SSH keys of the gitlab website.
|
|
|
|
...and copy/paste its contents to the box in the SSH keys of the GitLab website.
|
|
|
|
|
|
|
|
On Linux, this can be done by displaying the public key in the terminal:
|
|
|
|
```
|
| ... | ... | @@ -127,6 +129,6 @@ There are numerous tutorials on git on the web: |
|
|
|
There are also several e-books, which can be legally downloaded from [ULiège's library](https://lib.uliege.be) or the internet (e.g. [Pro Git](https://git-scm.com/book/fr/v2)).
|
|
|
|
|
|
|
|
I have created a powerpoint presentation for teaching git to my colleagues/students. You may download the current (unfinished) version with the link below:
|
|
|
|
* [Git powerpoint (in French)](http://metafor.ltas.ulg.ac.be/dokuwiki/_media/devel/git_v17.pdf)
|
|
|
|
* [Git powerpoint (in French)](http://metafor.ltas.ulg.ac.be/dokuwiki/_media/devel/git_v20.pdf)
|
|
|
|
|
|
|
|
Unlike the links above, this presentation focuses on the tools used at the University of Liège (this GitLab) and on the Windows operating system (because most of my colleagues/students use Windows). I also start the presentation by the local usage of git before using GitLab, so that branches and cleaning operations are well understood before going online. The git features of Visual Studio Code are also presented. |