This repository has been archived by the owner on May 16, 2022. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 2
/
README
152 lines (122 loc) · 5.9 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
This tool allows to manage the GNOME translations that reside on a VCS.
For example, if you want to edit several translation files and then
commit them to GNOME VCS, this tool automates the VCS access so that
what you need to worry is only the editing of the translation files.
Currently, the VCS is git throughout this program.
= Workflows =
A. Configuration [config]
1. Initial configuration (requires all options)
$ ./gnome-i18n-manage-vcs config --language el --languagefull Greek --username simos
2. Show current configuration
$ gnome-i18n-manage-vcs config -l
Configuration file (/home/user/.config/gnome-i18n-manage-vcs)
Data directory (/home/user/.local/share/gnome-i18n-manage-vcs)
Full language name = Greek
Language code = el
Username = simos
$ _
3. Show current state (where repositories reside, what repositories are availale, etc)
$ ./gnome-i18n-manage-vcs status
B. Managing VCS (GIT) repositories [vcsmanage]
1. Suppose you have fast connection in the US and you want to grab all GNOME 2.30
repositories and then download them with HTTP/Bittorrent to your home computer.
$ ./gnome-i18n-manage-vcs vcsmanage --clone --release gnome-2-30
2. Suppose you want to do the thing above but with anonymous clones (not use
your git.gnome.org account on that fast server)
$ ./gnome-i18n-manage-vcs config --language dummy --languagefull dummy --username anonymous
$ ./gnome-i18n-manage-vcs vcsmanage --clone --release gnome-2-30
$ ./gnome-i18n-manage-vcs vcsmanage --all --trim
$ ./gnome-i18n-manage-vcs config --language el --languagefull Greek --username simos
3. Suppose you want to fix up the anonymous clones on your home computer with your
git.gnome.org account details.
$ ./gnome-i18n-manage-vcs vcsmanage --all --reset
$ ./gnome-i18n-manage-vcs vcsmanage --all --eponymous
4. Suppose you want to update your git repositories and sy nch them with git.gnome.org.
$ ./gnome-i18n-manage-vcs vcsmanage --all --update-vcs
5. Suppose you want to clone one more repository and add in your gnome-i18n-manage-vcs list.
$ ./gnome-i18n-manage-vcs vcsmanage --clone --module anjal
(the above command clones the 'anjal' repository and adds it to the rest of your repos)
C. Retrieving PO files [poget] UNDER CONSTRUCTION !!!
1. Download all PO files for a release
gnome-i18n-manage-vcs poget
2. Download PO documentation files for gnome-games
gnome-i18n-manage-vcs poget --module gnome-games --transtype doc
3. Clean downloaded PO files
gnome-i18n-manage-vcs poget --clean
4. Clean downloaded PO files (dry run)
gnome-i18n-manage-vcs poget --clean --dry-run
D. Commiting PO files [pocommit] UNDER CONSTRUCTION !!!
1. <not available yet>
E. Command line help
$ ./gnome-i18n-manage-vcs
gnome-i18n-manage-vcs, a tool that helps manage translation files from GNOME VCS
Usage: gnome-i18n-manage-vcs <action> <options>
Please specify action. Available actions are:
* config configures the local settings
* status show detailed status of local files
* vcsmanage repository management tasks
* poget retrieval of PO files
* commit commiting PO files
Invoke with --help for full help options.
$ _
$ ./gnome-i18n-manage-vcs --help
gnome-i18n-manage-vcs, a tool that helps manage translation files from GNOME VCS
Usage: gnome-i18n-manage-vcs <action> <options>
Please specify action. Available actions are:
* config configures the local settings
* status show detailed status of local files
* vcsmanage repository management tasks
* poget retrieval of PO files
* commit commiting PO files
config Initial configuration
--language LANG specify the language code per ISO 639
--languagefull LANGFULL specify the full language name (such as 'Brazilian Portuguese')
--username USER specify username USR (corresponds to SVN/GIT GNOME account)
-l list the configuration options
status Show current status for a previously configured release.
vcsmanage Local repository management (Module filtering applies)
--cleanall cleans up the repository folder (USE WITH CARE, WIPES REPOSITORIES)
--clone clone repositories
--eponymous make repositories eponymous (sets to new 'username')
--git-quiet don't show progress when cloning (git 1.5 ignores this option).
--git-verbose show progress when cloning
--reset reset each repository (git reset --hard origin/master)
--trim erases the working copy
--update-vcs update local repositories (runs git pull --rebase on each)
poget Retrieve a selection of PO files (Module filtering required)
--cleanall clears up the downloaded files (USE WITH CARE, WIPES PO FILES)
commit Commit and push the translation work to the repositories
--commit commit changes in repositories
--dry-run do not really checkout/commit
Module filtering (applies to vcsmanage, poget, commit)
--all apply action to all locally available repositories
--cache use the cached XML file (if any) of the release modules
-c CAT --category CAT i18n category name CAT (such as 'desktop')
-m MODU --module MOD i18n module name MOD (such as 'gnome-games')
-r REL --release REL GNOME release (such as 'gnome-2-26')
-t TYPE --transtype TYPE optionally specify translation type, either ui or doc
Common options
-d --dry-run do not really perform the action
-h --help this craft
-v --verbose show verbose output
$ _
$ ./gnome-i18n-manage-vcs status
Language code: [el] Language: Greek Username: simos
VCS Directory: /home/myusername/.local/share/gnome-i18n-manage-vcs/vcs/
PO Directory: /home/myusername/.local/share/gnome-i18n-manage-vcs/po/
10 repositories found:
accerciser
accounts-dialog
anjal
cheese
empathy
evince
jhbuild
nautilus
sabayon
totem
0 PO files found:
No START file exists
PO files that are newer than timestamp:
Action has just completed.
$ _