~ubuntu-branches/ubuntu/utopic/kde-workspace/utopic-proposed

« back to all changes in this revision

Viewing changes to kcontrol/colors/README.i18n

  • Committer: Bazaar Package Importer
  • Author(s): Michał Zając
  • Date: 2011-07-09 08:31:15 UTC
  • Revision ID: james.westby@ubuntu.com-20110709083115-ohyxn6z93mily9fc
Tags: upstream-4.6.90
Import upstream version 4.6.90

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
There are two sets of preview strings in the color kcm, with special translation needs. In general, length of the translations, and "gist"-level clarity is more important than precise translation. It should be easy to identify what color role a string represents, but there are size considerations that should be taken into account. The tooltips should be translated normally.
 
2
 
 
3
 
 
4
 
 
5
When translating the color kcm, it is helpful to understand the intended meaning of the various color roles in order to chose the best possible translation if more than one would be possible. Hopefully the sets (view, window, button, selection, tooltip) are obvious, as well as normal background/foreground. The others are as follows:
 
6
 
 
7
Alternate [Background]: used in lists when every other row uses a different color; "different".
 
8
Inactive: comments, something which is old, unimportant/uninteresting/secondary text
 
9
Active: e.g. something new, something active (currently engaged in activity), something requesting attention, a hovered hyperlink
 
10
Link: hyperlink, somewhere the user can go, new history
 
11
Visited: visited hyperlinks, somewhere the user has been, old history
 
12
Negative: "bad", untrusted, unreliable, a mistake, an error the user made, an error that occurred
 
13
Neutral: warning, encrypted, anything "between" negative and positive
 
14
Positive: success, completion messages, trusted content
 
15
 
 
16
For Link, although other uses are possible, translate as referring to hyperlinks to minimize user confusion.
 
17
 
 
18
 
 
19
 
 
20
The "generic" preview uses these strings (all with disambiguation "color-kcm-preview"):
 
21
- Window Text
 
22
- Push Button
 
23
- Normal Text
 
24
- Selected Text
 
25
- link
 
26
- visited
 
27
- a
 
28
- i
 
29
- !
 
30
- =
 
31
- +
 
32
 
 
33
The two-word strings may be translated normally, though it is suggested to omit the translation of "Text" if the strings would be excessively (around 20+ characters) long and doing so does not cause confusion (i.e. substantially change the conveyed meaning). The "link" and "visited" strings should be translated according to the notes above, ideally keeping the length to four to eight characters; abbreviation (to not less than four characters if possible) is acceptable as the tooltips will provide more complete descriptions.
 
34
 
 
35
The remaining one-character strings represent (respectively) the text roles active (a), inactive (i), negative (!), neutral (=) and positive (+). These should be translated as one- or two-character strings which uniquely correspond to the aforementioned text roles, ideally taking the first letter of the corresponding translation, or maintaining the symbols (!, =, +) as-is if culturally appropriate.
 
36
 
 
37
Ideographic languages (e.g. Japanese, Mandarin, etc.) where the single-character strings can be replaced with one or two characters representing the full word should do so. These should also, if needed, consider a phonetic representation or relevant phrase for the longer elements, to keep the translations close to the same number of characters as the English.
 
38
 
 
39
 
 
40
 
 
41
The "set" preview uses these strings (all with disambiguation "color-kcm-set-preview"):
 
42
- normal
 
43
- link
 
44
- visited
 
45
- active
 
46
- inactive
 
47
- alternate
 
48
- negative
 
49
- neutral
 
50
- positive
 
51
- hover
 
52
- focus
 
53
 
 
54
These live in a preview widget that is two rows tall by nine items wide, and is often the determining factor in the minimum width of the dialog. For this reason, it is important to keep the strings SHORT. To ensure each text block is of sufficient size to provide an adequate preview, each should be at least a few characters long, but please try to limit them to no more than eight or ten characters on average. Abbreviation is fine and encouraged if necessary to achieve this average. In particular, PLEASE avoid adding the translated equivalent of " text" to these strings if at all possible; the tooltips will disambiguate if required. If these objectives cannot be achieved via direct translation, semantic translation (e.g. "negative" -> i18n("oops!"), "neutral" -> i18n("meh")) would be better. (Ideographic languages, which may need to ADD text to achieve a minimum length, should ignore the previous two sentences.) Note also that "hover" and "focus" are actually "decoration" roles, so e.g. "hover text" is incorrect (should be "hover decoration").