cvs: peardoc /ja/guide/developers contributing.xml intro.xml meaning.xml packagedef.xml recommendations.xml release.xml supporting.xml

From: Date: Sat, 20 Mar 2004 05:21:09 +0000
Subject: cvs: peardoc /ja/guide/developers contributing.xml intro.xml meaning.xml packagedef.xml recommendations.xml release.xml supporting.xml
Groups: php.pear.doc 
Request: Send a blank email to pear-doc+get-3036@lists.php.net to get a copy of this message
haruki Sat Mar 20 00:21:09 2004 EDT Added files: /peardoc/ja/guide/developers recommendations.xml Modified files: /peardoc/ja/guide/developers contributing.xml intro.xml meaning.xml packagedef.xml release.xml supporting.xml Log: Fix typo and expression. Sync new revisions. Add recommendations.xml. Add EN-Revision tag.

http://cvs.php.net/diff.php/peardoc/ja/guide/developers/contributing.xml?r1=1.4&r2=1.5&ty=u Index: peardoc/ja/guide/developers/contributing.xml diff -u peardoc/ja/guide/developers/contributing.xml:1.4 peardoc/ja/guide/developers/contributing.xml:1.5 --- peardoc/ja/guide/developers/contributing.xml:1.4 Thu Nov 13 18:01:20 2003 +++ peardoc/ja/guide/developers/contributing.xml Sat Mar 20 00:21:08 2004 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.4 $ --> -<!-- Sync: 1.15 --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.18 Maintainer: haruki Status: ready --> <!-- WORK IN PROGRESS, THERE IS PROBABLY LITTLE POINT IN TRANSLATING THIS DOCUMENT YET. @@ -12,9 +12,9 @@ <para> PEARは、<ulink url="http://www.opensource.org/">オープンソース</ulink> 志向の開発者コミュニティーによって運営されています。 - したがって、誰でも、本PEARプロジェクトに - (新しいパッケージの作成でも、既存のパッケージに対する改良であっても、) - コードを寄与する機会があります。 + ですから、誰でも、本PEARプロジェクトにコードを寄与することができます。 + それは、新しいパッケージの作成でも、 + 既存のパッケージに対する改良であってもかまいません。 しかしながら、 PEARでは、パッケージの品質を非常に高いレベルに保持することも目標としています。 そのため、コードの寄与には、以下に示す要求事項があります。 @@ -25,8 +25,8 @@ <titleabbrev>要求事項</titleabbrev> <simpara> - コード自体およびパッケージ著者の双方に対して、 - PEARではいくつかの要求事項があります。 + PEARでは、コード自体およびパッケージ著者の双方に対して、 + いくつかの要求事項があります。 </simpara> <para> @@ -178,14 +178,14 @@ ユーザからパッケージに対して寄与された有用な拡張を 取り入れることも必要です。 また、 - パッケージのバグ修正された新バージョンを + バグ修正が行われた新バージョンを 定期的にリリースすることも期待されます。 もし、長期間に渡ってパッケージのメンテナンスが出来なくなった場合には、 PEAR開発者メーリングリストにアナウンスし、 別の仮リードメンテナを任命するか、 パッケージが一時的にメンテナンスされない旨を皆に文書で知らせるかして、 さらに可能ならば、 - サポートとバグ修正を再び提供する大まかな時期も + サポートとバグ修正を再び開始する大まかな時期についても 知らせることが求められます。 </simpara> <warning> @@ -263,12 +263,12 @@ 寄与に当たっての第2のステップは、 <ulink url="mailto:&email.pear.dev;">開発者メーリングリスト</ulink> でパッケージを発表することです。 - 通常、発表に続いていくつかの論議が行われ、 - あなたの提案に対して、開発者による投票が開始されます。 + 通常、発表に続いて幾許かの論議が行われます。 (もちろん、あなたもその来るべき論議に加わることが求められます。) - 当然、パッケージの発表が、その許諾を意味するのではありません。 - さらに幾分かの時間がかかりますし、 - さらなる努力も要するかも知れません。 + 一週間後、あなたは投票を要求し、開発者による投票が開始されます。 + パッケージの発表が、当然、その許諾を意味してはいません。 + 許諾までには、幾分かの時間がかかりますし、 + 労力ももう少し要するかも知れません。 </para> <note> <para> @@ -278,7 +278,7 @@ パッケージ提案の扱い</ulink>」 に従っています。 そこに、新しいパッケージの投稿について詳しく述べられています。 - PEAR初心者の方は、この書類を読むことは必須でしょう。 + この文書を読むことは、PEAR初心者の方にとって必須でしょう。 </para> </note> @@ -291,12 +291,12 @@ </para> <para> 投票は合計されます。 - この合計とは、-1の票は、+1の票を相殺してしまうことを意味します。 + ここで合計とは、-1の票は、+1の票を相殺してしまうことを意味します。 しかし常に、-1の票は、重大なものと考えられ、 拒否権を保持する<ulink url="&url.pear.group;">PEARグループ</ulink>が ケースバイケースの決定をすることになるかもしれません。 (将来的には、そのような状況ではPEAR QAチームがPEARグループを - 補助することになるだろうということを意図しています。) + 補助することになるだろうということも考えられています。) ですので、 -1の票は必ずその決定について説明するコメントを 付加しなければなりません。 @@ -305,12 +305,12 @@ </para> <para> - 投票は、票の合計が+5を超えれば、受諾されます。 + 票の合計が+5を超えれば、投票が受諾されます。 </para> <para> 提案が受諾されない場合には、 - そのパッケージについてさらにメーリングリストで議論することが可能です。 + そのパッケージについてさらにメーリングリストで議論することも可能です。 提案者は (道理にかなう理由がある場合のみに期待されることですが、) 「投票要求」を再び行うことになるかもしれません。 @@ -415,10 +415,10 @@ <title>ドキュメントの書き方の実際</title> <titleabbrev>ドキュメントの書き方</titleabbrev> <para> - 本章は、マニュアルについて扱うものですが、 - peardocの標準に基づくドキュメント構成の詳細を - 扱うものではなく、 - どのようにしてドキュメントを論理的に構成するかについて述べるものです。 + このマニュアルについての章では、 + どのようにしてドキュメントを論理的に構成するかについて述べます。 + peardocの標準に基づく + ドキュメント構成方法の詳細を扱うものではありません。 peardoc形式でのドキュメントファイルのオーサリングについて学ぶには、 「<ulink url="&url.php.cvs.peardoc.authoring;">こちら</ulink>」のPHPのCVSを http://cvs.php.net/diff.php/peardoc/ja/guide/developers/intro.xml?r1=1.2&r2=1.3&ty=u Index: peardoc/ja/guide/developers/intro.xml diff -u peardoc/ja/guide/developers/intro.xml:1.2 peardoc/ja/guide/developers/intro.xml:1.3 --- peardoc/ja/guide/developers/intro.xml:1.2 Thu Nov 13 18:01:20 2003 +++ peardoc/ja/guide/developers/intro.xml Sat Mar 20 00:21:08 2004 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.2 $ --> -<!-- Sync: 1.1.1.1 --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.2 Maintainer: haruki Status: ready --> <!-- WORK IN PROGRESS, THERE IS PROBABLY LITTLE POINT IN TRANSLATING THIS DOCUMENT YET. @@ -21,11 +21,12 @@ <sect1> <title>このテキストの目的</title> <simpara> - このガイドの目的は、PEARに対して何らかの貢献をしたいと思っている開発者に + このガイドの目的は、 + PEARに何らかの貢献をしたいと思っている開発者に対して、 効率的に仕事を開始するのに十分な情報を提供することにあります。 </simpara> <simpara> - ガイドの初めのパートでは、PEARのコードを毎日の仕事で使用する場合に + ガイドの初めのパートでは、PEARのコードを毎日の仕事で使用することで 開発者が得ることのできる利点について述べます。 次に、コードをPEARに寄与する方法について示します。 最後に、開発者がPEARプロジェクトをサポートする手段を示します。 http://cvs.php.net/diff.php/peardoc/ja/guide/developers/meaning.xml?r1=1.2&r2=1.3&ty=u Index: peardoc/ja/guide/developers/meaning.xml diff -u peardoc/ja/guide/developers/meaning.xml:1.2 peardoc/ja/guide/developers/meaning.xml:1.3 --- peardoc/ja/guide/developers/meaning.xml:1.2 Thu Nov 13 18:01:20 2003 +++ peardoc/ja/guide/developers/meaning.xml Sat Mar 20 00:21:08 2004 @@ -1,12 +1,12 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.2 $ --> -<!-- Sync: 1.3 --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.4 Maintainer: haruki Status: ready --> <!-- WORK IN PROGRESS, THERE IS PROBABLY LITTLE POINT IN TRANSLATING THIS DOCUMENT YET. --> <chapter id="developers.meaning"> - <title>開発者にとってPEARのが持つ意味</title> + <title>開発者にとってPEARが持つ意味</title> <titleabbrev>開発者への意味</titleabbrev> <sect1 id="guide.dev.meaning"> @@ -18,9 +18,9 @@ <link linkend="standards">PEAR標準コーディング規約</link>に合致した コードの寄与だけをPEARは受け入れています。 これは皆さんにとって、 - 多かれ少なかれユニークなAPIを持つとはしても - 同じ標準コンポーネントに基づいており、また、 - 共通のエラー報告メカニズムを提供するコードを皆さんは使っているのだ、 + 多かれ少なかれユニークなAPIを持つとはしても、 + 同じ標準コンポーネントに基づいて、 + 共通のエラー報告メカニズムを提供するコードを使っている、 ということを意味しています。 </para> <para> http://cvs.php.net/diff.php/peardoc/ja/guide/developers/packagedef.xml?r1=1.5&r2=1.6&ty=u Index: peardoc/ja/guide/developers/packagedef.xml diff -u peardoc/ja/guide/developers/packagedef.xml:1.5 peardoc/ja/guide/developers/packagedef.xml:1.6 --- peardoc/ja/guide/developers/packagedef.xml:1.5 Thu Nov 13 18:01:20 2003 +++ peardoc/ja/guide/developers/packagedef.xml Sat Mar 20 00:21:08 2004 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.5 $ --> -<!-- Sync: 1.14 --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.14 Maintainer: haruki Status: ready --> <!-- WORK IN PROGRESS, THERE IS PROBABLY LITTLE POINT IN TRANSLATING THIS DOCUMENT YET. http://cvs.php.net/diff.php/peardoc/ja/guide/developers/release.xml?r1=1.2&r2=1.3&ty=u Index: peardoc/ja/guide/developers/release.xml diff -u peardoc/ja/guide/developers/release.xml:1.2 peardoc/ja/guide/developers/release.xml:1.3 --- peardoc/ja/guide/developers/release.xml:1.2 Thu Nov 13 18:01:20 2003 +++ peardoc/ja/guide/developers/release.xml Sat Mar 20 00:21:08 2004 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.2 $ --> -<!-- Sync: 1.13 --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.13 Maintainer: haruki Status: ready --> <chapter id="developers.release"> <docinfo> <author> @@ -52,11 +52,11 @@ 次のコマンドを実行してください。 <command>pear package</command> リリースのTarballが作成され、後でそれを新リリースのアップロードに使用します。 - <note> - <para> + <note> + <para> リリースのTarballを作成するには、PHPにzlib拡張のビルドが - 必要なことに注意してください。 - </para> + 必要なことに注意してください。 + </para> </note> </para> http://cvs.php.net/diff.php/peardoc/ja/guide/developers/supporting.xml?r1=1.2&r2=1.3&ty=u Index: peardoc/ja/guide/developers/supporting.xml diff -u peardoc/ja/guide/developers/supporting.xml:1.2 peardoc/ja/guide/developers/supporting.xml:1.3 --- peardoc/ja/guide/developers/supporting.xml:1.2 Thu Nov 13 18:01:20 2003 +++ peardoc/ja/guide/developers/supporting.xml Sat Mar 20 00:21:08 2004 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.2 $ --> -<!-- Sync: 1.3 --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.3 Maintainer: haruki Status: ready --> <!-- WORK IN PROGRESS, THERE IS PROBABLY LITTLE POINT IN TRANSLATING THIS DOCUMENT YET. @@ -69,7 +69,7 @@ <para> すべてのPEAR開発者にとって、PEARは自由時間に作業するプロジェクトです。 - つまり、そこからお金を得るということは意味していません。 + つまり、そこからお金を得るということを意味していません。 あなた、もしくはあなたが勤める会社が、製品にPEARパッケージを使う場合、 もちろん無料で使用できます。 しかし、使用したパッケージの作者に称賛を与えたいと思った場合は、 http://cvs.php.net/co.php/peardoc/ja/guide/developers/recommendations.xml?r=1.1&p=1 Index: peardoc/ja/guide/developers/recommendations.xml +++ peardoc/ja/guide/developers/recommendations.xml <?xml version="1.0" encoding="iso-8859-1" ?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.6 Maintainer: haruki Status: partial --> <chapter id="developers.recommendations"> <docinfo> <author> <firstname>Stefan</firstname> <surname>Neufeind</surname> </author> <date>2004-02-29</date> </docinfo> <title>推奨事項</title> <sect1 id="developers.recommendations.introduction"> <title> なぜ推奨事項か? </title> <para> 以下の推奨事項は、 <ulink url="mailto:&email.pear.dev;">開発者メーリングリスト</ulink>で 議論され同意された事項について記したものです。 これらは、標準コーディング規約の様に必ず従うべき 厳密なルールではありません。 共通のAPIスキームのガイドラインとなり、 相互運用を高めることを意図するものです。 可能ならば、あなたのパッケージに於いても、 以下に示す事項を考慮してください。 </para> </sect1> <sect1 id="developers.faq.colorrepresentation"> <title> PEARパッケージ内での色表現 </title> <titleabbrev> 色表現 </titleabbrev> <para> パッケージが色を扱う場合、 開発者は、それらPEARパッケージ内では、配列による色値の表現を 用いることが推奨されます。 すべての色値は、0から255までの範囲となります。 </para> <sect2> <title>RGB表現</title> <para> The following snippet defines an array that holds the RGB definition of the green coloring that is used in the official PEAR logo. <programlisting role="php"> <![CDATA[ $color = array(0x33, 0x99, 0x00); ]]> </programlisting> or <programlisting role="php"> <![CDATA[ $color = array(51, 153, 0); ]]> </programlisting> Please note that the internal, numerical representation of both forms of the example are equal. The values represent the RGB (red, green, blue) values. It was decided not to use "r", "g" and "b" as indices for the array, because numerical indices allow easier creation of color arrays in the sourcecode, make handling less complicated and are an already commonly used array representation for colors. </para> </sect2> <sect2> <title>アルファ値によるRGB表現</title> <para> Since this an extension of the RGB representation above, it is recommended to use a forth value for alpha-channel-prepresentation. An example of the <quote>PEAR-green</quote> with aprox. 80% intensity would be: <programlisting role="php"> <![CDATA[ $color = array(0x33, 0x99, 0x00, 0xCC); ]]> </programlisting> For consistency the alpha-value is also from the range 0..255. A value of 255 means fully opaque (full color-intensity, same as in RGB- notation), 0 means fully transparent. </para> <para> Please note this is in contrast to the alpha-value used by imagecolorallocate(). The alpha-representation used in PEAR was choosen for consistency with the other RGB values and because it is commonly accepted practise in many other applications (image-processing tools, etc.). </para> </sect2> <sect2> <title>RGB以外の色表現</title> <para> Since RGB/RGBA will used for graphic generation on a computer we decided to leave out an optional type-identifier classifying colors as RGB/RGBA. However for different color-representations an identifier is needed. The optional identifier "type" can be added to the color array. <programlisting role="php"> <![CDATA[ $color = array(0x33, 0x99, 0x00, 0xCC, "type" => "RGB"); ]]> </programlisting> Currently the following types are definied, with array-indices from 0..n follwing the colornames listed behind them: </para> <itemizedlist> <listitem> <simpara>RGB - red, green, blue</simpara> </listitem> <listitem> <simpara>CYMK - cyan, yellow, magenta, black (key)</simpara> </listitem> </itemizedlist> <para> Please note that also the RGBA representation has the type "RGB" since it's closely related. </para> </sect2> <sect2> <title>色表現の変換s</title> <para> The PEAR-package <ulink url="&url.pear.package;Image_Color">Image_Color</ulink> will (hopefully soon) contain all needed functions to convert arbitrary color formats to the internal RGBA representation and convert different color representations. </para> <para> Status: Currently Image_Color already offers functions to convert color-names (e.g. "green") and hex-representations-strings (e.g. "#339900") to the PEAR-RGBA-format. We are working to get alpha- channel support added hopefully soon and will later add funtions for CYMK-conversion as well. </para> </sect2> </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 sgml-namecase-general:t sgml-general-insert-case:lower End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
« previous php.pear.doc (#3036) next »