File: TRANSLATORS

package info (click to toggle)
tasque 0.1.12-4
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 3,416 kB
  • ctags: 1,743
  • sloc: cs: 11,981; sh: 10,754; makefile: 147
file content (106 lines) | stat: -rw-r--r-- 4,217 bytes parent folder | download | duplicates (2)
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
TRANSLATORS

This file explains the rules to follow for translating regular expressions:

- Do not add extra spaces.
- MAKE SURE 'fuzzy' translations are reviewed, and if the translation is valid,
  remove the fuzzy line, otherwise the translation is ignored.
- Do not remove the vertical separator or pipe ('|') in strings containing
  it. Only the elements separated by this character are translated. 
  
  If the English string includes "|" but the translated string doesn't have
  more than one word, then you will have to remove "|". Also, the opposite, if
  the English string doesn't include "|" but the translated string is translated 
  to more than one word, then include "|" to separate them. For example,
  in Spanish:

  "next" would be translated to "siguiente|proxima|próxima"

  If you understand Spanish, you will notice that "proxima" is misspelled, the
  idea here is to support spelling errors (that make sense). In this case we
  are ignoring the 'ó' to allow the spelling error. 
  As a recommendation include the translations that would make sense.

TRANSLATABLE EXPRESSIONS

The following table shows the tokens and the meaning of them.

--------------------------------------------------------------------------------
| Token | English words           | Description                | Translatable? |
--------------------------------------------------------------------------------
| M     | "Jan|January|Feb|..."   | Short and long months.     | No            |
| D     | "Sun|Sunday|Mon|..."    | Short and long weekdays.   | No            |
| A     | "d/m/y|d-m-y"           | Date separated             | No            |
| T     | "today", "tomorrow"     | Same.                      | Yes           |
| O     | "1st,2nd,3rd,11th,.."   | Ordinal number             | No            |
| N     | "1,2,3,11,.."           | Cardinal number.           | No            |
--------------------------------------------------------------------------------
| u     | "due|due by|due before" | Same                       | Yes           |
| d     | "day|days"              | Same                       | Yes           |
| w     | "week|weeks"            | Same                       | Yes           |
| m     | "month|months"          | Same                       | Yes           |
| y     | "year|years"            | Same                       | Yes           |
| n     | "next"                  | Same                       | Yes           |
| o     | "on"                    | Same                       | Yes           |
| i     | "in"                    | Same                       | Yes           |
--------------------------------------------------------------------------------

NOTE: Token "O", *only* lists the valid suffixes when using ordinal numbers,
for example, in English, valid ordinal numbers are:
- 1st
- 2nd
- 3rd
- 4th
- ..

So, all valid ordinal suffixes are: "st,nd,rd,th". If we wanted to translate 
this to Spanish the translation will be:

"o"

since all ordinal numbers in Spanish use the "o" suffix to indicate a cordinal
number:

- 1o
- 2o
- 3o
- ...

TRANSLATING REGULAR EXPRESSIONS

Regular expressions are usually defined by several tokens, for example,
the following regular expression in English:

"u M O"

In this regular expression we are using the tokens "u" "M" and "O", so the
following tasks would be valid (See the table for reference):

"due" "April" "2nd"
"due by" "Apr" "2nd"
"due before" "Apr" "2nd"

If we want to translate this to Spanish, we will have to, first, translate
the tokens that need translation, in this case only "u" token:

u = "para|antes de|antes|antes del"

After translating the token, we will have to translate the expression.
You will have to adapt the expression: add new words or move words,
to make sure the expression matches the task.

For example in Spanish, dates are "Day Month" not "Month Day", also you have to
use the word 'de' to join the Month and the Day. The final translated regular
expression would be

"u O 'de' M"

This will match:

"antes del" "1o" de "Abril"

If you have any question, send an email to the mailing list. We will
answer all of your questions:

http://mail.gnome.org/mailman/listinfo/tasque-list