FileHold User Interface
Internationalization - Obtaining & Translating Resource Files
FileHold’s Customer Services will deliver to resellers
a zipped-up directory structure which contains all resource files which
will have to be translated by resellers. Please contact us at localize@filehold.com
to obtain your resource files mentioning 'Resource File Request' in the
subject header. The zip file will have the following folder structure.
\NewLang
\FDA
\FOC
\Common
\WebClient
\WebCustomControls
\LibraryManager
\UserRoleManager
The resource files contained in these folders provide the default English
text strings for various web pages, ASP controls and WinForms.
All resource files are XML files which in theory could be edited using
any text editor or XML file editor. We DO NOT recommend this as it will
be an extremely error prone process. To perform translation we recommend
Microsoft Visual Studio’s resource file editor,
which comes with every version of Visual Studio including free downloadable
Visual Studio 2005 Express Editions such as:
- Visual Web Developer 2005 Express Edition - this is free to download
at http://msdn.microsoft.com/vstudio/express/downloads/default.aspx
- Visual C# 2005 Express Edition
- Visual Basic 2005 Express Edition
- Visual J# 2005 Express Edition
- SQL Server 2005 Express Edition ( It also comes with all other versions
of SQL Server 2005)
With the resource files in hand translation can begin. Complete
the following steps for translating each resource file.
- Open the resource file in Microsoft Visual Studio Resource
File Editor
- Translate all strings visible in the right hand column (Value) to
the new language (see screen shot below). One can switch to the language
specific keyboard to generate special characters.
- Renaming files to include the ISO code for the new language i.e. “fr”
for the French language. For example:
“HomeForm.aspx.resx”
should be renamed to “HomeForm.aspx.fr.resx”
“FileUpload.ascx.resx”
should be renamed to “FileUpload.ascx.fr.resx”
“MetadataPanel.resx”
should be renamed to “MetadataPanel.fr.resx”
VERY IMPORTANT NOTE:
While translating a care should be taken not to exceed the original
English text string length, which was originally provided in the Value
column, as FileHold does not provide automatic resizing of various controls,
user interface objects and forms to accommodate variable string length.
As a rule of thumb and to avoid several iterations of the translation
process cycle all new strings should be visibly slightly shorter than
the original English language equivalents.
|
