2月 23, 2006 9

php マニュアル(chm版) 文字化け解消方法

By in PHP

皆様は、phpオフィシャルサイトから、Windowsヘルプ形式のchm版のマニュアルをダウンロードしたことはありますでしょうか？
多分一度でも使ったことのある方は、非常に便利だ！って思っている方が多いと思います。

ただ、それでも実は 1 点大きな欠点があります。もちろん使用されたことのある方は知っているかと思いますが、ダウンロードしたままだと、マニュアル内のキーワード(マニュアルに含まれるキーワードをインクリメンタルサーチが出来る部分)が、文字化けしているんです。

実は結構悩んでいて、ただそのために随分古い文字化けの無いバージョンを使用していたのですが、解消する方法がわかったのでメモ残しておきます。

【方法】
ダウンロードした chm ファイルを、自分の PC 上で再コンパイルする。
【必要なツール】
【手順】
  1. KeyTool を起動
  2. メニューバー [Tools] → [Decompile] から、chm ファイルを自分の好きなフォルダに decompile (元のファイルに解凍?ってイメージに近い) する。
  3. そうすると、php_manual_ja.hhc、php_manual_ja.hhk、php_manual_ja.hhp、ja というフォルダ(中に数千の、.html) が作成されます。
  4. 今度は、HTML Help Workshop を起動。
  5. メニューバー [File] → [Compile] → [さきほどの php_manual_ja.hhp] を選択。
  6. Compile(数千の html ファイルをまとめ、chm ファイルを生成) が始まるので、しばらく待つ。
  7. 完了! キーワードの文字化けが解消した chm マニュアルが完成します。

オフィシャルの方は、何故うまくいってないかは想像でしか判断出来ませんが、自分で再コンパイルしてでも、キーワード検索は利用出来たほうが良いです(キッパリ)。

(おまけ)
でも、chm ファイルも便利ですが、つい先日のはてな勉強会で知った、
http://api.rails2u.com/
のインターフェイスのほうがさらに今風でかっこいいよなーと思います。

9 Responses to “php マニュアル(chm版) 文字化け解消方法”

  1. ポポロ より:
    2月 15, 2007 10:24 am

    大変参考になりました。
    本当にありがとうございます。私は英語が苦手なPGです。英語のManualは苦手です。

    一部エラーが出ました。今後の参考にしていただければ幸いです。
    HHC5003: Error: Compilation failed while compiling fancy-index.html.

    The following files were not compiled:
    fancy-index.html

  2. plastik より:
    3月 9, 2007 8:20 pm

    ポポロさん

    はじめまして。返事遅くなってしまって申し訳ございませんでした。
    私も久々にhtml作成し直してみましたが、確かにエラー表示されてますね。
    でも、エラーは表示されていますが、同時に文字化けされていないマニュアルも作成されているはずです。(.hhpファイルと同じディレクトリに→php_manual_ja.chmが出来ているはず)

    確かに気持ちは悪いですが、マニュアル生成自体が目的なので、ここは気にせず進んでしまうのが吉かと思います。

  3. ふらっと より:
    1月 19, 2008 5:48 pm

    PHP/MySQL日本語文字化け解消済みchmマニュアル配布…

    PHPやMySQLのリファレンスマニュアルはオンラインでも公開されていますが、
    chm (Windows Help) 形式のファイルをダウンロードすれば、
    索引を使ってより高速に使うことができます。
    しかし、…

  4. 文字化けしないchmを本家で配布してくれないかなぁ… より:
    7月 31, 2008 4:09 pm

    ↑HHC5003のエラーについて

    php_manual_ja.hhpの
    [OPTIONS]で
    Default topic=fancy-index.html
    ↓
    Default topic=ja\fancy-index.html

  5. サクラエディタ Sakura Editor | 空想デザイン より:
    9月 11, 2008 10:48 am

    […] php マニュアル(chm版) 文字化け解消方法 […]

  6. HappyQuality » Blog Archive » [PHPEclipse]phpヘルプを日本語にする より:
    10月 23, 2008 4:25 pm

    […] blog.plastik.jp » php マニュアル(chm版) 文字化け解消方法 […]

  7. 空想デザイン » Blog Archive » サクラエディタ Sakura Editor より:
    12月 27, 2008 4:03 pm

    […] php マニュアル(chm版) 文字化け解消方法 […]

  8. 通りすがり より:
    1月 13, 2009 11:44 pm

    ググって辿りつきました。
    上記の方法でphp_manual_ja.chm(Size: 9230Kb　Date: 13 Jan 2009)の
    文字化けが解消できなかったので、
    自分が行った対処法を書かせていただきます。

    上記の１～３まで実行
    php_manual_ja.hhc
    php_manual_ja.hhk
    php_manual_ja.hhp
    res(フォルダ）
    が文字コードUTF-8Nで作成されるので、
    .hhcと.hhkと.hhpを文字コードを変更して保存できるエディタで開きSHIFT-JISで上書き保存。
    resフォルダ配下の.htmlを全て文字コードUTF-8で上書き保存。
    あとは上記の４～実行すれば文字化けは解消されてました。たぶん。。。
    （全てチェックをした訳ではないので）

    なにぶん素人なので、これより簡単な方法があるのかもしれません。
    まぁ自分のような方の参考にでもなれば幸いです。

  9. サクラエディタ Sakura Editor より:
    7月 7, 2013 8:27 pm

    […] php マニュアル(chm版) 文字化け解消方法 […]

Leave a Reply