| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| contribute:translate:start [2026/09/10 05:22] – grammar improvement kevinbowen | contribute:translate:start [2026/10/11 19:09] (current) – re-add link to i18n mailing list kevinbowen |
|---|
| ====== Translating Xfce ====== | ====== Translating Xfce ====== |
| |
| Xfce uses the [[https://www.transifex.com/|Transifex]] translation platform as a portal for integrating the translator's efforts into the Xfce project. This allows translators to work online, submit new //po-files//, watch translations and view 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 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. |
| |
| 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 read the //getting started// section below. | 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. |
| | |
| | |
| | * **[[#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) |
| |
| ---- | ---- |
| |
| ===== Getting Started ===== | ===== Getting Started with Translating Xfce ===== |
| |
| Before contributing to the Xfce translation effort, please follow 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: |
| |
| - 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://matrix.to/#/#xfce-translation:matrix.org|#xfce-translation Matrix channel]] or write the [[https://mail.xfce.org/mailman/listinfo/xfce-i18n|Xfce translation mailing list]]. This is where translation communication is coordinated, so it is useful to introduce yourself here. On this list developers may also announce when releases are planned, a 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://explore.transifex.com/xfce/|Xfce hub project]] and request access to a team or request a new language if it doesn't yet exist. One of the developers or translation coordinators will approve your request. | - 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 for approval. If approval seems to be taking too long(>1 week), leave an additional reminder on the translation mailing list or Matrix channel. We will get to your approval as soon as we have time. | - 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 (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> | <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 all of the above steps have been followed and approval has been granted, you should have permission to submit and update translations in your respective language. Additional information about contributing to the project can be found below. Remember maintain contact 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 experience any error, or have ideas for improving the translation workflow, don't hesitate and send an email to the Xfce translation mailing list, we're always there to help you! | |
| | |
| ---- | |
| | |
| ===== Team Work ===== | |
| | |
| Keep in touch with the current translator(s). Is your language already translated or being translated by someone else? You should try and collaborate 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 [[https://mail.xfce.org/mailman/listinfo/xfce-i18n|i18n mailing-list]] and copy (CC) to the current translator. Let them know your intentions and wait for an answer from the current translator(s). | |
| | |
| Other than getting in touch with current translators, you can use a private page to share progress on translations. The defacto place is on our [[http://wiki.xfce.org/translations/|Xfce Wiki translation pages]], but you can also use alternative possibilities like the [[http://groups.google.com/support/|Google Groups]] or [[https://matrix.to/#/#xfce-translation:matrix.org|#xfce-translation Matrix]] channel. | |
| | |
| ---- | |
| | |
| ===== 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. | 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]]. |
| Transifex Usage | |
| | 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! |
| |
| You can read all about Transifex in their [[https://help.transifex.com/en/|support section]]. | 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! |
| |
| [[|Back To Top]] | [[|Back To Top]] |
| ---- | ---- |
| [[:contribute:start|Back to Main Contribute page]] | [[:contribute:start|Return to Main Xfce Contribute page]] |