Extended CHM PHP 語法手冊之DIY
1. Extended CHM 的主要特點
可自訂右鍵選單
php程式碼區塊以語法高亮顯示
php程式碼區塊中的函數帶有對應的函數手冊連結
更清晰的手冊介面
可以自訂手冊的外觀樣式
支援換膚功能
更詳盡的手冊內容
附帶非常實用使用者筆記
可以整合於大多數ide和編輯器
詳細資訊請造訪
>
2 . 為什麼要DIY
不知為什麼, 這麼好的東東在php 的官方網站上已經很久沒有更新了(最新的官方
版本是2003.9.6 發布的). 尤其是在php5 發布以後更是有不少內容都查不到, 所
以就只能發揚DIY 精神, 來自己製作了. ^_^
3. 預備知識
cvs 客戶端的使用.
linux 環境下的基本操作, 以及軟體的編譯與安裝.
4. 軟體需求
cvs客戶端軟體:
我們要透過php 官方網站的cvs 伺服器來取得phpdoc 的最新版本.
windows 環境下建議使用wincvs中文版
ncvs/>>
unix 陣營的作業系統一般都自備cvs 用戶端,
你可以在命令列下直接鍵入"cvs version" 來檢查cvs 是否安裝,
如果沒有安裝請從
> 中下載最新版
本的cvs 用戶端
Windows 作業系統:
需要在windows 系統中運行Microsoft Html Help Workshop 來產生chm 檔案
你也可以在linux下執行wine來模擬windows
Microsoft Html Help Workshop
微軟發布的用語產生chm 檔案的工具
Workshop>>
Linux 作業系統:
我們需要在此進行手冊和一些必備軟體套件的編譯安裝，
你也可以使用其他的unix 陣營的系統，
或乾脆用cygwin, vmware 等軟體來在Windows 下模擬一個linux 環境
PHP4.0或以上版本:
編譯和產生chm 檔案時均需要用到php 所以你需要再windows 和linux 環境下
都安裝php.
本文所使用的環境:
兩台pc, 分別裝有redhat 9 以及windows 2000 professional
5. 開始DIY
首先, 在linux 機器中
安裝OpenJada 和OpenSP
進入linux 控制台
代碼:------ -------------------------------------------------- ------------------------
$mkdir /home/phpdoc
$cd /home/phpdoc
$wget "http: //prdownloads.sourceforge.net/openjade/openjade-1.3.2.tar.gz"
$wget "http://prdownloads.sourceforge.net/openjade/OpenSP-1.5.1.tar.gz"
$tar -zxvf *.tar.gz
$cd openjade-1.3.2
$./configure
$make
$make install
$cd ../OpenSP-1.5. 1
$./configure
$make
$make install
$cd ../
-------------------- -------------------------------------------------- ----------
然後, 我們要從php 的官方cvs 伺服器取得phpdoc 的最新版本
程式碼:---------- -------------------------------------------------- --------------------
$export CVSROOT=:pserver:cvsread@cvs.php.net:/repository
$cvs -z9 checkout phpdoc
$cd phpdoc
$cvs update -dP -D"December 31, 2002 11:00pm" xsl
$cvs up -A xsl/version.xml xsl/docbook/html/chunker.xsl
-------------------------------------------------- ------------------------------
設定編譯參數
程式碼:--- -------------------------------------------------- ---------------------------
$autoconf
$./configure --with-chm=yes --with- lang=en
-------------------------------------------- ------------------------------------
這時, 要做一些小小的修正
用編輯器開啟/home/phpdoc/phpdoc/xsl/htmlhelp-db.xsl
在此檔案中搜尋"@DOCBOOKXSL_HTML@",
將其替換為"./docbook/html /chunk.xsl", 並儲存退出
然後再開啟/home/phpdoc/phpdoc/xsl/html-common.xsl
將如下程式碼加入檔案尾部一行之上, 並存檔退出
代碼:----------------------------------------- ---------------------------------------
