cvs: phpdoc /ja preface.xml /ja/appendices about.xml

fujimoto Fri Dec 21 11:11:56 2001 EDT Modified files: /phpdoc/ja preface.xml /phpdoc/ja/appendices about.xml Log: updated translation.

Index: phpdoc/ja/preface.xml diff -u phpdoc/ja/preface.xml:1.10 phpdoc/ja/preface.xml:1.11 --- phpdoc/ja/preface.xml:1.10 Wed Dec 12 15:52:10 2001 +++ phpdoc/ja/preface.xml Fri Dec 21 11:11:55 2001 @@ -1,41 +1,33 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.10 $ --> +<!-- $Revision: 1.11 $ --> <preface id="preface"> <title>序文</title> + <abstract> <simpara> - <acronym>PHP</acronym> は &quot;PHP: Hypertext Preprocessor&quot; - を意味し、HTML 埋め込み型のスクリプト言語です。 + <acronym>PHP</acronym> (&quot;PHP: Hypertext Preprocessor&quot;) + はHTML埋め込み型のオープンソースのスクリプト言語です。 PHP の多くの構文は C、Java、Perl 言語から転用したものですが、 PHP 特有の機能を実装するために独自の構文を導入しています。 PHP の目的は、Web 開発者が動的に生成されるページの作成を - 速やかに行うことができるようにすることです。PHPではさらに多くのことが - 可能です。このマニュアルを読み進めて、確かめてみて下さい。 + 速やかに行うことができるようにすることです。PHPではさらに多く + のことが可能です。 </simpara> </abstract> - <sect1 id="about"> - <title>このマニュアルについて</title> - <para> - このマニュアルはPHPには何が出来るのかといった概要や、提供される関数、 - 機能、そしてよくある問題に対する解決方法等を提供します。このマニュアルの - 主な焦点は関数のリファレンスを提供して、その関数の文法や使用方法の例を - 簡単にみつけることが出来るようにすることです。また、私たちはPHPの構成 - 要素に関する詳細な情報も提供します。 - </para> - <para> - マニュアルは様々な言語、フォーマットで提供されます。フォーマットに関する - 詳細や、どのように異なるフォーマットのマニュアルを生成しているのかについては - <link linkend="moreabout">マニュアルについての詳細</link>に記述してあります。 - そこには、慣例事項やさらなる情報へのポインタもあります。 - </para> - <para> - 様々のフォーマットの最新版のマニュアルを<ulink url="&url.php.docs;"> - &url.php.docs;</ulink>でダウンロードすることが出来ます。ダウンロード - ファイルは、その内容が変更されると自動的に更新されます。 - </para> - </sect1> + <para> + このマニュアルは関数リファレンスを中心として、言語リファレンス、PHPの + 主な機能の説明とその他の補足的な説明から成っています。 + </para> + <para> + 様々のフォーマットのマニュアルを<ulink url="&url.php.docs;"> + &url.php.docs;</ulink>でダウンロードすることが出来ます。 + ダウンロードファイルは、その内容が変更されると自動的に更新されます。 + このマニュアルがどのように作成されているか、といった詳細な + 情報は付録の<link linkend="about">マニュアルについて</link> + にあります。 + </para> </preface> Index: phpdoc/ja/appendices/about.xml diff -u phpdoc/ja/appendices/about.xml:1.2 phpdoc/ja/appendices/about.xml:1.3 --- phpdoc/ja/appendices/about.xml:1.2 Wed Dec 12 15:52:11 2001 +++ phpdoc/ja/appendices/about.xml Fri Dec 21 11:11:55 2001 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- TODO: add manual conventions section (eg. how to read @@ -9,174 +9,166 @@ add some tips about combining the versions (online- offline), and using "http://anymirror.php.net/funcname" --> - <appendix id="moreabout"> - <title>マニュアルについての詳細</title> + <appendix id="about"> + <title>マニュアルについて</title> - <sect1 id="moreabout.formats"> - <title>PHPマニュアルのフォーマット</title> + <sect1 id="about.formats"> + <title>フォーマット</title> <para> PHPのマニュアルはいくつかのフォーマットで提供されています。 大まかに言うとフォーマットには2つの種類があります。オンラインで 読むことのできるフォーマットとダウンロード可能なパッケージです。 </para> + <note> + <para> + いくつかの出版社は印刷されたマニュアルを提供しています。私たち + としてはそれらをお勧めすることは出来ません。何故ならそういった + ものはすぐに古いものなってしまいがちだからです。 + </para> + </note> <para> オンラインマニュアルは<ulink url="&url.php;">&url.php;</ulink> や、いくつかのミラーサイトで読むことができます。このタイプの フォーマットのマニュアルを快適に読むためには、一番近い場所にある - ミラーサイトを選択すると良いでしょう。オンラインマニュアルの - レイアウトは2種類のうちいずれかを選択できるので、回線速度が - 遅い場合や印刷を行いたい場合にはプリンタフレンドリーなものを - 選ぶことができます。オンラインマニュアルの主な利点は最新の - マニュアルを<link linkend="moreabout.notes">user notes</link> - 付で読むことができることと、ブラウザさえあれば他のソフトウェアを - セットアップする必要がないということです。 逆に不便な点は - 常にオンラインでいる必要があること、サーバがダウンしている - 間は使用不可能なこと、全文検索が行えない、そして全ページを網羅した - 目次が無いことです。 + ミラーサイトを選択すると良いでしょう。マニュアルはシンプルな + (プリンタフレンドリーな)HTMLフォーマットか、PHPのウェブサイト + のデザインに統合されたHTMLフォーマットのいずれかを選んでの + フォーマットで閲覧することが出来ます。 </para> <para> - PHPマニュアルをダウンロードする場合、私たちが提供する多くの - フォーマットのいずれかを選択することができます。選択肢は - OSやドキュメントを読む方法に依存します。もしこれらの異なった + オンラインマニュアルのオフラインのマニュアルに対する主な利点は + <link linkend="about.notes">ユーザノート</link>が統合されている + ことでしょう。不利な点は、当然ですがマニュアルを見るためには + 常にオンラインでいる必要があることです。 + </para> + <para> + オフラインフォーマットにはいくつかのタイプがあるので、使用している + OSや読み方にあわせて最適なものを選択してください。これらの異なった フォーマットのドキュメントをどのように生成しているかという - ことに興味があるのなら、この付録の<link linkend="moreabout.generate"> - 各種フォーマットを生成する方法</link>の項まで読み進めて下さい。 + 情報については、この付録の<link linkend="about.generate"> + 各種フォーマットを生成する方法</link>の項を読んでください。 </para> <para> テキストビューワやブラウザはどんなOSにも有るものなので、 HTMLとテキストファイルはほとんどプラットフォームを問わずに - 利用できるフォーマットです。HTMLファイルは様々なOSで - 利用できるようにいくつかの圧縮方式で提供されます。 - 一つのファイルにまとめられたHTMLファイルもしくはテキスト - ファイルは日常での利用においては理想的ではありませんが、 - 全文検索は容易です。分割されたHTMLを圧縮したバージョンには - 2000個以上のファイルが含まれるので注意して下さい。 - こうしたファイルから検索を行うにはOSの検索機能、例えば - Windowsなら検索ダイアログを、Unix系システムならgrepを - 使用します。このようなツールによる検索は快適とはいえないので - 必要なら適宜オンラインでの検索を利用して下さい。 - </para> - <para> - PDFもまたクロスプラットフォームなフォーマットです。 - このフォーマットは印刷するのに最適ですが、あまりに - 多くの資源を必要とするのでこのマニュアルの全ての部分を - 印刷するのはお勧めしません。また、マニュアルは日々更新 - されているので、印刷を行う前にもう一度よく考えてみて下さい。 - PDFを閲覧している場合には全文検索が可能です。ただ、 - PDFファイルを読むには<ulink url="&url.adobe.acrobat;">Adobe - Acrobat Reader</ulink>が必要だということに気をつけて - ください。 - </para> - <para> - PalmPilotのDOCとiSiloフォーマットは、頻繁に旅行/出張する人や - 陸や空を移動中にマニュアルをよんで勉強したい、という人に - とって理想的です。ダウンロードしたフォーマットに対応した - <ulink url="&url.palm.doc;">DOC</ulink>又は<ulink - url="&url.palm.isilo;">iSilo</ulink>リーダをインストールした - Palmを持ち歩くことができます。これはPHPを学ぶのに最適 - な方法では有りませんが、いつでもどこでも素早く情報を - 得ることができます。 - </para> - <para> - 最後に、とはいっても少し長くなりますが、Windows HTML - ヘルプバージョンのPHPマニュアルがあります。これは - 実際にはある種のHTMLパッケージです。コンパイルされたHTML - バージョン(<acronym>CHM</acronym>として知られています) - の最大の利点は、ビューワが全文検索、検索結果からの検索、 - 完全な目次、そしてブックマークの機能を提供することです。 - また、このフォーマットは主なPHPのIDEと親和性があります。 - 最も不利な点は現在のところWindows上でしか使えないことです。 - また、古いバージョンのWindowsを使用している場合、CHMに - アクセスするにはMicrosoft Internet Explorer 4.0以降が必要です。 - CHMクリエータとビューワの開発も行っているVisual Basic for - Linuxプロジェクトはまだ計画中の段階です。もしこの - プロジェクトの進行状況に興味があるなら、<ulink - url="&url.vb4linux;">sourceforge</ulink>のページを - 見て下さい。 - </para> + 利用できるフォーマットです。HTMLフォーマットは一つのHTMLファイル + もしくは章ごとに分割されたファイルのパッケージ(その結果、総数は + 数千にもなっています)の両方があります。HTMLとテキストファイルは + 圧縮されたtarアーカイブ(gzipもしくはbzip2)とZIPアーカイブで + 提供されています。 + </para> + <para> + PDF(またの名をAdobe Acrobat)もまたクロスプラットフォームな + フォーマットで、印刷するのに最適です。しかし、勢い込んで + このフォーマットをダウンロードして印刷ボタンを押す前に、 + このマニュアルは2000ページもの長さを持ち、常に更新されて + いる、ということについてよく考えてみてください。 + </para> + <note> + <para> + もしPDFファイルを閲覧するプログラムが無い場合は、<ulink + url="&url.adobe.acrobat;">Adobe Acrobat Reader</ulink>を + ダウンロードする必要があります。 + </para> + </note> + <para> + Palm互換のデバイスを持っている人にとっては、Palmドキュメントや + iSiloが理想的なフォーマットです。Palmを日々の通勤で持ち歩き、 + <ulink url="&url.palm.doc;">DOC</ulink>や<ulink + url="&url.palm.isilo;">iSilo</ulink>を使用してPHPの知識に + 磨きをかけたり、クイックリファレンスとして使用することが + できます。 + </para> + <para> + Windows上では、WindowsヘルプでWindows HTMLヘルプ版のマニュアルを + 使用すると非常に便利です。このバージョンは全文検索、完全な目次、 + そしてブックマーク機能を提供します。多くの有名なWindows上での + PHP開発環境ではこのバージョンのマニュアルを統合する機能を備えて + いて、間単にアクセスすることが出来ます。 + </para> + <note> + <para> + CHMクリエータとビューワの開発も行っているVisual Basic for + Linuxプロジェクトはまだ計画中の段階です。もしこの + プロジェクトの進行状況に興味があるなら、<ulink + url="&url.vb4linux;">sourceforge</ulink>のページを + 見て下さい。 + </para> + </note> </sect1> - <sect1 id="moreabout.notes"> + <sect1 id="about.notes"> <title>ユーザノートについて</title> <para> - ユーザノートはPHPマニュアルを読む上で重要となる箇所です。 - 中には非常に価値のある情報も含まれています。ユーザノート - システムは基本的には、個々の事例や関数や言語構造についての - 警告等を追加できるように作られています。 + ユーザノートはPHPマニュアルを作成していく上で重要な役割を + 持っています。マニュアルの読者が実例、警告そしてさらに詳しい + 説明をブラウザから提供できるようにすることで、そうした + フィードバックをマニュアルの本文に取り込むことが出来るのです。 + そして記事が本文に取り入れられるまでの間は、その内容をオンライン、 + もしくはいくつかのオフラインフォーマットで参照することが出来ます。 </para> <para> ユーザノートはPHPのサイトに表示される前に、何らかの 抑制があるわけではない、ということに注意して下さい。 - 従って、そこに書かれた内容の質については保証されません。 - </para> - <para> - もし、ユーザノートであなたの問題の解決策が見つからなかった場合は - <link linkend="moreabout.more">PHPに関する更なる情報を得るには - </link>を読むをよいでしょう。 + 従って、そこに書かれた内容、実例の質については保証 + されません(とはいえ、マニュアルの本文そのものの + 質が保証されない、ということではありません)。 </para> </sect1> - <sect1 id="moreabout.more"> + <sect1 id="about.more"> <title>PHPに関する更なる情報を得るには</title> <para> - このマニュアルは完全なプログラマーズガイドを目指している - わけではありません。もしあなたがプログラミング初心者なら - このマニュアルを読んだだけではPHPを使いこなせるようには - ならないでしょう。簡単なプログラミングを入念に説明している - 本の購入を検討したほうがいいかもしれません。こうした本の - 一覧は<ulink url="&url.php.books;">&url.php.books;</ulink> - で見つけることができます。PHPマニュアルを印刷したものを - 購入することはお勧めしません。なぜならそうしたものは - 大抵古くなっているからです。PHPマニュアルは日々更新されている - ことに気をつけてください。 - </para> - <para> - もし、あなたが格闘しているのと調度同じ問題を他の人も経験した - ことがあるはずだと考えるなら、メーリングリストを利用することも - できます。メーリングリストはテーマによって多くのグループに - 分かれています。あなたがどんなに忙しいときでも、数分で - 質問の答えが返ってくるでしょう。<ulink - url="&url.php.support;">&url.php.support;</ulink> - で、メーリングリストに加入することができます。 - またサポートページの左側のバーにあるリンクにはIRC - チャンネルがあります。 - </para> - <para> - もしメールによる議論が好きではない場合は、<ulink - url="&url.php.links;">&url.php.links;</ulink>のリンクページで - 多くのコミュニティサイトを見つけることができます。 + このマニュアルは一般的なプログラミングの解説を提供しよう + としているわけではありません。従って、もしあなたが全く初めて + プログラミングを行う、もしくはほとんど初心者である、と言う場合は + このマニュアルだけを使って、PHPのプログラミングを習得するのは + 難しいでしょう。そうした場合には初心者向けの本を探したほうが + よいかもしれません。PHP関連の書籍は<ulink + url="&url.php.books;">&url.php.books;</ulink>で見つけることが + できます。 + </para> + <para> + PHPに関する様々な側面について活発に議論しているメーリングリスト + も多数あります。もし問題にぶつかって、自分自身では解決できない + 場合はこれらのメーリングリストに参加している他の誰かの助けを + 得ることができるかもしません。メーリングリストとそのアーカイブ、 + またその他のリソースのの一覧が<ulink url="&url.php.support;"> + &url.php.support;</ulink>にあります。さらに<ulink + url="&url.php.links;">&url.php.links;</ulink>にはPHP関連の記事や + 掲示板、コードギャラリーを提供しているサイトの一覧があります。 </para> </sect1> - <sect1 id="moreabout.howtohelp"> + <sect1 id="about.howtohelp"> <title>ドキュメントの改善を手助けするには</title> <para> - もちろん、あなたはドキュメントを改善する手助けをする - ことができます。これには基本的に2つの方法があります。 + ドキュメントを改善していくには2つの方法があります。 </para> <para> もし(どの言語でかかれたものでも)マニュアルに間違いを見つけたら <ulink url="&url.php.bugs;">&url.php.bugs;</ulink>にある bug systemを使ってその問題を報告して下さい。バグの種別は - "Documentation Problem"にして下さい。こうすれば私たちは - 全てのバグに対応し、またどのように解決されたかを監視することが - できます。またフォーマットに関する問題(例えばPDF版のPHPマニュアル - が正しく表示されない等)があればこれも報告して下さい。 - 助けを呼ぶためにバグ報告を送信してシステムを乱用しないで - 下さい。このようなときは前述されているメーリングリストや - コミュニティを利用して下さい。 + "Documentation Problem"にして下さい。特定のフォーマット + でのみ起こる問題もここから送信することが出来ます。 </para> - <para> - 各ページに注釈をつけることで、マニュアルを書いた人よりも - 多くの例を読者に提供することができます。ユーザのコメントは - 非常に役立つという評判です。この注釈システムを使って - バグレポートを送信しないで下さい。注釈の詳細については、 - <link linkend="moreabout.notes">About user notes</link>の + <note> + <para> + bug systemに助けを要求することでシステムを無駄に使用しないで下さい。 + そういった場合は前述したメーリングリストやコミュニティサイトを + 利用してください。 + </para> + </note> + <para> + 各ページに注釈をつけることで、原文に実例、警告等の更なる説明を + 追加することが出来ます。とはいえ、この注釈システムを使って + バグレポートを送信しないで下さい。ユーザノートの詳細については、 + <link linkend="about.notes">About user notes</link>の 項を読んで下さい。 </para> </sect1> - <sect1 id="moreabout.generate"> + <sect1 id="about.generate"> <title>各種フォーマットを生成する方法</title> <para> このマニュアルはXMLで書かれていて、<ulink url="&url.docbook.xml;"> @@ -206,8 +198,8 @@ <acronym>PDF</acronym>、PalmPilot DOC、PalmPilot iSilo、 Windows HTML Help等を含む)様々な形式の最新のマニュアルを<ulink url="&url.php.docs;">&url.php.docs;</ulink>からダウロード - することができます。マニュアルは元となるXMLファイルが変更されると - 随時更新されます。 + することができます。マニュアルはその内容が変更されると + 自動的に更新されます。 </para> <para> このドキュメントの<acronym>XML</acronym>ソースコードのダウンロード