Typical non anonymous and anonymous checkout command lines for Debian Installer and related packages are listed in Chapter 1, For translators: translating Debian Installer.
Below is an example of a typical checkout for the console-data package:
user@host:~> svn co svn://anonscm.debian.org/console-data/trunk/debian/po console-data TODO user@host:~>
After this the
console-data directory contains all
files from the package. Updating this directory later needs running the svn update:
user@host:~> cd console-data user@host:~/console-data> svn up TODO user@host:~>
Subdirectories of a full SVN directory can also be checked out in case one want to work on specific parts. This can be very useful for Debian Installer core translations as Debian Installer SVN repository is very big:
user@host:~> svn co svn+ssh://<alioth_username>@svn.debian.org/svn/d-i/trunk/packages/po debian-installer level1-po TODO user@host:~> cd level1-po/ user@host:~/level1-po> ls -l total 19112 -rw-r--r-- 1 user user 369598 2005-08-18 02:56 ar.po -rw-r--r-- 1 user user 266462 2005-08-18 02:56 be.po .../... -rw-r--r-- 1 user user 1120 2005-07-17 08:17 PROSPECTIVE .../... -rw-r--r-- 1 user user 2027 2005-07-31 08:54 README -rw-r--r-- 1 user user 353752 2005-08-18 02:56 ro.po -rw-r--r-- 1 user user 324 2005-08-16 16:30 run-l10n-sync .../... -rw-r--r-- 1 user user 237996 2005-08-18 02:56 template.pot .../... -rw-r--r-- 1 user user 350181 2005-08-18 02:56 xh.po -rw-r--r-- 1 user user 335898 2005-08-18 02:56 zh_CN.po -rw-r--r-- 1 user user 335413 2005-08-18 02:56 zh_TW.po user@host:~/level1-po>
If the translation file already exists, then just update the local copy:
user@host:~/level1-po> lokalize fr.po .../...
(Use Lokalize or any other gettext utility, see Appendix E, Gettext files editors and tools for details about gettext files handling, editing and maintenance tools.)
Once you have saved the modified version of the file, the status can be displayed with the svn status command:
user@host:~/level1-po> svn status M fr.po user@host:~/level1-po>
The above means that
fr.po includes uncommited
modifications. These modifications can be committed by using the svn commit command:
user@host:~/level1-po> svn commit
The user will then be dropped into a file editor (either vi or any other file editor pointed by the EDITOR variable. The changelog message can then be typed in the editor. Saving it and exiting the editor will trigger the commit action to the SVN repository.
A more targeted commit command is also possible, as well as giving the commit message on the command line:
user@host:~/level1-po> svn commit -m"French translation update" fr.po TODO user@host:~/level1-po>
In general, a few recommendations can be made to translators:
Always use the svn update before working on a file or directory. This will minimize conflicts in case a file is changed in the repository while they work on it;
Always use the svn status command before committing changes, to be sure that only relevant changes are committed.