Specifications

Chapter 19228
translateMarkup()
Description
Performs the translation.
Arguments
docName, siteRoot, docContent
• docName is a string that contains the file:// URL for the document to be translated.
• siteRoot is a string that contains the file:// URL for the root of the site that contains the
document to be translated. If the document is outside a site, this string might be empty.
• docContent is a string that contains the contents of the document.
Returns
A string that contains the translated document or an empty string if nothing is translated.
Example
The following instance of translateMarkup() calls the C function translateASP(), which is
contained in a DLL (Windows) or a code library (Macintosh) called ASPTrans:
function translateMarkup(docName, siteRoot, docContent){
var translatedString = "";
if (docContent.length > 0){
translatedString = ASPTrans.translateASP(docName, siteRoot, ¬
docContent);
}
return translatedString;
}
For an all-JavaScript example, see “A simple attribute translator example” on page 230 or “A
simple block/tag translator example” on page 235.
liveDataTranslateMarkup function()
Availability
Dreamweaver UltraDev 1
Description
Translates documents when users are in the Live Data window. When the user chooses the
View > Live Data menu item or clicks the Refresh button, Dreamweaver calls the
liveDataTranslateMarkup() function instead of the translateMarkup() function.
Arguments
docName, siteRoot, docContent
• docName is a string that contains the file:// URL for the document to be translated.
• siteRoot is a string that contains the file:// URL for the root of the site that contains the
document to be translated. If the document is outside a site, this string might be empty.
• docContent is a string that contains the contents of the document.