Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
contribute:translate:start [2026/09/10 02:12] – Grammar improvement kevinbowencontribute:translate:start [2026/10/11 19:09] (current) – re-add link to i18n mailing list kevinbowen
Line 2: Line 2:
 ====== 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 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.
  
-=== Remote locations === 
  
-[[https://explore.transifex.com/xfce/|Xfce organization at Transifex]]\\ +  * **[[#Getting Started with Translating Xfce|Getting Started with Translating Xfce]]** 
-This is where you should be when translating Xfce. It contains projects and branches for all parts of 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://developers.transifex.com/docs/using-the-client|TX client]]\\ +  * **[[https://help.transifex.com/en/articles/6318604-reviewing-translations|Reviewing Translations]]** 
-Translators won't get GIT access, but there is a Transifex client they can use to handle po files directly.+  * **[[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 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 the translation communication is coordinated, so it is nice 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 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 (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 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! +
- +
----- +
- +
-===== Team Work ===== +
- +
-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 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]]