Parallels Welder 8.4 User's Manual
Contents
1. E 19 Obtaining Default LP There are two ways to obtain default Plesk LP source files 1 Taking the files downloaded with this Localization Kit current version of Plesk 2 Taking LP source files from a particular Plesk instance for which you want to create an LP gt To take the LP sources from a Plesk instance 1 Upload the std 1p tar gz archive downloaded with this Localization Kit to the server where the required version of Plesk is installed and unpack the archive 2 Runthe get orig locale utility with power user privileges For example when logged in as root root localhost std get orig locale sh The utility creates directory orig locale en US in your current directory and copies the default LP s sources from Plesk directories to it 12 Creating And Installing LP Translating LP Files Once you obtained LP sources the next step is to actually modify interface and contextual help messages and online help texts Generally speaking you have two options when creating your language pack Creating a partial LP that localizes only the GUI part of the Plesk user s environment which excludes online help system Creating a complete LP that localizes the whole Plesk user s environment which includes online help system The following sub sections explain how the LP source files are organized and provide recommendations that can be useful when translating the files In this sectio2. LP arm wie cilia ESS SES ESS aie ESS KORS Mba skanse 19 Locale Codes 20 4 Preface Preface In this section About EE TE 4 Who Should Read This GIG idi eiecti ebbe EP ERI enten 4 Typographical CONVENTIONS Lungene AERE RR Fake eden 5 Feedback d 5 About This Guide This document is a guide to translating Plesk for Linux Unix interface and online help to languages other than those released by Parallels Chapter 2 Localization Overview gives an idea of localizing a software product explains such terms used in the document as ocale and language pack and focuses on the localization capabilities of Plesk in detail Chapter 3 Creating And Installing LP provides guidelines instructions and recommendations on creating a Plesk language pack and installing it to Plesk The Appendix Locale Codes lists names of the locales supported by Plesk Who Should Read This Guide This guide is intended for those willing to create custom language packs i e to translate Plesk interface and online help to languages other than officially supported by Parallels Typographical Conventions Preface Before you start using this guide it is important to understand the documentation conventions used in it The following kinds of formatting in the text identify special information 5 Formatting convention Type of Information Example On screen computer output in
3. locale names supported by Plesk refer to the Appendix Locale Codes on page 20 Note Plesk supports an arbitrary number of locales depends on the purchased Plesk license A particular locale can be represented by only one LP that is you cannot install to a Plesk for example two different en US language packs By default Plesk is shipped with only U S English language pack Parallels also releases LP s for eight additional languages which are German de DE French fr FR Spanish es ES Italian it IT Russian ru RU Japanese ja JP Simplified Chinese zh CN Traditional Chinese zh TW Localization Overview These additional language packs for the latest Plesk version are available at the Language Support page http www parallels com en products plesk lp of the Parallels official Web Site To obtain an additional LP for the previous Plesk versions browse to Previous Versions in the left menu select the required version and go to the corresponding Language Support page This Plesk Localization Kit is designed to allow third party developers to create their own localizations for Plesk Note To install and use additional LPs be sure to have a Plesk license key allowing multi language support with a required number of language packs In this chapter Locale COMPONCMIS eee ect reet Det o tet cuan e b eme send 8 Language Pack COMI s sone pego Ee ette ede ENE Ei eese 9
4. to compile them to a language pack which will be easily installed to Plesk afterwards Tocompile an LP 1 Unpackthe std 1p tgz archive downloaded with this Localization Kit 2 Go to the directory std dist created during unpacking the archive on the previous step 3 In the std dist create the LP directories structure for details refer to the Language Pack Content on page 9 section assuming that std dist is an LP root Replace ocale in directories names with the name of your language pack For example if making up a language pack for Dutch spoken in The Netherlands nl NL the directories you create must be std dist plib locales n1 NL and std dist htdocs locales nl NL For the list of locale LP names supported by Plesk refer to the Locale Codes on page 20 section 4 Copy your translated LP files to the directories created on the previous step Be sure to include to the std dist directory all directories and files building an LP Even if you are making a partial LP only GUI and contextual help messages translated include the default online help files and folders Otherwise your LP will not be compiled in case when ntdocs folders are missing or no online help will be available after applying the LP in case when files in the ntdocs folders are missing 5 Creating And Installing LP 19 Change the names of LP files containing the locale name For our example with Dutch LP nl NL the foll
5. 8 Localization Overview Locale Components We distinguish the following three components in each Plesk locale 1 Interface Messages Include the following Alltextual elements of graphical user interface except for the contextual help tips namely names of the buttons icons links checkboxes lists options list items and so on All alert warning error progress and operation result messages 2 Contextual Help A set of context dependent tips shown at the bottom of navigation pane Contextual help messages say in brief either what the current Plesk page is designed for or if a mouse pointer is placed over a GUI control button icon list heading etc what the meaning of the control is 3 Online Help A Plesk user s guide which opens upon clicking Help in navigation pane and displays the content relevant to the current Plesk page bel Interface elements over Par allis Vetwazre Containers P Log sut Parallels Contents Search LI Qi om utet Aurora var Corral Pared veg Resource ard A riet noting Mars Vere gt D ret wrt tto Proceres Cortert tor New ie Cot nini Donan Names DB Setting Up Mowing Accourt for C Publish Ste ILL a te CI Deploying Databaser C Aerch geen OJ Secun E commerce Da Pesretng Access to web Sere Ste Stream et t setning Up addere Coman N Ql Hosting Personas wrt Pages or
6. C Setting Up Anonymous FIP Aen hang wet Seren Dor d 2 Coton ONG lore Configs D Serving Shes mth stene Con Ths page Gales bt d donare served by the ctm Contextual help Online help SD wd rage Misere ana comers Lunar ore Zen eos Rd co to zart forum H Cad paper Ore Que Puoi Setting Up Hosting Account for a Web Site To host web ate o the server 1 On your Mame page co i Ale Deor 2 Speofy the dimen name just you hare registered Leave the wm Check bos selected you wsh to alen users 10 access your Ste by common and hodiva URE crema tun eme com Having the wm shes precede pour comen name m l eot 6014 pou saying but wf size quens te get to your ote no matter what ther type in Der Browsers mm pour praem com a i ro domas com m l both post te pod sta if vou hare peeioutly crested domen template and peedefoad al hoyo terser and resource vinge alotmerts as o the Chapter Imolementg Mastng Plans select the requred temgolate from the Select template bor vov hare tender of IP addretons t choose from elect the regured address from the Select an EP address reo denn box Bear o rend Dat e commerce slet need decried DP address not shared among eer shes to Secure Sockets Layer data encryphon Figure 1 Plesk locale components Each of the components is defined by a particular file or set of files within a lan
7. Content for Nee Ve a Doman Names A Setting Up Hosting Account for IY a Ste D Dae Gres s BD Seog C commerce Tranecti TD Restricting Access to wee Sere D Or gerer Ste Franse wath S CI Setting Up Additional Doman N 6 Broun Personal web Page ox setting Up Anonymous C Custoraing Wed Server Error I S CI Custom ng ONS Jore www Serving Stes math External Don 1 Om your Home page cick Add Sew Doman 2 Specty the domen name juit at you have registered Leave the wwe check box selected d you with to allow users to access your ste by common and habitual URL ike van ror dom n cor 3 If you hare previously created dom n temolate and predefined all hostrg features and resource usage as desonbed in the chapter Implementna Mostra Plans select Me regured template from the Select template bor 4 W you hare a number of IP addresses to choose from select Me address from the Select an IP address drop dom bor at Soma n re wil not sers to get to your ste ombers www your wil both poet to your Manng the www cost you anything E no matter what they doman com and pour ste Bear trend thet e commerce sites need dedicated IP address ot shared among other sites to mplemest Secure Sockets Layer data emcryphon Mans for more information Implementing Hosting Plans Using Domai
8. Parallels Plesk Control Panel Localization Guide Plesk Language Packs Plesk 8 4 for Linux Unix Revision 1 0 Parallels Copyright Notice ISBN N A Parallels 660 SW 39th Street Suite 205 Renton Washington 98057 USA Phone 1 425 282 6400 Fax 1 425 282 6444 Copyright 1999 2008 Parallels Inc All rights reserved Distribution of this work or derivative of this work in any form is prohibited unless prior written permission is obtained from the copyright holder Patented technology protected by U S Patents 7 328 225 7 325 017 7 293 033 7 099 948 7 076 633 Patents pending in the U S Product and service names mentioned herein are the trademarks of their respective owners Contents Preface 4 About This Guides cuoc cn ve e a Yap ae ary Gant ae 4 Who Should Read This Guide k i ii iaaa 4 frise qn ape rae ave auct 5 ael qu 5 Localization Overview 6 locale Components Ee Pep e DE D adv Do Ede 8 Language Pack Content 9 Creating And Installing LP 11 ObtainingiBeraultiE EE 11 Translating LP Files reine DIEBUS E been satan meier been 12 Translating GUI and Contextual Help Messages 12 Translating Online Help uicit e de oie gle ette age eno en e co dee eae auno aga 16 Compiling a rM TEE 18 Installing
9. com doc mysql en Connection parameters html gt http dev mysql com doc mysql en Connection parameters html lt a gt or enclose the message with single quotes odbc mysql option gt Options that specify how MyODBC should work See a href http dev mysql com doc mysql en Connection parameters html gt ht tp dev mysql com doc mysql en Connection parameters html lt a gt Variables When translating Plesk interface and contextual help messages pay special attention to the messages containing variables Leave variables as they are do not translate them Translate the other text of a message carefully considering a variable meaning and how the variable value will be embedded to the whole message text in Plesk interface The following types of variables are used 1 PROD NAME replaces the nomination of the Plesk instance For example if we have Plesk 8 0 for Unix installed and the file messages en US php contains the string LH license you should accept gt In order to use PROD NAMI you should agree to the terms of this license the corresponding message in the Plesk GUI looks as In order to use Plesk 8 0 for Unix you should agree to the terms of this license 2 lt variable name gt variables of this type are used in messages locale php files For example if the IP address is 192 0 2 68 the client name is John Doe and the file messages en US php contains th
10. e string ui client domain properties client ip address was assigned gt The IP address ip address was assigned to client names then the corresponding message in Plesk GUI looks as The IP address 192 0 2 68 was assigned to John Doe 3 Creating And Installing LP 15 1 2 etc this type is used in messages locale php files Such variables may replace almost everything titles of Plesk objects Domain Client IP etc domain client and other Plesk objects names error messages and so on in each string the meaning of a particular variable of such type depends on the context The variable value is dynamically set by Plesk when it displays the message in its GUI The table below gives an idea of how to understand messages with these variables RN Variable Meaning Message Examples clist info gt 4 the number of 100 Domains total total items in a list 1 the Plesk object I3Clenttotal Clients total EET Databases total 6 Clients total P S A Client s name 4 Company name T Q x Clarion Inn client with login name 1 Plesk client login Client with login name lready exists Client johndoe already exists with login name 1 already exists Error Unable to update client data Client with login name johndoe already exists domain resolves to anoth 1 IP address to The domain resolves to er ip gt The domain which a domain another IP add
11. ence in content the online help systems are the same in the view of their implementation All of them are Plesk User s guides compiled of the specific files building particular structural elements of the guides Creating And Installing LP To translate an online help system you should modify the following files 1 2 numerous htm files 1 number htm e g 33243 htm 17 pages containing the online help contents displayed in the main content frame of the online help window toc htm toc lt number gt htm e g toc246135 htm pages containing different states of the Contents tree displayed in the left frame of the online help window gif files gif images used as navigation elements Top of page Prev Next Locate Page and Print dhtml search js java script implementing the mechanism of search through the guide This figure shows the structural elements of the online help system defined by the files listed above Contents Search d too d page Go to Parallels documentation forums te support Comens Search Drep of page T Cl Pret ace x Que Exec er ae eme Que al oer red template T Ci Customer You Control Panes Setting Up Hosting Account for a Web Site Setting Up H ID verg Amare Aetmsents and 10 results found A implement Pans Ver To host web site o the server To host web Items in the Standard View Wed Ste Cl Predel ring
12. guage pack Localization Overview 9 Language Pack Content All locale defining files are specifically structured within a language pack so that when the LP is being installed the locale files are correctly built in the Plesk directories structure LP files and folders are structured as shown below p1ib and ntdocs directories are located at the LP root plild serves as a container for the lower level directory y locales serves as a container for the lower level directory locale serves as a container for the files defining GUI messages and contextual help Must be named according to the locale implemented by the LP For example in case of the U S English its name is en US B conhelp contains strings that define contextual help tips locale php What contextual help text is shown when a mouse points at a particular page control Must be named according to the locale implemented by the LP For example in case of the U S English its name messages contains strings that define interface messages locale php What interface message is shown at what Plesk interface location Must be named according to the locale implemented by the LP For example in case of the U S English its name is messages en US php htdocs Serves as a container for the lower level directory x 1 Serves as a container for the lower level directory locale serves as a container for htm
13. html files defining a particular locale Must be named according to the locale implemented by the LP For example in case of the U S English its name is en US license html contains the text of Parallels End User License Agreement shown to Plesk Administrator at his first login to the control panel help contains files composing online help addressed to Plesk Administrator serves as a container for lower level directories el contains files composing online help addressed to Plesk Client 10 Localization Overview contains files composing online help addressed to Plesk Domain Administrator ml usr contains files composing online help addressed to Plesk Mail User For the detailed information on files composing online help refer to the Translating Online Help on page 12 section CHAPTER 2 Creating And Installing LP In brief to create a language pack you should do the following 1 Obtain the default en US language pack sources 2 Translate the source files content to a required language 3 Compile your resulting files to a new language pack Refer to the following sub sections for the detailed information on performing each of the steps In this chapter Obtaining Default Pa c coe tereti eite mre P itor ib tpe ie ere et 11 Translating GP chro o a tero Rete 12 Compiling EP usce trie pe e Rte D rea eter De od ete pde aen e we ae bea 18 Insialnd LP 4 250 etes fette
14. imultaneously target an international multi language audience owing to the possibility of localization Localization means a process of adapting software for a particular country or region which is generally speaking translating Plesk user s environment to a language spoken in the country or region A subset of Plesk user s environment adjusted to a particular language and culture is called ocale The Locale Components on page 8 section answers what substitutes a Plesk locale On the implementation level a particular locale is represented by the corresponding language pack LP Language pack is an installable file containing all the resource files and processing instructions necessary for installing a particular locale to an existing Plesk instance In other words LP is a packed set of files containing all the language related data that define the appearance of a particular user environment component The Language Pack Content on page 9 section focuses on what files are included to an LP how the files must be structured and shows how these files are related to locale components Plesk locale and language pack names follow the RFC 1766 standard in the format lt languagecode2 gt lt country regioncode2 gt where languagecode2 is a lower case two letter code derived from ISO 639 1 and country regioncode2 is an upper case two letter code derived from ISO 3166 For example U S English locale is named en US To see a list of
15. n Translating GUI and Contextual Help Messages sssssnseeessessesrrrrresserrrrrre 12 Translating Online Help EE 16 Translating GUI and Contextual Help Messages In this section Elles STUE oe eet ome hibet inediti due tv 12 Translation TIPS EE 13 Files Structure Files messages locale php and conhelp locale php have a simple structure presenting an associative array made up of records like localization key gt gt lt message gt where localization key uniquely identifies a Plesk GUI item message is a text in a human language which describes a particular Plesk GUI item appearing as either a GUI or a contextual help text Creating And Installing LP 13 To adjust these files so that the Plesk GUI was displayed to users in a particular language translate all string parts containing messages message leaving localization keys as they are Important Do not translate any of the localization keys Plesk uses localization keys to link a particular GUI item with the corresponding message so if you change a key in an LP file the original key will be displayed in Plesk instead of the corresponding message Translation Tips For editing locale defining PHP files we recommend using a text editor which supports highlighting syntax Using such editors not only makes the translating more comfortable than when using those displaying just plain text but also what s more important helps yo
16. n Templates domare s may war to create hx n presets referred to ses Gat w pre setting c sccounts for few domains and web sites The templates cover doman template and define hosting services and resource skotmerts n accordance rath your hoshr plan Medd yug Tem lates On your Home page dick Doman Temolstes i the Tools aouo lt 1 Om your 2 Specty Leave th uters to the wwe Having th cost you tio matte deman d see 3 If you hy preden herrer Mostra Select t 4 Wyeuh select ed drop do Bear in 1 address Secure 5 1 1 Main content frame 1 2 Contents tree 2 Contents Search tab Figure 2 Online help structural elements 3 Search frame 18 Creating And Installing LP Translation Tips For editing the files that build Plesk online help system we recommend using a WYSIWYG HTML editor which supports working with files in UTF 8 Using such editor makes the process of translation more comfortable because it lets you concentrate on modifying the help content without the necessity of separating it from the HTML syntax prevents you from modifying anything besides the help content which guarantees that the files will not be corrupted somehow Important Do not change the files encoding It must be UTF 8 Otherwise the texts you translated may be displayed incorrectly Compiling LP Once you translated the locale defining files to a required language you are ready
17. owing changes should be done messages en US php gt messages nl NL php conhelp en US php gt conhelp nl NL php Make std your current directory and run the make lp dist utility Usage make lp dist sh lt major version minor version gt locale Running the utility results in creating in the std directory an installable language pack with the name in format plesk locale major version minor version build YYMMDD HH locale install sh where build YYMMDD HH indicates the timestamp for the LP creation For our example with Dutch LP for Plesk 8 1 1 the command compiling the LP is make lp dist sh 8 2 nl NL and the resulting Dutch LP gets the name plesk locale 8 2 build070710 14 nl NL install sh Installing LP To install an LP to Plesk Upload the LP self installing file to the server with Plesk the upload directory is not important Run the file For example plesk locale 8 1 build070206 14 nl NL install sh After you receive from the system the message about successful installing of the LP the LP you created and installed can be used in Plesk it appears automatically in the list of installed language packs Server gt Interface Management gt Locales and becomes available for choosing in all Interface Preferences forms and on the Plesk login screen 20 Locale Codes Locale Codes Afrikaans South Africa Icelandic Iceland is IS Albanian Albania eg AL Indonesian Indone
18. ress 10 0 0 4 resolves to another IP resolves Please correct DNS settings address 1 Please correct DNS settings 9 Warning The domain resolves to another IP address 66 150 161 133 Please correct DNS settings unable update cl data 1 A phrase stating Unable to update client data gt Unable to update client why updating a client Client with login name data 1 account is impossible johndoe exists Q Error Unable to update client data Client with login name johndoe already exists 16 Creating And Installing LP HTML Entities Special Characters Do not translate HTML entities for example amp 1t amp gt used for defining and gt symbols Special characters for example n used for defining a new line Translating Online Help In this section Files EE ee ee 16 Translation Tips ro beer itd ead equ rae bcd esed ee ei ral cera aes rte peus 18 Files Structure Online help is presented by 4 sets of files each designed for displaying to a particular Plesk user and located at a specific folder within LP Administrator ntdocs locales lt locale gt help Client ntdocs locales lt locale gt help cl Domain Administrator ntdocs locales lt locale gt help dl usr Mail User htdocs locales lt locale gt help ml usr 4 different online help systems exist due to the difference in Plesk functionality available to each type of Plesk users In spite of this differ
19. s SV English Zimbabwe es GT 22 Locale Codes Language Country Region Faroese Faroese Faroe Islands Farsi Iran Finnish Finland French Belgium French Canada French France French Luxembourg French Monaco French Switzerland Galician Galician Georgian Georgian Georgia German Austria German Germany German Liechtenstein German Luxembourg German Switzerland Greek Greece Gujarati India Hebrew Israel Hindi India Hungarian Hungary o m m m fe w rm C ow M jm
20. sia Arabic Algeria la DZ sien Italy it IT Arabic Iraq Japanese Japan ja JP Arabic Kuwait lar KW Kannada India kn IN x N Arabic Libya ar LY Kazakh Kazakhstan Navio Morocco farm mm _ Korean Korea ko KR Arabic Qatar Kyrgyz lt A O Arabic Saudi Arabia la SA Kyrgyz Kyrgyzstan lt rz lt Arabic Lebanon FE ky Wmem Jee Albanian sg Indonesian Bee Basque Je mem Bulgarian Mongolian Mongolia mn MN Armenian Armenia hy AM Macedonian Former Yugoslav mk MK Republic of Macedonia Language Country Region Code Language Country Region Code Arabic Bahrain Italian Switzerland it CH Locale Codes 21 Language Country Region Code o Nonvegan pol Chinese Chinese Hong Kong SAR Catalan Polish Poland pl PL Chinese China Simplified zh CN Portuguese Brazil pt BR Chinese Chinese Singapore Portuguese Portugal pt PT Chinese Taiwan Traditional zh TW Chinese Croatian Punjabi India pa IN hr Punjabi Czech Czech Czech Republic DREES Dutch The Netherlands nl NL 5 a ben English Australia sk SK English Canada sl SI English Caribbean en CB Spanish English Jamaica es BO English New Zealand es CL a z dn 2 Ke 5 English Philippines es CO English South Africa es CR English Trinidad and Tobago English United Kingdom es EC English United States e
21. u detect the file corruption if you change the array syntax Note Use editor that supports editing texts in UTF 8 There is a number of recommendations that might be useful when translating these files specifically concerning PHP array syntax message variables HTML entities and special characters Important Do not change the files encoding It must be UTF 8 Otherwise the messages you ve translated may be displayed incorrectly Array syntax It is important that commas at the end of each string were left where they are Otherwise the PHP array will be corrupt and when using such language pack Plesk GUI will display pure localization keys instead of the correct messages What else can corrupt the array is mistakes in using quotes To avoid such mistakes follow the rules below 1 If a message text does not contain any quotes enclose the text with either single or double quotes 2 If a message text contains at least one single quote or apostrophe precede each quote with backslash 5 for clients gt gt address to wclient s pools or enclose the message with double quotes gt Wackl He eebe ro eeneg M s oos sr 14 Creating And Installing LP 3 If a message text contains at least one double quote precede each quote with backslash odbc mysql option gt Options that specify how MyODBC should work See a href http dev mysql
22. your command line sessions source code in XML C or other programming languages Special Bold Items you must select such as Go to the System tab menu options command buttons or items in a list Titles of chapters sections and Read the Basic Administration subsections chapter Italics Used to emphasize the The system supports the so called importance of a point to wildcard character search introduce a term or to designate a command line placeholder which is to be replaced with a real name or value Monospace The names of commands files The license file is located in the and directories http docs common license s directory Preformatted ls al files total 14470 Preformatted Bold What you type contrasted with on screen computer output cd root rpms php CAPITALS Names of keys on the keyboard SHIFT CTRL ALT KEY KEY Key combinations for which the user must press and hold down one key and then press another CTRL P ALT F4 Feedback If you have found a mistake in this guide or if you have suggestions or ideas on how to improve this guide please send your feedback using the online form at http www parallels com en support usersdoc Please include in your report the guide s title chapter and section titles and the fragment of text in which you have found an error CHAPTER 1 Localization Overview Since Plesk is a web application a single instance may s
Download Pdf Manuals
Related Search