GPSLog Labs
Help: Translation
If you'd like to help translate GPSLog Labs into your language I'd love to hear from you, please contact me at tom.paton+gpsloglabs@gmail.com.
Accessing the translation editor
Once you've been granted translator permissions, you will see the Translate link at the bottom of each page on GPSLog Labs:
This will take you to Rosetta, an online tool for editing translations. Select your language from the list:
Translating
The main translation screen is pretty simple. The first column shows the original English version of the text, and you enter the translated version for your language in the second column.
Any blank strings will be left in English, so you can fill in what makes sense and leave the rest for later.
There are a lot of strings, and the order of the translations is unfortunately not very useful, so I'd suggest initially you skip anything you don't recognize from one of the main pages.
Try to find and do all the short generic strings first that appear in lots of areas of the site (e.g. tab and column headings) as they will have the most benefit with the least effort.
The Occurrences column lists the places in the source code where the strings appear. This will be of limited use when you're not familiar with the code, but hopefully the filenames will give you hint as to what area of the site the string appears in and strings with lots of occurrences probably should be done before strings with only one occurrence.
Google Suggest
There's a suggest link under each textbox which will use Google Translate to provide an initial translation. This may or may not speed things up depending on how good Google's translation is.
Note: Unfortunately, this feature is no longer supported and now returns an error message from Google.
Format strings
Some strings will contain "printf" style placeholders (%s, %d, %f and so on, highlighted in red), they will be expanded into data from the database and need to appear in the translated string too.
Some have only a %s, some have a keyword in brackets, such as %(file)s. The word in brackets must be in English and not be translated. If there is more than one placeholder, it's ok to swap them around if you need to.
Be careful as the Google Suggest link will mess those up.
HTML formatting
Wherever possible I will try to avoid including HTML markup in the strings, but you will find some and it needs to be left in the translated string for the site to work properly.
Generally anything between angle brackets < and > needs to be left alone. Be particularly careful if using the Google Suggest link as it will break the HTML and you'll need to fix it up to match the English original.
- <br> or <BR> — This is a line-break.
- <strong> — This makes the text bold and must be matched by a closing </strong> tag.
- <em> — This makes the text italic and must be matched by a closing </em> tag.
- <a href="%(url)"> ... </a> — This is a link and the site won't work properly if it's changed.
Plurals
Some strings require a different translation depending on the number of items being referred to:
Enter the singular case in the top textbox (0) and the plural case in the bottom textbox (1). For some languages, there may be a third textbox (2), which is usually for special cases such as numbers ending in 1, 2, 3, 4. Some more (technical) information can be found in the GNU gettext documentation.
Fuzzy
Translations you've already made may be marked as fuzzy when I change something in the original text. It means that the translation may no longer be accurate and needs to be checked again.
You can also use the fuzzy flag to remind yourself to come back to an entry for some reason.
NOTE: Fuzzy entries will not be displayed on the site and need to be marked "not fuzzy" as soon as possible.
Search
Use the search function to find the things you can see on the screens you use, don't worry about the other strings as much. If you haven't seen them, most users probably won't see them either.
If you can't find a string that appears on the site, let me know as there are some areas of the site that haven't been marked up for translation yet.
Filters
You can filter the list to show only untranslated or fuzzy strings by clicking the buttons on the top right of the page.
Updates to the site
As I make changes to the site, the translations will need to be updated too. Your existing translated strings get marked as fuzzy if I change the original English version.
- For spelling mistakes and very minor tweaks I'll just remove the fuzzy flag and keep your translation.
- When I make a major change where I can't tell if the translation is valid any more I will leave the translation marked as fuzzy. Please look at these and fix them if necessary and un-tick the fuzzy flag so they are displayed on the site again.
Questions?
Please contact me if you have any questions at all, I want to make this as easy as possible for you as you're helping me and the other GPSLog Labs users.
- Not sure what a string means? It's possibly confusing in English too and I'm happy to discuss it.
- Found a problem with the English string? Spelling or grammar mistakes, is it confusing or unclear?
- If you can't find a string in the site, try using the Occurrences as a hint, and failing that, ask me and I'll let you know where to find it.
- If you can't find a string from the site to translate let me know as some areas of the site have not been marked up for translation.
If you get a "File is read-only" error then let me know and I'll fix it, this happens sometimes after an update to the site.
GPSLog Labs © 2009–2018 Tom Paton | Privacy | Feedback | About | Language: English