B.3.  Using SVN/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 svn and git checkout commands as detailed in Chapter 2, For maintainers: maintaining internationalized Debian Installer packages. Note, that this is not necessary for translators!

For doing svn+ssh connections (mandatory for being able to commit files later), users must have an account on alioth.debian.org and be authorized for commit to the repository they want to checkout. Replace alioth_username by this login name before using the SVN pseudo-URLS.

svn+ssh connections require you to use RSA key-based authentication to connect to alioth.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 below, 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 alioth.debian.org. For this, you need to output the contents of .ssh/id_rsa.pub and paste it in the relevant field of the account management page on alioth.debian.org (https://alioth.debian.org/account), in the section named Shell account informations, by clicking on Edit keys.

In case users have problems with SVN 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.

MS-Windows users who want to use TortoiseSVN to checkout or commit can go to the TortoiseSVN SSH HowTo page to get information about setting up TortoiseSVN to do SVN+SSH connections.