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

hirokawa Thu Aug 14 01:11:57 2003 EDT Added files: /peardoc/ja/chapters contributing.xml Modified files: /peardoc/ja/chapters installation.xml intro.xml support.xml Log: added contributing.xml in japanese manual.

Index: peardoc/ja/chapters/installation.xml diff -u peardoc/ja/chapters/installation.xml:1.2 peardoc/ja/chapters/installation.xml:1.3 --- peardoc/ja/chapters/installation.xml:1.2 Fri Apr 4 23:52:49 2003 +++ peardoc/ja/chapters/installation.xml Thu Aug 14 01:11:57 2003 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.2 $ --> +<!-- sync: 1.8 --> +<!-- $Revision: 1.3 $ --> <!-- WORK IN PROGRESS, THERE IS PROBABLY LITTLE POINT IN TRANSLATING THIS DOCUMENT YET. @@ -31,34 +32,9 @@ トール済みです。 </para> <para> -<!-- - かなり古いバージョンのPHPを使用している場合、PEARは動作しません。 - インストールされているバージョンを更新することを強く推奨します! - さもないと、世界中のスクリプトキッズにサーバがハッキングされるリス - クを負うことになります。 - </para> - <para> - PFCに含まれていないパッケージは、以下の2種類の異なる手段でインストー - ル可能です。 - <itemizedlist> - <listitem> - <simpara> - <link linkend="installation.web">Webインストーラ経由</link> - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="installation.cvs">CVS経由</link> - </simpara> - </listitem> - </itemizedlist> - 最初の手段は推奨される手段で、特に理由がない限りこれを使用するべき - です。2番目の手段は、CVSクライアントをいじるのが好きな熟練者か、パッ - ケージの最新の開発バージョンを使用したい場合の手段です。 ---> PFC以外のパッケージは、PEARパッケージマネージャによりインストール 可能です。このマネージャは、Debianの<quote>apt-get</quote>と互換性 - があります。また、最近のバージョン(&gt; 4.3.0pre1) のPHPを実行して + があります。また、最近のバージョン(&gt; 4.3.0) のPHPを実行して いる場合、次節を読み飛ばすことができます。PHP 4.2.*およびそれ以前 のバージョンを使用している場合、このマネージャを別途インストールす る必要があります。 @@ -75,13 +51,41 @@ <sect1 id="installation.getting"> <title>PEARパッケージマネージャの取得</title> <simpara> - 最新版のPHP(&gt; 4.3.0pre1)を使用していない人のために、このページ - では、PEARパッケージマネージャのインストール方法について説明します。 + Linux: PHP 4.3.0以降、./configure で--without-pearが指定されていな + い限り、PEAR Package Managerはインストールされています。 </simpara> + <note> + <para> + いくつかのLinuxディストリビューション(例: Redhat) は、 + コマンドラインブラウザの名前として<filename>lynx</filename>ではな + く、<filename>links</filename>を使用しているようです。 + この場合、以下の行を同様に変更する必要があります。 + </para> + </note> <simpara> - 現在、go-pear.orgにあるシェルスクリプトをPEARベース - クラスおよびPEARパッケージマネージャをインストールするために - 使用することができます。以下をコンソールウインドウで実行して下さい。 + Windows: PHP 4.3.2以降、go-pearスクリプトがバンドルされています。 + (ウインドウズエクスプローラのダブルクリックと同様に実行してみて下さい。 + </simpara> + <para> + <screen> + <userinput> +drive:path\to\php\go-pear.bat + </userinput> + </screen> + </para> + <simpara> + この後の質問に全て応えて下さい。 + これにより、PEARパッケージマネージャが指定したパスにインストールさ + れます。このパスをシステムのPATH環境変数 + (スタート > コントロールパネル > システム > 環境変数) + に追加し、コマンドプロンプトでpearとタイプしてみて下さい。 + 見事に動作するはずです。 + </simpara> + <simpara> + 最新版のPHP(&gt; 4.3.0)を使っていないユーザや + パッケージマネージャを再インストールしたい場合は、 + 別の方法が用意されています。 + 以下のコマンドをLinux上で実行することができます。 </simpara> <para> <screen> @@ -91,16 +95,26 @@ </screen> </para> <simpara> - 残りは自動的に行なわれます。 + Windowsでは、go-pear.orgからスクリプトをダウンロード、保存し、 + 以下のコマンドで実行して下さい。 + </simpara> + <para> + <screen> + <userinput> +php go-pear (または保存したファイル名) + </userinput> + </screen> + </para> + <simpara> + (サーバにsshアクセスできる環境でない限り)pearコマンドを使用できな + いので、Webホストにpearをインストールできるか懸念されるかもしれま + せん。しかし、全く不可能なわけではありません。 + PEARパッケージマネージャは、パッケージインストールの手順を簡単にし + てくれるだけのものです。１つの手段としては、デスクトップPCにpear + コマンドでインストールしてから、サーバーにファイルをコピーするとい + うものがあります。PEARファイルが際とで利用できるように + set_include_path()を使用することを忘れないようにして下さい。 </simpara> - <note> - <para> - (RedHatのような)いくつかのLinuxディストリビューションでは、 - コマンドラインブラウザの名前として <filename>lynx</filename>の代わりに - <filename>links</filename>を使用する必要があるようです。 - このような場合には、上の行を対応して変更する必要があります。 - </para> - </note> </sect1> <sect1 id="installation.cli"> Index: peardoc/ja/chapters/intro.xml diff -u peardoc/ja/chapters/intro.xml:1.2 peardoc/ja/chapters/intro.xml:1.3 --- peardoc/ja/chapters/intro.xml:1.2 Fri Apr 4 23:52:49 2003 +++ peardoc/ja/chapters/intro.xml Thu Aug 14 01:11:57 2003 @@ -1,5 +1,6 @@ <?xml encoding="utf-8"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> +<!-- sync: 1.3 --> <chapter id="introduction"> <docinfo> <author> @@ -195,7 +196,14 @@ <title>Gtkパッケージ</title> <subtitle>Gtk</subtitle> <para> - TBD + Gtkパッケージは、 + <ulink url="&url.php.gtk;">PHP-GTK</ulink>プロジェクトの技術を使 + 用するソフトウエアを提供します。このサブレポジトリにあるコードは、 + <link linkend="standards">コーディング標準</link>に従っています。 + </para> + <para> + 現在のところ、このパッケージをPEARのリリースとしてリリースする方 + 法は、未定です。 </para> </sect2> Index: peardoc/ja/chapters/support.xml diff -u peardoc/ja/chapters/support.xml:1.2 peardoc/ja/chapters/support.xml:1.3 --- peardoc/ja/chapters/support.xml:1.2 Fri Apr 4 23:52:49 2003 +++ peardoc/ja/chapters/support.xml Thu Aug 14 01:11:57 2003 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> +<!-- sync: 1.7 --> <chapter id="support"> <title>サポート</title> <simpara> @@ -45,11 +46,17 @@ </itemizedlist> </para> <para> - 最初の3行は、質問がある場合に助けとなるためのものです。以下を読ん - で、どのリストが自分のニーズに合致するかを知って下さい。 + 最初の3つのリストは、質問がある場合に助けとなるためのものです。以 + 下を読んで、どのリストが自分のニーズに合致するかを知って下さい。 CVS commit リストは、PEARに貢献する人用です。リビジョン管理システ ム(CVS)への全てのコミットはこのリストに送られます。 </para> + + <para> + PEARメーリングリストには、 + <ulink url="&url.pear.support;">このWebサイト</ulink>で登録できま + す。 + </para> </sect2> <sect2 id="support.lists.general"> @@ -120,12 +127,27 @@ </para> </sect2> + <sect2 id="support.lists.qa"> + <title>The QA mailing list</title> + + <para> + People being interested in improving the overall quality of PEAR + come together on the <ulink url="mailto:&email.pear.qa;">QA list</ulink>. + </para> + <para> + The Quality Insurance team is always seeking people that want to + help. If you are interested, just + <ulink url="&url.pear.support;">sign up</ulink> and announce + yourself on the mailing list. + </para> + </sect2> + <sect2 id="support.lists.webmaster"> <title>Webmasterメーリングリスト</title> <para> If you have found a problem on our website or have a question - concerning the site, you can mail the guys on <ulink url="mailto: - pear-webmaster@php.net">pear-webmaster@php.net</ulink>. + concerning the site, you can email the guys on + <ulink url="mailto:&email.pear.webmaster;">&email.pear.webmaster; </para> </sect2> @@ -137,9 +159,9 @@ <para> There are a number of web sites that deal with PEAR. We have compiled a list of them - <ulink url="http://pear.php.net/support.php">here</ulink>. If a + <ulink url="&url.pear.support;">here</ulink>. If a site is missing, you can email - <ulink url="mailto:pear-webmaster@php.net">the webmaster</ulink>. + <ulink url="mailto:&email.pear.webmaster;">the webmaster</ulink>. </para> </sect1> @@ -147,8 +169,9 @@ <title>IRCの#PEAR</title> <para> - PEARプロジェクトには専用のIRCチャンネル#PEARがあり、EFnetで利用可 - 能です。参加して、グルーたちに合って下さい。彼らのインターネット接 + PEARプロジェクトには専用のIRCチャンネル#PEARがあり、<ulink + url="&url.efnet;">EFnet</ulink>で利用可能です。 + 参加して、グルーたちに合って下さい。彼らのインターネット接 続の料金を負担する必要はなく、一日中IRCに接続したままとすることが できます。 </para> Index: peardoc/ja/chapters/contributing.xml +++ peardoc/ja/chapters/contributing.xml <?xml version="1.0" encoding="utf-8" ?> <!-- $Revision: 1.1 $ --> <!-- sync: 1.6 --> <chapter id="contributing"> <docinfo> <author> <firstname>Tal</firstname> <surname>Peer</surname> </author> <author> <firstname>Martin</firstname> <surname>Jansen</surname> </author> <date>2003-03-21</date> </docinfo> <title>貢献</title> <simpara> 本章は、PEARに貢献するための複数の方法について説明するものです。 </simpara> <sect1 id="contributing.introduction"> <title>はじめに</title> <simpara> PEARはオープンソースプロジェクトであり、どんな人でもPEARを改良に参 加することができます。改良とは、コードを書くことだけを意味するわけ ではありません。改良は、バグを報告したり、フィードバックを提供し たり、機能のリクエストをしたりすることも意味し、金銭的なサポートを 行うことさえも含まれます。 </simpara> </sect1> <sect1 id="contributing.newpackage"> <title>新しいパッケージを作成する</title> <para> 新規パッケージの投稿に関する説明は、 <link linkend="guide-developers">デベロッパーズガイド</link>にあります。 </para> </sect1> <sect1 id="contributing.patches"> <title>パッチの投稿</title> <para> If you have modified a package to expand its functionality or to fix a bug, you should contribute your changes back to the community (some licenses force you to do so, and it is generally considered immoral not to). </para> <para> Before creating the patch, you must first obtain the latest sources of the package you wish to patch from CVS by running the commands (the package in this example is Foo_Bar): <screen> <command>cvs -d:pserver:cvsread@cvs.php.net:/repository login</command> password is "phpfi" <command> cvs -z3 -d:pserver:cvsread@cvs.php.net:/repository co Foo_Bar </command> </screen> Now that you have the latest sources, you can edit the relevant file(s). Make sure that your patch is fully compatible with the &link.coding-standards;. </para> <para> After you have finished adding/changing the code, TEST it: We will not accept code that hasn't been carefully tested. When you are absolutely sure the new code doesn't introduce bugs, create a unified diff by running: <screen> <command>cd pear/Foo_Bar</command> <command>cvs diff -u >Foo_Bar.diff</command> </screen> The resulting .diff file contains your patch. This diff makes it easy for us to see what has been changed. </para> <para> Next step is to submit the patch. Send a mail to &email.pear.dev; and Cc the maintainer(s) of the package. The subject of the mail should be prefixed with '[Patch]' to make it clear you are submitting a patch. Also include a verbose explanation of what the patch does. Don't forget to attach the .diff file to the mail. The maintainers of the package are usually listed in the header of each source file. Apart from that their email adresses are available on the package information page on &url.pear;. </para> <note> <para> If you are using Outlook or Outlook Express, please change the file extension of the diff file to .txt, because Outlook's MIME-Type detection depends on the file extension and attachments with a MIME-Type not equal to <literal>text/plain</literal> will be rejected by our mailinglist software. </para> </note> <note> <para> If your patch does break backwards compatibility, the chances are fairly good that the maintainers won't be happy about it. Thus you should always try to fix a bug in a way that does not seriously change the public API. But if there is absolutely no way to keep backwards compatibility and/or if your patch contains a groundbraking improvement, even API changes are fine. </para> </note> </sect1> <sect1 id="contributing.bugs"> <title>バグの報告</title> <para> If you think that you have found a bug in a PEAR package, please take care that you are using the latest version of the package and that your system does meet the packages' requirements. </para> <para> If the bug still persists with the latest version of the package, don't hesitate to fill out a bug report on <ulink url="&url.php.bugs;">&url.php.bugs;</ulink>. Please choose "PEAR related" as the category for the report. The developers on the PEAR development list will be noticed about your report. </para> <para> More information and tips on how to report bugs in a proper way can be found at <ulink url="&url.php.bugs.howto;">&url.php.bugs.howto;</ulink>. </para> <para> If you have already fixed a bug that you have found in a package, please read <link linkend="contributing.bugs">this</link>. </para> </sect1> <sect1 id="contributing.wishlist"> <title>欲しいものリスト(ウイッシュリスト)</title> <para> Some of the PEAR developers have wishlists at Amazon or a similar service. If you appreciate the work of a certain developer, feel free to buy something for her from her wishlist. To find out if a developer has one of those wishlists, go to the <ulink url="&url.pear.account;">account browser</ulink>, look for the details of the developer and there you'll see if she has a wishlist. Buying something from people's wishlists may even speed up the time in which annoying bugs are fixed ;-). </para> </sect1> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->