Difference between revisions of "Resources/Translation"

From AtoM wiki
(Receive Notifications of Updates)
(12 intermediate revisions by 3 users not shown)
Line 2: Line 2:
 
[[Main Page]] > [[Resources]] > Resources/Translation
 
[[Main Page]] > [[Resources]] > Resources/Translation
  
Thank you for your interest in contributing user interface translations to the AtoM project! Your contributions help to make AtoM a multilingual application with a global reach.
+
Thank you for your interest in contributing user interface translations to the AtoM project! Your contributions help to further AtoM as a multilingual application
 +
with a global reach.
  
In an effort to make the process of translating the AtoM interface more efficient, Artefactual Systems has started using [https://www.transifex.com/ Transifex], a web application to support dynamic publication of localization content from multiple sources. This means that more than one translator can contribute translated strings, making the process faster and easier, and enabling Artefactual Systems to publish translations more often. As well, everything is web-based using Transifex, meaning you can access your translation work via any web browser, instead of having to handle [https://en.wikipedia.org/wiki/XLIFF XLIFF] files directly, as was the case with early versions of ICA-AtoM translations.
+
In our continuing efforts to make the process of translating the AtoM interface more efficient, Artefactual Systems has moved from its previous translation
 +
service, [https://www.transifex.com/ Transifex] to [https://www.weblate.org/ Weblate], an open source web-based translation management system supporting
 +
continuous translation from multiple sources. More than one translator can contribute translated strings, making the process fast and easy, and
 +
enabling Artefactual Systems to publish translations more often. Everything is web-based using Weblate, meaning you can access your translation work via any
 +
web browser.
  
This page will introduce you to the AtoM Transifex project, so that you can sign up and begin contributing translations. When we package the next public release, we will include all translations submitted via Transifex in the release - so the entire community will benefit from your contributions.
+
This page will introduce you to the AtoM Weblate translation project, so that you can log in and begin translating. If you have contributed through Transifex in the past, you will notice that the log in process with Weblate is slightly different, but contributing translations continues to be easy and flexible.
  
 
<admonition type="seealso">
 
<admonition type="seealso">
* Interested in contributing to our project documentation? We have a separate page for that! See: [[Resources/Documentation/Contribute|Contribute documentation]]
+
* Interested in contributing to our project documentation? We have a separate page for that! See:[[Resources/Documentation/Contribute|Contribute documentation]]
 
* Looking to contribute code to AtoM? See: [[Development/Contribute code|Contribute code]]
 
* Looking to contribute code to AtoM? See: [[Development/Contribute code|Contribute code]]
 
* Check out our [https://www.accesstomemory.org/docs User Manual] for information on how to translate content or interface elements locally (in your installation only) - see the Multilingual section.
 
* Check out our [https://www.accesstomemory.org/docs User Manual] for information on how to translate content or interface elements locally (in your installation only) - see the Multilingual section.
 +
* Got questions, or find something that's not covered below that you think would be helpful? Let us know via the AtoM [https://groups.google.com/forum/#!forum/ica-atom-users User Forum], or send us an email at [mailto:translate@artefactual.com translate@artefactual.com].
 
</admonition>
 
</admonition>
  
'''You can see the AtoM project in Transifex here:''' https://www.transifex.com/projects/p/atom/
 
  
 +
__TOC__
 +
 +
 +
==Browsing Artefactual translations==
 +
 +
'''The AtoM project in Weblate lives here:'''
  
__TOC__
+
* https://translations.artefactual.com/
  
 +
[[File:weblate-first-view.png|frameless|500px|center|First view]]
  
 +
You can browse the project as an anonymous user without logging in, view available languages, and see what has and hasn't been translated.  Click on the <code>Browse</code> button or the <code>atom</code> link to begin. This will take you to the list of components within a given project. The project is
 +
'''atom''' and the component(s) are the active versions of AtoM available for translation. For example purposes, this document shows two components for AtoM translations - '''2.4''' and '''2.5'''.
  
===Sign up for an account with Transifex===
+
[[File:atom-components.png|frameless|500px|center|Components]]
  
'''1.''' Navigate to https://www.transifex.com/signup/
+
While anyone can browse and view translations, only logged in users can contribute and save translations, and are credited for every translation made. To contribute translations, keep reading below!
  
[[File:transifex-signup.png|thumb|400px|center|Sign-up page for Transifex]]
+
==Log in to contribute to Artefactual translations==
  
 +
'''1.''' You do not need to set up an account with Weblate to begin translating for AtoM. Artefactual has configured authentication through GitHub. Navigate to https://translations.artefactual.com/ and click '''Login''' at the top right. Use your GitHub account to log in. If you don't have a GitHub account, you can set one up [https://github.com/ here].
  
'''2.''' Fill in all the required fields, click on “Create my Account” (note: by doing so you are agreeing with the Transifex Terms of Use). If you have an existing Google,  GitHub, or LinkedIn account, you can use this to create your Transifex account.
+
[[File:weblate-github.png|frameless|300px|center|GitHub auth]]
  
<admonition type="seealso">
+
The first time you log in you will be asked to grant access to your GitHub account. Click
Transifex has its own help documentation - here's a help page on getting started:
+
Authorize translations.artefactual.com by qubot
* [http://docs.transifex.com/introduction/translators/ Getting Started as a Translator]
+
You will not see this screen on subsequent logins.
</admonition>
 
  
===Join the AtoM Project===
+
[[File:qubot-authorization.png|frameless|500px|center|Authorization]]
  
'''3.''' Once you have created an account, you will be redirected to a configuration page. Fill in your name and preferences.
+
==Set your preferences==
  
'''4.''' On the second configuration page, you will be given the option to start your own project or to join an existing one. Select "Join an existing project".
+
'''2.''' When you log in you will see the Dashboard and menu options.
  
[[File:transifex-find-projects.png|thumb|400px|center|Configuration page for Transifex. Click the "Find projects" button after inputting your preferences and languages]]
+
[[File:first-login.png|frameless|500px|center|Weblate dashboard]]
  
'''5.''' The last configuration page will ask you to identify languages that you speak. Select as many as are applicable and click on "Get started".
+
You can set your preferences by clicking on "Manage languages", "Manage watched projects", or "Settings" and selecting your preferences in the navigation tabs.
 +
[[File:weblate-manage-settings.png|frameless|500px|center|Set your preferences]]
  
'''6.''' A pop-up window will appear. After you click on "Find a project to translate", type "atom" into the search bar and then click on the AtoM project when it appears below.
+
Each of these choices takes you to the settings screen. The three navigation tabs you will want to review before you start translating are '''Languages''', '''Subscriptions''', and '''Preferences'''.
  
[[File:transifex-find-atom.png|thumb|400px|center|Project finder for Transifex. Type "atom" into the search bar and then select the AtoM project]]
+
'''3.''' From the '''Language''' navigation tab, choose the languages you wish to translate and those you may want to follow. Choose your primary languages from the '''Translated languages''' box. These are the languages you speak fluently and wish to translate. They will show up on your dashboard as "Watched languages" when you log in or navigate to the dashboard. If there are other languages you want to follow, choose those in the '''Secondary languages''' box. Strings that have been translated in these languages will appear on the translation page (see [[#Begin translating]]). When you have made your selections, click <code>Save</code>. You can change these settings at any time by returning to the Languages tab in settings.
  
'''7.''' You will be redirected to the [https://www.transifex.com/artefactual/atom/ AtoM Transifex Project homepage].
+
[[File:weblate-language-tab.png|frameless|500px|center|Language tab]]
  
[[File:transifex-atom.png|thumb|400px|center|The AtoM project homepage in Transifex]]
+
'''4.''' From the '''Subscription''' tab, you can choose translation project(s) you wish to follow and click <code>Save</code>. Currently Artefactual has only one translation project - '''atom'''. Even though there is currently only one project, choose it and click <code>Save</code> so that it will appear in your dashboard.
  
===Join a team===
+
You can also specify '''notifications''' that you would like to receive. Notifications are selected from the '''Subscription''' tab below the Projects section. Translation notifications apply to your primary languages. This can be especially useful for users who are designated reviewers (see [[#Become a reviewer]]). When you are done,  save your selections.
  
'''8.''' In the top right corner of the page, select "Join team".
+
[[File:weblate-subscription-tab.png|frameless|500px|center|Subscription tab]]
  
[[File:transifex-join-team.png|thumb|400px|center|Joining a team in the AtoM Transifex project]]
+
These settings can be changed or updated at any time by returning to the Subscriptions tab in settings.
  
'''9.''' A pop-up will appear with a list of the available languages. Select your chosen translation language from the list. When you've found it, click the Submit button (if you wish to translate AtoM into multiple languages, you can repeat this process again later).
+
'''5.''' Once you have chosen languages and subscriptions (projects), these will appear on your dashboard, showing the status of translation for each of your chosen languages and projects. You will also see a '''Watched projects''' dropdown list on the main navigation bar at the top of the page; all Artefactual translation projects are available from the '''Projects''' dropdown list, and all available languages from the '''Languages''' dropdown list.
  
<admonition type="important">
+
In the screenshot below, the user has selected three primary languages - these will always be shown on the dashboard for the available components of watched projects (subscriptions) when that user logs in.
Please review the options available in the list prior to requesting a new language! In many cases, we have had requests for different locales (for example, requesting "fr_FR" for France French, instead of working in the existing "fr" French project), but AtoM does not always support these very well. If at all possible, please work within the existing projects, or try to select the most generic option, without locale codes. We'll work with you if there are no other options, of course - but if you can avoid using a specific locale, it will make merging and maintaining your translations in AtoM much easier!
 
</admonition>
 
  
[[File:transifex-select-language.png|thumb|400px|center|Selecting a language in the AtoM Transifex project]]
+
[[File:weblate-dashboard2.png|frameless|500px|center|Projects dashboard]]
  
'''10.''' You will see a confirmation message informing you that your request has been submitted. One of the Artefactual project maintainers will review the request and approve your account.
+
<admonition type="tip">
 +
Don't see a language you would like to provide translations for? We have instructions on how you can request new languages in the section [[#Requesting new languages|below]]!
 +
</admonition>
  
'''11.''' You will receive an automated email from Transifex introducing you to the translation editor interface and providing you with a link to generic help instructions. You may review these instructions if you wish, or follow the specific instructions that the AtoM coordinators have provided below.
+
'''6.''' From the '''Preferences''' tab you can choose how you would like the translation screen to appear. '''Translation editor mode''' offers two choices - '''Full editor''' mode and '''Zen''' mode. These are described below in [[#Begin translating|Begin translating]]. You can also choose what information appears on your dashboard. When you are finished making your selections, click <code>Save</code>.
  
 
<admonition type="seealso">
 
<admonition type="seealso">
Here are the links that Transifex will provide you with in the email, for reference:
+
Weblate has its own help documentation - here's a help page on getting started:
* [http://docs.transifex.com/tutorials/txeditor/ Translating and reviewing content in the Transifex Editor]
+
 
* [http://docs.transifex.com/ Transifex Help documentation]
+
* [https://docs.weblate.org/en/latest/user/index.html Weblate Documentation]
 
</admonition>
 
</admonition>
  
'''12.''' Once your account is approved by the AtoM coordinators, you will receive an email notification from Transifex. It will indicate that you have been accepted to the team of the language of your choice within the AtoM project. Once you've received this email, return to the AtoM Project homepage in Transifex (https://www.transifex.com/artefactual/atom/dashboard/).
+
===Requesting new languages===
 +
 
 +
'''7.''' Don't see a language you would like to provide translations for? If you would like to translate in a language that is not currently available in our Weblate project, you can request that it be added. To start a request, click on the project component in which you plan to add translations (currently 2.4 and 2.5). From the '''Tools''' menus select <code>Start new translation</code> or scroll to the bottom of the list of languages and click on <code>Start new translation</code> at the bottom of the page.
 +
 
 +
From the tools menu:
 +
 
 +
[[File:request-language-tools.png|frameless|400px|center|Request new language]]
 +
 
 +
From the bottom of the page:
 +
 
 +
[[File:request-language.png|frameless|400px|center|Request new language]]
 +
 
 +
Select the language(s) you would like added to the project and click '''Request new translation'''.
  
'''13.''' Click on the blue Translate button to start translating. Follow the on-screen prompts to select your language and the resource that you would like to translate.
+
[[File:request-language2.png|frameless|500px|center|Request Acholi]]
  
[[File:transifex-translate-now.png|thumb|400px|center|Follow the directions to begin translating.]]
+
If the languages listed still do not include one that you want to translate, click the link <code>Can't find your language in the list above?</code>. View a list of all languages supported in AtoM, with their corresponding language codes, here:
  
'''14.''' You will be taken to a page containing the current translated strings in that project for your chosen language. This is the Translation Editor.
+
* [https://gist.github.com/sevein/d248525a66ef793c93d8 AtoM supported languages]
  
<admonition type="tip">
+
Complete the Weblate form with as much detail as possible using information from this list and click <code>Send</code>. Your request will be received by Artefactual.
Want to work translating multiple languages at once? Repeat steps 8-15 above. When you work with the Translation Editor, you will then be able to switch easily between languages.
 
</admonition>
 
  
===Use the Translation Editor===
+
[[File:request-language3.png|frameless|500px|center|Language contact]]
  
You are now in the Editor screen. If you are a translator for more than one language/ team you can switch between the available languages using the language drop-down menu at the top left side of the screen.
+
<admonition type="important"> Please review the options available in the list prior to requesting a new language! In many cases, we have had requests for different locales (for example, requesting "fr_FR" for France French, instead of working in the existing "fr" French project), but AtoM does not always support these very well. If at all possible, please work within the existing projects, or try to select the most generic option, without locale codes. We'll work with you if there are no other options, of course - but if you can avoid using a specific locale, it will make merging and maintaining your translations in AtoM much easier! </admonition>
  
Here's what the Translation Editor interface looks like - we've added some numbered orange circles to the image to point out different parts of the interface, which will be explained below.
 
  
[[File:transifex-translation-interface.png|thumb|700px|center|The Transifex Editor web interface]]
 
  
<admonition type="seealso">
+
==Begin translating==
Transifex documentation:
 
* [http://docs.transifex.com/tutorials/txeditor/ Translating and reviewing content in the Transifex Editor]
 
* [http://docs.transifex.com/introduction/translators/ Getting started as a Translator]
 
</admonition>
 
  
'''( 1 ) The language drop-down'''
+
'''8.''' From your dashboard you can navigate to the translation screen in two ways.
  
This is where you can see what language you are currently working in. If you are working on translating AtoM into multiple languages (e.g. you have followed the steps above one time for each language, and have been added to the language teams), then you can also use this language drop-down to switch quickly between languages.
+
[[File:weblate-dashboard3.png|frameless|500px|center|Projects dashboard]]
  
'''( 2 ) Navigation panel - source strings'''
+
Click on your choice of component and language in the '''Component''' column. This will take you to the '''Overview''' screen of the main translation page for that language.  Here you will see links that can take you to the translation screen. Clicking on the <code>Translate</code> button will take you to the set of strings needing action. You can choose different filtered set by clicking any of the links under '''Strings to check'''.
  
The left-hand column of the page is the Navigation panel. It shows all the original source (English) strings to be translated on the farthest left. You can use the search bar above to search for a specific translation string (translation text keyword search), or you can search by a number of other filters, such as translated date (for strings that have already been translated), comments, etc.
+
[[File:weblate-translation-links.png|frameless|500px|center|Translating]]
  
[[File:transifex-search-bar.png|thumb|500px|center|The Transifex Editor's search bar, searching for specific text in the source strings]]
+
The second way to reach the translation screen from your dashboard is to click on the <code>Translate</code> button to the right of the component/language you want to translate. This will take you directly to the translation screen and strings needing action. You can change the filter on strings for translation from the dropdown menu at the top left.
  
You can also filter the source strings in the Navigation panel to show only those strings that have not yet been translated, using the buttons described in '''( 4 )''', below.
+
'''9.''' Once you have reached the translation screen you will see the first item needing translation. The default view is '''Full editor''' mode; the screen shows any watched (secondary) languages you have set, the source string to be translated, and a text field in which you can enter your translation. In this screenshot, there are no watched languages.
  
To translate a string, click on a source string in the navigation panel, and then perform your translation work in the middle column, the Translation panel described in '''( 5 )''', below.
+
[[File:full-editor-mode.png|frameless|500px|center|Full editor]]
  
'''( 3 ) Navigation panel - translated strings'''
+
Many source strings include variables, e.g. %1%, or (%3% b). These should be included in the translated string in the appropriate position for the destination language, e.g. from the current example
 +
%1%Download%2% (%3% b)
 +
will be translated as
 +
%1%Sækja%2% (%3% b)
  
Whenever content has already been translated by you or another Transifex user in your team, it will appear in grey to the right of the original source strings. You can re-edit translated content at any time by selecting a specific string, and then editing the existing translation using the middle column Translation panel, described in '''( 5 )''', below.
+
When you have entered your translation, click <code>Save</code>. Your translation will be saved and checked by Weblate's quality checks. If there are any failing checks a message will appear. You can then edit your translation and resave, or leave the translation as is and move on to the next source string. You can skip any strings you do not want to translate.
  
'''( 4 ) Navigation filters'''
+
<admonition type="note"> All translations are saved in Weblate regardless of failing checks. Weblate runs a wide range of quality checks on each translation, including syntax, length, consistency, duplication and more, taking into account special rules for different languages. See types of translation checks [https://docs.weblate.org/en/latest/user/checks.html#translation-checks here]. Any translation that has not been approved by a designated reviewer can be edited by any logged in user, including fixing failed checks or editing a saved translation. You can see the status of a translation by hovering over the '''State''' next to a translation on the translation screen. Translation states include <code>Message is approved</code> (green check mark, translation cannot be edited);
 +
<code>Message is translated</code> (blue check mark, translation can be edited); <code>Message has failing checks</code> (brown exclamation mark, translation can be edited); and <code>Message not translated</code> (red x).
  
These tabs allow you to quickly filter the content displayed in the left-hand column, the Navigation panel (described above). For example, you can use the middle filter to limit content in the Navigation panel so it displays only those strings that have not yet been translated. These tabs also offer you a measure of your team's progress - how many total strings there are, and how many have already been translated. If you have a team reviewer, you can also see at a glance how many strings have yet to be reviewed.
+
[[File:translation-states.png|frameless|300px|center|Translation states]]
  
<admonition type="tip">
 
Note as well that to the far right of the Navigation filters there is a progress bar, indicating how much of the source strings you have translated as a green progress indicator filling up the grey bar. If you hover this progress bar you can see further details.
 
[[File:transifex-progress-bar.png|thumb|400px|center|The Transifex Editor's progress bar]]
 
 
</admonition>
 
</admonition>
  
'''( 5 ) Translation panel'''
+
'''10.''' For faster translation switch to '''Zen''' mode by clicking <code>Zen</code> at the top right of the screen. In Zen mode each item shows (1) the source string (location in the Artefactual database), (2) translations in any languages you are watching, (3) the term to be translated, and (4) the edit area for your translation.
  
The middle column on the page is where you will do the actual translation work. To start translating, you will first need to select a source string from the Navigation panel on the left (described above).
+
[[File:edit-screen.png|frameless|500px|center|Adding Translations]]
  
The Translation panel is divided into 3 main sections. On the top is the source box, which contains the original source string you have selected in the Navigation panel on the left. In the middle is the translation box, where you can type in your translation of the source string. If the string is already translated, this box is filled in with the last translation, and the soure box will display in light grey the name of the user who last translated the string, and when. You can still make edits to the current translation if desired - simply click your cursor into the middle translation box, make your corrections, and click "Save." The bottom  of the Translation panel holds the context box, which includes some automated contextual information about the current string.
+
You can switch from Zen mode back to Full Editor mode by clicking <code>Exit Zen</code>. .
  
<admonition type="important">
+
In Zen mode your translation will be saved automatically, and checked, once you move your cursor out of the translation field.
Don't forget to click the Save button after you have entered a translation!  If you navigate to another source string, the translation stays in draft mode for as long as the editor is open and you are navigating on the same resource and translation language. If you save the translation before navigating to another source string, the translation is saved. There is a "Save all" button that will save all draft translations you've entered at once - but if you close the editor without saving your work, it will be lost!
 
</admonition>
 
  
'''( 6 ) Collaboration panel'''
+
[[File:weblate-translated-word.png|frameless|500px|center|Translated word]]
  
The column on the right-hand side of the Transifex Editor offers a number of tools to support productivity and collaboration. It includes 4 different tabs:
+
If your translation fails any checks, a red "x" will appear. Scrolling over the "x" will highlight the syntax error.
  
* '''Suggestions''' These are automated translation suggestions provided by Transifex, based on previously entered strings. Transifex also provides an indication of how much of a match it believes its suggestions are for the current string. Other users can also add suggestions, and members of your team can then use these, or vote on team member suggestions.
+
[[File:weblate-translation-fail.png|frameless|300px|center|Failed translation]]
  
[[File:transifex-suggestions.png|thumb|400px|center|Transifex machine-generated suggestions, based on previous translation work in the AtoM project]]
+
You can work through the list of strings needing translation, choosing those you want to translate.
  
<admonition type="seealso">
+
<admonition type="important"> When you are entering translations in '''Zen''' mode, your entries will be saved automatically. When you are in '''Full editor''' mode, however, you need to save the translation in the primary language. </admonition>
Want to learn more about the automated Translation suggestions provided by Transifex in the Suggestions tab? They call it "Translation Memory." See:
 
* [http://docs.transifex.com/features/tm/ Translation Memory Introduction]
 
* [https://www.transifex.com/blog/2015/translation-memory-3-0/ Blog post: Translation Memory 3.0]
 
</admonition>
 
  
* '''History''': If previous translation work has been done on the currently selected string, the user name and date of the previous translations will be displayed in the History tab of the right-hand Collaboration panel.
+
'''11.''' You can contribute translations in any language, even those you have not set as primary or secondary. Clicking on a project component will bring up a list of all languages in the project. Click <code>Translate</code> next to any language to go to the translation screen for that language. Click <code>Watched projects</code> from the main menu bar, select <code>atom</code>, and then select the component you want.
* '''Glossary''': Glossary shows you any terms that have a pre-set translation. Thus far, we have not been using this feature in Transifex.
 
* '''Comments''': This allows you to collaborate with other users (across languages even!) and to ask for help if needed. Comments can be associated directly with a particular string, and posted either as a comment, or as an issue. Artefactual project maintainers get notifications about issues, so if you need further context for a string for example, feel free to comment as an issue (you will see the 2 options when you enter a comment - "Save", or "Save as issue") asking for clarification, and we will respond as soon as we can.
 
  
 +
[[File:all-languages.png|frameless|500px|center|All languages]]
  
---------
+
You can access a particular source string in any other language by starting from the translation screen of one of your primary languages. Exit '''Zen''' mode if necessary. From Full Editor mode you can then enter your translation in the primary language, and by scrolling down to <code>Other languages</code> enter or edit translations for that same string in as many languages as you like by clicking <code>Edit</code> to the right of the translation field for each language. If you do not want to edit the string that is offered, click on <code>Skip</code> in the main translation box. Move to the next string by clicking the counter at the top of the screen.
  
There are other options and functions available within the Transifex Editor, but the above should provide you with the basics. To learn more, we suggest checking out some of the existing Transifex documentation:
+
[[File:weblate-translate-many.png|frameless|500px|center|Translating in several languages]]
  
* [http://docs.transifex.com/tutorials/txeditor/ Translating and reviewing content in the Transifex Editor]
+
<admonition type="note"> Weblate supports keyboard shortcuts to make navigating through the site quicker and more efficient. You can see a complete list of shortcuts [https://docs.weblate.org/en/weblate-3.2.2/user/translating.html#keyboard-shortcuts here]. </admonition>
* [http://docs.transifex.com/introduction/translators/ Getting started as a Translator]
 
* [http://docs.transifex.com/faq/#what-are-the-web-editors-auxiliary-tools FAQ: What are the Web Editor's Auxiliary Tools?]
 
* [https://youtu.be/3y0x8q3Oj7Q Getting Started with Transifex (YouTube video)]
 
  
===Receive Notifications of Updates===
+
'''12.''' Your translations are all saved in our database. However, before they can be included into the public branch of AtoM they need to be approved by designated reviewers, and then pushed to AtoM by Artefactual administrators.
  
One of the features Transifex provides is to allow translators to follow a specific project (e.g., AtoM)  This feature is called "watches" in Transifex. You can also configure several automatic notification settings for your account - if issues or comments are filed; if another user messages you, if there are changes in the source files for your project, etc.
+
==Become a reviewer==
  
'''To watch the AtoM project'''
+
'''13.''' Before translations from Weblate are added to AtoM they must be approved by designated reviewers. Reviewers are community members who are willing the review and approve translations in languages in which they are proficient. Once a translation is approved it cannot be changed (except by an administrator). These approved and locked translations are then ready to be incorporated into the main AtoM site. This will be done periodically by Artefactual.
  
Navigate to the AtoM project page in Transifex (https://www.transifex.com/projects/p/atom/), and click the "Watch project" button on the right side of the menu bar at the top of the page.
+
'''14.''' All logged-in users at https://translations.artefactual.com have translator privileges that allow them to enter translations and edit their own and others' translations prior to approval. Reviewers have the same privileges as translators, as well as privileges that allow them to approve (and therefore lock) translations. If you would like to be a reviewer, log into the [https://translations.artefactual.com translation project]. This will ensure that your email is registered with the site as a translator, and visible to the Artefactual administrators. Then send us an email at [mailto:translate@artefactual.com translate@artefactual.com] so that we can grant you reviewer privileges.
  
[[File:transifex-watch-project.png|thumb|500px|center|The "Watch project" button on the AtoM project homepage in Transifex]]
+
'''15.''' Once you have reviewer privileges you can search for strings to be approved in your primary language(s). Click on <code>Strings waiting for review</code> from the translation screen in your chosen language. In Full editor mode this link appears in the list of strings to check.
  
You can always click this button again to stop watching the project.
+
[[File:waiting-for-review-full.png|frameless|500px|center|Strings needing approval]]
  
'''To configure your notification settings and your watches'''
+
If you have set Zen mode as your default view, you can select strings waiting for review from the drop down list at the top of the page.
  
In the top right corner of the the screen, located in the dark blue header bar at the top of the page, you will see your user name, followed by a little box with either a check mark, or a number in it. This second box is the notifications widget - if all notifications have been read, it will display a checkmark; if there are unread notifications, it will display the number of notifications to be reviewed.
+
[[File:waiting-for-review-zen.png|frameless|500px|center|Strings needing approval]]
  
If you click on the notification widget, you will be taken to the notifications page of your user account:
+
For each string needing approval, you can click the radio button <code>Approved</code> to lock the translation for that string. Remember to click <code>Save</code> if you are using Full editor mode.
  
[[File:transifex-notifications.png|thumb|500px|center|The notifications page in Transifex, with the notification widget shown in the top right corner]]
+
'''16.''' Several times through the year Artefactual developers will push approved strings into the main AtoM branch. Reviewers will receive an email several weeks before these events to request that they approve new translations in their designated languages.
  
On this page, you will see any activity notifications you have recieved, and the associated date. Just above these, you will see a link called "Notification settings." Click this to go to the Notification settings page of your account.
+
==FAQs==
  
In the main tab, you can check or uncheck options for when you are notified (via the email you used to register your Transifex account, and via the notifications widget in the header bar). There is a second tab called "Watches" where you can review and control which projects and languages you are watching.
+
Below you'll find some responses to frequently asked questions about Weblate, and our move from Transifex. You can also explore the Weblate documentation - here are a few handy links:
  
[[File:transifex-notification-settings.png|thumb|500px|center|The notification settings page for your user account in Transifex.]]
+
* [https://docs.weblate.org/en/latest/user/index.html Weblate: Translator's guide]
 +
* [https://docs.weblate.org/en/latest/faq.html#usage Weblate: FAQ on usage]
  
 
<admonition type="tip">
 
<admonition type="tip">
You can also get to this page by clicking on your user name, selecting Account settings from the drop-down menu, and then choosing "Notification settings" from the menu on the left. Note that in this area, you can also edit your user profile, change your email or password, and manage your connections to other accounts such as Facebook, Twitter, Github, etc - use the Account menu links on the left of the page to explore each accounts setting section.
+
Have a question you don't see addressed here? Let us know via the AtoM [https://groups.google.com/forum/#!forum/ica-atom-users User Forum], or send us an email at [mailto:translate@artefactual.com translate@artefactual.com].
 
</admonition>
 
</admonition>
  
===View project announcements===
+
===I just got comfortable using Transifex - Why are you moving from Transifex to Weblate?===
 +
 
 +
Artefactual was previously able to use Transifex because they offered free plans  to open source projects. As of 2018, Transifex changed its policy to limit these free accounts to small projects with 10 collaborators or less - and because AtoM has a vibrant translation community with dozens of translators, we no longer qualify. A [https://www.transifex.com/pricing/ paid plan with Transifex] that could support as many collaborators as we need would cost at least $1,500 USD a month to maintain, which would represent a serious drain on the resources we have to maintain the project. Instead, we have chosen to move to an open source platform, Weblate, so we can host and manage the application ourselves.
 +
 
 +
 
 +
===Why can I only log in through GitHub?===
 +
 
 +
Now that Artefactual is hosting and maintaining our translation infrastructure, we expect that many bots, web crawlers, and spam accounts would hit our user registration page, requiring significant time and energy to manage. GitHub is a long-established code repository platform that has existing filters and checks in place to reduce these kinds of spurious registration attempts, so we don't have to do it manually.
 +
 
 +
Artefactual already makes use of GitHub for AtoM's [https://github.com/artefactual/atom/ code repository] and [https://github.com/artefactual/atom-docs/ documentation], and going forward, the translation strings for each release will also be maintained in a separate [https://github.com/artefactual/atom-translations GitHub repository].
 +
 
 +
 
 +
===There are two components in the Weblate AtoM project - which one should I use?===
 +
 
 +
Generally, Artefactual offers two kinds of releases: a major release (e.g. 2.3, 2.4, 2.5, etc) and sometimes, a minor release (e.g. 2.3.1, 2.4.1, etc). Major releases include new features and enhancements, while in most cases, minor releases will only include bug fixes. Both releases ''may'' include translation updates if they have been provided by our community. In Weblate, components will only have major numbers (e.g. 2.4, 2.5, 2.6, etc) and will be used to prepare any releases, major or minor, relating to the component number.
  
From time to time, we'll post an announcement about the status of a project. You can view these by going to the AtoM project homepage in Transifex (https://www.transifex.com/projects/p/atom/), and then clicking on the "Announcements" link in the light blue menu at the top of the page.
+
In most cases, there should only be one unlocked component in Weblate's AtoM project - if we've released 2.5 for example but expect to create a 2.5.1 release, we will likely not open a 2.6 component until 2.5.1 has been released, so that translators don't have add the same translations to both components. However, there may be rare cases where we have two components open and unlocked. This might occur if, for example, we've already added a 2.6 component, but then discover an issue in 2.5 big enough to warrant a 2.5.1 release, and want to allow our translator community an opportunity to supplement or update existing translations in that release as well.
  
[[File:transifex-announcements.png|thumb|500px|center|The announcements tab of the AtoM project in Transifex]]
+
In this rare case, it's up to you which component you choose to work in - but it should be informed by your goals, and a clear understanding of the consequences.
  
<admonition type="tip">
+
<admonition type="important">
You can configure your notification settings so you receive an email whenever an announcement is posted. See the section above, [[Resources/Translation#Receive_Notifications_of_Updates|Receive Notifications of Updates]], for more information.
+
If there are 2 open components in Weblate, then translations added to one component will '''not''' automatically be added to the other, even if it is for an earlier release. The only way to have your translations available in both components (and both releases) will be to manually add your translations to both components.
 
</admonition>
 
</admonition>
  
----
+
If there is a 2.5 and a 2.6 AtoM component in Weblate, then the 2.5 component will be used for a 2.5 minor release (i.e. 2.5.1, 2.5.2), and the 2.6 component will be used for the next major release (i.e. 2.6.0). In the case where there are 2 open components, those translation strings added in the earlier version will ''not'' be carried forward into the later component - but the later component ''will'' be used to create the next component in the future, meaning the strings will be carried forward into subsequent releases.
 +
 
 +
Because of this, we recommend only working in the earlier component if you want to fix poor translations or make other minor improvements in the next minor release so you can access them more quickly (since this will be the next public release), and you don't mind losing them in the next release or manually making the same changes in the later component. Otherwise, we recommend focusing on the latest component available - this ensures that your translations will be included in future releases as well.
 +
 
 +
 
 +
===What's the difference between a reviewer and translator?===
 +
 
 +
Every person who logs into our AtoM translation project through GitHub will automatically be a translator. That means you can choose projects, and primary and secondary languages to watch, add translations in your chosen language(s) and any other languages you have knowledge of, and request that new languages that are currently unavailable in the project be added to it. When you add a translation, that string is automatically saved in the Weblate database and becomes visible to everyone. It can still be edited by you or by other translators. However, it will not be part of the next Artefactual commit until it has been approved. That is the role of a reviewer.
 +
 
 +
Reviewers have all the same privileges as translators, as well as the ability to approve translations. Once a reviewer has approved a translation it will no longer be editable, and it will be part of the next Artefactual commit.
 +
 
 +
===Why do I need a reviewer?===
 +
 
 +
Artefactual has chosen to use this model in order to maintain quality control on translations. If you would like to be a reviewer, please let us know by sending an email to  [mailto:translate@artefactual.com translate@artefactual.com].
 +
 
 +
 
 +
===What do I do if there are no reviewers on my language?===
 +
 
 +
We track who is a reviewer for any given language, and will contact translators directly if reviewers are needed for a language. If you find yourself completing translations with no reviewer for your chosen language(s), please feel free to contact us at [mailto:translate@artefactual.com translate@artefactual.com].
 +
 
 +
===Why can't i translate in a specific sublocale (like ES_es)?===
 +
 
 +
AtoM was built using the [https://symfony.com/legacy Symfony 1.x] PHP framework, and we borrow its internationalization (or i18n) functionality to implement AtoM's ability to translate content into multiple languages. However, as an older framework, Symfony's support for specific sublocales is limited. AtoM cannot at this time support a language that is not supported by the underlying Symfony i18n framework.
 +
 
 +
===Where can I find a list of supported languages for translation in AtoM?===
 +
 
 +
We have a list of all of AtoM's supported languages, and their 2-letter ISO 639-1 language codes, here:
 +
 
 +
* http://bit.ly/AtoM-langs
 +
 
 +
 
 +
===How do I request a new language?===
 +
 
 +
First, please make sure that the language you would like to request is supported in AtoM - see this list:
 +
 
 +
* http://bit.ly/AtoM-langs
 +
 
 +
If it is supported, but you don't see it in Weblate, please see the [[#Requesting new languages|"Requesting new languages"]] section above. You can request a new language via Weblate - here's a quick summary of the steps outlined above:
 +
 
 +
* Navigate to the AtoM component in which you want to work
 +
* Click the "Start new translation" button at the bottom of the page
 +
* In the Language selection page that will appear, click the "Can't find your language in the list above?" hyperlink
 +
* Weblate will open a Contact form - please fill out the details of your request. Artefactual will receive it and review the request. If you've requested a language that AtoM supports (full list available [http://bit.ly/AtoM-langs here]), we'll approve it!
 +
 
 +
See the documentation section [[Resources/Translation#Set_your_preferences|above]] for more details and screenshots.
  
'''Thank you''' for helping us translate AtoM - it is through your participation that we can make AtoM a truly international application!
+
Alternatively, feel free to email us at [mailto:translate@artefactual.com translate@artefactual.com] and we will be happy to add a new language for you!
  
Got questions, or find something that's not covered here that you think would be helpful? Let us know via the AtoM [https://groups.google.com/forum/#!forum/ica-atom-users User Forum], or send us an email at [mailto:translate@artefactual.com translate@artefactual.com].
 
  
  
 +
----
  
 +
'''Thank you''' for helping us translate AtoM - it is through your participation that we can make AtoM a truly international application!
  
 +
Got questions, or find something that's not covered below that you think would be helpful? Let us know via the AtoM [https://groups.google.com/forum/#!forum/ica-atom-users User Forum], or send us an email at [mailto:translate@artefactual.com translate@artefactual.com].
  
  
Line 222: Line 293:
  
 
* [[Resources|Back to Resources]]
 
* [[Resources|Back to Resources]]
* [[Main Page|Back to AtoM wiki home]]
+
* [[Main_Page|AtoM wiki home]]
 
 
  
  
 
[[Category:Resources]]
 
[[Category:Resources]]

Revision as of 13:11, 4 February 2019

Main Page > Resources > Resources/Translation

Thank you for your interest in contributing user interface translations to the AtoM project! Your contributions help to further AtoM as a multilingual application with a global reach.

In our continuing efforts to make the process of translating the AtoM interface more efficient, Artefactual Systems has moved from its previous translation service, Transifex to Weblate, an open source web-based translation management system supporting continuous translation from multiple sources. More than one translator can contribute translated strings, making the process fast and easy, and enabling Artefactual Systems to publish translations more often. Everything is web-based using Weblate, meaning you can access your translation work via any web browser.

This page will introduce you to the AtoM Weblate translation project, so that you can log in and begin translating. If you have contributed through Transifex in the past, you will notice that the log in process with Weblate is slightly different, but contributing translations continues to be easy and flexible.

Seealso

  • Interested in contributing to our project documentation? We have a separate page for that! See:Contribute documentation
  • Looking to contribute code to AtoM? See: Contribute code
  • Check out our User Manual for information on how to translate content or interface elements locally (in your installation only) - see the Multilingual section.
  • Got questions, or find something that's not covered below that you think would be helpful? Let us know via the AtoM User Forum, or send us an email at translate@artefactual.com.

Browsing Artefactual translations

The AtoM project in Weblate lives here:

First view

You can browse the project as an anonymous user without logging in, view available languages, and see what has and hasn't been translated. Click on the Browse button or the atom link to begin. This will take you to the list of components within a given project. The project is atom and the component(s) are the active versions of AtoM available for translation. For example purposes, this document shows two components for AtoM translations - 2.4 and 2.5.

Components

While anyone can browse and view translations, only logged in users can contribute and save translations, and are credited for every translation made. To contribute translations, keep reading below!

Log in to contribute to Artefactual translations

1. You do not need to set up an account with Weblate to begin translating for AtoM. Artefactual has configured authentication through GitHub. Navigate to https://translations.artefactual.com/ and click Login at the top right. Use your GitHub account to log in. If you don't have a GitHub account, you can set one up here.

GitHub auth

The first time you log in you will be asked to grant access to your GitHub account. Click

Authorize translations.artefactual.com by qubot

You will not see this screen on subsequent logins.

Authorization

Set your preferences

2. When you log in you will see the Dashboard and menu options.

Weblate dashboard

You can set your preferences by clicking on "Manage languages", "Manage watched projects", or "Settings" and selecting your preferences in the navigation tabs.

Set your preferences

Each of these choices takes you to the settings screen. The three navigation tabs you will want to review before you start translating are Languages, Subscriptions, and Preferences.

3. From the Language navigation tab, choose the languages you wish to translate and those you may want to follow. Choose your primary languages from the Translated languages box. These are the languages you speak fluently and wish to translate. They will show up on your dashboard as "Watched languages" when you log in or navigate to the dashboard. If there are other languages you want to follow, choose those in the Secondary languages box. Strings that have been translated in these languages will appear on the translation page (see #Begin translating). When you have made your selections, click Save. You can change these settings at any time by returning to the Languages tab in settings.

Language tab

4. From the Subscription tab, you can choose translation project(s) you wish to follow and click Save. Currently Artefactual has only one translation project - atom. Even though there is currently only one project, choose it and click Save so that it will appear in your dashboard.

You can also specify notifications that you would like to receive. Notifications are selected from the Subscription tab below the Projects section. Translation notifications apply to your primary languages. This can be especially useful for users who are designated reviewers (see #Become a reviewer). When you are done, save your selections.

Subscription tab

These settings can be changed or updated at any time by returning to the Subscriptions tab in settings.

5. Once you have chosen languages and subscriptions (projects), these will appear on your dashboard, showing the status of translation for each of your chosen languages and projects. You will also see a Watched projects dropdown list on the main navigation bar at the top of the page; all Artefactual translation projects are available from the Projects dropdown list, and all available languages from the Languages dropdown list.

In the screenshot below, the user has selected three primary languages - these will always be shown on the dashboard for the available components of watched projects (subscriptions) when that user logs in.

Projects dashboard

Tip

Don't see a language you would like to provide translations for? We have instructions on how you can request new languages in the section below!

6. From the Preferences tab you can choose how you would like the translation screen to appear. Translation editor mode offers two choices - Full editor mode and Zen mode. These are described below in Begin translating. You can also choose what information appears on your dashboard. When you are finished making your selections, click Save.

Seealso

Weblate has its own help documentation - here's a help page on getting started:

Requesting new languages

7. Don't see a language you would like to provide translations for? If you would like to translate in a language that is not currently available in our Weblate project, you can request that it be added. To start a request, click on the project component in which you plan to add translations (currently 2.4 and 2.5). From the Tools menus select Start new translation or scroll to the bottom of the list of languages and click on Start new translation at the bottom of the page.

From the tools menu:

Request new language

From the bottom of the page:

Request new language

Select the language(s) you would like added to the project and click Request new translation.

Request Acholi

If the languages listed still do not include one that you want to translate, click the link Can't find your language in the list above?. View a list of all languages supported in AtoM, with their corresponding language codes, here:

Complete the Weblate form with as much detail as possible using information from this list and click Send. Your request will be received by Artefactual.

Language contact

Important

Please review the options available in the list prior to requesting a new language! In many cases, we have had requests for different locales (for example, requesting "fr_FR" for France French, instead of working in the existing "fr" French project), but AtoM does not always support these very well. If at all possible, please work within the existing projects, or try to select the most generic option, without locale codes. We'll work with you if there are no other options, of course - but if you can avoid using a specific locale, it will make merging and maintaining your translations in AtoM much easier!

Begin translating

8. From your dashboard you can navigate to the translation screen in two ways.

Projects dashboard

Click on your choice of component and language in the Component column. This will take you to the Overview screen of the main translation page for that language. Here you will see links that can take you to the translation screen. Clicking on the Translate button will take you to the set of strings needing action. You can choose different filtered set by clicking any of the links under Strings to check.

Translating

The second way to reach the translation screen from your dashboard is to click on the Translate button to the right of the component/language you want to translate. This will take you directly to the translation screen and strings needing action. You can change the filter on strings for translation from the dropdown menu at the top left.

9. Once you have reached the translation screen you will see the first item needing translation. The default view is Full editor mode; the screen shows any watched (secondary) languages you have set, the source string to be translated, and a text field in which you can enter your translation. In this screenshot, there are no watched languages.

Full editor

Many source strings include variables, e.g. %1%, or (%3% b). These should be included in the translated string in the appropriate position for the destination language, e.g. from the current example

%1%Download%2% (%3% b)

will be translated as

%1%Sækja%2% (%3% b)

When you have entered your translation, click Save. Your translation will be saved and checked by Weblate's quality checks. If there are any failing checks a message will appear. You can then edit your translation and resave, or leave the translation as is and move on to the next source string. You can skip any strings you do not want to translate.

Note

All translations are saved in Weblate regardless of failing checks. Weblate runs a wide range of quality checks on each translation, including syntax, length, consistency, duplication and more, taking into account special rules for different languages. See types of translation checks here. Any translation that has not been approved by a designated reviewer can be edited by any logged in user, including fixing failed checks or editing a saved translation. You can see the status of a translation by hovering over the State next to a translation on the translation screen. Translation states include Message is approved (green check mark, translation cannot be edited);

Message is translated (blue check mark, translation can be edited); Message has failing checks (brown exclamation mark, translation can be edited); and Message not translated (red x).

Translation states

10. For faster translation switch to Zen mode by clicking Zen at the top right of the screen. In Zen mode each item shows (1) the source string (location in the Artefactual database), (2) translations in any languages you are watching, (3) the term to be translated, and (4) the edit area for your translation.

Adding Translations

You can switch from Zen mode back to Full Editor mode by clicking Exit Zen. .

In Zen mode your translation will be saved automatically, and checked, once you move your cursor out of the translation field.

Translated word

If your translation fails any checks, a red "x" will appear. Scrolling over the "x" will highlight the syntax error.

Failed translation

You can work through the list of strings needing translation, choosing those you want to translate.

Important

When you are entering translations in Zen mode, your entries will be saved automatically. When you are in Full editor mode, however, you need to save the translation in the primary language.

11. You can contribute translations in any language, even those you have not set as primary or secondary. Clicking on a project component will bring up a list of all languages in the project. Click Translate next to any language to go to the translation screen for that language. Click Watched projects from the main menu bar, select atom, and then select the component you want.

All languages

You can access a particular source string in any other language by starting from the translation screen of one of your primary languages. Exit Zen mode if necessary. From Full Editor mode you can then enter your translation in the primary language, and by scrolling down to Other languages enter or edit translations for that same string in as many languages as you like by clicking Edit to the right of the translation field for each language. If you do not want to edit the string that is offered, click on Skip in the main translation box. Move to the next string by clicking the counter at the top of the screen.

Translating in several languages

Note

Weblate supports keyboard shortcuts to make navigating through the site quicker and more efficient. You can see a complete list of shortcuts here.

12. Your translations are all saved in our database. However, before they can be included into the public branch of AtoM they need to be approved by designated reviewers, and then pushed to AtoM by Artefactual administrators.

Become a reviewer

13. Before translations from Weblate are added to AtoM they must be approved by designated reviewers. Reviewers are community members who are willing the review and approve translations in languages in which they are proficient. Once a translation is approved it cannot be changed (except by an administrator). These approved and locked translations are then ready to be incorporated into the main AtoM site. This will be done periodically by Artefactual.

14. All logged-in users at https://translations.artefactual.com have translator privileges that allow them to enter translations and edit their own and others' translations prior to approval. Reviewers have the same privileges as translators, as well as privileges that allow them to approve (and therefore lock) translations. If you would like to be a reviewer, log into the translation project. This will ensure that your email is registered with the site as a translator, and visible to the Artefactual administrators. Then send us an email at translate@artefactual.com so that we can grant you reviewer privileges.

15. Once you have reviewer privileges you can search for strings to be approved in your primary language(s). Click on Strings waiting for review from the translation screen in your chosen language. In Full editor mode this link appears in the list of strings to check.

Strings needing approval

If you have set Zen mode as your default view, you can select strings waiting for review from the drop down list at the top of the page.

Strings needing approval

For each string needing approval, you can click the radio button Approved to lock the translation for that string. Remember to click Save if you are using Full editor mode.

16. Several times through the year Artefactual developers will push approved strings into the main AtoM branch. Reviewers will receive an email several weeks before these events to request that they approve new translations in their designated languages.

FAQs

Below you'll find some responses to frequently asked questions about Weblate, and our move from Transifex. You can also explore the Weblate documentation - here are a few handy links:

Tip

Have a question you don't see addressed here? Let us know via the AtoM User Forum, or send us an email at translate@artefactual.com.

I just got comfortable using Transifex - Why are you moving from Transifex to Weblate?

Artefactual was previously able to use Transifex because they offered free plans to open source projects. As of 2018, Transifex changed its policy to limit these free accounts to small projects with 10 collaborators or less - and because AtoM has a vibrant translation community with dozens of translators, we no longer qualify. A paid plan with Transifex that could support as many collaborators as we need would cost at least $1,500 USD a month to maintain, which would represent a serious drain on the resources we have to maintain the project. Instead, we have chosen to move to an open source platform, Weblate, so we can host and manage the application ourselves.

Why can I only log in through GitHub?

Now that Artefactual is hosting and maintaining our translation infrastructure, we expect that many bots, web crawlers, and spam accounts would hit our user registration page, requiring significant time and energy to manage. GitHub is a long-established code repository platform that has existing filters and checks in place to reduce these kinds of spurious registration attempts, so we don't have to do it manually.

Artefactual already makes use of GitHub for AtoM's code repository and documentation, and going forward, the translation strings for each release will also be maintained in a separate GitHub repository.

There are two components in the Weblate AtoM project - which one should I use?

Generally, Artefactual offers two kinds of releases: a major release (e.g. 2.3, 2.4, 2.5, etc) and sometimes, a minor release (e.g. 2.3.1, 2.4.1, etc). Major releases include new features and enhancements, while in most cases, minor releases will only include bug fixes. Both releases may include translation updates if they have been provided by our community. In Weblate, components will only have major numbers (e.g. 2.4, 2.5, 2.6, etc) and will be used to prepare any releases, major or minor, relating to the component number.

In most cases, there should only be one unlocked component in Weblate's AtoM project - if we've released 2.5 for example but expect to create a 2.5.1 release, we will likely not open a 2.6 component until 2.5.1 has been released, so that translators don't have add the same translations to both components. However, there may be rare cases where we have two components open and unlocked. This might occur if, for example, we've already added a 2.6 component, but then discover an issue in 2.5 big enough to warrant a 2.5.1 release, and want to allow our translator community an opportunity to supplement or update existing translations in that release as well.

In this rare case, it's up to you which component you choose to work in - but it should be informed by your goals, and a clear understanding of the consequences.

Important

If there are 2 open components in Weblate, then translations added to one component will not automatically be added to the other, even if it is for an earlier release. The only way to have your translations available in both components (and both releases) will be to manually add your translations to both components.

If there is a 2.5 and a 2.6 AtoM component in Weblate, then the 2.5 component will be used for a 2.5 minor release (i.e. 2.5.1, 2.5.2), and the 2.6 component will be used for the next major release (i.e. 2.6.0). In the case where there are 2 open components, those translation strings added in the earlier version will not be carried forward into the later component - but the later component will be used to create the next component in the future, meaning the strings will be carried forward into subsequent releases.

Because of this, we recommend only working in the earlier component if you want to fix poor translations or make other minor improvements in the next minor release so you can access them more quickly (since this will be the next public release), and you don't mind losing them in the next release or manually making the same changes in the later component. Otherwise, we recommend focusing on the latest component available - this ensures that your translations will be included in future releases as well.

What's the difference between a reviewer and translator?

Every person who logs into our AtoM translation project through GitHub will automatically be a translator. That means you can choose projects, and primary and secondary languages to watch, add translations in your chosen language(s) and any other languages you have knowledge of, and request that new languages that are currently unavailable in the project be added to it. When you add a translation, that string is automatically saved in the Weblate database and becomes visible to everyone. It can still be edited by you or by other translators. However, it will not be part of the next Artefactual commit until it has been approved. That is the role of a reviewer.

Reviewers have all the same privileges as translators, as well as the ability to approve translations. Once a reviewer has approved a translation it will no longer be editable, and it will be part of the next Artefactual commit.

Why do I need a reviewer?

Artefactual has chosen to use this model in order to maintain quality control on translations. If you would like to be a reviewer, please let us know by sending an email to translate@artefactual.com.

What do I do if there are no reviewers on my language?

We track who is a reviewer for any given language, and will contact translators directly if reviewers are needed for a language. If you find yourself completing translations with no reviewer for your chosen language(s), please feel free to contact us at translate@artefactual.com.

Why can't i translate in a specific sublocale (like ES_es)?

AtoM was built using the Symfony 1.x PHP framework, and we borrow its internationalization (or i18n) functionality to implement AtoM's ability to translate content into multiple languages. However, as an older framework, Symfony's support for specific sublocales is limited. AtoM cannot at this time support a language that is not supported by the underlying Symfony i18n framework.

Where can I find a list of supported languages for translation in AtoM?

We have a list of all of AtoM's supported languages, and their 2-letter ISO 639-1 language codes, here:

How do I request a new language?

First, please make sure that the language you would like to request is supported in AtoM - see this list:

If it is supported, but you don't see it in Weblate, please see the "Requesting new languages" section above. You can request a new language via Weblate - here's a quick summary of the steps outlined above:

  • Navigate to the AtoM component in which you want to work
  • Click the "Start new translation" button at the bottom of the page
  • In the Language selection page that will appear, click the "Can't find your language in the list above?" hyperlink
  • Weblate will open a Contact form - please fill out the details of your request. Artefactual will receive it and review the request. If you've requested a language that AtoM supports (full list available here), we'll approve it!

See the documentation section above for more details and screenshots.

Alternatively, feel free to email us at translate@artefactual.com and we will be happy to add a new language for you!


Thank you for helping us translate AtoM - it is through your participation that we can make AtoM a truly international application!

Got questions, or find something that's not covered below that you think would be helpful? Let us know via the AtoM User Forum, or send us an email at translate@artefactual.com.