How to translate bits.debian.org into your language

The following instructions are work in progress. Translations are usually coordinated inside the L10n teams, please check with them first.

Get your alioth access ready

If you don't have account in Alioth, the Debian source code forge, create one account: https://alioth.debian.org/account/register.php (your account name will be something like USER-guest)

Set up your ssh key: follow the instructions here and here.

Then request joining the Publicity project in Alioth: https://alioth.debian.org/projects/publicity/

If you are Debian Developer, you already have commit access, no need to join the publicity project in Alioth.

Get the git repository

http://bits.debian.org is handled via git. You will need to install git in your machine.

1. In your local machine, clone the git repository. Open a terminal and type:

If you already cloned the repo some time ago, just update your local copy with:

2. Create a branch for your language if it doesn't exist already. Use the name of your languange in English.

3.1. The branch exists already, just do:

change Spanish for the name of your language.

3.2. The branch doesn't exist, create it:

change Spanish for the name of your language.

Prepare the post to translate

1. Browse the posts under content/ and choose the post you want to translate. If you work inside a established translation group, they might have a process to reserve the file you want to translate.

2. Copy the post you want to translate adding the suffix -XX, where XX is the code of the language:

Now you can edit it with a text editor. The posts are in markdown so a editor with syntax hilight would make it easier.

3. Below the Tags line add the following line: Lang: es

where "es" should be the code for your language, "es" is the code for Spanish. Check the code for your language in this page https://www.debian.org/international/l10n/po/

4. Add your name in an Translator line below the Author line:

Translator: Juana Smith

5. Change the Status line from "published" to "draft".

6. Check the header is something like this:

Title: translated title
Datehttps://titanpad.com/publicityl10n: leave it as is
Tags: leave it as is
Slug: leave it as is
Author: translate the "and" (if several authors)
Translator: add name+surname, or nick
Lang: xx  (where xx is the language code, e.g. es for Spanish, tr for Turkish)
Status: draft

7. And now, finally, translate the Title line and the text of the post! Beware of the markdown syntax. You can read about markdown at https://en.wikipedia.org/wiki/Markdown

Push your translation in git

Once you have finished, commit the post and push it:

    $ git add content/2015/yourpost-xx.md
    $ git commit -m "lang xx: initial translation post foo"
    $ git push 

Make sure you commit it in the branch of your language.

Now it's time to get somebody else reviewing your post! Once the post is reviewed, it can be pushed into the main branch and shown in http://bits.debian.org