cvs: peardoc /ja/guide/developers packagedef.xml

From: Date: Sat, 24 Sep 2005 05:19:22 +0000
Subject: cvs: peardoc /ja/guide/developers packagedef.xml
Groups: php.pear.doc 
Request: Send a blank email to pear-doc+get-6910@lists.php.net to get a copy of this message
haruki Sat Sep 24 01:19:22 2005 EDT Modified files: /peardoc/ja/guide/developers packagedef.xml Log: sync with en

http://cvs.php.net/diff.php/peardoc/ja/guide/developers/packagedef.xml?r1=1.10&r2=1.11&ty=u Index: peardoc/ja/guide/developers/packagedef.xml diff -u peardoc/ja/guide/developers/packagedef.xml:1.10 peardoc/ja/guide/developers/packagedef.xml:1.11 --- peardoc/ja/guide/developers/packagedef.xml:1.10 Tue Sep 28 07:10:46 2004 +++ peardoc/ja/guide/developers/packagedef.xml Sat Sep 24 01:19:21 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.23 Maintainer: haruki Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.29 Maintainer: haruki Status: ready --> <!-- WORK IN PROGRESS, THERE IS PROBABLY LITTLE POINT IN TRANSLATING THIS DOCUMENT YET. @@ -15,18 +15,18 @@ <simpara> パッケージ定義ファイル <filename>package.xml</filename> は、 - その名が示す通り、ある PEAR パッケージについてのすべての情報が記載された - 整形式 XML ファイルです。 + その名が示す通り、ある PEAR パッケージについての情報が記載された + 整形式の XML ファイルです。 </simpara> <simpara> - この章では、パッケージ定義に使用可能な要素について述べ、 - 自らのパッケージに対して定義ファイルを作成する方法について解説します。 + このセクションでは、パッケージ定義に使用可能な要素について述べ、 + 自作のパッケージに対して定義ファイルを作成する方法について解説します。 </simpara> <simpara> <link linkend="package.pear.pear-packagefilemanager">PEAR_PackageFileManager</link> パッケージを使えば、package.xml の作成が容易になります。 - 下記の通り、通常と同様のコマンドで PEAR_PackageFileManager のインストールが可能です。 + 下記の通りのコマンドで、通常と同様、PEAR_PackageFileManager をインストールできます。 </simpara> <para> @@ -37,7 +37,7 @@ </screen> </para> - <sect2> + <sect2 id="developers.packagedef.elements"> <title>使用可能な要素</title> <para> @@ -76,7 +76,7 @@ <itemizedlist> <listitem> <para> - <literal>&lt;maintainer&gt;</literal>: 一人のメンテナに関する情報 + <literal>&lt;maintainer&gt;</literal>: メンテナ各人に関する情報 (複数回記述可能) <itemizedlist> <listitem> @@ -118,7 +118,7 @@ <listitem> <simpara> <literal>&lt;state&gt;</literal>: リリースの状態 - (stable, dev, beta, alpha, devel もしくは snapshot のいずれか) + (stable, beta, alpha, devel もしくは snapshot のいずれか) </simpara> </listitem> <listitem> @@ -205,7 +205,33 @@ </itemizedlist> </sect2> - <sect2> + + <sect2 id="developers.packagedef.characters"> + <title>使用可能な文字</title> + <para> + 要素内で使用可能な文字は A-Z および a-z です。 + 他の文字、たとえば <literal>&eacute;</literal> など、 + を使用するには、エンティティを用います(このばあいは <literal>&eacute;</literal>)。 + </para> + <para> + package.xml ファイルを EAR_PackageFileManager を使って作成する場合には、 + インストールされた PEAR をバージョン 1.4.0a2 以降にしておくと良いでしょう。 + FileManager が自動的に処理しますので、使用可能な文字について心配しなくてすみます。 + </para> + <para> + package.xml ファイルを手動で作成する場合は、使用するエンティティを + 自ら入力する必要があります。 + 一般的に良く使われるエンティティについては、 + <ulink url="&url.xml.entities.common;"> + &url.xml.entities.common;</ulink> を参照してください。 + 必要な文字が無い場合は、 + <ulink url="&url.xml.entities.all;"> + &url.xml.entities.all;</ulink> + や他のリストも参照してください。 + </para> + </sect2> + + <sect2 id="developers.packagedef.creating"> <title>パッケージ定義ファイルの作成</title> <titleabbrev>定義ファイルの作成</titleabbrev> @@ -251,8 +277,8 @@ </para> <para> この <filename>package.xml</filename> は、必要な要素をすべて含んでおり、 - テンプレートとして使用できます。この例をあなたのパッケージに適用するには、 - 多くの場合、タグ間の文字データを変更するだけです。 + テンプレートとして使用できます。 + 多くの場合、タグ間の文字データを変更するだけで、この例を自作のパッケージに適用できます。 </para> <para> <example> @@ -302,14 +328,14 @@ </para> <para> 本章で得た知識に基づいて、 - 自身のパッケージの定義ファイルを作成可能になったことでしょう。 + パッケージ定義ファイルを作成可能になったことでしょう。 この話題について、さらに疑問がある場合は、 <ulink url="mailto:&email.pear.general;">メーリングリスト</ulink>で 質問してください。 </para> </sect2> - <sect2> + <sect2 id="developers.packagedef.roles"> <title>ファイルの役割</title> <para> &lt;file&gt; タグ中の <literal>type</literal> 属性により @@ -451,7 +477,7 @@ <entry>prog</entry> <entry>プログラム</entry> <entry> - システムパス中にある特定のプログラムに依存 + システムパス中にある特定のプログラムに依存(PEAR インストーラでは未サポート) </entry> <entry><quote>latex</quote></entry> </row> @@ -466,14 +492,14 @@ <row> <entry>sapi</entry> <entry>サーバ API</entry> - <entry>特定のサーバ API に依存</entry> + <entry>特定のサーバ API に依存(PEAR インストーラでは未サポート)</entry> <entry><quote>Apache</quote></entry> </row> <row> <entry>zend</entry> <entry>Zend</entry> - <entry>特定の Zend API バージョンに依存</entry> + <entry>特定の Zend API バージョンに依存(PEAR インストーラでは未サポート)</entry> <entry><quote>2</quote></entry> </row> </tbody> @@ -501,7 +527,7 @@ <entry>値</entry> <entry></entry> <entry>意味</entry> - <entry>使用可能 type 属性</entry> + <entry>使用可能な type 属性</entry> </row> </thead> <tbody> @@ -510,7 +536,7 @@ <entry>has</entry> <entry>保持</entry> <entry> - インストール先のシステムが要求された特性を保持している。version 属性は必須ではありません。 + インストール先のシステムが要求された特性を保持している。version 属性は無視されます。 </entry> <entry>pkg, ext, php, prog, os, sapi, zend</entry> </row> @@ -560,12 +586,23 @@ <entry>pkg, ext, php, zend</entry> </row> + <row> + <entry>not</entry> + <entry>衝突</entry> + <entry> + 依存性が本パッケージと衝突しており、共存できない。 + version 属性は無視されます。 + </entry> + <entry>ext, php</entry> + </row> + </tbody> </tgroup> </table> <para> 値を指定しない場合、 <literal>has</literal> が指定されたことになります。 + rel 属性を用いるには PEAR 1.4.0 かそれ以降が必要です。 </para> </sect3> <sect3>
« previous php.pear.doc (#6910) next »