Group: Windows 7 Sins/Getting started with translation
Contents
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 sysadmin@gnu.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.
