FindinSite-JS: Search engine for a Java server website   .
  search
Powered by FindinSite-JS
. Home | Installation | Indexing | Configuration | Advanced | Purchasing .
. .
  Init parameters | Look and Feel | Languages | Word highlighting | Runtime parameters | Rules | Subsets | Meta-data fields

 

findinsite-js language support


Introduction

findinsite-js automatically responds to search queries using each user's preferred language and character set - if possible. (Users set their preferred language in their browser.)

Alternatively, a user can override the preferred language setting as described below. The override language setting is stored in a cookie (for one year).

Response language

Currently, 29 response languages are supported, with English the default if the user's preferred language is not recognised.

The findinsite-js Configuration screen shows all the languages that are currently loaded.  This should be the same as the list below.  Some Western browsers may not be able to display the Asian language names correctly.

Response Character Set

findinsite-js always responds using the UTF-8 character set (charset). If any characters cannot be represented, then they are represented with HTML escape sequences.

findinsite-js uses the Java servlet engine's built-in facilities to do this job; if the servlet engine supports this functionality then most users' character sets should be supported.

Local
language name
Language name
in English
Language code Country code
български Bulgarian bg
Česky Czech cs
Dansk Danish da
Deutsch German de
Eesti keel Estonian et
Español Spanish es
ελληνικά Greek el
English English en
Français French fr
Hrvatski Croatian hr
Italiano Italian it
Magyar Hungarian hu
Latviešu valoda Latvian lv
Lietuvių kalba Lithuanian lt
Malti Maltese mt
Nederlands Dutch nl
Norsk Norwegian no
Polski Polish pl
Português Portuguese pt
Română Romanian ro
Slovenčina Slovak sk
Slovenščina Slovenian sl
Suomi Finnish fi
Svenska Swedish sv
العربية Arabic ar
ภาษาไทย Thai th
日本語 Japanese ja
简体中文 Simplified Chinese zh
繁体中文 Traditional Chinese zh TW

The table above gives the ISO Language Code and where specified, the ISO Country Code.  The two character lower case language codes are defined by ISO-639 at http://www.ics.uci.edu/pub/ietf/http/related/iso639.txt.  The two character upper case country codes are defined by ISO-3166 at http://www.chemie.fu-berlin.de/diverse/doc/ISO_3166.html.


User's Preference

findinsite-js works out which language to use by looking at a header sent by each user's browser.  The Accept-Language HTTP header has a list of the user's preferred languages, specifying a language code, a country code and a priority.

findinsite-js tries to match the language and country codes first.  Then a language code match is used.  If there is no match then English is used.

User Language Override

By default the findinsite-js output includes set language links like this in the page footer:
Language:   English Deutsch Español, etc.

If a user clicks on one of the named links, then findinsite-js will always use that language for its output. (The user's browser must have cookies enabled for this to work.) Click on the "Language" link to turn off this override.

The set language links are generated when %LANGUAGES% appears in one of the findinsite-js template files.


Adding more languages

You can add support for more languages (or change the existing languages) by setting the Additional Languages box in the Configuration screen Look and Feel section.

You need to alter or write a language file for each language.  Please contact sales/support if you want to do this.  It's not too hard - you just need a plain text editor.

Put the language file(s) in the same directory as findinsitejs.jar, eg the WEB-INF/lib/ directory. Then put a comma separated list of the language files in the Additional Languages box, eg:

/FindEnGB3.hil, /FindEl3.hil

If one of your language files specifies a language code / country code combination that already exists, then your language file will take precedence over the existing file.

findinsite-js has several language files built in to its runtime, findinsitejs.jar.  You can use an unzipper tool to find these languages files.

  All site Copyright © 1996-2011 PHD Computer Consultants Ltd, PHDCC   Privacy  

Last modified: 19 October 2009.

Valid HTML 4.01 Transitional Valid CSS!