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 checkout of the d-i GIT repository, containing the po files for level 1:
user@host:~$ git clone git@salsa.debian.org:installer-team/d-i.git d-i Cloning into 'd-i'... remote: Counting objects: 405013, done. remote: Compressing objects: 100% (72424/72424), done. remote: Total 405013 (delta 316140), reused 404965 (delta 316098) Receiving objects: 100% (405013/405013), 187.52 MiB | 199.00 KiB/s, done. Resolving deltas: 100% (316140/316140), done. user@host:~$
After this the d-i directory contains all
files from the repository. Updating this directory later needs running git pull:
user@host:~$ cd d-i user@host:~/d-i$ git pull Already up-to-date. user@host:~/d-i$
Now find the po translation files in the subdirectories under packages/po.
user@host:~/d-i$ cd packages/po/sublevel1 user@host:~/d-i/packages/po/sublevel1$
Just update the local copy:
user@host:~/d-i/packages/po/sublevel1$ 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 git status command:
user@host:~/d-i/packages/po/sublevel1$ git status -s M fr.po user@host:~/d-i/packages/po/sublevel1$
The above means that fr.po includes uncommited
modifications. The changed files need to be added to the staging area
by git add filename.
Then commit the modifications by using the
git commit command:
user@host:~/d-i/packages/po/sublevel1$ git add fr.po user@host:~/d-i/packages/po/sublevel1$ git commit -m "Insert a senseful commit message here, like 'Updated french translation'"
Now you need to push your changings to the remote GIT repository:
user@host:~/d-i/packages/po/sublevel1$ git push
In general, a few recommendations can be made to translators:
Always use the git pull 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 git status command before committing changes, to be sure that only relevant changes are committed.