getting_started

viewhistorytalk

Be a Translator!

This guide will show how to make changes using Crowdin in order to translate strings on reddit.

Signup for a free account on Crowdin, our localization workflow platform. Visit the reddit project page. Then join the team for the language you're looking to work with. If it doesn't exist, you can request that one be created. That's all!

Your Crowdin dashboard should guide you straight to that language team. Jump right in, look at the untranslated strings and start submitting translations. You can also vote on other people's translations.

Did you know that translations are open sourced? The code that reddit runs is also open sourced on github!
Wondering how the translations make it to the reddit site? Check out the translation pipeline.

If you have any questions about the context for a text string, just follow the guidelines below. For more info, see the Crowdin help page

A few things to keep in mind...

Context for Text Strings

If you have any questions about a specific word usage on reddit, search for the string on reddit.com or even in the reddit github repo for the context. Crowdin translation panel has the code reference in the context field. A select few strings also have screenshots to help you determine the context of the text strings. If you still cannot, use the request context button in Crowdin. Someone will help you!

Translation Consistency

Please check the glossary in Crowdin to maintain consistency. There are many ways to write a sentence. Let's make sure we are consistent and more efficient in our translations!

If you are a translator or proofreader, please use it to maintain standardized translations from English. You should be able to check & edit the terms in the Glossary for your translation team. (e.g. French translators & proofreaders can edit & update the French glossary).

The format to use in the glossary file is shown below:
The source string will be in English.

Translation panel:

Noun 1: xxxxxxxxx
Noun 2: xxxxx
Verb: xxxxxxx
etc.

The reddit Style Guide

Some strings don't actually need a translation! Acronyms, links, html entities, etc., may be marked for translation, but are just fine in alternate languages. For example, you must leave – and simlar variables untranslated.

A few things about writing styles. The term "reddit" is always lowercase. Site terms like "subreddit", "multireddit", "reddit gold" should either be transliterated or remain untranslated depending on your language's convention. Technical acronyms like "CSS", "API" as well as acronymns like "NSFW" should not be translated.

Additionally, keep in mind that text on reddit should feel like a helpful friend. Use an informal & friendly tone in your translations. Do not to use formal language unless the context requires it.

If you would like to create a style guide for your language, you may also create such pages on the /r/i18n wiki

Plural & Singular Strings

Several strings on Crowdin request both singular form & plural translations of text strings. First translate the string in the singular form, then click the button below the translation text box to switch to the plural form.

Special Strings

Please note if there any special instructions for strings before translating them. For example, there are a number of strings that look like Reason to create a reddit 4 & Funny 500 page message1 that have particular instructions to not translate them literally.

Variables & placeholders

A number of the strings have funny characters like %s(value)s or %d() or %r or similar. There are variables that will have the correct values dynamically updated–for example when calculating the age of a reddit post. these variables should not to be translated, edited, or changed.

That's it! If you have any questions please ask on /r/i18n.

Proofreading Translations
(for those with proofreader status on a language team)

If you have proofreader status, please use it responsibly.

Please don't

  • don't approve a string if you don't know the context. Just request context in Crowdin and someone will help you.
  • don't approve a string if it doesn't follow the developer/context instructions.
  • don't immediately proofread strings that you have translated. Wait two weeks to allow other people to comment or translate them.
  • don't just approve the string with the highest votes. Approve the string that is correct and fits the reddit guidelines.
  • don't approve strings that translate site-specific terms.
  • don't approve strings with translated or incorrectly formatted variables/placeholders.

Please do

  • update the glossary for your language. Just go to your language page in Crowdin and choose glossary.
  • check translated strings so they are consistent by utilizing the glossary.
  • check translated strings to make sure they are the correct for the context used on reddit.
  • do vote up translations in Crowdin that are correct.
  • do bring up any issues regarding translations in the reddit.

Thanks and happy translating!


revision by Werner__Herzog— view source