B.3.  Using git to get and commit files

Once their account is allowed to write to the project, translators can download the translation files using the checkout commands mentioned in Chapter 1, For translators: translating Debian Installer.

Developers can download the full project source tree using git and mr commands as detailed in Chapter 2, For maintainers: maintaining internationalized Debian Installer packages. Note, that this is not necessary for translators!

ssh connections require you to use RSA key-based authentication to connect to salsa.debian.org.

If you don't have an existing SSH keypair on your local system, you must create one with the ssh-keygen command:

spongebob@mykerinos:~$ ssh-keygen -t rsa
Generating public/private rsa key pair.
Enter file in which to save the key (/home/spongebob/.ssh/id_dsa):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /home/spongebob/.ssh/id_rsa.
Your public key has been saved in /home/spongebob/.ssh/id_rsa.pub.
The key fingerprint is:
8d:6d:14:72:72:07:01:6a:85:de:97:d3:aa:b2:ee:4a spongebob@mykerinos

In the example above, the user spongebob creates a SSH RSA keypair, which is saved in a directory named .ssh in his/her home directory.

This keypair is protected by a passphrase. The passphrase has to be entered each time the keypair will be used to connect to a remote host. Take care to choose a non trivial passphrase.

After doing so, the public part of that keypair must be put in your account on salsa.debian.org.

In case users have problems with GIT checkouts/commits, they can ask for help, either on IRC, #debian-boot on irc.debian.org or by mail with the Debian Installer i18n coordinators.