36c24f4f |
1 | Translating the help files. |
2 | |
3 | I have tried to write the help files in plain english with good grammer. |
4 | Since English is not my strong point you probably can't tell, but I hope it helps. |
5 | |
6 | The help files, at this point, are devided into functional areas. |
7 | Each .hlp file represents a different functional block of how the program looks to the user. |
8 | |
9 | I put each sentance on a line of its own because I thought it might make |
10 | it easier to translate. Hopefully as SquirrelMail is more widely used, |
11 | non-english translations will be used to make other non-english translations. |
12 | You might want to keep this in mind when writing yours. Remember that these wil be used |
13 | All over the world and in many different environments so local language dialects might |
14 | confuse someone else. |
15 | |
16 | File Structure. |
17 | |
18 | All translated files should be placed under the hlp directory. |
19 | Under the hlp directory create another directory. This directory MUST be named |
20 | to the two letter standard abbreviation for the language. English is "en" and |
21 | Spanish would be "sp" for example. |
22 | |
23 | The help files are written in the following format: |
24 | <P> |
25 | <A NAME=some_name></A> |
26 | <H1>Some Head</H1> |
27 | Some text on some subject. |
28 | </P> |
29 | |
30 | <P> |
31 | <A NAME=some_name></A> |
32 | <H3>Some Head</H3> |
33 | Some text on some subject. |
34 | </P> |
35 | |
36 | This is important because the left menu is dynamically built from what is inside the .hlp files. |
37 | All <A NAME></A>, <H1></H1>, and <H3></H3> tags MUST be on a line by themselves. |
38 | No modifiers may be used for the <A> anchor tags. Modifiers other than the NAME modifier |
39 | Will result in the additional modifier's inclusion in the left menu. |
40 | Any other tags used such as <H4> will be ignored. I am currently working on making all the |
41 | headers which are already listed in the po file translate automatically. We'll see how this goes. |
42 | This will not work for files like FAQ.hlp and Basic.hlp which are not in the main program. |
43 | |
44 | At the current time no logic is in place to check if help is written on a certain subject. |
45 | |