DIY のための拡張 CHM PHP 構文マニュアル
1. 拡張 CHM の主な機能
カスタマイズ可能な右クリック メニュー
PHP コード ブロックが構文強調表示付きで表示されます
PHP コード ブロック内の関数は対応しています機能マニュアルリンク
より明確なマニュアルインターフェイス
マニュアルの外観をカスタマイズできます
スキン変更機能をサポート
より詳細なマニュアルコンテンツ
非常に実用的なユーザーノートが付属
はい に統合されていますほとんどの IDE およびエディタ
詳細については、
<
2なぜ DIY
なのかわかりませんが、このような優れた内容は php の公式 Web サイトで長い間更新されていませんでした (最新の公式
バージョンは、特にリリース後は 2003 年 9 月 6 日にリリースされました)。 of php5 今後も見つからない内容がたくさん出てきますので
DIY精神を引き継いで自分で作るしかありません^_^
3. > CVS クライアントの使用。
Linux 環境での基本操作、およびソフトウェアのコンパイルとインストール。
CVS クライアント ソフトウェア:
php 公式 Web サイトの cvs サーバー Windows 環境では最新バージョンの Wincvs を推奨します
<
コマンド ラインに直接「CVS バージョン」と入力して、CVS がインストールされているかどうかを確認できます。
インストールされていない場合は、以下からダウンロードしてください。
<
Windows オペレーティング システム:
で Microsoft Html Help Workshop を実行する必要があります。 Windows システムで chm ファイルを生成します
Linux でも実行できます Windows で wine を実行して Windows をシミュレートします
Microsoft Html Help Workshop
chm ファイルを生成するために Microsoft がリリースしたツール
<< ;Microsoft Html ヘルプ
ワークショップ>>
Linux オペレーティング システム:
ここでマニュアルと必要なソフトウェア パッケージをコンパイルしてインストールする必要があります。
他の Unix Camp システムも使用できます。 > または単に cygwin、vmware、およびその他のソフトウェアを使用して Windows 環境で Linux をシミュレートします
PHP4.0 以降:
chm ファイルをコンパイルおよび生成するときに PHP が必要となるため、Windows と Linux の両方に PHP をインストールする必要があります環境
.
この記事で使用する環境:
それぞれ redhat 9 と Windows 2000 professional がインストールされた 2 台の PC
5. DIY を開始します
まず、OpenJada と OpenSP をインストールします。 Linux マシン
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" 2002 年 12 月 31 日 11:午後 00 時" 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 を開きます
次のコードをファイルに追加します の行の最後に、保存して終了しますexit
コード:---------------------------- ------------ -------------------------------------- ---
< ;xsl:param name="chunker.output.doctype -public" select="'-//W3C//DTD HTML
4.01 Transitional//EN'"/>
------ ------------- -------------------------------------- ------------------------ ----------
次にコンパイル操作を続行します。
コード:---------- ------------- -------------------------------------- ------------------------ ----------
$make chm_xsl
------ ------------- ------------------------- ------------
コンパイルが完了したら、最新の PHP ミラー サイト リストとユーザー ノート ファイル
コードを取得する必要があります。 ---------------------- -------------------------------------------------- - -------
$cd htmlhelp
$wget "http://www.php.net/include/mirrors.inc"
$wget "http://www.php. net /backend/notes/all.bz2"
$bunzip2 all.bz2
cd ../
---------------------- -------------------------------------------------- - -------
生成されたファイルをパッケージ化し、Windows マシンに転送できます
コード: ------- -------------------------------------------------- - ---------------
tar -czvf phpdoc.tar.gz ./htmlhelp
--------------- -------------------------------------------------- - -----------
この時点で、Linux プラットフォームで実行する必要がある操作は完了です
ここで、操作は Windows 環境に転送されます
まず、先ほどのファイルを解凍します 生成された phpdoc.tar.gz
入手したバージョンをコンパイルした後に生成されたファイルの一部には、関連する関数へのリンクにエラーがあるため、
そのため、htmlhelp/ を変更する必要がありますfilter_files.php ファイル
まず、次のコードをヘッダー
PHP コードに追加します。 ------------------------ -------- -------------------------------------- ---
// 関数のリンク エラーを修正します
function fix_function_link($m) {
$fname1 = 'function.'.strto lower(str_replace('_','-',$m[1] )).'.html';
$fname2 = 'function.'.strto lower(str_replace('_','.',$m[1])).'.html'; ("html/".$fname1 )) {
return ''.$m[1].'()';
}elseif(file_exists("html/".$fname2)) {
return ' '.$m[1]. '()';
}else{
return ''.$ m[1].'()'
}
}
-------- -------- -------------------------------------- -------- -------------
次に、ファイル
PHP コードで次のコードを見つけます。------ ------ -------------------------------------------- ------ -------
// ソースファイルの内容を読み込みます
$content = join("", file( "$HTML_SRC/$ファイル名 "));
--------------------------------- ------ -------------------------------------
変更
PHP コード:-------------------------------------- -- --------------------------------------
// 内容を読み込むソースファイルの
$content = join("", file("$HTML_SRC/$filename"));
$content = str_replace("»","»",$content); >$ reg_fix = '/'.preg_quote('', "/").'(w )()'.preg_quote(' < /a>', "/").'/is';
$content = preg_replace_callback($reg_fix,'fix_function_link',$content);
$reg_fix = '/'.preg_quote(' ;a href="">', "/").'(w )()'.preg_quote('', "/").'/is ';
$content = preg_replace_callback($reg_fix,'fix_function_link',$content);
---------- ------------------------------------------------ -- ---
保存後、「htmlhelplocal_vars.php.src」の名前を
「htmlhelplocal_vars.php」に変更します。
「htmlhelplocal_vars.php」を編集し、
$HELP_WORKSHOP 変数の値を設定しますHtml Help Workshop のインストール ディレクトリに移動し、保存して終了します。
終了
php.exe が存在するディレクトリをパス環境変数に追加します。
「実行」に cmd と入力して、コンソール モードに入ります。 phpdoc.tar.gz のリリース ディレクトリを入力します
コード:-------------------------------- -----------------------------------------------
cd htmlhelp
make_chm.bat
-------------------------------------- - --------------------------------------
実行待ち 完了後、 PHP 構文マニュアルの拡張 CHM バージョンが生成されます。
htmlhelp/release ディレクトリに保存します
<
このプログラムを実行して、右クリックメニューや使用するスキンなどをマニュアルに設定します。
設定が完了したら、php_manual_en.chmをダブルクリックしてマニュアルを参照してください。