introduction_handouts.tex

\documentclass{article}

\providecommand{\handoutsTitle}{Git Introduction}

\usepackage{handouts}
\input{../shared/shared}

\begin{document}
\makeHeader

\subsubsection*{Local configuration}
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 "your@email.address"
  $ cat ~/.gitconfig
\end{lstlisting}
\bigskip

For the other practicals, it is convenient to have a \lstinline{projects}
folder for your repositories:
\begin{lstlisting}
  mkdir ~/projects
  cd ~/projects
\end{lstlisting}

\subsubsection*{Remote configuration}
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.
\bigskip

Open \url{https://git.lumc.nl} in your browser.
\medskip

In the authentication form, use your username and password.
\bigskip

You can now edit your profile by clicking on the ``Profile Settings'' item in
the menu on the left.
\medskip

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

To be able to upload new versions, you need to add your ssh key. Click the
``SSH Keys'' item 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 \lstinline{cat} command above).

\end{document}