| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| translations:start [2026/09/14 05:22] – add transifex team coordinators section kevinbowen | translations:start [2026/10/11 19:11] (current) – [Getting Help] kevinbowen |
|---|
| ====== Xfce Translation Resources ====== | ====== Xfce Translation Resources ====== |
| These pages have been set up to assist contributing to the translation of Xfce using Transifex, an online localiztion tool. | These pages have been set up to assist contributing to the translation of Xfce using Transifex, an online localiztion tool. |
| |
| |
| |
| ---- | ---- |
| |
| ===== Getting Started ===== | ===== Getting Started ===== |
| Transifex is the online, web-based platform for translators and project maintainers hosted at [[https://explore.transifex.com/xfce/| transifex.com]]. It gives the possibility to edit/upload translations through a simple form instead of learning technical tools. The main [[https://docs.xfce.org/contribute/translate/start|"Translating Xfce" page]] provides instructions for getting started and the initial Transifex registration process. | [[https://explore.transifex.com/xfce/|Transifex]] is the preferred tool used by Xfce translators. As an online, web-based tool, it allows translators to edit translations through a web interface rather than requiring contributors to learn more complex, and potentially error-prone tools. The main [[https://docs.xfce.org/contribute/translate/start|"Translating Xfce" page]] provides instructions for getting started with the initial Transifex registration process. |
| | |
| | * **[[#Translation Teams|Translation Teams]]** |
| | * **[[#Collaborating with your Translation Team|Collaborating with your Translation Team]]** |
| | * **[[#Transifex Team Coordinators|Transifex Team Coordinators]]** |
| | * **[[#Historical/Advanced Translation Resources|Historical/Advanced Translation Resources]]** |
| |
| ---- | ---- |
| ===== Getting Help ===== | ===== Getting Help ===== |
| |
| * **[[https://matrix.to/#/#xfce-translation:matrix.org|#xfce-translation Matrix channel]]** (Recommended Support channel) | * **[[https://matrix.to/#/#xfce-translation:matrix.org|xfce-translation Matrix channel]]** (Recommended Support channel) |
| | * **[[https://mail.xfce.org/mailman/listinfo/xfce-i18n|Xfce-i18n mailing list]]** (low-volume mailing list support) |
| | * **[[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://help.transifex.com/en/|Transifex Help Documentation]]** | * **[[https://help.transifex.com/en/|Transifex Help Documentation]]** |
| * **[[https://mail.xfce.org/mailman/listinfo/xfce-i18n|Xfce i18n mailing-list]]** | |
| |
| ---- | ---- |
| The [[translations:teams:|list of teams]] contains the maintainers of each language and a link to their wiki here (if one exists). | The [[translations:teams:|list of teams]] contains the maintainers of each language and a link to their wiki here (if one exists). |
| |
| We encourage translators to create and maintain a team wiki for your language team(even if you are the only translator). This can help in making it more accesible and welcoming for new translators to join your team. You can have a look at the other teams pages to get an idea about what you could put in yours. If you are using an external resource to exchange discussions then you may simply link to it on the team's wiki page here, if you prefer. | We encourage translators to create and maintain a team wiki for your language team(even if you are the only translator). This can help in making it more accesible and welcoming for new translators to join your team. You can have a look at the other teams pages to get an idea about what you could put in yours. If you are using an external resource to communicate with your team, it is recommended that it is linked to it on the team's wiki page here, for new and future translators. |
| |
| In order to get write-access to the translation wiki pages here, please join our[[https://matrix.to/#/#xfce-translation:matrix.org|#xfce-translation Matrix channel]] to introduce yourself to the team and request that a wiki.xfce.org account be created for you. | In order to get write-access to the translation wiki pages here, please join our[[https://matrix.to/#/#xfce-translation:matrix.org|Xfce translation Matrix channel]] to introduce yourself to the team and request that a wiki.xfce.org account be created for you. |
| |
| ---- | ---- |
| ===== Collaborating with your Translation Team ===== | ===== Collaborating with your Translation Team ===== |
| |
| Keep in contact with the other translator(s) of your language. 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 that you are potentially reducing your workload and increasing the quality of the translation. Many translators are happy to share the work and appreciate people discussing the translations that they are working on. | It is important to keep in contact with the other translator(s) of your language. |
| |
| 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]]. | Is your language already translated or being translated by someone else? If so, you should reach out and make an effort to collaborate with the current translator(s) of that language, and split up the work so that you are potentially reducing your workload and increasing the quality of the translation. Many translators are happy to share the work and appreciate people discussing the translations that they are working on. |
| | |
| 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). | |
| | |
| Along with communicating with current translators, you can use a private page to share progress on translations. The default place should be on our [[http://wiki.xfce.org/translations/|Xfce Wiki translation pages]], or the [[https://matrix.to/#/#xfce-translation:matrix.org|Matrix #xfce-translation]] channel. | |
| |
| [[|Back to Top]] | [[|Back to Top]] |
| * Accept or deny a translation review. | * Accept or deny a translation review. |
| |
| It is recommended that the team language coordinator should not accept new translators without having a little history of their involvement in other projects. If the coordinator 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, or the coordinator can ask the new member to submit the work for review. Following this process is important whenever the translations have to use a standard vocabulary. | It is recommended that the team language coordinator not accept new translators without having some familiarity with their involvement in other projects. If a coordinator is unsure if a new member has deep knowledge of translations, it is possible to check the new Transifex account and start a short discussion per email. |
| |
| A good practice for the team language coordinator is to check the translations prior to a new release, A new release consists of compiling each Xfce component with the latest translations and making sure everything is in good shape. | At this point, the coordinator can either accept the new member who will be allowed to commit changes directly in our repositories, or the coordinator can ask the new member to submit a sample of work for review. Following this process is important whenever the translations require the use of a shared vocabulary. |
| | |
| | A good practice for the team language coordinator is to check the translations prior to a new release, A new release consists of compiling each Xfce component with the latest translations and ensuring that everything meets a reasonable standard of quality. |
| |
| ---- | ---- |
| For the majority of our translators, we **strongly recommend** using [[https://app.transifex.com/xfce/|Transifex web interface]] as this should be sufficient for majority of the Xfce translation work. However, if you would like more technical details on translations and working with PO files, see our [[:translations:advanced:|advanced translation resources]] page. | For the majority of our translators, we **strongly recommend** using [[https://app.transifex.com/xfce/|Transifex web interface]] as this should be sufficient for majority of the Xfce translation work. However, if you would like more technical details on translations and working with PO files, see our [[:translations:advanced:|advanced translation resources]] page. |
| |
| | [[|Back to Top]] |
| |
| ---- | ---- |
| [[https://docs.xfce.org/contribute/translate/start|Return to docs.xfce.org translation page]] | [[https://docs.xfce.org/contribute/translate/start|Return to docs.xfce.org translation page]] |