これを Mac に入れて、オフラインでも（飛行機の中でも）見れるようにしてみた。

$ mkdir CakeDoc
↑ ディレクトリ名は何でもOK

$ cd CakeDoc
$ git clone https://github.com/cakephp/docs.git .
$ sudo easy_install sphinx
$ sudo easy_install sphinxcontrib-phpdomain
$ make html

ここまですると、 CakeDoc の中に build/html というディレクトリが出来ていて、そこに en, ja などなど マニュアルの HTMLファイルができている。

特定のサーバにSSH接続をする際、VPNを経由しないと接続できないような制限をもうけられていることがあった。

MacのVPN接続設定のオプションで、「すべてのトラフィックをVPN経由で送信」にチェックを入れておかないと、サーバにアクセスできなかった。が、これではVPNを経由する必要のないデータまでVPNを経由するようになってしまう。

サーバに接続する場合にのみ、VPNを経由するような設定をした。

参考にしたのは、こちら

• VPN(PPTP)接続時に自動でrouteを実行させたい。
• MacでPPTP（VPN）接続しつつ、通常の接続も行えるようにする方法

sudo vi /etc/ppp/ip-up

以下のように編集し保存。

#!/bin/sh
 
if [ "$4" = "YYY.YYY.YYY.YYY" ]; then
    /sbin/route add -net XXX.XXX.XXX.XX1 ZZZ.ZZZ.ZZZ.ZZZ
    /sbin/route add -net XXX.XXX.XXX.XX2 ZZZ.ZZZ.ZZZ.ZZZ
    /sbin/route add -net XXX.XXX.XXX.XX3 ZZZ.ZZZ.ZZZ.ZZZ
    /sbin/route add -net XXX.XXX.XXX.XX4 ZZZ.ZZZ.ZZZ.ZZZ
fi

XXX.XXX.XXX.XX1〜4 は、VPN経由させたいサーバのIP。
YYY.YYY.YYY.YYY は、VPN経由した際のローカルIP。
ZZZ.ZZZ.ZZZ.ZZZ は、VPN経由した際のゲートウェイのIP。
参考サイトでは、interface-name が ppp0 かどうかで分岐していたが、VPN接続先が複数あったため、VPN経由した際のローカルIPで分岐するようにした。

# 2011/05/02 追記
# VPN経由した際のローカルIPが固定でなかったので、条件部分を書き換え
if [[ ! -z `echo "$4" | egrep "^YYY.YYY.YYY.[0-9]+$”` ]]; then
#if [ "$4" = "YYY.YYY.YYY.YYY" ]; then （←古いこっちはコメントアウト）
/sbin/route add -net XXX.XXX.XXX.XX1 ZZZ.ZZZ.ZZZ.ZZZ
/sbin/route add -net XXX.XXX.XXX.XX2 ZZZ.ZZZ.ZZZ.ZZZ
/sbin/route add -net XXX.XXX.XXX.XX3 ZZZ.ZZZ.ZZZ.ZZZ
/sbin/route add -net XXX.XXX.XXX.XX4 ZZZ.ZZZ.ZZZ.ZZZ
fi

ファイルのパーミッションを変更

sudo chmod 744 /etc/ppp/ip-up

最後に、VPN接続設定の「すべてのトラフィックをVPN経由で送信」のチェックをはずして変更を保存適用。

設定が有効かどうかを調べるために、↓のコマンドで確認。設定した分の行が表示されればOK。（VPN接続中のみ表示される。切断すると表示されないことも合わせて確認。）

netstat -rn | grep ZZZ.ZZZ.ZZZ.ZZZ

これでVPNを接続するたびにこの設定が有効化され、特定の接続先のみVPN経由されるようになる。
ためしに確認くんを開くと、VPN経由しないIPから接続していると表示され、その状態のままサーバにVPN経由で無事SSH接続することができた。

SVNのインストール

$ sudo port install subversion

PhDのインストール

$ sudo pear channel-discover doc.php.net
$ sudo pear install doc.php.net/phd
$ sudo pear install doc.php.net/phd_php

SVNからから日本語ドキュメント関連のファイルを取得

$ svn co http://svn.php.net/repository/phpdoc/modules/doc-ja phpdoc

↑英語版のマニュアルにしたい場合は、doc-ja の部分を doc-en にしてください。

マニュアルのビルド

$ cd phpdoc
$ php doc-base/configure.php --with-lang=ja

↑英語版のマニュアルにしたい場合は、デフォルトが en なので –with-lang オプションをつけなくてOK。

$ phd -d doc-base/.manual.xml -P PHP -f xhtml

phpdocディレクトリの中に output というディレクトリが作成される。
phpdoc/output/php-chunked-xhtml/index.htmlをブラウザで開く。
完成☆

ちなみに、configure のオプションは他にもいろいろあるようです。以下のように -h でヘルプが表示されます。

$ php doc-base/configure.php -h

まずは Snow Leopard のインストールDVDから Xcode3.2 をインストール。

Xcodeのインストールが終わったら、http://www.macports.org/install.phpからSnow Leopard用の Mac OS X Package Installer をダウンロードし、インストール。

インストールが終わったら、↓のコマンドを実行。

sudo port -v selfupdate

http://framework.zend.com/manual/ja/zend.tool.framework.clitool.html
↑のマニュアルを参考にしました。

phpがインストールされていて、ZendFrameworkソースファイルを取得していることを前提に進めます。
ちなみに私はmacportsのphp5をインストールしています。
ZendFrameworkは/projects/zf/library/Zend/となるように置いています。

まず、

which php
/opt/local/bin/php

でphpバイナリがあるパスを確認します。この場合は、/opt/local/binがそうです。

cd /opt/local/bin

http://framework.zend.com/svn/framework/standard/trunk/bin/
cdコマンドで移動し、上記URLにあるzf.phpとzf.shをコピーします。
zf.shはzfとリネームします。

次にphp.iniでZendFrameworkをinclude_pathに追加します。
（既に設定してある場合は省略）
正しくinclude_pathに指定されたか、を確認します。

php -i | grep include_path
include_path => .:/projects/zf/library => .:/projects/zf/library

これでzfコマンドが使えるようになります。

wasacoは悪くないんだけれど、reply文中に@がつかないのが不便。
wasacoも夏ライオンも、もうちょいスリムになってくれるとうれしい。
WassrだけGTalk経由にして、Adiumで見ていた時もあったけれど、アイコンが出ないのが不便。

で、いろいろ探していたら、Afficheurというアプリを発見。

twitter、Wassrの他にもTumblr、jaiku、identi.ca、Jiskoにマルチポストできる。
リストも設定したサービスすべての発言をまとめてくれる。
Replyするときは、発言する先をReply元のみにセットしてくれる。
素晴らしい。

$ git push origin master
Permission denied (publickey).
fatal: The remote end hung up unexpectedly

よくよく.~/.sshの中を見ると、configというファイルができていた。
中身を見てみると、↓のようになっている。
んっ？id_dsa？？？そりゃ動くわけないわ。。。id_rsaだもん。。。

$ cat config
Host github.com
  User git
  Port 22
  Hostname github.com
  IdentityFile ~/.ssh/id_dsa
  TCPKeepAlive yes
  IdentitiesOnly yes

というわけで、「IdentityFile ~/.ssh/id_dsa」部分を「IdentityFile ~/.ssh/id_rsa」に書き換え。
ついでに、同じく~/.sshの中にあるknown_hostsというファイルから、「github.com」で始まる一行を削除。

気を取り直してgit pushすると、できた☆

[CORESERVER側で下準備]

まずはSSHでCORESERVERにログイン。
（CORESERVER管理画面でssh登録を事前にすませておく）

ssh [ユーザー名]@s[数字].coreserver.jp [ユーザー名]@s[数字].coreserver.jp's password:

パスワードを入力し、Enter。
ホームディレクトリに.sshというディレクトリを作成し、その中にauthorized_keysというファイルを作成。

$ mkdir .ssh
$ mkdir chmod 700 .ssh
$ cd .ssh
$ touch authorized_keys

[Mac側でSSH公開鍵を作成]

ターミナル上で「ssh-keygen」と打つと、「/Users/[ユーザー名]/.ssh/id_rsa」というファイルで作ってよいか聞かれる。
パスやファイル名を変更したい場合は、直接指定。
聞かれたとおりでよければ何も書かずにEnter。
パスフレーズを2回聞かれるので、入力してEnter。

$ ssh-keygen
Generating public/private rsa key pair.
Enter file in which to save the key (/Users/[ユーザー名]/.ssh/id_rsa):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:

[SSH公開鍵ファイルをMacからCORESERVERにコピー]

作成した鍵ファイルをscpコマンドでCORESERVERにコピー。
（鍵ファイルへのパスは、↑でEnter file in which to save the keyで聞かれたときのもの）

$ scp /Users/[ユーザー名]/.ssh/id_rsa.pub [ユーザー名]@s[数字].coreserver.jp:~/.ssh
[ユーザー名]@s[数字].coreserver.jp's password:
id_rsa.pub                                              100%  638     0.6KB/s   00:00

[CORESERVER側で鍵ファイルを設定]

authorized_keysファイルにid_rsa.pubの内容を追記。

$ cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys

[今後SSH接続するときは]

↓だけで、パスフレーズを利用してログインできるようになる。

$ ssh [ユーザー名]@s[数字].coreserver.jp

Screengrab!
http://www.screengrab.org/

とりあえず入れて使ってみたところ、なかなかいい感じ。
PNGとJPGを選んで保存できる。
スクロールのある画面全体や、選択した範囲だけ、ウィンドウなど、
キャプチャする範囲も選べる。

保存をする先を選択するウィンドウ上部になにやらあやしげな文字化けが発生するが、使用している分には、特に問題はない。

気に入った。

下準備 – 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を書き換えてあげればよい。