cvs: peardoc /ja/chapters contributing.xml installation.xml intro.xml

From: Date: Thu, 20 May 2004 10:00:34 +0000
Subject: cvs: peardoc /ja/chapters contributing.xml installation.xml intro.xml
Groups: php.pear.doc 
Request: Send a blank email to pear-doc+get-4049@lists.php.net to get a copy of this message
haruki Thu May 20 06:00:34 2004 EDT Modified files: /peardoc/ja/chapters contributing.xml installation.xml intro.xml Log: docinfo -> chapterinfo. change some expr.

http://cvs.php.net/diff.php/peardoc/ja/chapters/contributing.xml?r1=1.2&r2=1.3&ty=u Index: peardoc/ja/chapters/contributing.xml diff -u peardoc/ja/chapters/contributing.xml:1.2 peardoc/ja/chapters/contributing.xml:1.3 --- peardoc/ja/chapters/contributing.xml:1.2 Mon Apr 19 12:54:28 2004 +++ peardoc/ja/chapters/contributing.xml Thu May 20 06:00:34 2004 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <chapter id="contributing"> <!-- EN-Revision: 1.13 Maintainer: danielc Status: added english for doc/translate section --> - <docinfo> + <chapterinfo> <author> <firstname>Tal</firstname> <surname>Peer</surname> @@ -16,7 +16,7 @@ <surname>Convissor</surname> </author> <date>2004-04-15</date> - </docinfo> + </chapterinfo> <title>貢献</title> <simpara> 本章は、PEARに貢献するための複数の方法について説明するものです。 http://cvs.php.net/diff.php/peardoc/ja/chapters/installation.xml?r1=1.3&r2=1.4&ty=u Index: peardoc/ja/chapters/installation.xml diff -u peardoc/ja/chapters/installation.xml:1.3 peardoc/ja/chapters/installation.xml:1.4 --- peardoc/ja/chapters/installation.xml:1.3 Thu Aug 14 01:11:57 2003 +++ peardoc/ja/chapters/installation.xml Thu May 20 06:00:34 2004 @@ -1,18 +1,20 @@ <?xml version="1.0" encoding="utf-8" ?> <!-- sync: 1.8 --> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.8 Maintainer: Status: ready --> +<!-- CREDITS: --> <!-- WORK IN PROGRESS, THERE IS PROBABLY LITTLE POINT IN TRANSLATING THIS DOCUMENT YET. --> <chapter id="installation"> - <docinfo> + <chapterinfo> <author> <firstname>Martin</firstname> <surname>Jansen</surname> </author> <date>2002-02-10</date> - </docinfo> + </chapterinfo> <title>インストール</title> <simpara> 本章は、PEARからパッケージをインストールする方法について説明します。 http://cvs.php.net/diff.php/peardoc/ja/chapters/intro.xml?r1=1.4&r2=1.5&ty=u Index: peardoc/ja/chapters/intro.xml diff -u peardoc/ja/chapters/intro.xml:1.4 peardoc/ja/chapters/intro.xml:1.5 --- peardoc/ja/chapters/intro.xml:1.4 Sun Feb 8 21:49:58 2004 +++ peardoc/ja/chapters/intro.xml Thu May 20 06:00:34 2004 @@ -1,129 +1,146 @@ <?xml encoding="utf-8"?> -<!-- $Revision: 1.4 $ --> -<!-- sync: 1.3 --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.6 Maintainer: Status: ready --> +<!-- CREDITS: hirokawa, elf, haruki --> <chapter id="introduction"> - <docinfo> + <chapterinfo> <author> <firstname>Stig</firstname> <surname>Bakken</surname> </author> <date>2002-02-10</date> - </docinfo> + </chapterinfo> <title>はじめに</title> <subtitle>The PEAR Manifest</subtitle> <simpara> - PEAR は、1999/11/21 に生まれたMalin Bakkenに捧げられています。 + PEAR は、1999/11/21 に生まれた Malin Bakken に捧げられています。 </simpara> <sect1 id="about.pear"> - <title>PEARとは?</title> + <title>PEAR とは?</title> <para> - PEAR は、"PHP Extension and Application Repository"を省略したもの - で、果物(梨)と同じように発音します。PEARの目的は次のようなものです。 + PEAR は、"PHP Extension and Application Repository" を省略したもので、 + 果物(梨)と同じように発音します。PEAR の目的は,、以下を提供することにあります。 <itemizedlist> <listitem> <simpara> - PHPユーザのためのオープンソースコードの構造化されたライブラリ + PHP ユーザのためのオープンソースコードの構造化されたライブラリ </simpara> </listitem> <listitem> <simpara> - コード配布及びパッケージ管理のためのシステム + コード配布およびパッケージ管理のためのシステム </simpara> </listitem> <listitem> <simpara> - <link linkend="standards">ここで指定されている</link>PHPのコー - ド作成に関する標準スタイル + PHP のコード作成に関する標準スタイル。 + <link linkend="standards">こちらで規定されています</link> </simpara> </listitem> <listitem> <simpara> - The PHP Foundation Classes (PFC)。<link linkend="about-pfc">詳 - 細は以下を参照</link> + The PHP Foundation Classes (PFC)。 + <link linkend="about-pfc">詳細は以下を参照</link> </simpara> </listitem> <listitem> <simpara> - The PHP Extension Community Library (PECL), + The PHP Extension Community Library (PECL)。 <link linkend="about-pecl">詳細は以下を参照</link> </simpara> </listitem> <listitem> <simpara> - PHP/PEARコミュニティをサポートするためのWebサイト、メーリングリ - スト、ダウンロードミラー + PHP/PEAR コミュニティをサポートするための Web サイト、 + メーリングリスト、ダウンロードミラー </simpara> </listitem> </itemizedlist> </para> + <para> + PEAR は、<ulink url="http://pear.php.net/group/">PEAR Group</ulink> を + 管理機関とした、コミュニティーにより運営されるプロジェクトです。 + 1999 年に Stig S. Bakken によって開始され、これまでに + <ulink url="http://pear.php.net/accounts.php">たくさんの方々</ulink>が、 + 参加をしています。 + </para> + <sect2 id="about-pear-stlib"> - <title>PHPコードの構造化されたライブラリ</title> + <title>PHP コードの構造化されたライブラリ</title> <para> - PEARのコードは、「パッケージ」に分けられています。各パッケージは、 - 個有の開発チーム、バージョン番号、開発サイクル、ドキュメント、(依 - 存性を含む)他のパッケージとの相関を有する別個のプロジェクトです。 - パッケージは、説明用のファイルと共にgzip圧縮されたtarアーカイブと - して配布されており、PEARインストーラによりローカルシステムにイン - ストールされます。 + PEAR のコードは、「パッケージ」に分けられています。各パッケージは、 + 個有の開発チームを有する個別のプロジェクトで、 + バージョン番号、開発サイクル、ドキュメント、 + 他のパッケージとの関連(依存性等)などは、それぞれ異なります。 + 各パッケージは、説明用のファイルと共に、gzip 圧縮された tar アーカイブ + として配布されており、PEAR インストーラによりローカルシステムに + インストールします。 </para> <para> - パッケージには、(ソースファイルのみを含む)ソースパッケージと(プラッ - トフォーム依存のバイナリ、ある場合はソースファイルも含む)バイナリ - パッケージの2種類があります。Cコードを有するソースパッケージをイ - ンストールするには、当然、Cの開発環境が必要です。 + パッケージには、(ソースファイルのみを含む)ソースパッケージと + (プラットフォーム依存のバイナリ、ある場合はソースファイルも含む) + バイナリパッケージの2種類があります。C コードを有するソースパッケージを + インストールするには、当然、C の開発環境が必要です。 </para> <para> - PEARは、1つのパッケージツリーを定義します。このツリーの各「ノード」 - は、パッケージ名の一部として表されています。ノードは、簡略的なト - ピックで構成されており、各パートはアンダースコアで区切られます。 - パッケージ名の例は、"MP3_Id"、"Archive_Tar"、"HTTP_Post"です。 + PEAR では、(パッケージの分類・整理のために) + パッケージツリーを定義しており、 + パッケージ名の各パートが、ツリーの各「ノード」を表しています。 + それぞれのノードは、分類が簡潔に記述されたもので、 + パート間はアンダースコアで区切られます。 + パッケージ名の例をあげると、"MP3_Id"、"Archive_Tar"、"HTTP_Post" + のようになります。 </para> <para> - パッケージは、明示的な依存性により相互に関係している可能性があり - ます。しかし、(例えば、"HTTP_Post"がデフォルトで"HTTP"とは独立で - あるというように)パッケージとそのパッケージツリーの「親」の間のよ - うに自動的な相関は、存在しません。 + 依存性が明示され、相互に関係しているパッケージも存在します。 + しかし、パッケージとそのパッケージツリーの「親」の間に + 自動的に依存関係が存在するわけではありません + (たとえば、"HTTP_Post" は、通常、"HTTP" とは独立である + というように)。 </para> <para> - 「サブレポジトリ」と呼ばれるパッケージツリーにある少数の最上位の - ノードは、特別な関数は、特別な機能を有しています。現在、 + 「サブレポジトリ」と呼ばれるパッケージツリー最上位の少数の + ノードは、特別な機能を有しています。現在、 <link linkend="about-pecl">PECL</link>、<link linkend="about-gtk">Gtk</link>、<link - linkend="about-app">App</link>があります。これらの各々に関しては、 - 異なる規則が適用されます。詳細については、以下の各サブレポジトリ - に関する説明を参照下さい。 + linkend="about-app">App</link>がそれです。これらに関しては、 + 別の規則が適用されます。詳細については、各サブレポジトリに関する説明を + 参照してください。 </para> <para> - スタイルガイドである、<link linkend="standards">PEAR標準コーディ - ング規約</link> (省略形:PCS)が、複数のPEAR開発者による共同開発を - 容易に行い、品質及び移植性を高め、PEARに貢献する人が統一された外 - 観を有するAPIを提供することを容易にするために作成されています。 - <link linkend="about-pfc">PFC</link>の中のパッケージについては、 - この標準規約が厳格に適用され、PFC以外のパッケージについては、より - 柔軟な適用が行われます。 + さらに、スタイルガイド、すなわち <link linkend="standards">PEAR + 標準コーディング規約</link> (PCS) が作成されており、これにより + 複数のPEAR開発者による共同開発が容易になり、 + 品質および移植性の向上、統一感のあるルックアンドフィールの + API の提供に役立ちます。 + <link linkend="about-pfc">PFC</link> に含まれるパッケージについては、 + この標準規約が厳格に適用されています。PFC以外のパッケージについては、 + より柔軟に適用が行われています。 </para> </sect2> <sect2 id="about-pear-distpkg"> - <title>コード配布及びパッケージ管理</title> + <title>コード配布およびパッケージ管理</title> <para> - 全てのPEARパッケージは、pear.php.netにあるデータベースに登録され、 - アップロードされます。オープンソースのサードパーティのパッケージ - も登録及びアップロード可能です。クローズドソースのパッケージも - PEARインストーラによりインストールすることが可能ですが、PEARデー - タベースは、オープンソースコード専用です。 + すべての PEAR パッケージは、pear.php.net のデータベースに登録され、 + アップロードされています。オープンソースのサードパーティのパッケージ + についても登録およびアップロードが可能です。 + クローズドソースのパッケージについては、 + PEAR インストーラによりインストールすることは可能ですが、 + PEAR データベースは、オープンソースコード専用です。 </para> <para> - pear.php.netは、ヒューマンフレンドリ(HTML)及びマシンフレンドリ(現 - 在は、XML-RPC)なPEARデータベースへのインターフェイスを提供します。 - パッケージのダウンロードは、プレーンなHTTPで行われます。 - pear.php.netサイトが提供する他の機能には、以下のものがあります。 + pear.php.net は、ヒューマンフレンドリ (HTML) およびマシンフレンドリ + (現在は、XML-RPC) な形で、PEAR データベースへのインターフェイスを + 提供しています。 + パッケージのダウンロードは、プレーンな HTTP で行われます。 + pear.php.net サイトが提供するその他の機能には、以下のものがあります。 <itemizedlist> <listitem> - <simpara>ユーザアカウント管理 (CVSサーバに統合)</simpara> + <simpara>ユーザアカウント管理 (CVS サーバに統合)</simpara> </listitem> <listitem> <simpara>パッケージ管理</simpara> @@ -134,10 +151,10 @@ </itemizedlist> </para> <para> - パッケージは、XMLで書かれた説明用ファイルと共にgzip圧縮されたtar - ファイルで配布されます。この説明用ファイルには、パッケージ、ファ - イルリスト及びその役割、依存性といったいくつかの情報が記述されて - います。 + パッケージは、XML で書かれた定義ファイルと共に gzip 圧縮された + tar ファイルで配布されます。この定義ファイルには、パッケージ、 + ファイルのリストと役割、依存性といったいくつかの情報が + 記述されています。 </para> </sect2> @@ -145,33 +162,33 @@ <title>The PHP Foundation Classes</title> <titleabbrev>PFC</titleabbrev> <para> - The PHP Foundation ClassesはPEARのサブセットで、品質、一般性、相 - 互運用性、互換性に焦点をあてています。PHPが、インストーラ以外に - PEARパッケージのバンドルを継続する場合、PFCがバンドルされるでしょ - う。 + The PHP Foundation Classes は PEAR のサブセットで、品質、一般性、 + 相互運用性、互換性に焦点をあてたものです。PHPが、インストーラ以外の + PEAR パッケージのバンドルを継続する場合、PFC がバンドルされる予定です。 </para> <para> - 品質へ焦点をあてると言うことは、「安定な」品質以外のパッケージま - たはリリースは、PFCでは受け入れられないということを意味します。 + 品質へ焦点をあてると言うことは、「安定な (stable)」品質以外のパッケージ + またはリリースは、PFC では受け入れられないということを意味します。 </para> <para> - 一般性とは、パッケージは(HTML、オペレーティングシステム、Webサー - バ、SAPIバックエンド等のような)特定の環境に依存してはいけないこと - を意味します。 + 一般性とは、パッケージは(HTML、オペレーティングシステム、 + Web サーバ、SAPI バックエンド等のような) + 特定の環境に依存しないことを意味します。 </para> <para> - 相互運用性を有するパッケージは、安定で、標準化されたAPIを有する他 - のパッケージと供用することができ、他の確立された(同様に相互運用 - 性を有する)コンポーネントとも相互運用化膿で、異なる環境(PHPバージョ - ン、SAPIバックエンド、オペレーティングシステム等)でも良好に動作し - ます。 + 相互運用性を有するパッケージは、安定で標準化された API を有し、 + 他のパッケージと協働することができます。 + また、コンポーネントの一部とすることで、 + そのコンポーネントの機能を確定する(また、相互運用性をあたえる) + こともできます。さらに、様々な環境(PHPバージョン、SAPIバックエンド、 + オペレーティングシステム等)でも良好に動作します。 </para> <para> - 互換性は、前のバージョンと同じ構文とセマンティクスをサポートする - だけではなく、コードを記述する際の見通しについても関係します。 - コード設計は容易であることが望ましく、また、少なくとも、後で作成 - されそうな機能を追加することが可能である「上位互換性」を有するコー - ドとする必要があります。 + 互換性は、前のバージョンと同じ構文・セマンティクスをサポートする + だけではなく、コードを記述する際の今後のプランにも関係します。 + コードの設計に は、「前方互換性」、すなわち、 + 後で必要となりそうな機能を追加することが容易であること、 + 少なくとも可能であることが望まれます。 </para> </sect2> @@ -179,39 +196,47 @@ <title>The PHP Extension Community Library (PECL)</title> <subtitle>PECL</subtitle> <para> - PECL ("pickle"と読みます)は、PHP 4と共に配布されるものと同様のC拡 - 張モジュール用のPEARのサブレポジトリです。実際、PECLを作成する動 - 機の1つは、いくつかの拡張モジュールをPHPから他の場所に移動すると - いうものでした。PECLの拡張モジュールは、PEARのではなくPHPのコード - 作成標準に基づいています。しかし、PEARパッケージとして配布、イン - ストールされます。 - </para> - <para> - PHPからPECLに拡張モジュールを移動する手続きは、"pickling"と呼ばれ - ます。 + PECL("pickle"と読みます)は、PHP 4 と共に配布されるものと同様の + C 拡張モジュール用の PEAR のサブレポジトリです。 + 実際、PECLを作成した動機には、 + 拡張モジュールをいくつか PHP 本体から他の場所に移動したいということが + ありました。PECL 拡張モジュールは、PEAR ではなく、 + PHP のコード作成標準に基づいています。 + しかし、PEAR パッケージとして配布・インストールされます。 + </para> + <para> + PHP 本体から PECL に拡張モジュールを移動する手続きは、"pickling" + と呼ばれます。 + </para> + <para> + 2003年10月、PECL は独立のプロジェクトとなり、PEAR には含まれなくなりました + (PECL が PEAR より借用しているインフラを除く)。 + PECL についてのすべての情報は、<ulink url="&url.pecl;">PECL + ホームページ</ulink>を参照してください。 + PECL の分離に伴って、その名称も、<quote>PHP Extension Code Library</quote> + から、<quote>PHP Extension Community Library</quote> へ変更されました。 </para> </sect2> <sect2 id="about-gtk"> - <title>Gtkパッケージ</title> + <title>Gtk パッケージ</title> <subtitle>Gtk</subtitle> <para> Gtkパッケージは、 - <ulink url="&url.php.gtk;">PHP-GTK</ulink>プロジェクトの技術を使 - 用するソフトウエアを提供します。このサブレポジトリにあるコードは、 - <link linkend="standards">コーディング標準</link>に従っています。 + <ulink url="&url.php.gtk;">PHP-GTK</ulink> プロジェクトの技術を + 使用するソフトウエアを提供します。このサブレポジトリにあるコードは、 + <link linkend="standards">標準コーディング規約</link>に従っています。 </para> <para> - 現在のところ、このパッケージをPEARのリリースとしてリリースする方 - 法は、未定です。 + 現在のところ、PEAR からそれらをリリースする方法は、未定です。 </para> </sect2> <sect2 id="about-app"> - <title>Applicationパッケージ</title> + <title>Application パッケージ</title> <subtitle>App</subtitle> <para> - TBD + 未定。 <!-- Ideas: * files may also be installed in the web server's document root
« previous php.pear.doc (#4049) next »