Presentation for the git intro tutorial.
The main document (the one you should run pdflatex
on) is larics-git-tutorial-intro.tex
. The LaTeX code uses the minted package, so it is necessary to add the -shell-escape
option to the pdflatex command line when compiling the document.
The classes are interactive, i.e., students are expected to follow along on their own laptops.
The material is appropriate for 2 classes of 2 hours (2x90 minutes). The first class should cover the "Keeping track of your code" section, i.e., material up to slide 30 "Getting changes from the remote repository" The second class should cover the material on "Collaborating with others".
The students should arrive to class prepared, i.e., they should:
- Open a GitHub account
- Check for existing ssh keys
- In case they do not have a key, they should generate a new ssh key
- Add the key to their GitHub account
To check that the key was successfully added they should try logging on to git (answer yes if prompted):
$ sudo ssh [email protected]
Hi <user>! You've successfully authenticated, but GitHub does not provide shell access.
Connection to github.com closed.
On Linux, the following software must be installed:
$ sudo apt-get install git git-gui gitg
Optionally, students who whish to work on the C++ example should also install:
$ sudo apt-get install build-essential cmake
The classes can also be followed on Windows, with the help of the following software:
- Git for Windows
- The gitg Windows client (path to the executable must be added to the Windows PATH environment variable)
- mingw and CMake or Python (theoretically, but the demo code currently seems to break on Windows)