Preparing to Translation

This step requires that you install Parallels Plesk Panel LP Builder and start a new language pack project in it.

To install LP Builder:

1. Run the lpsdk.msi installation package downloaded with this Localization Kit, and follow the Installation Wizard instructions.

   LP Builder is installed to the following location: C:\Program Files\Parallels\Plesk Panel LP Builder\.

To start a new LP project:

1. Run LPBuilder.exe located at the C:\Program Files\Parallels\Plesk Panel LP Builder\ directory.
2. Select New in the File menu.
3. Specify the LP project properties:
   • Browse for a directory where your project files must be located, this directory will nest the htdocs\ and plib\ directories.
   • Select a locale for which the LP is created from the Choose locale menu.
   • Specify the Plesk version for which the LP is created.

     Note: By default, LP Builder creates an LP project with LP sources of a particular major version of Plesk (e.g., 9.0). If you are making an LP for another version (say, 9.0.1), change the value in the Version text box.

4. Click OK.

   Your LP project is created, and you can start translating the en-US LP to a required language. Speaking about the file system, the project is located in the folder you specified, and consists of LP Builder accessory files and folders, and source files (for details, refer to the Language Pack Content section) of the en-US LP for Plesk for Windows.

Using Alternative LP Sources

LP Builder tool is updated for every major Parallels Plesk Panel version (under a major version we understand the one in format X.X, like 8.4, 8.6, 9.0 and so on) to include the LP sources of this version. So, if you use Parallels Plesk Panel 9.0.0, it is enough to use LP sources that go with LP Builder to make up a PPP 9.0.0 LP.

However, the default locale may change in minor version/update releases, say, 9.0.1, while LP Builder still brings 9.0.0 sources. To have a 9.0.1 LP which 100% matches PPP 9.0.1 user environment, you need to use LP sources from Plesk 9.0.1. To do this, you have to manually add the required sources (in our example, 9.0.1) to an LP Builder project.

To add your sources to an LP Builder project:

1. Start a new LP project for a required language as described above.
2. Take LP sources from a required Plesk instance.

   The files and folders you need are

   1. %plesk-dir%\admin\htdocs\locales\en-US\
   2. %plesk-dir%\admin\plib\locales\en-US\ excluding the devmessages_en-US.php file

      where %plesk-dir% is a Plesk installation directory

3. Empty the <lp-project-location>\htdocs\locales\lang\ folder and place there the %plesk-dir%\admin\htdocs\locales\en-US\ directory content.
4. Empty the <lp-project-location>\plib\locales\lang\ folder and place there the %plesk-dir%\admin\plib\locales\en-US\ directory content.
5. Remove the en-US language code from names of files in the <lp-project-location>\plib\locales\lang\ directory, as follows:
   1. cli_messages_en-US.php > cli_messages.php
   2. common_messages_en-US.php > common_messages.php
   3. conhelp_en-US.php > conhelp.php
   4. messages_en-US.php > messages.php
6. Save the project in LP Builder (File > Save).

That is it, you have your files added to LP project and can now translate them. Or, in case you added files already translated, you are ready to compile your LP.