Installation guide
Table Of Contents
- Gateway Customization Guide
- Contents
- Preface
- Introduction
- Setting Up the Gateway
- Gateway Installation Planning
- HTTP Server Configuration
- Creating a New Gateway Instance
- Gateway .conf File Configuration
- Configuring Gateway Clients
- Gateway Localization
- File Controlling Gateway Functionality
- Editing Entry Types
- Search Attributes, Filters, and Results
- Customizing Graphics and Color
- Parameters Defined in the .conf File
- Gateway Directives
- Introduction
- Context-Related Directives
- Entry-Related Directives
- DS_ENTRYBEGIN
- DS_ENTRYEND
- DS_ATTRIBUTE
- DS_OBJECTCLASS
- DS_VIEW_SWITCHER
- DS_SORTENTRIES
- DS_SEARCHDESC
- DS_POSTEDVALUE
- DS_EDITBUTTON
- DS_DELETEBUTTON
- DS_SAVEBUTTON
- DS_EDITASBUTTON
- DS_NEWPASSWORD
- DS_CONFIRM_NEWPASSWORD
- DS_OLDPASSWORD
- DS_HELPBUTTON
- DS_CLOSEBUTTON
- DS_BEGIN_ENTRYFORM
- DS_END_ENTRYFORM
- DS_EMIT_BASE_HREF
- DS_DNEDITBUTTON
- DS_BEGIN_DNSEARCHFORM
- DS_ATTRVAL_SET
- IF/ ELSE/ ELIF/ ENDIF
- Miscellaneous Directives
- CGI Usage
- Index
- List of Tables
Gateway Locales
46 Red Hat Directory Server Gateway Customization Guide • April 2005
This works around a problem with Japanese NT, which garbles environment variables that
are in UTF-8 (or any charset except
Shift_JIS). The Web server passes information to
the gateway CGI programs in environment variables, but the query string environment
variable
$QUERY_STRING is URL-encoded, so it can handle UTF-8 (from Windows' point
of view, it's ASCII).
Gateway Locales
The gateway's default language is US English.
Support for Multiple Locales
A single gateway instance supports clients in multiple locales concurrently.
Support for multiple locales is accomplished by translating documentation (including
online help), the string resource database, and the configuration and HTML template files.
A single copy of the compiled code handles all supported locales.
Locale-dependent information is stored in translated files stored in subdirectories
identifying the locale name. These editable files are stored separately from the gateway
code. For example, the German translation of
config/search.html is stored in
config/de/search.html, the French translation is stored in
config/fr/search.html, and the Japanese translation is stored in
config/ja/search.html.
Setting Up Locales for Translation
The default gateway can be configured to support locales in addition to English (the
default locale), French, German, Spanish, and Japanese. This is part of the overall
localization effort, which includes localizing all the configuration and HTML files,
including the online help and the string resource database. This is made possible by
including a pointer to the mapping table in the
dsgw-l10n.conf file, which is stored
during Directory Server installation in the
lang directory:
serverRoot/clients/dsgw/config/lang