急! phpdoc 文件編譯設定錯誤
| From: | Kevin Kee | Date: | Sat, 01 Feb 2003 06:52:58 +0000 |
| Subject: | 急! phpdoc 文件編譯設定錯誤 | ||
| Groups: | php.doc.tw | ||
| Request: | Send a blank email to doc-tw+get-27@lists.php.net to get a copy of this message | ||
先恭祝大家新年快樂!
不知大家有沒有發現 php.net 的中文繁體版其實使用了 ISO-8859-1 做為
charset 呢? 怪不得每次瀏覽時都要自己將瀏覽器的 charset coding 轉回 big5
才能正確顯示繁體中文。
我在嘗試將 xml 編譯成 html 時也發現同一問題。在執行 ./configure
--with-lang=tw 後,我發現 /home/xxx/phpdoc/configure 檔裏有如下一段設定:
case "$LANG" in
ja|tw|ko) ENCODING="UTF-8";;
zh_hk) ENCODING="big5";;
zh_cn) ENCODING="gb2312";;
.
.
.
*) ENCODING="ISO-8859-1";;
esac
錯誤1) 中文繁體版的代號 tw 的預設值為 UTF-8,正確應為 big5
錯誤2) 中文繁體版所使用的正確代號應該是 zh_tw, 而不是
tw,所以最後落入了
* 而其 charset 也就成了 ISO-8859-1
上述第二項錯誤在 /home/xxx/phpdoc/dsssl/phpweb.dsl 一檔中的第48行可看出:
"sendManualHeaders(ISO-8859-1','zh_tw');" newline
其結果是,所有由 php.net 傳出的 zh_tw 手冊均以 iso-8859-1 做為 charset
的 encoding.
另外一個檔 /home/xxx/phpdoc/dsssl/html-locale.dsl 的最後一行錯誤地成了:
'(("META" ("HTTP-EQUIV" "Content-type") ("CONTENT"
"text/html;
charset=iso-8859-1"))))
結果是,所有編譯出來的 html 檔的 <head>部份的 content-type META tag 就變
成這樣:
<meta HTTP-EQUIV="Content-type" CONTENT="text/html; charset=ISO-8859-1">
以上錯誤不但令 charset
設定錯誤,更重要的是,就連一些已翻譯好的文件也無
法正確編譯出來。如 tw/preface.xml 一檔 (由 Gregory 更新)已翻譯好,但
php.net 的和我編譯出來的手冊卻是英文版的。可是,一旦將 /dsssl/ 中的上述
兩個檔案中的 iso-8859-1 改成 big5 後,此檔的中文版就出來了!
現在我們要做的就是連絡編寫 phpdoc
編譯腳本的負責人,更改上述錯誤,否則大
家再努力翻譯也沒人可以享用已翻譯好的手冊。問題問題...該找誰?
Kevin