DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> XML學習教程 >> XML詳解
XML 加 ASP 幫網站做多語言「本地化」
編輯:XML詳解     

想讓站台被不同國家的使用者看懂,就得提供多語言版本,也就是所謂的本地化。最直覺的做法是各語言各寫一套頁面放在不同目錄,首頁再擺幾個連結。問題很明顯:公共元素與版面框架被複製成好幾份,日後修改維護一場混亂。

本文示範用 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……)承載畫面上要顯示的文字。

ASP 端怎麼取字串

這裡用微軟 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")。

把字串插入 HTML

為了讓程式碼簡潔,包一個函數:

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 是全域變數,在包含檔案或多使用者情境下容易出問題,正式環境應改成函數參數傳入。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved