| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| contribute:translate:start [2018/08/19 08:07] – [Getting Started] Fix typo andreldm | contribute:translate:start [2026/10/11 19:09] (current) – re-add link to i18n mailing list kevinbowen |
|---|
| | ~~NOTOC~~ |
| | ====== Translating Xfce ====== |
| |
| ====== Translation ====== | Xfce uses the [[https://www.transifex.com/|Transifex]] translation platform as a portal for integrating the translator's efforts into the Xfce project. As a web-based platform, it allows translators to work online, submit new //po-files//, watch translations and view project-specific statistics. All translation updates are directly submitted into the [[https://gitlab.xfce.org|Xfce git repositories]], so they are made available for the rest of the world as soon as new releases are published. |
| |
| Xfce uses the [[https://www.transifex.com/|Transifex]] translation platform as a portal for translators. This allows translators to translate on-line, submit new //po-files//, watch translations and view statistics. All translation updates are directly submitted in the Xfce GIT repositories, so they are directly available for the rest of the world. | As we would like to translate Xfce into as many languages as possible, we are always looking for new translation contributors. If you are interested in this opportunity, please continue reading. |
| |
| Because we'd like to translate Xfce in as much languages as possible, we are always looking for new translation contributors. If you're interested in this, read the //getting started// section below. | |
| |
| === Remote locations === | * **[[#Getting Started with Translating Xfce|Getting Started with Translating Xfce]]** |
| | * **[[https://wiki.xfce.org/translations/|Xfce Translation Resources]]** |
| | * **[[https://help.transifex.com/en/articles/6318216-translating-with-the-web-editor|Translating with the Web Editor]]** |
| | * **[[https://help.transifex.com/en/articles/6318604-reviewing-translations|Reviewing Translations]]** |
| | * **[[https://help.transifex.com/en/collections/3441044-starting-with-the-basics|Introduction to Transifex]]** (Collection of introductory Transifex documentation) |
| |
| [[https://www.transifex.com/organization/xfce/|Xfce organization at Transifex]]\\ | ---- |
| This is where you should be when translating Xfce. It contains projects and branches for all parts of Xfce. | |
| |
| [[http://docs.transifex.com/developer/client/|TX client]]\\ | ===== Getting Started with Translating Xfce ===== |
| Translators won't get GIT access, but there is a Transifex client they can use to handle po files directly. | |
| ===== Getting Started ===== | |
| |
| Before you can contribute translations, you have to go through the steps below. Note that ALL these steps are required: | Before contributing to the Xfce translation effort, please follow the steps below. Note that ALL these steps are required: |
| |
| - First go to [[https://www.transifex.com/|transifex.com]] and create a new profile. | - Create a new profile on the [[https://www.transifex.com/|Transifex website]]. |
| - If you want to communicate with other translators, join the [[https://mail.xfce.org/mailman/listinfo/xfce-i18n|Xfce translation mailing list]]. This is where the translation communication is coordinated, so it is nice to introduce yourself here. On this list developer will also announce when releases are planned, translations system changes or anything else you should know as a translators. | - Join the [[https://matrix.to/#/#xfce-translation:matrix.org|Xfce translation Matrix channel]] and post an introduction. This is where you will be communicating with other translators(our [[https://mail.xfce.org/mailman/listinfo/xfce-i18n|Xfce-i18n mailing list]] is also available as an alternate communication method), |
| - Go to [[https://www.transifex.com/organization/xfce/|Xfce hub project]] and request access to a team or request a new language if it doesn't exist yet. One of the developers or translation coordinators will approve (or decline) your request. All other Xfce related projects outsource the permissions of the Xfce hub. | - After posting an introduction, you may proceed to the [[https://explore.transifex.com/xfce/|Xfce Transifex main project page]] and request access to a team. One of the developers or translation coordinators will approve your request. |
| - Now wait patiently. If it takes too long, leave a message on the translation mailing list. | - If you would like to provide translations for a new language, you **must** discuss this first in the Matrix channel. |
| | - Wait for approval. If approval seems to be taking too long(>1 week), leave an additional reminder on the Matrix channel. We will get to your approval as soon as we have time. |
| |
| <note important>Languages requested outside the Xfce organisation (ie. on an individual project), will be rejected!</note> | <note important>Languages requested outside the Xfce organisation (i.e. on an individual project) or for redundant locales (e.g. ''Italian (Italy) (it_IT)'' instead of just ''Italian (it)''), will be rejected!</note> |
| |
| Once this has all happened, you should have permission to submit and update translations in your language. You can find more information about this below. Don't forget to keep in touch with the other translators in your language (you can find them in the translation groups) to coordinate the translation work! | Once all of the above steps have been completed and approval has been granted, you should have permission to submit and update translations in your respective language. |
| |
| If you think anything went wrong, ideas? Don't hesitate and send an email to the Xfce translation mailing list, we're always there to help you! | Additional information about contributing to the project can be found below as well as on [[https://wiki.xfce.org/translations/start|Xfce Translation Resources pages]]. |
| | |
| | Remember to maintain contact with the other translators in your language. You can find them in the [[https://wiki.xfce.org/translations/teams/start|translation team list]] for your specific language. This will help you to coordinate the translation work! |
| |
| ===== Team Work ===== | If you experience errors using Transfix, or have ideas for improving the translation workflow, don't hesitate reach out on the [[https://matrix.to/#/#xfce-translation:matrix.org|Xfce translation Matrix channel]], we're always there to help you! |
| | |
| Keep in touch with the current translator(s). Is your language already translated or being translated by someone else, then you should try to work together with the current translator(s) of that language, and split up the work so you are reducing the workload and increasing the quality of the translation. Many translators are happy to share the work or even appreciate people discussing translations. | |
| | |
| The header of the PO files contain the field "Last-Translator" As example here is the French translation of xfce4-panel: [[http://git.xfce.org/xfce/xfce4-panel/plain/po/fr.po|fr.po]]. | |
| | |
| You can send an email to the i18n mailing-list as well with a copy (CC) to the current translator if you did find out his email. Let know your intention and wait for an answer from the current translator(s). If you don't get a response in the upcoming weeks (2~3 weeks) you can consider translating the different projects. | |
| | |
| Other than getting in touch with current translators, you can use a private page to share progress on translations. The defacto place is on [[http://wiki.xfce.org/translations/|wiki.xfce.org]], but you can also use alternative possibilities like the [[http://groups.google.com/support/|Google Groups]]. | |
| | |
| ===== Team Coordinator ===== | |
| | |
| Transifex allows you to manage a team with a list of translators and coordinators. Usually you will find one coordinator per team who is allowed to perform the following tasks: | |
| | |
| * Accept or deny new translators in the team | |
| * Accept or deny a translation review | |
| | |
| The coordinator should not accept new translators without having a little history of their involvement in other projects. If it is unsure if a new member has deep knowledge of translations or not, it is possible to check the new Transifex account and start a short discussion per email. At this point the coordinator can either accept the new member who will be allowed to commit changes directly in our repositories, otherwise the coordinator can ask the new member to submit the work for review. This process is important whenever the translations have to use a standard vocabulary for instance. | |
| | |
| A good practice for the coordinator is to check the translations before a new release, that consists into compiling each Xfce component with the latest translations and making sure everything is in good shape. | |
| Transifex Usage | |
| | |
| You can read all about Transifex in their [[http://support.transifex.com/|support section]]. | |
| |
| | [[|Back To Top]] |
| | ---- |
| | [[:contribute:start|Return to Main Xfce Contribute page]] |