讯息在地化-UWInfoBlog.DOC

訊息在地化 前言 此版本的訊息在地化主要針對網頁文字內容轉換而設計，以檔案目錄跟網頁為單位個別做文字整理與翻譯，一方面解決舊機制集中在一個訊息檔案過於龐大與管理不易的缺點，一方面讓開發人員也能輕易的處理網頁文字轉換問題。  方法 以一個網頁目錄為單位產生一支xml檔案，檔案命名以StringTable為開頭，然後以’^’為目錄分隔符號，並將檔案放在特定資料夾下，此資料夾於Global.asax的網站初始時設定，例如Server.MapPath(“~/App_Data/MsgTable”) + “\(LangCode)\”。舉例，/Admin/Member下所有網頁翻譯文字均放在\App_Data\MsgTable\(LangCode)\StringTable^Admin^Member.xml裡面，其資料結構如下：?xml version=1.0 ?xml version=1.0 encoding=utf-8 ? StringTable Page name=game_bf_unsupported.aspx Msg msgid=REMINDER貼心提醒/Msg /Page Page name=game_prepare.aspx Msg msgid=CAN_NOT_DETECT_GAME無法正確偵測您的遊戲安裝狀態/Msg Msg msgid=INSTRUCTION請點選[span class=HighlightText]『確認安裝』[/span]重新偵測。若未安裝，請點選[span class=HighlightText]『下載遊戲』[/span]進行安裝。/Msg Msg msgid=NO_RELATED_FILE_TO_DOWNLOAD無相關檔案可下載。/Msg Msg msgid=INSTALL_SUCCESS確認安裝成功/Msg Msg msgid=INSTALL_FAIL確認安裝失敗/Msg /Page Page name=game_start.aspx Msg msgid=LOADING載入中.../Msg Msg msgid=GOTO_SITE前往[a href=%1 target=_blank]%2[/a]/Msg /Page /StringTable Msg的inner Text文字規則除了需遵照xml規範之外，這邊也另外訂定規則，讓使用上更有彈性。1. 可以使用html標籤，但是必須將 ‘’, ‘’ 至換成 ‘[‘, ‘]’，前端程式使用時會自動轉換回, 2. 若要用 ‘[‘ 或 ‘]’ 作為內容，請用 ‘((‘ 或 ‘))’取代，前端程式使用時會自動轉換回去3. 若有內容是變數必須以程式取代，請使用% + 數字，例如： %1 %2…., 需由1開始，前端程式再自動將這些變數依序取代掉。 使用UW.LM物件，專門處理翻譯。 new此物件有5個方法，1.不傳入參數，2.將檔案虛擬路徑傳入，3.將檔案虛擬路徑及Lang Code傳入，4.傳入AutoDetectLangCode，5.傳入檔案虛擬路徑及AutoDetectLangCode。不傳入參數時，程式會自動抓取目前頁面路徑及LangCode。 此物件有1個屬性與4個public方法，使用方式後面會詳述1. LangCode: 可以new完之後再查看或設定語言碼。2. Translate(params string[] args)3. AutoTranslate(System.Web.UI.Control objControl)4. AppendStringTableJavascript(System.Web.UI.Control targetControl)5. GetJsonForJavascript() 建議此物件在 Page_PreRender下使用，最好是在 Page.IsPostBack == fasle 狀況下將文字做轉換。 // set LocalMessageUW.LM.DefaultLangCode = en;UW.LM.RootPath = Server.MapPath(~/App_Data/MsgTable/);UW.LM.AllLangCodeList = en,zh-TW,zh-CN; // set LocalMessage UW.LM.DefaultLangCode = en; UW.LM.RootPath = Server.MapPath(~/App_Data/MsgTable/); UW.LM.AllLangCodeList = en,zh-TW,zh-CN;  使用範例 1. Translate(params st