Made by you—Please do not copy and paste machine translation—you’re much smarter than algorithms.
Complete and accurate—Make sure you’ve translated all words, converted all measurements, researched technical terms, used terms defined in the glossary, etc.
Comprehensible—Would your neighbor/niece/grandpa understand?
In a modern and informal style—Write as if you’re explaining how to change a light bulb to a friend. (Link to the general guidelines, opens in a new window)
We are using a tool called Crowdin to translate the user interface of the site. Actual content—guides and wikis—can be translated directly on iFixit.com. Here we have some general guidelines.
Crowdin is an online, peer-review translation platform. They offer an excellent overview/tutorial including information regarding your account and on how to contact iFixit employees.
We recommend you read through their overview and get familiar with the Crowdin interface before you start translating. If you are ready to dive in, make an account, join the iFixit translation project, and get to work on the untranslated portions of iFixit.com.
- In-context translationPer-language forumsAwesome moderation / proof-reading interface
Crowdin separates the material that needs translating into different categories, based on where that material lives on iFixit.com. The highest priority for translation is labeled as “Base.po”—that’s essentially the base architecture of iFixit, and what most visitors to the site see.
One strategy to find the translation on the site, which can be quite challenging, might be to Google your target phrase, like this:
site:ifixit.com “ask a question”.
Crowdin keeps track of your translation progress. As you translate more phrases (or strings) on iFixit, you’ll see the language completion percentage slowly increase. In the event that the language you’re working on has reached 100% completion, please continue to check Crowdin on a regularly basis. We are constantly adding new content to the site that needs to be translated.
- When you have translated a string of text, read it again and see if there are any errors and if the translation sounds right in your language.If the translated phrase does not make sense, it is definitely wrong and you should rephrase it.
Of course, it’s very important to be correct when translating, but if you happen to mistranslate something, there’s a safety mechanism engineered into Crowdin: All the translations you submit will be reviewed by someone else. So rest easy—you won’t accidentally take down the site if you mess up a translation.
A helpful tool on Crowdin is the Translation Memory (tab “Search TM") where you can search for specific words and how they have been translated within the iFixit project before. If you work on a string that has been translated before, Crowdin will suggest the old translation. Furthermore, you can check the memory for specific translations that have been used before (Search TM below the translation box). But be careful: Just that they are in the memory is no proof they are still in use – to make sure, check the specific string. With the translation memory, we try to get a continuity in a language even though it has been translated by several different translators.
Machine translations are translations made by a computer, instead of a human. Crowdin offers Google Translate and Microsoft Translator right below previous translations of a specific string.
But: We see machine translation as a stop-gap. It’s not a solution and even the best machine translations tend to be pretty bad. Human translations are more nuanced, more accurate, and much better. That’s why we ask our translators not to just copy the given translation—except sometimes, when there is nothing to improve on a translation.
In many programming languages, a developer can insert data into a string by using a placeholder, such as a % sign followed by a number. You might see something like that on the site. These placeholders should not be modified.
Here are some examples of placeholders you might encounter:
In this case, the" %1" is most likely going to be a number. So when you translate this sentence, place the “%1” where a number would make sense. You can also reword it to something like “I have a Reputation of %1” — but the % and the 1 must always appear in the same order. Likewise, inserting a space between the % and 1 will break the placeholder’s function on iFixit.
When placeholders are surrounding text, then they imply some kind of styling. It can be indicating bold type, italics, URLs, etc. We have done this to reduce the amount of HTML you need to copy. When the placeholder is substituted, the sentence might look like this:
This is a link to Google
Once again, don’t change the order of the placeholders, and don’t insert spaces that didn’t appear in the original text. Otherwise, you could break the link when you translate.
- In some cases, you might encounter a character that resembles a small square attached to a placeholder. Ignore the small squares in your translations.By default, Crowdin enables the option to validate translations. The option checks translations for missing punctuation, variables, and more. This is ideal, except for one small caveat. You may find a string of text that has a placeholder and a word without a space in between, such as “%1Find us on %2facebook”; Crowdin will think that %1F is the placeholder. In which case, if you attempt to commit the translation, you will find yourself with an error message saying you have missed or mistranslated some variables. Go ahead and click ‘Save Anyway’ and continue with your translations.
While we try to minimize it, you may see HTML/XML tags, such as , used to format text in a string. If you see code, don’t translate it. It shouldn’t be there. Report the issue to iFixit admins.
