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}