book.ethna.jp は、Ethna のドキュメントを整理するプロジェクトです。 Sphinx を使って作成されています。
Macの場合
$ sudo easy_install sphinx
Linuxの場合
aptitude/yum で python-setuptools をインストールした後、
$ sudo easy_install sphinx
簡単です。 clone したディレクトリで
$ make html
するだけです。 _build/html ディレクトリに HTML が生成されるため、HTML ファイルをブラウザで確認しましょう。
元々の http://ethna.jp/old/ の内容をベースに、バージョンに沿った内容に書きなおしたりしています。
生成済み Sphinx ドキュメントは GitHub Pages でホスティングされており、 http://ethna.jp/doc に適用されます。
ドキュメントの間違いの指摘、修正、追加などは GitHub から直接 pull request を送っていただいても構いませんし、 ML で相談していただいても構いません。Pull request を送る際は、master ブランチへ直接はコミットせず、他の名前でブランチを適当に区切ってから送ってください。
ドキュメントを充実させることに協力いただけるのは大歓迎です!
ドキュメント名前は、 ドキュメントファイル名のスラッシュをアンダースコアに変換したものを使います。
PHPコードは、次のように code-block をつかうとハイライトされます
.. code-block:: php-inline
class Sample_Action_Sample extends Sample_ActionClass
{
// ...
}