piece network 1

26
PHPマニュアルの 読みかた TAKAGI Masahiro <[email protected]>

Upload: masahiro-takagi

Post on 08-Aug-2015

938 views

Category:

Technology


0 download

TRANSCRIPT

PHPマニュアルの読みかた

TAKAGI Masahiro <[email protected]>

自己紹介

高木正弘(たかぎまさひろ)

http://www.m-takagi.org/

http://www.ohloh.net/accounts/11450

http://ja.wikipedia.org/wiki/高木正弘

今日の内容

読んでみよう作ってみよう参加しよう

読んでみよう「マニュアル読め」とは言うものの……

読んでみよう

注意点

どこから読む?どこを読む?

裏ワザ

注意点

そのマニュアル、最新ですか?

どこから読む?

頭から最後まで全部?

どこから読む?

PHPマニュアルの総ページ数……

どこから読む?

言語リファレンス

関数リファレンス

配列や文字列などを扱う関数を押さえる

付録の「関数一覧」で検索

裏ワザ

ショートカットの活用

http://php.net/関数名

http://php.net/型名 (int,float,array, ...)

裏ワザ(続き)

その他に使用できるショートカットの一部

“<<<”, ”_”, “@”, ...

”ini”, ”htaccess”, “windows”, ...

その正体は http://cvs.php.net/viewvc.cgi/phpweb/error.php?view=markup

作ってみよう意外と簡単。マニュアルのビルド方法

PHP (バージョン5.2.3以降)

CVS

PhD (http://doc.php.net/wiki/phd)

必要なもの

PhD

PHP based Docbook renderer

外部のツールに依存しない

現在バージョン0.2.0が公開中

将来はHTML Help版やPDF版にも対応予定

手順(1)

PhDのインストール

$ pear install http://doc.php.net/phd/PhD-0.2.0.tgz

手順(2)

PHPマニュアルのソースの取得$ cvs -d:pserver:[email protected]:/repository login(パスワード:phpfi)

$ cvs -d:pserver:[email protected]:/repository checkout phpdoc-ja

2回目以降は、phpdoc-jaディレクトリの中で cvs update するだけでOK

手順(3)

マニュアルのビルド

$ cd phpdoc-ja

$ php configure.php --with-lang=ja

$ phd -d.manual.xml

参加しようPHPマニュアル翻訳プロジェクトについて

やってること

PHPマニュアル(英語版)の翻訳

英語版のマニュアルの更新内容の反映

日本語訳の間違い、おかしな日本語等の修正

メンバー

マニュアルの「序文」→「翻訳者」参照

やってみませんか?

PHPの最新情報を追いかけたい人

ぁゃιぃ日本語訳を何とかしたい人

有名になりたい人

***@php.net のメールアドレスがほしい人

必要な能力

日本語が読み書きできること

英語力は必須ではない

連絡先・参考資料

PHP-docメーリングリスト

http://ml.php.gr.jp/

PHPドキュメンテーションHOWTO

http://www.m-takagi.org/docs/php/howto/

今日お話しした内容

読んでみよう作ってみよう参加しよう

質問?

おしまいご静聴ありがとうございました。

続きは懇親会で。