XML加ASP實現網頁“本地化”

2024-09-05 20:54:56

字體：大中小

來源：轉載

供稿：網友

想讓你的站點能被來自多個國家的沖浪者看明白嗎？無疑，這就需要提供多個語言版本的頁面內容，也就是所謂的
“本地化”功能。最容易想到的方法就是分別編寫多種語言的頁面內容，然后放置到不同的目錄下，再在首頁上添加導航
到各自語言位置的鏈接。很明顯，這樣的處理方式將浪費許多包含公共元素以及設計框架的空間，而且修改、維護也很煩
瑣。有什么好方法嗎？當然，本文就介紹如何結合使用XML與ASP技術實現這個目的。

　　本文將討論如下幾個方面的內容：創建包含語言資源的XML文檔、使用ASP創建Web頁面模板、使用XPath語法和MSXML3
分析器定位XML文檔中的目標內容以及動態地在HTML流中插入語言字符串。

準備條件
　　本文討論的技術涉及到以下方面：IIS4 或者 PWS（包含ASP功能），MSXML 版本 3。

功能展示
　　本文要討論的例程是一個簡單的HTML表單，用以提交名字和地址信息。下面是在Netscape Navigator中顯示西班牙語
言的圖示：

　　采用本文論述的技術，你就可以非常簡單地通過更新一個XML文件實現為站點添加多種語言的功能。

創建包含語言資源的XML文檔
首先，使用喜愛的頁面編輯器創建一個叫做xmltrans.asp的Web頁面文件。我發現使用靜態占位符文字（比如"First
name "）設計頁面最容易。當XML準備好后，就可以使用變量替換這些靜態文字。要下載例程文件請點擊這里。
　　完成基本頁面的功能設計后，開始創建一個包含語言字符串的良好格式XML文檔。在這里，我使用純文本編輯器
Notepad編寫初始的XML語言集－英語版本。Notepad使我感覺更接近于源代碼。XML文件命名為xmltrans.xml。下面列出了
包含English、French和Spanish字符串的XML文件代碼內容：

　　<?xml version="1.0" encoding="UTF-8"?>

　　<languages>

　　 <language xml:lang="en" engname="English" langname="English" charset="Windows-1252">

　　 <title>Localize ASP with XML</title>

　　 <firstname>First name</firstname>

　　 <lastname>Last name</lastname>

　　 <prefix>Prefix</prefix>

　　 <suffix>Suffix</suffix>

　　 <address1>Address</address1>

　　 <address2>Address 2</address2>

　　 <address3>Address 3</address3>

　　 <city>City</city>

　　 <region>State/Province</region>

　　 <postalcode>Postal code</postalcode>

　　 <areacode>Area code</areacode>

　　 <telephone>Telephone number</telephone>

　　 <submit>OK</submit>

　　 <lang>en</lang>

　　 <charset>Windows-1252</charset>

　　 <langname>English</langname>

　　 </language>

　　 <language xml:lang="fr" engname="French" langname="franζais" charset="Windows-1252">

　　 <title>Localize ASP with XML - French</title>

　　 <firstname>Prénom</firstname>

　　 <lastname>Nom</lastname>

　　 <prefix>Préfixe (M., Mme, Mlle)</prefix>

　　 <suffix>Suffixe/Titre</suffix>

　　 <address1>Rue</address1>

　　 <address2/>

　　 <address3/>

　　 <city>Ville</city>

　　 <region>Région/Province</region>

　　 <postalcode>Code postal</postalcode>

　　 <areacode>Indicatif régional</areacode>

　　 <telephone>Numéro de téléphone</telephone>

　　 <submit>OK</submit>

　　 <lang>fr</lang>

　　 <charset>Windows-1252</charset>

　　 <langname>French</langname>

　　 </language>

　　 <language xml:lang="sp" engname="Spanish" langname="Espanol" charset="Windows-1252">

　　 <title>Localize ASP with XML - Spanish</title>

　　 <firstname>Nombre</firstname>

　　 <lastname>Apellido paterno</lastname>

　　 <prefix>Prefijo (Sr., Sra., Srta.)</prefix>

　　 <suffix>Sufijo o título</suffix>

　　 <address1>Línea 1 de dirección</address1>

　　 <address2/>

　　 <address3/>

　　 <city>Ciudad</city>

　　 <region>Región, estado o provincia</region>

　　 <postalcode>Código postal</postalcode>

　　 <areacode>Código de área</areacode>

　　 <telephone>Número de teléfono </telephone>

　　 <submit>OK</submit>

　　 <lang>sp</lang>

　　 <charset>iso-8859-1</charset>

　　 <langname>Spanish</langname>

　　 </language>

　　</languages>

　　xmltrans.xml文件的第一行是XML聲明。其中的version屬性告訴讀者文檔符合XML 1.0的標準，encoding屬性指示解析
器使用壓縮版本的Unicode：

　　<?xml version="1.0" encoding="UTF-8"?>

　　一個XML文檔需要一個包含其他元素的根元素。因為這里的例程是包含一些語言，所以就命名根元素為languages：

　　<languages>

　　作為集合類型，languages元素包含了一個或多個language元素：

　　<language xml:lang="en" engname="English" langname="English" charset="Windows-1252">

　　以上language標記包含4個屬性。xml:lang屬性是其中最重要的，在ASP程序中將通過這個屬性值的2字母語言代碼搜索
字符串組。其他的屬性，比如charset，可以為將來的功能擴充而用。

　　每種語言節點中，我都添加了一個元素作為變量，其中含有顯示在HTML頁面上的文字。XML允許使用有含義的名字作為
自定義標記，比如，我使用<title>元素包含HTML頁面的標題。同樣，<firstname>元素包含字符串"First name"。

　　<title>Localize ASP with XML</title>

　　<firstname>First name</firstname>

　　最后，良好格式的XML文檔包含了一整套對應于HTML頁面的字符串。下圖顯示了XML文件中的標記和English語言字符
串。注意，現在這里只討論English版本，以后可以添加更多種語言。

ASP文件代碼分析
　　現在回來看看ASP文件xmltrans.asp。在其中我們使用XML路徑語言（XPath），它可以在微軟的XML解析器（MSXML）中
執行。你可以認為XPath是抵達XML文檔一部分內容預定位置的工具，這有些類似于在命令行中輸入一個路徑以執行文件，
比如c:winntnotepad.exe，或者在瀏覽器中敲入了一個URL訪問頁面。下面研究這個ASP文件看看如何取回English語言字
符串。首先，我們實例化一個叫做MSXML2.DOMDocument的XML解析器工作對象：

　　set doc=server._

　　CreateObject _

　　("MSXML2.DOMDocument")

　　由于ASP程序不能象Win32程序一樣處理事件，所以在這里我們關閉了異步操作選項。這樣就確保了在轉向其他任務
前，腳本程序會一直等待當前事件的完成：

　　doc.async = False

　　接著使用DOMDocument對象的Load方法裝載包含字符串的XML文檔。如果轉載過程中發生了錯誤，就發出警告信息并停
止運行：

　　if not doc.Load(server._

　　mappath("xmltrans.xml")) then

　　 msg="Failed to load "

　　 msg=msg & "the XML file"

　　 Response.Write msg

　　 Response.End

　　end if

　　我們可以使用兩種方法查詢XML文檔：XSL和XPath。在這里讓解析器使用后者，傳遞屬性名字和正確數值給
setProperty方法：

　　doc.setProperty _

　　 "SelectionLanguage", "XPath"

　　然后，創建選擇XML文檔部分內容的路徑。很明顯，相關字符串位于languages元素的某個位置內，因此languages成為
路徑的最開始部分。同時我們知道字符串是被包含在一個language元素內的，但是是哪一個呢？請別忘記在前面的XML文檔
中，我們嵌入了一個叫做xml:lang的屬性，并給出了一個唯一數值“en”。這就是我們要選擇的，下面是操作它的語法：

　　sel="/languages/language"

　　sel=sel & "[@xml:lang='en']"

　　這有些不好理解，但你可以將這段XPath代碼想像為一個SQL語句，類似于取回一個記錄集的命令：

　　SELECT * FROM languages.language WHERE xml:lang='en'

　　回到現實的XPath查詢，要使用下面的代碼返回包含第一個匹配節點的節點對象：

　　set selectednode = _

　　 doc.selectSingleNode(sel)

　　最后一步是傳遞元素名字("title")給selectSingleNode方法，并要求它取回"title"節點的text屬性值。就是說，取
得包含在<title>和</title>的文字。在這里，取回的文字是"Localize ASP with XML"：

　　txt=selectednode._

　　selectSingleNode("title").text

　　與SQL命令對照，就象從ADO記錄集內部取回一個字段值，語句是：

　　txt=rs("title")

在ASP頁面中插入語言字符串
　　知道了如何從XML元素中選取文字并賦值給變量，就可以將變量值插入到HTML流中了。為了使代碼簡潔，創建一個叫做
getstring()的函數，如下：

　　function getstring(instring)

　　temp=selectednode._

　　selectSingleNode _

　　(instring).text

　　getstring= _

　　server.htmlencode(temp)

　　end function

　　getstring()函數的輸入值是元素名，元素值要從XML文檔中取回。比如，將"firstname"傳遞給getstring()，
getstring函數就選擇firstname元素并返回它的文本數值。為保險起見，在返回給調用者前，我們使用ASP的
server.htmlencode方法轉換文本為合法的HTML代碼。在ASP頁面中，調用代碼類似如下：

　　<td>

　　<%=getstring("firstname")%>:

　　</td>

　　如果選擇了XML文檔的English部分，HTML輸出結果如下：

　　<td>First name:v/td>

　　如果選擇了French，HTML輸出結果如下：

　　<td>Prénom:</td>

　　下圖顯示了French語言版本的表單：

選擇可用語言
　　XML的一大優勢就是它是以清晰的文本格式保存，我們能夠在任何時候更新Web服務器上的XML文件。而且，我們還可以
將English版本的xmltrans.xml文件在XML編輯器XML NotHPad中打開，復制一份，然后將其中文字翻譯為一種新語言。下圖
顯示了XML Notepad中的例程文件：

　　上圖中，在左邊可以執行添加、刪除以及選擇元素和屬性的操作，在右邊可以編輯相關內容。當站點需要多種語言版
本時，只需要在內容中執行粘貼操作，然后上載最新的XML文檔就可以了。

　　為了使添加的語言立即生效，要增加一個程序，用它判斷文件中不同語言的種類數量，并返回語言代碼和語言名稱。
如下面的代碼段所示，我們可以將數據格式化處理以創建一個HTML列表框。當用戶提交表單時，2字母表示的語言種類代碼
被存儲到ASP會話變量choselang中。

　　<select name="chosenlang">

　　<%

　　for i=0 to selectednodes.length - 1

　　 response.write "<option value=" & _

　　 chr(34) & _

　　 selectednodes.item(i)._

　　selectSingleNode("lang").text & chr(34)

　　 if (selectednodes.item(i)._

　　selectSingleNode("lang").text = _

　　session("chosenlang")) then

　　 response.write " selected>"

　　 else

　　 response.write ">"

　　 end if

　　 response.write selectednodes.item(i)._

　　selectSingleNode("langname").text & _

　　"</option>" & vbcrlf

　　next

　　%></select>

添加提示信息以及字符集數據
　　上面使用XML提供了HTML表單的可變語言文字顯示，接著還要考慮一些更豐富的用途。比如說，要在選擇語言時添加一
個提示信息，只需要在文字前后嵌入HTML標記<LABEL>，并從XML中提供可變內容作為title屬性值。同理，為了幫助瀏覽器
識別HTML頁面的語言種類，將字符集信息保存到XML文件中，比如：

　　<charset>x-sjis</charset>

　　然后，就可以使用ASP將字符集類型插入到HTML流中：

　　<meta HTTP-EQUIV="Content-Type" content="text/html; charset=

　　<%=getstring("charset")%>" />

　　最后的HTML代碼包括了Japanese字符集參考：

　　<meta HTTP-EQUIV="Content-Type" content="text/html; charset=x-sjis" />

　　下圖顯示了使用Japanese字符集的頁面。記住，要看到正確的內容，操作系統以及瀏覽器必須支持Unicode并安裝了相
應字符。否則，就會看到一些奇怪的文字，可能是一些問號，也可能是一些方塊符號等等。

總結
　　本文講述了如何使用XML文件保存Web頁面的語言字符串。從中我們學會了使用ASP腳本程序并借助微軟XML解析器和W3C
的XPath語言實現查詢XML文檔的功能。ASP代碼將包含字符集類型的可變文字插入到HTML流中，并形成列表框以讓用戶選擇
可用語言。本文涵蓋了許多內容，但我想這只是一個起點。雖然可以在支持XML的瀏覽器中簡單地實現這些功能，但我們已
經看到：使用服務器端腳本可以轉換XML數據為普通的HTML內容，即使是早期版本的瀏覽器，同樣能夠看到這些精彩內容。

上一篇：僅用xsl和asp實現分頁功能

下一篇：XSL中實現HTML的表格自動換行