TsiLang Components Suite
English version German version Russian version
    home           overview           features           download          order           contact us           forum

TsiLang Components Suite Quick Start Guide

Contents
Installation (Trial Version)
Installation (Registered Version)
Translating
Translating strings
Translating DBGrids

With TsiLang and the TsiLang Expert that comes with it, you can translate your project as quickly and easily as you play your favorite game.

Installation (Trial Version)top

On Windows:

  • Close all running instances of Delphi or C++ Builder.
  • Run SETUP.EXE and follow the instructions.
  • Once the installation script is completed the TsiLang Components Suite will be automatically installed into selected IDEs.

On Linux:

  • Unpack the archive: tar -xzf sicomp.tar.gz
  • From the IDE's menu select Component|Install Packages...|Add... and choose an appropriate package:
    TSiLang_K1.so - in Kylix 1,
    TSiLang_K2.so - in Kylix 2,
    TSiLang_K3D.so - in Kylix 3.
  • You may need to adjust the IDE's library path to the files location directory.

Installation (Registered Version)top

Note: If you have previously installed a trial copy of the TsiLang Components Suite, uninstall it from your PC. Make sure all its files are deleted.

VCL Edition:

  • Close all running instances of Delphi or C++ Builder.
  • Run SISETUP.EXE and follow the instructions. The installation script will install source files to destination folder and adjust library path for the selected IDEs.
  • Once installation is completed you will need to compile and install the packages into your IDE. From the IDE's menu select File|Open... and choose an appropriate package:
    TSiLang_Dn.dpk - under Delphi (n is IDE version),
    TSiLang_CBn.bpk - under C++Builder (n is IDE version),
    TsiLang_D2005.bdsproj - under Delphi 2005,
    TsiLang_D2006.bdsproj - under Borland Developer Studio 2006.
  • In the Package Editor click on Install button.

CLX Edition:

If you have not chosen the Install CLX support option when running SISETUP.EXE, then re-launch the installation and follow the instructions (make sure the Install CLX support box is checked). The extracted source files can be used on both Windows and Linux platforms.

On Windows:

  • From the IDE's menu select File|Open... and choose an appropriate package:
    TSiLang_Dn_CLX.dpk - under Delphi (n is IDE version),
    TSiLang_CBn_CLX.bpk - under C++ Builder (n is IDE version).
  • In the Package Editor click the Install button.
  • Adjust the IDE's library path to the package directory.

On Linux:

  • From the IDE's menu select File|Open... and choose an appropriate package:
    TSiLang_K1.dpk - in Kylix 1,
    TSiLang_K2.dpk - in Kylix 2,
    TSiLang_K3D.dpk - in Kylix 3.
  • In the Package Editor click the Install button.
  • Adjust the IDE's library path to the package directory.

Translatingtop

Note: The translation example below is a simplified sample and was used just for demonstration.

Second, translating your project:

  • Open a project for translating.
  • Select Tools|TsiLang Expert in your IDE's main menu. (TsiLang Expert is an powerful tool that will help you to translate your project in one-two mouse-clicks.)
TsiLang Expert

TsiLang Expert

  • Select File|Wizard in TsiLang Expert menu and click Next button on the first page of appeared Wizard.
  • Select all forms in the list and set TsiLang type for them in the combo-box at the right.
Translation Wizard. Step 1

Translation Wizard. Step 1

  • Set settings as presented on the picture below and click Next button.
Translation Wizard. Step 2

Translation Wizard. Step 1

  • After Wizard completed double-click on the form in the TsiLang Expert to open Translation Editor.
TsiLang Translation Editor

TsiLang Translation Editor

If certain components property should not change, just leave the corresponding language field empty.

  • Click File|Close in Translation Editor menu.
  • Insert a line for changing the active language into the source file. In Delphi, it will be something like this:
procedure TForm1.MenuItemGermanClick(Sender: TObject);
begin
  siLangDispatcher1.ActiveLanguage := 2;
end;

procedure TForm1.MenuItemEnglishClick(Sender: TObject);
begin
  siLangDispatcher1.ActiveLanguage := 1;
end;

Translating stringstop

Third, TsiLang Expert can analyze your source file, collect and translate strings and string constants used in your source code. Just select File|Source|With Form in TsiLang Expert's menu.

Translating DBGridstop

Fourth, for translating TDBGrids:

  • Add the necessary fields in the TDataSet fields editor.
  • Select File|Translate in TsiLang Expert's menu.
  • In the appeared Translation Editor select DisplayLabels node in the translations tree.
  • Enter the values for corresponding fields' DisplayLabel property.
  • Also you can translate grids using Collections property.
  • Click File|Close in Translation Editor menu.

And finally,

compile your project. You are ready to distribute your multilingual application and receive new sales from new regional markets!

Best Globalization Tool for Delphi
  Order now!
Click here to purchase your license. Registered version will allow to execute your applications without Delphi™ or C++Builder™ running. All translations done with trial version will be kept.
 
  Users Say
"TsiLang is absolutely the best solution I found..." Maik Kappeler, Switzerland.

"Worked seamlessly and the auto translation is a great feature! Congratulations for a great product!" Eric Deghaye, Belgium.

More testimonials...
 
  Frequently Asked Questions
Please refer to our collection of Frequently Asked Questions to find answer for possible questions.
 
  Our Forum
Discuss TsiLang issues with other users.
 
  See Also
Resource Builder- full featured resource editor
 
Embarcadero Technology Partner © 1999-2017 SiComponents® http://www.sicomponents.com. All Rights Reserved.
TsiLang®, SiComponents® and Resource Builder® are registered trademarks or trademarks of Igor Siticov.