Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
..
Failed to load latest commit information.
README.md

README.md

This page is a guide for people who would like to contribute translations to Loomio.

If you're a developer, check out the code guide

Contents

  1. Getting Started
    1. join an existing language
    2. create a new language
    3. set a fall-back language (optional)
  2. How to translate
    1. the basics
    2. more advanced translation
    3. working within a community of translators
  3. How to get translations up on Loomio.org
  4. Improving processes, giving feedback

Links - - { Email us } - { Loomio group } - { Transifex } - { Twitter updates } - -


Getting Started

We use Transifex to manage our translation process (an excellent service that's free for open-source projects). As you follow the step below you'll be invited to set up an account.

+ join an existing language

You can see the full list of languages underway on the Loomio Transifex page Click "Help Translate Loomio" and ask to join a translation [this needs some more detail]

NB: Make sure you click 'Display all Languages' :
image

+ create a new language

Please check whether your language has been started before requesting a new one! (see above). Feel free to request a new language or dialect if it doesn't exist.

If you're not sure or need help, please email us

+ set a fall-back language (optional)

If a translation is missing in your language Loomio will 'fall back' to using English in that location (so that there is at least some text present). If you would like to recommend a better fall-back language please let us know.

You can see Loomio's current fall-back settings at the bottom of this page : www.loomio.org/translation


How to translate

Make sure you have either joined/ created a language (and have a Transifex account).

+ the basics

  1. visit the Loomio Transifex page, and click on your language image

  2. select the resource you want to translate image (start with Main app resource, then move on to frontpage)

  3. click 'Translate'

  4. (a) click on a phrases, (b) read the english text, (c) enter your translation, (d) save image

What to ignore

Ignore anything in angle brackets or curly braces. E.g.:

<h2>Welcome</h2>
<p>
%{who} invited you to Loomio! 
<a href='%{link}'>Click here to visit %{group_name}!</a>
</p>

The <h2>, <p>, and <a> is html code (for heading, paragraph and link), so they don't need to be translated.

The text inside the %{curly braces} will get replaced by the software, so it's important to keep it unmodified.

+ more advanced translation

- language style guide www.loomio.org/d/xDUZJPrp/language-style-guide-for-translators

+ working within a community of translators

As you translate, you might encounter questions like:

  • should this use formal/ informal language ?
  • who should I check this translation with ?

In a lot of cases, it's best to work through these challenges with other translators in your language.

We are currently working with the community to figure out how best to support teams of translators to work together. Any input on this is welcome.


How to get translations up on Loomio.org

We deploy language updates at least once a week.
Watch twitter @loomio #translation for updates.

If you would like to see translations up faster, please tweet us or email Nati

+ overview of whole translation process

image

context: Github is where the working code of Loomio is managed and deployed from.

  1. Transifex grabs a copy of all the English phrases from Github (auotmatic)
  2. Amazing community uses Transifex to translate all these phrases.
  3. Mix imports all the new translations into Github, and checks to make sure nothing is broken.
  4. We deploy translations to Loomio.org

image

Mix wrangling code


Improving processes, giving feedback

If you'd would like to suggest an improvement, or have some feedback on the translation process, please feel free to start a discussion in the Loomio group, or email Nati at nati@loomio.org