Group: Windows 7 Sins/Getting started with translation
Thanks for your work in translating Windows 7 Sins
The website is quite small, and can be translated by a single person, or small team.
To get started with translations, you will need the following things:
- A Savannah account
- An SSH key associated with your Savannah account
- A Subversion client installed on your computer
- Basic HTML experience
- Basic text editor experience
Don't worry if you're missing some of these — this guide will help you get started.
How Windows 7 Sins is built
The Windows 7 Sins website is built from small files containing snippets of HTML. These files are used by several different pages on the website, meaning you only have to translate something once, and it is reflected across the site.
In addition, once you start working on a translation, you can check your changes in and see them reflected on the development site in a few minutes. And if you make a mistake, you can fix it quickly and easily.
All translations of the Windows 7 Sins website, live on windows7sins.org. We use the ISO standard language code for each site. So, if you are translating the Spanish version of the website, your site will appear at http://es.windows7sins.org/ and your development site will be http://dev.es.windows7sins.org/ -- if your development site isn't working, please contact the Free Software Foundation's systems team, at firstname.lastname@example.org.
Step one: Getting a Savannah account.
This is the first step, and hopefully, one of the easiest.
To get your Savannah account, go to savannah.gnu.org and sign up. Be sure to check your email after signing up to confirm your email address.
Once you have your account, head over to the 'My Groups' page, and request inclusion on the 'win7trans' project, in the lower right side of the page.
Step two: Registering your SSH key with Savannah.
SSH (or Secure Shell) is a method of connecting to remote computers in a secure, encrypted way. You may have used SSH in the past to connect to your website, to upload files, or change your password.
Sometimes, when you connect to a server with SSH, you enter a password, but to make things easier, you can generate a secure pair of 'keys' on your computer. This pair of keys allow you to skip the need for passwords and allow other programs to connect to remote computers on your behalf. To check out the website for Windows 7 Sins, we use a system that keeps track of all the changes made to the website, called Subversion. Subversion is typically used by programmers to keep their programming code in a safe place, allowing other people to check it out, change it and send them bug fixes and suggestions.
For the purposes of Windows 7 Sins, we use Subversion to make sure multiple people can work on the website at the same time, but to do this, Savannah needs to know your SSH public key.
Your public key is usually stored in a file called id_rsa.pub or id_dsa.pub in a folder called .ssh in your home folder. You may not be able to see this, as most graphical file managers hide folders and files that begin with a period.
Open up your favourite text editor (such as gedit or GNU Emacs) and try to open the file. If it doesn't exist, you may not have an SSH key. Generating one is easy, and Savannah has a guide to generating an SSH key.
Once you have a key, head over to [[My SSH keys]] and add your key. It can take up to an hour for your key to be registered by Savannah, so now is a good time to take a break.
Step three: Installing subversion
Subversion is pretty easy to install, you should be able to find it in your regular package manager on your GNU/Linux machine.
Once you have Subversion installed, at a terminal type this:
svn co svn+ssh://<yourusername>@svn.savannah.gnu.org/win7trans
Be sure to replace yourusername with your Savannah username.