Mercurial > mplayer.hg
annotate DOCS/tech/translations.txt @ 36920:40ad45360c8a
Replace old item 'potmeter' by new item 'pimage'.
Recent versions of the X11/GTK GUI didn't allow to control a potmeter,
because that didn't seem to make any sense.
In order to get rid of the confusing potmeter that doesn't distinguish
from a hpotmeter and in order to allow the more useful behaviour recent
versions of the X11/GTK GUI have been utilized (and because we're still
supporting item 'potmeter' for reasons of compatibility with old skins),
introduce new item 'pimage' that reuses most of the current potmeter
code.
Additionally, remove remaining code and documentation of 'potmeter'.
author | ib |
---|---|
date | Mon, 17 Mar 2014 12:29:46 +0000 |
parents | 518549e08426 |
children |
rev | line source |
---|---|
11809 | 1 ________________________________________ |
2 HOW TO DO A GOOD TRANSLATION FOR MPLAYER | |
3 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
4 | |
5 We always welcome new translations, but please be aware that | |
6 translations are not just one time jobs. They have to be maintained | |
7 in order to be useful. Otherwise they quickly get outdated and become | |
8 obsolete, useless cruft. That said, we would be happy if you could | |
9 maintain a new documentation translation. | |
10 | |
26655
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
11 Experience shows that translations work best when done by teams. Not only |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
12 can the workload be shared, but there is also the chance to review the |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
13 translation. So if possible try to find more people to help out with |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
14 translating. |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
15 |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
16 Furthermore, if you take over an unmaintained translation, bring the existing |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
17 parts up-to-date before translating new ones. Outdated information is worse |
36711 | 18 than missing information. For console messages, GUI localization and the XML |
19 documentation, missing parts are automatically replaced by the English | |
20 versions. | |
26655
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
21 |
16120
cc8e5b36f1ed
Mention the MPlayer-translations mailing list and explain the difference
diego
parents:
14558
diff
changeset
|
22 Documentation related discussions happen on the MPlayer-DOCS mailing list, |
cc8e5b36f1ed
Mention the MPlayer-translations mailing list and explain the difference
diego
parents:
14558
diff
changeset
|
23 while documentation translation related discussions happen on the |
cc8e5b36f1ed
Mention the MPlayer-translations mailing list and explain the difference
diego
parents:
14558
diff
changeset
|
24 MPlayer-translations mailing list. If you want to maintain a translation |
19657 | 25 you should subscribe to both, as the English documentation Subversion |
26 changelogs, which you need to keep the translation up to date, are sent | |
27 to MPlayer-DOCS. You can subscribe here: | |
11809 | 28 |
20232 | 29 http://lists.mplayerhq.hu/mailman/listinfo/mplayer-docs |
30 http://lists.mplayerhq.hu/mailman/listinfo/mplayer-translations | |
11809 | 31 |
23180 | 32 Send updates and patches to this mailing list or directly to the translation |
33 coordination maintainer, see DOCS/tech/MAINTAINERS for details. | |
11809 | 34 |
35 Translations of MPlayer documentation consist of 3 parts in descending | |
36 order of importance: | |
37 | |
26657 | 38 0) homepage |
36711 | 39 1) console messages and GUI localization (help/help_mp-XX.h) |
11809 | 40 2) man page |
41 3) XML documentation | |
42 | |
26656 | 43 Not all parts are available in all languages. Keeping existing parts up-to-date |
44 should have precedence over adding newly translated content. It is perfectly | |
45 acceptable to work on only a subset of these parts, but please follow the above | |
46 order of importance nonetheless. | |
11809 | 47 |
26656 | 48 Now on to some more detailed instructions... |
26654 | 49 |
26655
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
50 general: |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
51 ~~~~~~~~ |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
52 |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
53 Please note that the help_mp files and the XML documentation are both encoded |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
54 in UTF-8. Editing these files in a program which uses a different encoding |
36711 | 55 will result in breaking console messages, GUI localization and HTML. |
26655
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
56 |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
57 Translations are for documentation what porting is for code. Many more eyes |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
58 see it and get to find mistakes. If you stumble over mistakes, inaccuracies, |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
59 clumsy wording, spelling/grammar errors or if you notice that something is |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
60 incomplete, please let us know, we'll fix it. Patches are more than welcome, |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
61 of course. Do not, however, change the translation first, please get your |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
62 update into the English version first. |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
63 |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
64 If you have Subversion write access and commit a translation update, use |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
65 something like "synced with rXXX" as first line of the commit message so |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
66 that it is possible to tell with a glance at the Subversion log or ViewVC |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
67 if the translation is outdated and which revision of the English master |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
68 file it is equivalent to. |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
69 |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
70 If you make (spelling/wording/consistency/etc) changes to a file without |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
71 adapting parts that changed in the English master file, leave the sync |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
72 tag as it is. |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
73 |
733f7ac7a855
Move some blocks around for better text structuring.
diego
parents:
26654
diff
changeset
|
74 |
26657 | 75 homepage: |
76 ~~~~~~~~~ | |
77 | |
78 Get the homepage from Subversion with | |
79 | |
80 svn checkout svn://svn.mplayerhq.hu/homepage/trunk/ homepage | |
81 | |
82 or browse the sources online at | |
83 | |
84 http://svn.mplayerhq.hu/homepage/trunk/ | |
85 | |
86 The homepage uses design template files that are combined with the content | |
87 files to form the final HTML pages. To build the HTML pages, type 'make' in | |
88 the root of the homepage source directory. | |
89 | |
90 | |
36711 | 91 console messages / GUI localization: |
92 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
26654 | 93 |
19657 | 94 You can find the latest versions of the help_mp-XX.h files in Subversion or |
11809 | 95 here: |
96 | |
18750 | 97 http://svn.mplayerhq.hu/mplayer/trunk/help/ |
11809 | 98 |
99 help_mp-en.h is the master file that you should use as a base for translations. | |
100 If you are adopting an already existing translation, please check it from top | |
18539 | 101 to bottom once. Later it should suffice to just translate missing messages. |
102 Additionally, please make sure that your translated messages fit on an 80 | |
103 character wide display to avoid overflowing output. | |
104 | |
36686
8715803f09e8
Enhance the tool for checking translated messages header files.
ib
parents:
36685
diff
changeset
|
105 You are strongly encouraged to use TOOLS/mphelp_check.py, a small tool to |
8715803f09e8
Enhance the tool for checking translated messages header files.
ib
parents:
36685
diff
changeset
|
106 check translated files. It will report conflicting definitions, mismatching |
8715803f09e8
Enhance the tool for checking translated messages header files.
ib
parents:
36685
diff
changeset
|
107 arguments, extra definitions not present in the master file and (optionally) |
8715803f09e8
Enhance the tool for checking translated messages header files.
ib
parents:
36685
diff
changeset
|
108 definitions missing from the translation. Running it as |
11809 | 109 |
26652
41f5023fe2bd
more complete mphelp_check.py command lines, typo, clarifications
diego
parents:
23180
diff
changeset
|
110 TOOLS/mphelp_check.py help/help_mp-en.h help/help_mp-XX.h |
18539 | 111 |
112 will output errors to the screen, just substitute XX with your language code. | |
26652
41f5023fe2bd
more complete mphelp_check.py command lines, typo, clarifications
diego
parents:
23180
diff
changeset
|
113 Adding the -missing option to the command line as in |
11809 | 114 |
26652
41f5023fe2bd
more complete mphelp_check.py command lines, typo, clarifications
diego
parents:
23180
diff
changeset
|
115 TOOLS/mphelp_check.py -missing help/help_mp-en.h help/help_mp-XX.h |
18539 | 116 |
117 will additionally print untranslated messages to the screen. | |
11809 | 118 |
12091
c67c28e4992e
How to handle incomplete translations of message files.
diego
parents:
11809
diff
changeset
|
119 If you do not translate all messages at once, please do not leave untranslated |
c67c28e4992e
How to handle incomplete translations of message files.
diego
parents:
11809
diff
changeset
|
120 messages in your translated file, just leave them out instead. The MPlayer |
c67c28e4992e
How to handle incomplete translations of message files.
diego
parents:
11809
diff
changeset
|
121 build system automatically checks for missing messages and uses the English |
c67c28e4992e
How to handle incomplete translations of message files.
diego
parents:
11809
diff
changeset
|
122 ones instead. This has the added advantage of providing the latest versions of |
c67c28e4992e
How to handle incomplete translations of message files.
diego
parents:
11809
diff
changeset
|
123 the English messages, since English messages in translations may be outdated. |
c67c28e4992e
How to handle incomplete translations of message files.
diego
parents:
11809
diff
changeset
|
124 |
16791
fe601b7b10c8
Add a note about the "synce with 1.XXX" line that should be in every
diego
parents:
16120
diff
changeset
|
125 If no messages are missing, please add a line similar to |
fe601b7b10c8
Add a note about the "synce with 1.XXX" line that should be in every
diego
parents:
16120
diff
changeset
|
126 |
19704
338961243006
Some more CVS --> Subversion changes, explain what to do with the sync tag
diego
parents:
19658
diff
changeset
|
127 /* Synced with help_mp-en.h rXXX */ |
16791
fe601b7b10c8
Add a note about the "synce with 1.XXX" line that should be in every
diego
parents:
16120
diff
changeset
|
128 |
fe601b7b10c8
Add a note about the "synce with 1.XXX" line that should be in every
diego
parents:
16120
diff
changeset
|
129 to the file header, replacing XXX with the revision of help_mp-en.h that your |
fe601b7b10c8
Add a note about the "synce with 1.XXX" line that should be in every
diego
parents:
16120
diff
changeset
|
130 translation is in sync with. This way we can easily tell if the translation |
fe601b7b10c8
Add a note about the "synce with 1.XXX" line that should be in every
diego
parents:
16120
diff
changeset
|
131 is up to date or not. |
fe601b7b10c8
Add a note about the "synce with 1.XXX" line that should be in every
diego
parents:
16120
diff
changeset
|
132 |
26654 | 133 |
134 XML documentation: | |
135 ~~~~~~~~~~~~~~~~~~ | |
136 | |
20025 | 137 If you make changes to the XML documentation, doublecheck that the |
34235
91794b4aa5d0
build: merge DOCS/xml/Makefile into top-level Makefile
diego
parents:
34232
diff
changeset
|
138 documentation still builds by running 'make doc'. |
34232
8b541e3d05c1
doc: Move XML translation notes to translations.txt.
diego
parents:
26657
diff
changeset
|
139 |
8b541e3d05c1
doc: Move XML translation notes to translations.txt.
diego
parents:
26657
diff
changeset
|
140 Place XML files in a new subdirectory named after the language code you are |
8b541e3d05c1
doc: Move XML translation notes to translations.txt.
diego
parents:
26657
diff
changeset
|
141 translating for. main.xml is autogenerated, do not translate it. |
8b541e3d05c1
doc: Move XML translation notes to translations.txt.
diego
parents:
26657
diff
changeset
|
142 |
8b541e3d05c1
doc: Move XML translation notes to translations.txt.
diego
parents:
26657
diff
changeset
|
143 In each translated file after the <?xml ... ?> tag place a note like |
8b541e3d05c1
doc: Move XML translation notes to translations.txt.
diego
parents:
26657
diff
changeset
|
144 <!-- synced with rXXX -->, where XXX is the revision of corresponding |
8b541e3d05c1
doc: Move XML translation notes to translations.txt.
diego
parents:
26657
diff
changeset
|
145 English file (see comment at the top of file). |