MacBookAir(MacOS10.5Leopard)に常に最新のZendFrameworkマニュアルを作成する
投稿者: lllnorikolll, カテゴリ: Mac, ZendFramework
ZendFrameworkはSubversion(以下SVN)から取得して常に最新版での動作を確認することができる。
（マニュアルの1.2. インストール参照）
このSVNリポジトリにはdocumentationディレクトリもあり、各国の言語でのマニュアルも日々更新されている。
MacBookAirはHDD容量が少なめなため、SVNから取得した最新マニュアルの日本語版のみをHTML作成したい。できればZendFramework日本語マニュアルを自分が見やすいと思うような好みのデザインにCSSで変更したい。
というわけで、翻訳の神id:m-takagiさんに色々と助けていただきながら作成してみた。
下準備 – MacPortsからautoconfとlibxsltをインストール
ZendFrameworkのマニュアルはDockBookというもので書かれているため、SVNから取得できるのはxmlファイルとテンプレートとなるデザインのみ。
これをHTMLにするにはMacにautoconfとlibxsltというものをMacPortsからインストールする。
MacPortsのインストールについては前回の記事を参照。
ターミナルを立ち上げ、以下のコマンドでautoconfとlibxsltをインストール（若干時間がかかる）
$ sudo port install autoconf
$ sudo port install libxslt
SVNから日本語マニュアルHTML作成に必要なもののみ取得
SVNからのソースの取得方法は、ここでは省略する。（取得方法については他サイトを参考に）
SVNから下記の２ディレクトリ以下のもののみチェックアウトする
- 日本語マニュアル用（http://framework.zend.com/svn/framework/standard/trunk/documentation/manual/ja/）
- 英語マニュアル用（http://framework.zend.com/svn/framework/standard/trunk/documentation/manual/en/）
なぜ英語版も必要かは後述。
チェックアウト完了後、ターミナルを起動。
作成されたjaディレクトリにcdコマンドで移動。
下記コマンドをうつ。
$ autoconf
$ ./configure
$ make
makeと打ったあと、
warning: failed to load external entity “module_specs/Zend_Dojo-View-Helpers.xml”
というワーニングがいくつか出るが、id:m-takagiさんによると、jaディレクトリにファイルが無いワーニングで、ファイルが無い場合はenディレクトリから英語版のものを利用することになっているので、問題ないとのこと。
このような部分で英語版を利用するのでenもSVNから取得していた。
warningが出た後しばらくそのまま待っていると、writing ……とファイル作成中の表示が出てja/html以下にhtmlファイルが作成される。（全ファイルを作成するまでに結構時間がかかる）
できたーーー。と感動していると、実はja/html/imagesディレクトリが無くて一部画像が表示されないので、以下2ファイルを本家マニュアルから拝借し、ja/html/imagesディレクトリを作成してgifファイルをpngファイルに変更し、保存。
- http://framework.zend.com/images/note.gif→これをnote.pngにして保存
- http://framework.zend.com/images/tip.gif→これをtip.pngにして保存
pngファイルにするのが面倒な場合は、手元にある適当な画像を置いてもOK。
ja/html/index.html
このファイルをブラウザで開くと、ZendFrameworkマニュアル日本語版が見れる。
あとはSVNをupdateするたびにコマンドでhtmlを作成しなおせばOK。
HTMLのデザインを変更するには、
ja/html/dbstyle.cssファイルでCSSを書き換えてあげればよい。
エントリ (RSS)