more doxygen doku.
[citadel.git] / webcit / gettext.c
1 /*
2  * $Id
3  */
4 /**
5  * \defgroup LocaleHeaderParser Parse the browser http locale headers and set the NLS stuff.
6  */
7 /*@{*/
8 /** we need _GNU_SOURCE for various functions arround the NLS-Stuff */
9 #define _GNU_SOURCE
10 #include "webcit.h"
11 #include "webserver.h"
12
13 #ifdef ENABLE_NLS
14
15 #define NUM_LANGS 4 /**< how many different locales do we know? */
16 #define SEARCH_LANG 20 /**< how many langs should we parse? */
17
18 /** actual supported locales */
19 char *AvailLang[NUM_LANGS] = {
20         "C",
21         "en_US",
22         "de_DE",
23         "it_IT"
24 };
25
26 locale_t wc_locales[NUM_LANGS]; /**< here we keep the parsed stuff */
27
28 /** Keep information about one locale */
29 typedef struct _lang_pref{
30         char lang[16];          /**< the language locale string */
31         char region[16];        /**< the region locale string */
32         long priority;          /**< which priority does it have */
33         int availability;       /**< do we know it? */
34         int selectedlang;       /**< is this the selected language? */
35 } LangStruct;
36
37 /* \brief parse browser locale header 
38  * seems as most browsers just do a one after coma value even if more than 10 locales are available. Sample strings:
39  * opera: 
40  * Accept-Language: sq;q=1.0,de;q=0.9,as;q=0.8,ar;q=0.7,bn;q=0.6,zh-cn;q=0.5,kn;q=0.4,ch;q=0.3,fo;q=0.2,gn;q=0.1,ce;q=0.1,ie;q=0.1 
41  * Firefox 
42  * Accept-Language: 'de-de,en-us;q=0.7,en;q=0.3' 
43  * Accept-Language: de,en-ph;q=0.8,en-us;q=0.5,de-at;q=0.3 
44  * Accept-Language: de,en-us;q=0.9,it;q=0.9,de-de;q=0.8,en-ph;q=0.7,de-at;q=0.7,zh-cn;q=0.6,cy;q=0.5,ar-om;q=0.5,en-tt;q=0.4,xh;q=0.3,nl-be;q=0.3,cs;q=0.2,sv;q=0.1,tk;q=0.1 
45  * \param LocaleString the string from the browser http headers
46  */
47
48 void httplang_to_locale(char *LocaleString)
49 {
50         LangStruct wanted_locales[SEARCH_LANG];
51         LangStruct *ls;
52
53         int i = 0;
54         int j = 0;
55         size_t len = strlen(LocaleString);
56         long prio;
57         int av;
58         int nBest;
59         int nParts;
60         char *search = (char *) malloc(len);
61         // locale_t my_Locale;
62         // locale_t my_Empty_Locale;
63         
64         memcpy(search, LocaleString, len);
65         search[len] = '\0';
66         nParts=num_tokens(search,',');
67         for (i=0; ((i<nParts)&&(i<SEARCH_LANG)); i++)
68         {
69                         char buf[16];
70                         char sbuf[16];
71                         char lbuf[16];
72                         int blen;
73                         
74                         ls=&wanted_locales[i];
75
76                         extract_token(&buf[0],search, i,',',16);
77                         /** we are searching, if this list item has something like ;q=n*/
78                         if (num_tokens(&buf[0],'=')>1) {
79                                 int sbuflen, k;
80                                 extract_token(&sbuf[0],&buf[0], 1,'=',16);
81                                 sbuflen=strlen(&sbuf[0]);
82                                 for (k=0; k<sbuflen; k++) if (sbuf[k]=='.') sbuf[k]='0';
83                                 ls->priority=atol(&sbuf[0]);
84                         }
85                         else {
86                                 ls->priority=1000;
87                         }
88                         /** get the locale part */
89                         extract_token(&sbuf[0],&buf[0],0,';',16);
90                         /** get the lang part, which should be allways there */
91                         extract_token(&ls->lang[0],&sbuf[0],0,'-',16);
92                         /** get the area code if any. */
93                         if (num_tokens(&sbuf[0],'-')>1) {
94                                 extract_token(&ls->region[0],&sbuf[0],1,'-',16);
95                         }
96                         else { /** no ara code? use lang code */
97                                 blen=strlen(&ls->lang[0]);
98                                 memcpy(&ls->region[0], ls->lang,blen);
99                                 ls->region[blen]='\0';
100                         } /** area codes are uppercase */
101                         blen=strlen(&ls->region[0]);
102                         for (j=0; j<blen; j++)
103                                 {
104                                         int chars=toupper(ls->region[j]);
105                                         ls->region[j]=(char)chars;/** \todo ?! */
106                                 }
107                         sprintf(&lbuf[0],"%s_%s",&ls->lang[0],&ls->region[0]);
108                         
109                         /** check if we have this lang */
110                         ls->availability=1;
111                         ls->selectedlang=-1;
112                         for (j=0; j<NUM_LANGS; j++) {
113                                 int result;
114                                 /** match against the LANG part */
115                                 result=strcasecmp(&ls->lang[0], AvailLang[j]);
116                                 if ((result<0)&&(result<ls->availability)){
117                                         ls->availability=result;
118                                         ls->selectedlang=j;
119                                 }
120                                 /** match against lang and locale */
121                                 if (0==strcasecmp(&lbuf[0], AvailLang[j])){
122                                         ls->availability=0;
123                                         ls->selectedlang=j;
124                                         j=NUM_LANGS;
125                                 }
126                         }
127         }
128         
129         prio=0;
130         av=-1000;
131         nBest=-1;
132         for (i=0; ((i<nParts)&&(i<SEARCH_LANG)); i++)
133                 {
134                         ls=&wanted_locales[i];
135                         if ((ls->availability<=0)&& 
136                                 (av<ls->availability)&&
137                                 (prio<ls->priority)&&
138                                 (ls->selectedlang!=-1)){
139                                 nBest=ls->selectedlang;
140                                 av=ls->availability;
141                                 prio=ls->priority;
142                         }
143                 }
144         if (nBest==-1) /** fall back to C */
145                 nBest=0;
146         WC->selected_language=nBest;
147         lprintf(9, "language found: %s\n", AvailLang[WC->selected_language]);
148         //      set_selected_language(selected_locale);
149 }
150
151 /* TODO: we skip the language weightening so far. */
152 /* Accept-Language: 'de-de,en-us;q=0.7,en;q=0.3' */
153 /* Accept-Language: de,en-ph;q=0.8,en-us;q=0.5,de-at;q=0.3 */
154 //void httplang_to_locale(char *LocaleString)
155 //{
156 //      char selected_locale[16];
157 //      int i, j;
158 //      char lang[64];
159 //      int num_accept = 0;
160 //
161 //      lprintf(9, "languageAccept: %s\n", LocaleString);
162 //
163 //      strcpy(selected_locale, "C");
164 //      num_accept = num_tokens(LocaleString, ',');
165 //
166 //      for (i=num_accept-1; i>=0; --i) {
167 //              extract_token(lang, LocaleString, i, ',', sizeof lang);
168 //
169 //              /* Strip out the weights; we don't use them.  Also convert
170 //               * hyphens to underscores.
171 //               */
172 //              for (j=0; j<strlen(lang); ++j) {
173 //                      if (lang[j] == '-') lang[j] = '_';
174 //                      if (lang[j] == ';') lang[j] = 0;
175 //              }
176 //
177 //              for (j=0; j<NUM_LANGS; ++j) {
178 //                      if (!strncasecmp(lang, AvailLang[j], strlen(lang))) {
179 //                              strcpy(selected_locale, AvailLang[j]);
180 //                      }
181 //              }
182 //      }
183 //
184 //      lprintf(9, "language found: %s\n", selected_locale);
185 //      set_selected_language(selected_locale);
186 //}
187
188
189 /**
190  * \brief show the language chooser on the login dialog
191  * depending on the browser locale change the sequence of the 
192  * language chooser.
193  */
194 void offer_languages(void) {
195         int i;
196
197         wprintf("<select name=\"language\" size=\"1\">\n");
198
199         for (i=0; i < NUM_LANGS; ++i) {
200                 wprintf("<option %s value=%s>%s</option>\n",
201                         ((WC->selected_language == i) ? "selected" : ""),
202                         AvailLang[i],
203                         AvailLang[i]
204                 );
205         }
206
207         wprintf("</select>\n");
208 }
209
210 /**
211  * \brief Set the selected language for this session.
212  * \param lang the locale to set.
213  */
214 void set_selected_language(char *lang) {
215         int i;
216
217         for (i=0; i<NUM_LANGS; ++i) {
218                 if (!strcasecmp(lang, AvailLang[i])) {
219                         WC->selected_language = i;
220                 }
221         }
222 }
223
224 /**
225  * \brief Activate the selected language for this session.
226  */
227 void go_selected_language(void) {
228         if (WC->selected_language < 0) return;
229         uselocale(wc_locales[WC->selected_language]);   /** switch locales */
230         textdomain(textdomain(NULL));                   /** clear the cache */
231 }
232
233 /**
234  * \brief Deactivate the selected language for this session.
235  */
236 void stop_selected_language(void) {
237         uselocale(LC_GLOBAL_LOCALE);                    /** switch locales */
238         textdomain(textdomain(NULL));                   /** clear the cache */
239 }
240
241
242 /**
243  * \brief Create a locale_t for each available language
244  */
245 void initialize_locales(void) {
246         int i;
247         locale_t Empty_Locale;
248         char buf[32];
249
250         /* create default locale */
251         Empty_Locale = newlocale(LC_ALL_MASK, NULL, NULL);
252
253         for (i = 0; i < NUM_LANGS; ++i) {
254                 sprintf(buf, "%s.UTF8", AvailLang[i]);
255                 wc_locales[i] = newlocale(LC_MESSAGES_MASK /* |LC_TIME_MASK FIXME */ ,
256                         buf,
257                         Empty_Locale
258                 );
259         }
260 }
261
262
263 #else   /* ENABLE_NLS */
264 /** \brief dummy for non NLS enabled systems */
265 void offer_languages(void) {
266         wprintf("English (US)");
267 }
268
269 /** \brief dummy for non NLS enabled systems */
270 void set_selected_language(char *lang) {
271 }
272
273 /** \brief dummy for non NLS enabled systems */
274 void go_selected_language(void) {
275 }
276
277 /** \brief dummy for non NLS enabled systems */
278 void stop_selected_language(void) {
279 }
280
281 #endif  /* ENABLE_NLS */
282
283
284 /*@}*/