Subversion Information For Translators

General subversion information

The Xfce subversion repository is available for anonymous and developers (requires authentication). If you do not have a developer login to access the subversion repository, you can still help by submitting patches — or updated translation files — to the mailinglist.

Developers get write access to certain parts of the Xfce subversion repository, and can commit directly to this repository with their username and password. How to receive a developers account is covered here: translator account information.

The repository layout is quite complex, and there are tens of modules that you can checkout. Only a small portion of the repository is interesting for translators however, and that is why we ask translators to checkout only the translation directories of the packages that they want to translate, and not the entire Xfce repository. This is a lot faster too for translators, and easy to update. Have a look at the SVN Scripts section and grab the one that suits your needs.

Anonymous access

Anonymous access is available to everyone. First, you will need to checkout a copy of the translation parts of the Xfce subversion repository by using the scripts below! After doing this, you may update your local copy with the update command (the local copy is also known as the working copy) regularly and use the diff functionality of subversion to create patches. You can then send this patch to the Xfce-i18n mailing list as an attachment. The translations maintainers will then commit the changes for you.

To browse the Xfce subversion repositories, just visit http://svn.xfce.org/.

Developer access

Developers can write directly into the repository and commit changes to the translations directly. They use a different method to checkout and work that uses SSL encryption and username/password authentication. This way the repository system keeps track of who has edited parts of the repository, and changelogs can be made efficiently.

To make this process easier, please read the section about translator SVN scripts below.

Developers will need to use a different base URL to work with the subversion repository, which is:

https://username@svn.xfce.org/svn/xfce

Using this URL with subversion requires that you have a valid username and password.

Some good practices when commit

SVN Scripts

To use the scripts, just download them and make them executable with the command “chmod +x <the-script>”. Also put them inside your $PATH so you can call them whenever you need them.

Start by creating a working directory for the translation, for instance “xfce-i18n” in you home, where you will checkout different branches to translate.

  • xdt-i18n - checkout and update script for translators
  • xdt-commit - commits your changes with a log message based on the ChangeLog files

xdt-i18n usage

Print the usage of the script xdt-i18n
List available versions to translate xdt-i18n list
Checkout the 4.4 version of Xfce xdt-i18n init xfce/4.4
Checkout the trunk version of Xfce xdt-i18n init xfce/trunk
Checkout the trunk with developer accountxdt-i18n init xfce/trunk -https
Checkout the goodies xdt-i18n init goodies/trunk
Update the current working directory xdt-i18n update
Display statistics for files fr.po xdt-i18n stat fr.po
Check for errors over files fr.po xdt-i18n check fr.po

If you have a developer account you can append a “-https” flag at the end of the “init” command.

 
svn_howto.txt · Last modified: 2008/06/08 16:06 by 88.172.125.130
 
Recent changes RSS feed Creative Commons License Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki