logo

FTS PRO DOCUMENTATION

Version 1.5 - February 1, 2000

MainMenu

LANGUAGE SUPPORT

FTS Pro supports the use of Language Plug-ins.

By nature, FTS Pro's Search Interface will appear in English - without the use of any Language Plug-in.

Note that the Indexer and Help will always appear in English.

If you wish to use another language, you will need to acquire the appropriate .FTL (Full Text Language) file.

An .FTL file is really just an INI file with about 21 messages translated into the appropriate language.


WHERE DO I GET THESE LANGUAGE FILES?

You can find many .FTL files in the Languages folder that ships with your FTS product.


HOW DO I USE A LANGUAGE FILE?

The FTS Pro Search Interface will appear in English by default. If you would like to use a different language, you would simply locate the proper language file (.FTL) and place that file in the same location as your .TBK files.

If you only have ONE language you wish to use, no configuration is needed. FTS Pro will sense the presence of this .FTL file and automatically use it.


HOW DO I USE MULTIPLE LANGUAGE FILES?

If you want to be able to use several .FTL files for use in a multi-language application, you can include numerous .FTL files.

Since there will be more than one .FTL file present, FTS Pro will be unable to automatically sense which of these to use, and you will need to tell FTS Pro which one to initially use. If you fail to tell FTS Pro which to use, it will use the first one it finds.

When FTS Pro loads, it will attempt to add a SEARCH menu to your menubar. However, to appear in the correct language, the language file must be located and loaded.

FTS_LANGUAGE
To tell FTS Pro which of your .FTL files to use first, the user property
FTS_Language must be set to the name of the language file. This is a book property and must be set for each book in which you want this feature to occur.

For example to use the German language file (with a filename of german.ftl) you would set:

FTS_Language of this book = "german"
[do not include the .FTL extension in the name]

Note that this can also be set with the configuration dialog.

If FTS Pro finds this file and is able to load the data, your Search menu will appear in the appropriate language (assuming you have your menu bar enabled).

If you need to switch languages, you have two options.

1.If you need the Search menu to immediately update
to the correct language, you can call this function. This
will force the menu to be removed and re-added.

get fts_LoadNewLanguage( <language> )

If you pass a
<language> value such as "German", FTS Pro
will attempt to load that language. It will also set the
FTS_Language property of your book to this new value.

If you pass
NULL, the FTS_Language property
of your book will be used to determine which file to
load.

2.If you are not using a Search menu you don't have to do
anything other than set the FTS_Language property
to the name of the new language file. The next time the
search interface is shown, it will automatically update
itself to reflect the new language setting.

If you need to switch between languages, and English is one of those languages, you MUST include the ENGLISH.FTL language file.