Git should be installed on your computer as part of your Bash install (see the Shell installation instructions).
12.11.2024 & 03.12.2024
10:00 - 16:00
Instructors: Kevin Lindt, Stefan Kirsch
Helpers:
This workshop is a mix & match workshop based on the Software Carpentry lesson Version Control with Git, using the gitlab infrastructure of the TU Ilmenau.
The Carpentries project comprises the Software Carpentry, Data Carpentry, and Library Carpentry communities of Instructors, Trainers, Maintainers, helpers, and supporters who share a mission to teach foundational computational and data science skills to researchers.
Want to learn more and stay engaged with The Carpentries? Carpentries Clippings is The Carpentries' biweekly newsletter, where we share community news, community job postings, and more. Sign up to receive future editions and read our full archive: https://carpentries.org/newsletter/
Software Carpentry aims to help researchers get their work done in less time and with less pain by teaching them basic research computing skills. This hands-on workshop will cover basic concepts and tools, including program design, version control, data management, and task automation. Participants will be encouraged to help one another and to apply what they have learned to their own research problems.
For more information on what we teach and why, please see our paper "Best Practices for Scientific Computing".
Who: The course is aimed at graduate students and researchers of the TU Ilmenau. You don't need to have any previous knowledge of git. You don't have to attend both parts if you're for exapmle only interested in one. However, for the second part (03.12.) you need basic knowledge of git as taught in the first part (12.11).
Where: Grace-Hopper-Bau, Helmholtzplatz 7, 98693 Ilmenau. Get directions with OpenStreetMap or Google Maps.
When: 12.11.2024 & 03.12.2024; 10:00 - 16:00 Add to your Google Calendar.
Requirements: Participants must bring a laptop with a Mac, Linux, or Windows operating system (not a tablet, Chromebook, etc.) that they have administrative privileges on. They should have a few specific software packages installed (listed below).
Accessibility: We are committed to making this workshop accessible to everybody. The workshop organizers have checked that:
We are dedicated to providing a positive and accessible learning environment for all. We do not require participants to provide documentation of disabilities or disclose any unnecessary personal information. However, we do want to help create an inclusive, accessible experience for all participants. We encourage you to share any information that would be helpful to make your Carpentries experience accessible. To request an accommodation for this workshop, please fill out the accommodation request form. If you have questions or need assistance with the accommodation form please email us.
Glosario is a multilingual glossary for computing and data science terms. The glossary helps learners attend workshops and use our lessons to make sense of computational and programming jargon written in English by offering it in their native language. Translating data science terms also provides a teaching tool for Carpentries Instructors to reduce barriers for their learners.
Contact: Please email data-steward@tu-ilmenau.de for more information.
Roles: To learn more about the roles at the workshop (who will be doing what), refer to our Workshop FAQ.
Everyone who participates in Carpentries activities is required to conform to the Code of Conduct. This document also outlines how to report an incident if needed.
Please be sure to complete these surveys before and after the workshop.
Before | Pre-workshop survey |
10:00 | Basic Version Control with Git |
13:00 | Lunch break |
14:00 | Basic Version Control with Git (continued) |
16:00 | END |
10:00 | Collaborative Version Control with Git |
13:00 | Lunch break |
14:00 | Collaborative Version Control with Git (continued) |
16:00 | END |
After | Post-workshop Survey |
To participate in a Software Carpentry workshop, you will need access to software as described below. In addition, you will need an up-to-date web browser.
We maintain a list of common issues that occur during installation as a reference for instructors that may be useful on the Configuration Problems and Solutions wiki page.
Git is a version control system that lets you track who made changes to what when and has options for easily updating a shared or public version of your code on github.com. You will need a supported web browser.
You will need access to gitlab.tu-ilmenau.de for the second part of this workshop (03.12.). As a member of the TU Ilmenau you have access via your university login. If you don't have a university login (yet) please contact the contact e-mail mentioned above.
Git should be installed on your computer as part of your Bash install (see the Shell installation instructions).
Please open the Terminal app, type git --version
and press
Enter/Return. If it's not installed already,
follow the instructions to Install
the "command line
developer tools". Do not click "Get Xcode", because that will
take too long and is not necessary for our Git lesson.
After installing these tools, there won't be anything in your /Applications
folder, as they and Git are command line programs.
For older versions of OS X (10.5-10.8) use the
most recent available installer labelled "snow-leopard"
available here.
(Note: this project is no longer maintained.)
Because this installer is not signed by the developer, you may have to
right click (control click) on the .pkg file, click Open, and click
Open in the pop-up dialog. You can watch
a video tutorial about this case.
If Git is not already available on your machine you can try to
install it via your distro's package manager. For Debian/Ubuntu run
sudo apt-get install git
and for Fedora run
sudo dnf install git
.
Bash is a commonly-used shell that gives you the power to do tasks more quickly.
cmd
and press Enter)setx HOME "%USERPROFILE%"
SUCCESS: Specified value was saved.
exit
then pressing EnterThis will provide you with both Git and Bash in the Git Bash program.
The default shell in Mac OS X Ventura and newer versions is Zsh, but
Bash is available in all versions, so no need to install anything.
You access Bash from the Terminal (found in
/Applications/Utilities
).
See the Git installation video tutorial
for an example on how to open the Terminal.
You may want to keep Terminal in your dock for this workshop.
To see if your default shell is Bash type echo $SHELL
in Terminal and press the Return key. If the message
printed does not end with '/bash' then your default is something
else, you can change your current shell to Bash by typing
bash
and then pressing Return. To check
your current shell type echo $0
and press Return.
To change your default shell to Bash type chsh -s /bin/bash
and
press the Return key, then reboot for the change to take effect. To
change your default back to Zsh, type chsh -s /bin/zsh
, press the
Return key and reboot. To check available shells, type
cat /etc/shells
.
The default shell is usually Bash and there is usually no need to install anything.
To see if your default shell is Bash type echo $SHELL
in Terminal and press the Return key. If the message
printed does not end with '/bash' then your default is something
else, you can change your current shell to Bash by typing
bash
and then pressing Return. To check
your current shell type echo $0
and press Return.
To change your default shell to Bash type chsh -s /bin/bash
and
press the Return key, then reboot for the change to take effect. To
change your default back to Zsh, type chsh -s /bin/zsh
, press the
Return key and reboot. To check available shells, type
cat /etc/shells
.
When you're writing code, it's nice to have a text editor that is optimized for writing code, with features like automatic color-coding of key words. The default text editor on macOS and Linux is usually set to Vim, which is not famous for being intuitive. If you accidentally find yourself stuck in it, hit the Esc key, followed by :+Q+! (colon, lower-case 'q', exclamation mark), then hitting Return to return to the shell.
nano is a basic editor and the default that instructors use in the workshop. It is installed along with Git.
nano is a basic editor and the default that instructors use in the workshop. See the Git installation video tutorial for an example on how to open nano. It should be pre-installed.
nano is a basic editor and the default that instructors use in the workshop. It should be pre-installed.