introduction_handouts.tex 2.67 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
\documentclass{article}
\usepackage{fullpage}
\usepackage{listings}

\frenchspacing
\setlength{\parindent}{0pt}
\pagestyle{empty}

\begin{document}
\begin{center}
{\bf Git Introduction Course}

Git Introduction practical.
\end{center}
\bigskip

17
\subsubsection*{Local configuration}
18
19
20
21
First, let Git know what your name and e-mail address is:
\begin{lstlisting}
  $ git config --global user.name "<Your Name>"
  $ git config --global user.email "<name@lumc.nl>"
22
  $ cat ~/.gitconfig
23
24
25
\end{lstlisting}
\bigskip

26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
For the other practicals, it is convenient to have a \texttt{projects} folder
for your repositories:
\begin{lstlisting}
  mkdir ~/projects
  cd ~/projects
\end{lstlisting}

\newcommand{\generalconfiguration}{
  You can now edit your profile by clicking on the ``profile'' button
  (pictogram of a torso), located on the top right of your screen. On mouse
  over, a text balloon will pop up, saying ``Profile settings''.
  \medskip

  Check your name and e-mail address (you probably want to change your name).
  \bigskip
}

\subsubsection*{Remote configuration for LUMC participants}
44
45
46
47
48
49
50
51
52
53
54
55
56
57
Check whether you have an ssh key:
\begin{lstlisting}
  $ cat ~/.ssh/id_rsa.pub
\end{lstlisting}
\bigskip

If not, make one:
\begin{lstlisting}
  $ ssh-keygen
  Enter file in which to save the key (/home/<username>/.ssh/id_rsa):
  Enter passphrase (empty for no passphrase):
  Enter same passphrase again:
\end{lstlisting}
You can leave all fields blank.
58
\bigskip
59
60

Open \texttt{https://git.lumc.nl} in your browser.
61
\medskip
62
63
64
65

In the authentication form, use your LUMC username and password (LDAP login).
\bigskip

66
67
68
69
70
71
72
73
74
75
76
77
78
\generalconfiguration

To be able to upload new versions, you need to add your ssh key. Open the ``SSH
Keys'' tab and click the ``Add SSH Key'' button.
\medskip

Give your key a title (e.g., ``Course laptop'').
\medskip

Copy your ssh key to the key field (see the \texttt{cat} command above).

\subsubsection*{Remote configuration for other participants}
Open \texttt{https://git.lumc.nl} in your browser.
79
80
\bigskip

81
82
In the authentication form, use the provided username and password (Standard
login).
83
84
\bigskip

85
\generalconfiguration
86

87
88
Open \texttt{https://git.lumc.nl/humgen/gitcourse} in your browser.
\bigskip
89

90
91
92
93
94
95
96
97
98
99
On the right, you see a text box containing the string
\texttt{git@git.lumc.nl:humgen/gitcourse.git}, notice the ``SSH'' button is
selected. During the course we will ask you to use this protocol (ssh) for
remote repositories. Since we do not have access to the LUMC using this
protocol, we are going to use an other protocol.
\bigskip

Click the ``HTTPS'' button, and you will see the string
\texttt{https://git.lumc.nl/humgen/gitcourse.git}. We can use this protocol
(https) for remote repositories.
100
\end{document}