< Day Day Up > |
Use the following techniques to make it easier to translate your extensions into local languages.
XML String filesStore all strings in XML files in the Dreamweaver Configuration/Strings folder. If you install many related extension files, this lets you share all strings in a single XML file. If applicable, this also lets you refer to the same string from both C++ and JavaScript extensions. You could create a file called myExtensionStrings.xml. The following example shows the format of the file: <strings> <!-- errors for feature X --> <string value="There was a with X when you did Y. Try not to do Y!"/> <string value="There was another problem with X, regarding Z. Don't ever do Z!"/> </strings> Now your JavaScript files can refer to these translatable strings by calling the dw.loadString() function, as shown in the following example: function initializeUI() { ... if (problemYhasOccured) { alert(dw.loadString("featureX/subProblemY"); } } You can use slash (/) characters in your string identifiers, but do not use spaces. Using slashes, you can create a hierarchy to suit your needs, and include all the strings in a single XML file. NOTE Files that begin with cc in the Configuration/Strings folder are Contribute files. For example, the file ccSiteStrings.xml is a Contribute file. Localizable Strings with Embedded ValuesSome display strings have values embedded in them. You can use the errMsg() function to display these strings. You can find the errMsg() function, which is similar to the printf() function in C, in the string.js file in the Configuration/Shared/MM/Scripts/CMN folder. Use the placeholder characters percent sign (%) and s to indicate where values should appear in the string and then pass the string and variable names as arguments to errMsg(). For example: <string value="File %s could not be found in folder %s."/> The following example shows how the string, along with any variables to embed, is passed to the alert() function. if (fileMissing) { alert( errMsg(dw.loadString("featureX/fileNotFoundInFolder"),fileName, folderName) ); } |
< Day Day Up > |