想讓站台被不同國家的使用者看懂,就得提供多語言版本,也就是所謂的本地化。最直覺的做法是各語言各寫一套頁面放在不同目錄,首頁再擺幾個連結。問題很明顯:公共元素與版面框架被複製成好幾份,日後修改維護一場混亂。
本文示範用 XML 存放語言字串、用 ASP 組裝頁面,靠 XPath 定位內容並動態插入 HTML 串流。
IIS 4 或 PWS(需含 ASP 功能)、MSXML 3 版。
先用你慣用的編輯器做出一個 XMLtrans.ASP 頁面,以靜態佔位文字(如 "First name")排版,等 XML 準備好之後再用變數替換。語言字串則另外存成 xmltrans.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/>
<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>
<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>
<lang>fr</lang>
<charset>Windows-1252</charset>
<langname>French</langname>
</language>
<language XML:lang="sp" engname="Spanish" langname="Español" charset="iso-8859-1">
<title>Localize ASP with XML - Spanish</title>
<firstname>Nombre</firstname>
<lastname>Apellido paterno</lastname>
<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>
<lang>sp</lang>
<charset>iso-8859-1</charset>
<langname>Spanish</langname>
</language>
</languages>
第一行是 XML 宣告,version 表示符合 XML 1.0,encoding 指示解析器使用 UTF-8。根元素 languages 之下掛多個 language 節點,每個節點帶四個屬性:XML:lang 是最關鍵的,ASP 程式靠這個兩字母代碼搜尋字串組;engname、langname 供語言選擇清單顯示;charset 則保留給後續擴充。每個語言節點裡,用有意義的自訂標籤(title、firstname、city……)承載畫面上要顯示的文字。
這裡用微軟 XML 解析器(MSXML)提供的 XPath 查詢。可以把它想成「抵達文件某位置的導航語法」,類似在命令列打檔案路徑或在瀏覽器輸入 URL。
首先建立解析器物件並關閉非同步:
set doc = Server.CreateObject("MSXML2.DOMDocument")
doc.async = False ' ASP 無法像 Win32 那樣處理事件,必須同步等待
載入語言檔,失敗就中止:
If Not doc.Load(Server.MapPath("xmltrans.XML")) Then
Response.Write "Failed to load the XML file"
Response.End
End If
指定查詢語言為 XPath:
doc.setProperty "SelectionLanguage", "XPath"
接著組出定位路徑。字串都在 languages 裡的某個 language 節點下,而我們知道要選 XML:lang 屬性為 en 的那一個:
sel = "/languages/language[@XML:lang='en']"
這段 XPath 可以類比成 SQL:
SELECT * FROM languages.language WHERE XML:lang='en'
取出第一個符合的節點:
set selectednode = doc.selectSingleNode(sel)
最後把元素名稱傳進 selectSingleNode,取其 text 屬性,也就是 <title> 與 </title> 之間的文字:
txt = selectednode.selectSingleNode("title").text
對照 ADO 的寫法,等同 txt = rs("title")。
為了讓程式碼簡潔,包一個函數:
Function getstring(instring)
Dim temp
temp = selectednode.selectSingleNode(instring).text
getstring = Server.HtmlEncode(temp) ' 轉成合法 HTML
End Function
呼叫方式:
<td>
<%=getstring("firstname")%>:
</td>
選 English 時輸出 <td>First name:</td>;選 French 時輸出 <td>Prénom:</td>。
XML 以純文字儲存,任何時候都能直接在伺服器上更新。把英文版複製一份翻譯成新語言即可。接著寫一段程式判斷檔案裡有幾種語言,產生下拉選單;使用者送出表單後,兩字母語言代碼存進 Session 變數 chosenlang。
<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:
<charset>x-sjis</charset>
然後動態寫進 meta:
<meta HTTP-EQUIV="Content-Type" content="text/Html; charset=<%=getstring("charset")%>" />
選到日文時輸出 charset=x-sjis。要注意:要看到正確內容,作業系統與瀏覽器必須支援該字元集並安裝相應字型,否則畫面上會出現問號或方框。
這套做法的價值在於:語言內容與程式邏輯彻底分離,新增語言只是加一份 XML 翻譯;而且因為是在伺服器端轉換成普通 HTML,就連舊版瀏覽器也能看到同樣的效果,不必依賴用戶端支援 XML。
實作上有兩點要補:一是 getstring 找不到節點時會丟出錯誤,建議加上 existence 檢查並回退到預設語言;二是 selectednode 是全域變數,在包含檔案或多使用者情境下容易出問題,正式環境應改成函數參數傳入。