|
|
| (96 intermediate revisions by 2 users not shown) |
| Line 4: |
Line 4: |
| | This is an internal workspace for Artefactual staff who are drafting new wiki content or major revisions to existing pages to test out their edits. Contents here are considered draft, unstable, and temporary. | | This is an internal workspace for Artefactual staff who are drafting new wiki content or major revisions to existing pages to test out their edits. Contents here are considered draft, unstable, and temporary. |
| | </admonition> | | </admonition> |
| − |
| |
| − |
| |
| − |
| |
| − |
| |
| − |
| |
| − |
| |
| − |
| |
| − |
| |
| − |
| |
| − |
| |
| | | | |
| | ----- | | ----- |
| | | | |
| | * [[Main_Page|AtoM wiki home]] | | * [[Main_Page|AtoM wiki home]] |
| − |
| |
| − | -----
| |
| − |
| |
| − | 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.
| |
| − |
| |
| − | 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 Weblate translation project, so that
| |
| − | you can sign up and begin contributing translations. If you have contributed
| |
| − | through Transifex in the past, you will need to open a new account with Weblate
| |
| − | to continue contributing.
| |
| − |
| |
| − | <admonition type="seealso">
| |
| − | * 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]]
| |
| − | * 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.
| |
| − | </admonition>
| |
| − |
| |
| − | '''You can see the AtoM project in Weblate here:'''
| |
| − |
| |
| − | * https://translations.artefactual.com/
| |
| − |
| |
| − |
| |
| − | __TOC__
| |
| − |
| |
| − |
| |
| − |
| |
| − | ===Sign up for an account with Weblate===
| |
| − |
| |
| − | '''1.''' Navigate to https://translations.artefactual.com/ to see current Artefactual translation projects. While everybody can
| |
| − | browse these projects, view translations or suggest them, only registered
| |
| − | users can save translations, and are credited for every translation made.
| |
| − |
| |
| − | '''2.''' To register and begin contributing, navigate to https://translations.artefactual.com/engage/atom/ and click on '''Register''' to create an account.
| |
| − |
| |
| − | [[File:weblate-intro.png|frameless|500px|center|Sign up for Weblate]]
| |
| − |
| |
| − | Fill in your information and click '''Register'''.
| |
| − |
| |
| − | [[File:weblate-register2.png|frameless|500px|center|Registration information]]
| |
| − |
| |
| − | <admonition type="note"> By registering you are agreeing with Weblate to use your name and email in version control commits and provide your contribution under the terms of the Creative Commons Attribution Share Alike 4.0 ([https://creativecommons.org/licenses/by-sa/4.0/CC-BY-SA-4.0]) license that applies to all AtoM documentation. </admonition>
| |
| − |
| |
| − | <admonition type="seealso">
| |
| − | Weblate also supports several third-party registrations and provides links from their registration page.
| |
| − |
| |
| − | [[File:weblate-3rd-party-registration.png|frameless|300px|center|Third party registration options]]
| |
| − | </admonition>
| |
| − |
| |
| − | After you submit your registration you will be sent an activation email to the email account you used to register. Follow the instructions in the email to complete your registration and activate your account.
| |
| − |
| |
| − | <admonition type="seealso">
| |
| − | Weblate has its own help documentation - here's a help page on getting started:
| |
| − |
| |
| − | * [https://docs.weblate.org/en/latest/user/index.html Weblate Documentation -
| |
| − | Translators guide]
| |
| − | </admonition>
| |
| − |
| |
| − | ===Log in and set your preferences===
| |
| − |
| |
| − | '''3.''' When you activate your account you will be redirected to a page that asks you to agree to Weblate's Terms of Service and you will be prompted to set a password.
| |
| − |
| |
| − | '''4.''' When you have logged in you will see the Dashboard.
| |
| − |
| |
| − | [[File:weblate-dashboard.png|frameless|500px|center|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.
| |
| − |
| |
| − | [[File:weblate-manage-settings.png|frameless|500px|center|Set your preferences]]
| |
| − |
| |
| − | '''5.''' Select the languages you want to see on your dashboard from the '''Languages''' tab, and projects from the '''Subscriptions''' tab before you begin to contribute translations.
| |
| − |
| |
| − | From the '''Language''' navigation tab, choose the languages you wish to translate and those you want to follow. Your primary languages are the languages you wish to translate. They will show up on your dashboard as "Watched languages" when you log in or navigate to the dashboard. Secondary languages are languages whose translations you want to follow. 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 but clicking on the language links to add or delete from the primary and secondary language choices.
| |
| − |
| |
| − | [[File:weblate-language-tab.png|frameless|500px|center|Language tab]]
| |
| − |
| |
| − | From the '''Subscription''' tab, choose the translation project(s) you wish to follow and click '''Save'''. Scroll down the page to select notifications you want to receive about the project(s) you have subscribed to. Save your selections.
| |
| − |
| |
| − | [[File:weblate-subscription-tab.png|frameless|500px|center|Subscription tab]]
| |
| − |
| |
| − | These settings can be changed or updated at any time.
| |
| − |
| |
| − | 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.
| |
| − |
| |
| − | [[File:weblate-dashboard2.png|frameless|500px|center|Projects dashboard]]
| |
| − |
| |
| − | You can also see all languages available to a given project and their translation status by selecting a project from '''Watched projects''' in the main navigation bar.
| |
| − |
| |
| − | <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!
| |
| − |
| |
| − | You can view a list of all languages supported in AtoM, with their corresponding language codes, here:
| |
| − |
| |
| − | * [https://gist.github.com/sevein/d248525a66ef793c93d8 AtoM supported languages] </admonition>
| |
| − |
| |
| − | '''6.''' Other preferences on how you want Weblate to be displayed are available from the '''Preference''' tab in the menu bar. See the [https://docs.weblate.org/en/latest/user/index.html Weblate] documentation for details.
| |
| − |
| |
| − | ===Begin translating===
| |
| − |
| |
| − | '''7.''' From your dashboard you can navigate to the translation screen in two ways.
| |
| − |
| |
| − | [[File:weblate-dashboard3.png|frameless|500px|center|Projects dashboard]]
| |
| − |
| |
| − | The first way is from the '''Component''' column. Click on the project/language you want to translate. 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 general translation screen or to filtered sets of strings for translation. Clicking on the <code>Translate</code> button or one of the filtered sets will take you to the translation screen.
| |
| − |
| |
| − | [[File:weblate-translation-links.png|frameless|500px|center|Translating]]
| |
| − |
| |
| − | The second way is to click on the <code>Translate</code> button to the right of the language you want to translate on your dashboard. This will take you directly to the translation screen.
| |
| − |
| |
| − | '''8.''' Once you have reached the translation screen you will see a list of items needing translation. The default view is '''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.
| |
| − |
| |
| − | [[File:edit-screen.png|frameless|500px|center|Adding Translations]]
| |
| − |
| |
| − | <admonition type="note">
| |
| − | You can switch from Zen mode to Full Editor mode by clicking <code>Exit Zen</code>. You can change the filter on strings for translation from the dropdown menu on the left..
| |
| − |
| |
| − | [[File:weblate-filter.png|frameless|500px|center|Translation filter]]
| |
| − |
| |
| − | </admonition>
| |
| − |
| |
| − | Your translation will be saved automatically, and checked, once you move your cursor out of the translation field. If your translation passes the checks, a green checkmark will appear to the left of the translation.
| |
| − |
| |
| − | [[File:weblate-translated-word.png|frameless|500px|center|Translated word]]
| |
| − |
| |
| − | If your translation fails any checks, a red "x" will appear. Scrolling over the "x" will highlight the syntax error.
| |
| − |
| |
| − | [[File:weblate-translation-fail.png|frameless|300px|center|Failed translation]]
| |
| − |
| |
| − | You can work through the list of strings needing translation, choosing those you want to translate.
| |
| − |
| |
| − | '''9.''' You can translate in any language, even those you have not set as primary or secondary. To do so, choose any of your primary languages from the dashboard, choose <code>Translate</code> or any preferred filtered set, and exit '''Zen''' mode. 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.
| |
| − |
| |
| − | [[File:weblate-translate-many.png|frameless|500px|center|Translating in several languages]]
| |
| − |
| |
| − | <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>
| |
| − |
| |
| − | <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>
| |
| − | ----
| |
| − |
| |
| − | '''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 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].
| |
