- jeudi 03 février 2011, 17:05 -

- dpm_, 17:05 -
Hi everyone!
Welcome to the first ever Translations Training Session :-)
we'll wait a couple of minutes to see if there are any late-comers
ok, let's get started
Let's see who's here, any new translators around?
ok, first of all, a few words about these sessions.
Here's how they will work:
We'll be running IRC sessions every two weeks, covering different topics on each one, all related to different aspects of translating Ubuntu.
The main goal is to help new translators giving them a quickstart on how to start contributing,
but we will also cover topics that can be of interest to more experienced translators or to people starting to create a new translation team.
As such, the range of topics will be broad. We've got a bunch of suggestions here:
https://wiki.ubuntu.com/Translations...ng/Suggestions
and I encourage you to add your own suggestions on that page,
so we can make this more personal and tailor the sessions to what you think it is important to know as a translator.
When we run out of topics, we can repeat them again, as there are always new translators willing to learn :-)
Eventually, I'd like the resources created during these sessions (translations training projects in Launchpad, session logs, session outlines) to be useful for each local translation team
to reuse them to run sessions in their language
But enough introductory talk. Let's get started.
* What we'll learn today: we'll focus on describing and using the Launchpad Translations web interface, which is what you'll be using to translate Ubuntu

The Translations Web UI
-----------------------
Generally, you'd be going to http://translations.launchpad.net/ubuntu to translate your favourite distro
But today we'll be using a kind of a playground project in Launchpad,
so you can start playing around with translations and submitting data without the worry of sending or overwriting real translation data.
Here it is:
https://translations.launchpad.net/t...translate-this
The Translations Training project
So if you all go there, we'll first start looking at all of the elements of the UI.
Go and click on the name of your language in that page, which should take you to the translatable messages.
For example in my case (Catalan), it takes me to:
https://translations.launchpad.net/t.../ca/+translate
Once you are there, click at the little magnifier icon on the far left of the first translatable message.
It's the icon with a plus sign (+) on it.
If you cannot find it, don't worry, you can just go to the Catalan version here:
https://translations.launchpad.net/t...a/1/+translate
Ok, so we're all set now, and we can start having a look at all the UI elements.
Here are the most important:
1. The original English message.
That is the message on top, which says "My first ever translation".
This is the message you'll have to translate into your language.
We'll be calling this the original message or string (as in a string of characters),
and it will be always in English.
So you will in principle only need knowledge of English and the language you are trying to translate into
2. The translators comment.
You'll see this text right below the original English message, next to a small info {i} icon.
These are messages that are written by developers to give additional information to translators as to the context of the message.
These are really useful to provide accurate translations, especially when the original text can be ambiguous
3. Current translation.
Shown below the translators comment, this shows the current translation, if any, into the local language.
If there isn't any translation, it will show the text "(no translation yet)".
You'll see it's got a radio button, so that you can select the appropriate translation in case there are already translation suggestions (more on this below).
4. Translation suggestions.
Right below the current translation, there is a space with radio buttons where translation suggestions (if any) are shown.
You will not see this if there haven't been any suggestions yet.
Translation suggestions are either translations that contributors have provided directly, or that have been found in other projects in Launchpad.
Launchpad is quite clever on this, and if it finds the same original message in any of the hosted projects, it will show it as a suggestion automatically for you.
meaning it will show the translations for the original message as a suggestion
Suggestions are quite a cool feature: they allow you to basically do "point and click" translation and save you a lot of work.
They will also allow you to ensure the quality of translations through review (more on this below).
You can also dismiss suggestions by ticking the "Dismiss all suggestions above" checkbox and committing the change by pressing the "Save & Continue" button.
5. New translation.
This is the interesting part.
On this textbox you'll be able to submit your translations, which can be direct ones or suggestions - depending on the permissions of the translatable project and on your team membership.
It might show an expander at the end of it, which you can click in case you need to expand the text box to provide a longer translation
6. Needs Review checkbox.
Right below the "New translation" text field, you'll see the "Someone should review this translation" checkbox.
You can use this to let reviewers look at your translations before they are accepted.
This is generally recommended for translation quality, as the reviewers will spot mistakes, typos and inconsistencies, and will help you getting translations right before they are released to users.
You will learn a lot from reviews, so I encourage you to get your translations reviewed by contacting the team responsible for your language
or to do reviews yourself
Ticking this checkbox and pressing the "Save & Continue" button will make your translations be submitted as suggestions, and applies only if you are already a member of a translation team.
If you are not yet, your translations will be submitted as suggestions always, without the need to tick that box.
As an example, you can see several suggestions, not yet reviewed and accepted, here:
https://translations.launchpad.net/t...a/1/+translate
And here you can see a suggestion which has been reviewed and accepted:
https://translations.launchpad.net/t...a/2/+translate
Notice how Launchpad properly credits both the translator and the reviewer.
7. Source code reference.
Below the Needs Review checkbox you'll see a smaller text telling you where in the code for the program the string appears.
You shouldn't worry much about that, but in some cases,
this can be really useful to find out which file the string belongs to, or it might give you a hint to what kind of translation that is, depending on the type of file
8. Zoom.
You've used this already, and it's the magnifier icon with the plus (+) or minus (-)
on the far left of the translatable message
If you click on it, it will let you switch between the single message view or all translatable messages view.
Useful to concentrate on a difficult translation or to get the URL to a particular message you want to point out to (i.e. for review or to show someone a particular translation).
9. Copy text.
That's the arrow icon right to the left of the translatable message.
It provides a shortcut to be able to just copying the original text into the translation field
without having to retype the message
This comes in quite handy when the translation is actually the same as the original
i.e. it is actually not translated. This happens in the names of programs, acronyms, names of programming languages, etc.
10. "Save & Continue" button.
That is a key part of the UI.
The moment you press it, your translations or suggestions are saved in the Launchpad database.
This allows you coming back at a later time to review them and they will be right there where you left them last time.
You don't have to complete all translations in a page
you can press it at any time and it will save only the ones you've made.
Ok, so that has covered the most important UI elements of the Launchpad Translations interface.
I tried to detail each one of them, but you'll see that they are quite intuitive and it will just take you a couple of minutes to get used to them.
-> Any questions so far?
ok, let's move on
Doing Your First Translations
-----------------------------
So now for the fun part.
The translations-training project is thought for you to experiment with translations and with all the UI elements.
It's thought of as a hands-on tutorial, as the translator comments will tell you more about the particular translation
and help you learn more about elements of translation.
It has just a few translatable messages now, but we'll be adding more in future sessions.
If you are not there yet, you can go to
https://translations.launchpad.net/t...tions-training
Then click on your language and start submitting your translation suggestions.
Right now the project is set up with Restricted permissions, in the same way Ubuntu is.
This means that you can only submit direct translations if you are a member of an approved translation team,
but you'll always be able to submit translation suggestions.
If, after you've tried submitting suggestions you want to see what it's like submitting direct translations, do let me know and I can change the permissions temporarily to Open, so that anyone can do it.
So go and play with this project, and do come back if you've got any questions
Everything clear so far?
So if there aren't any questions, we'll wrap up and leave it here for today, and we'll continue in two weeks time in the next session

- mbouzada a quitté la salle

- dpm_, 17:52 -
Summary
-------
So today we learnt about:
* The Launchpad Translations UI elements and how to use them
* Submitting translations and suggestions through the Translations Training project in Launchpad: https://translations.launchpad.net/t...tions-training
- Déconnecté
- Sujet défini : Welcome to the Ubuntu Translators channel! | List of Ubuntu Translation teams: https://translations.launchpad.net/+...tu-translators | We use Launchpad Translations https://translations.launchpad.net | Howtos, FAQ and Contact info: https://wiki.ubuntu.com/Translations | Logs: http://logs.ubuntu-eu.org/free/
- Connecté
- primes2h a quitté la salle
- danilos s'est déconnecté (Quit: Ex-Chat)
- Blue-Omega a rejoint le salon
- Blue-Omega s'est déconnecté (Remote host closed the connection)
- Déconnecté
- Sujet défini : Welcome to the Ubuntu Translators channel! | List of Ubuntu Translation teams: https://translations.launchpad.net/+...tu-translators | We use Launchpad Translations https://translations.launchpad.net | Howtos, FAQ and Contact info: https://wiki.ubuntu.com/Translations | Logs: http://logs.ubuntu-eu.org/free/
- Connecté
- vendredi 04 février 2011, 00:30 -
- trijntje s'est déconnecté (Quit: Ik ga weg)
- askhl a rejoint le salon
- Claudinux a rejoint le salon