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

想讓你的網站能被來自多個國家的衝浪者看明白嗎？無疑，這就需要提供多個語言版本的頁面內容，也就是所謂的
“本地化”功能。最容易想到的方法就是分別編寫多種語言的頁面內容，然後放置到不同的目錄下，再在首頁上添加導航
到各自語言位置的連結。很明顯，這樣的處理方式將浪費許多包含公用元素以及設計架構的空間，而且修改、維護也很煩
瑣。有什麼好方法嗎？當然，本文就介紹如何結合使用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:\winnt\notepad.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內容，即使是早期版本的瀏覽器，同樣能夠看到這些精彩內
容。