shins****@users*****
shins****@users*****
2006年 7月 20日 (木) 12:49:46 JST
Update of /cvsroot/jetspeed-japan/jetspeed-2-trans/ja/xdocs/guides In directory sf-cvs:/tmp/cvs-serv3914/ja/xdocs/guides Modified Files: guide-menus-declarative-psml.xml Log Message: reviewed jetspeed-2-trans/ja/xdocs/guides/guide-menus-declarative-psml.xml 1.4 -> 1.5 (modified) http://cvs.sourceforge.jp/cgi-bin/viewcvs.cgi/jetspeed-japan/jetspeed-2-trans/ja/xdocs/guides/guide-menus-declarative-psml.xml.diff?r1=1.4&r2=1.5 =================================================================== RCS file: jetspeed-2-trans/ja/xdocs/guides/guide-menus-declarative-psml.xml,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- guide-menus-declarative-psml.xml 2006/05/25 03:55:48 1.4 +++ guide-menus-declarative-psml.xml 2006/07/20 03:49:46 1.5 @@ -16,8 +16,8 @@ --> <document> <properties> - <title>Guide to Declarative Menus in PSML</title> - <subtitle>Guide to Declarative Menus in PSML</subtitle> + <title>[Guide to Declarative Menus in PSML]PSML でのメニューの宣言ガイド</title> + <subtitle>[Guide to Declarative Menus in PSML]PSML でのメニューの宣言ガイド</subtitle> <authors> <person name="Randy Watler" email="rwatl****@apach*****"/> </authors> @@ -38,7 +38,7 @@ </p> </div> <p> -メニューの宣言は、表示されているポータルページに新しいナビゲーション要素を追加したり、デフォルトのものをカスタマイズしたりするために使われます。これらの PSML 宣言は、<a href="guide-psml.html#Page">page</a> と <a href="guide-psml.html#Folder">folder</a> 要素の一部分です。他の PSML 要素と同様に、メニュー宣言は、親フォルダで定義された全てに加えて、ページ内で明示的に定義されるものが有効となります。このため、グローバルなサイトのメニューは、サイトのルートフォルダに関連づけられている PSML ファイル内で定義されます。特定のページやフォルダのメニューの定義は、親フォルダで定義されている同じ名前のメニューを上書きします。 +メニューの宣言は、表示されているポータルページに新しいナビゲーション要素を追加したり、デフォルトのものをカスタマイズしたりするために使われます。これらの PSML 宣言は、<a href="guide-psml.html#Page">ページ</a> 要素と <a href="guide-psml.html#Folder">フォルダ</a> 要素の一部分です。他の PSML 要素と同様に、メニュー宣言は、親フォルダで定義された全てに加えて、ページ内で明示的に定義されるものが有効となります。このため、グローバルなサイトのメニューは、サイトのルートフォルダに関連づけられている PSML ファイル内で定義されます。特定のページやフォルダのメニューの定義は、親フォルダで定義されている同じ名前のメニューを上書きします。 </p> <div class="original"> <p> @@ -56,12 +56,12 @@ </p> </div> <p> -ポータルのレイアウトデコレータは、ポータルのコンテンツを描画している時に、名前でページメニューの宣言にアクセスします。メニューは、ダイナミックなナビゲーションペインや、ポータルページのタブや、ブレッドクラム機能 (訳注：よくページ上部に表示されるような、現在のページのウェブサイト内での階層構造をリストアップしたもの。例えば「ホーム＞商品＞デジタルカメラ」のように、どういうルートをたどって今のページに至ったかを示す。)や、プルダウンメニューを作成するのに使われます。ポータルサイトコンポーネントは、サイトのページ固有の PSML エレメントを持つダイナミックなメニュー定義の選択肢を実際に形成するのに関係します。例えば、グローバルなメニュー定義は、一般的に、ポータルページが構成されている間、次のような順序でイベントに関係します。 +ポータルのレイアウトデコレータは、ポータルのコンテンツを描画しているときに、名前でページメニューの宣言にアクセスします。メニューは、動的なナビゲーションペインや、ポータルページのタブや、パンくずリスト (訳注：よくページ上部に表示されるような、現在のページのウェブサイト内での階層構造をリストアップしたもの。例えば「ホーム > 商品 > デジタルカメラ」のように、どういうルートをたどって今のページに至ったかを示す。) や、プルダウンメニューを作成するのに使われます。ポータルサイトコンポーネントは、サイトのページ固有の PSML エレメントを持つ動的なメニュー定義の選択肢を実際に形成することを担当しています。例えば、グローバルなメニュー定義は、一般的に、ポータルページが構成されている間、次のような順序でイベントに関係します。 <ol> <li>ポータルレイアウトデコレータは、名前でメニュー定義の要求を行います。</li> <li>定義は、現在のページに継承され、ルートフォルダの PSML に設定されます。</li> <li>ポータルサイトコンポーネントは、現在のページのコンテキスト内のメニュー定義を解釈し、<a href="guide-psml.html#Page">ページ</a>や<a href="guide-psml.html#Folder">フォルダ</a>やメニューの選択肢の<a href="guide-psml.html#Link">リンク</a>を設置します。</li> - <li>デコレータは、メニュー定義自身と計算されたメニューの選択肢を元に、ポータルのナビゲーションコンテンツにタイトルとテキストを描画し、メニューを表示します。</li> + <li>デコレータは、メニュー定義自身と算出されたメニューの選択肢を元に、ポータルのナビゲーションコンテンツにタイトルとテキストを描画し、メニューを表示します。</li> </ol> </p> <div class="original"> @@ -78,7 +78,7 @@ </p> </div> <p> -ポータルサイトコンポーネントによって内部的にサポートされた共通のメニュー定義が存在し、サイトのページやフォルダの PSML 要素に明示的には定義の必要がありません。 +ポータルサイトコンポーネントによって、内部的にサポートされた共通のメニュー定義が存在し、サイトのページやフォルダの PSML 要素に明示的には定義の必要がありません。 <ul> <li><b>pages</b>: ポータル上のページタブを定義するのに使われる、相対的なページメニュー。</li> <li><b>bredcrumbs</b>: ページタブ以下にリンクの履歴を提供するのに使われる、ページへのパス。</li> @@ -125,7 +125,7 @@ </p> </div> <p> -<menu> 要素は、レイアウトデコレータもしくは他のメニュー内のネストされたメニューによって使われるメニューを定義します。menu 要素には、たくさんの有効な属性が存在します。 +<menu> 要素は、レイアウトデコレータもしくは他のメニュー内の階層化されたメニューによって使われるメニューを定義します。menu 要素には、たくさんの有効な属性が存在します。 </p> <div class="original"> <table> @@ -174,19 +174,19 @@ </tr> <tr> <td>name</td> - <td>テンプレートコードおよび(または)メニュー参照からの検索のためのメニュー名を指定します。この属性は、トップレベルのノードで必須で、ネストされたメニューでは無視されます。</td> + <td>テンプレートコードおよび(または)メニュー参照からの検索のためのメニュー名を指定します。この属性は、トップレベルのノードで必須で、階層化されたメニューでは無視されます。</td> </tr> <tr> <td>options</td> - <td>メニューの指定に、ドキュメントとフォルダの深い階層が存在する場合、メニューのためのルートドキュメントのパスを指定します。この属性は、ページ、フォルダ、メニューの選択肢のリンクの指定を行うドキュメントパスも定義します。カンマで区切ったパスおよび (または) 正規表現のパターンを、複数のオプションパスとして指定可能です。相対パスは、現在のページからの相対パスとして解釈されます。'~' や '@' といった特別なパターンを、現在のページを参照するために使うことができます。</td> + <td>メニューの指定に、ドキュメントとフォルダの深い階層が存在する場合、メニューのためのルートドキュメントのパスを指定します。この属性は、ページ、フォルダ、メニューの選択肢のリンクの指定を行うドキュメントパスも定義します。カンマで区切ったパスおよび (または) 正規表現のパターンを、複数のオプションパスとして指定可能です。相対パスは、現在のページからの相対パスとして解釈されます。「~」や「@」といった特別なパターンを、現在のページを参照するために使うことができます。</td> </tr> <tr> <td>depth</td> - <td>オプションフォルダからのドキュメントの深さを指定します (0 以下の深さの指定は無限大を表す)。メニューの選択肢は、それぞれの可視ページを表示するか、サイトへのリンクを行うために作成されます。フォルダはこの設定によってネストしたメニューに変換されます。</td> + <td>オプションフォルダからのドキュメントの深さを指定します (0 以下の深さの指定は無限大を表す)。メニューの選択肢は、それぞれの可視ページを表示するか、サイトへのリンクを行うために作成されます。フォルダはこの設定によって階層化したメニューに変換されます。</td> </tr> <tr> <td>paths</td> - <td>ルートフォルダから指定された選択肢への順序付きのパスオプションを含むかどうかを指定する真偽値。この設定は「履歴」もしくは「ブレッドクラム」メニューを生成するのに使います。</td> + <td>ルートフォルダから指定された選択肢への順序付きのパスオプションを含むかどうかを指定する真偽値。この設定は「履歴」もしくは「パンくずリスト」メニューを生成するのに使います。</td> </tr> <tr> <td>regexp</td> @@ -194,7 +194,7 @@ </tr> <tr> <td>profile</td> - <td>オプションの値を評価する際に使われるプロファイルロケータの名前を指定します。この属性は、オプションとネストしたメニューのためのデフォルトのプロファイルの値も設定します。'*' の指定は、全てのプロファイルロケータの名前を受け入れます。これは、親メニューが選択したプロファイル名を上書きするのに使うことができます。</td> + <td>オプションの値を評価する際に使われるプロファイルロケータの名前を指定します。この属性は、オプションと階層化したメニューのためのデフォルトのプロファイルの値も設定します。「*」の指定は、全てのプロファイルロケータの名前を受け入れます。これは、親メニューが選択したプロファイル名を上書きするのに使うことができます。</td> </tr> <tr> <td>order</td> @@ -202,7 +202,7 @@ </tr> <tr> <td>skin</td> - <td>メニューのためのレイアウトのヒントを定義するオプショナルなデコレータ。この属性は、選択肢やネストしたメニューのデフォルトスキンの値としても使われます。このヒントは、現時点では Jetspeed 2 のデコレータでは使われていません。</td> + <td>メニューのためのレイアウトのヒントを定義する省略可能なデコレータ。この属性は、選択肢や階層化したメニューのデフォルトスキンの値としても使われます。このヒントは、現時点では Jetspeed 2 のデコレータでは使われていません。</td> </tr> </table> <div class="original"> @@ -260,15 +260,15 @@ </tr> <tr> <td>title?</td> - <td>メニュー用のデフォルトのロケール特有のタイトルを指定する単純な要素。メニューのタイトルは、その長い記述とみなされます。そして、もしメニューの短いタイトルが利用可能である場合、デコレータによってはロールオーバー用のテキストとして使う場合があります。もし指定されない場合、メニューの名前が使われます。</td> + <td>メニュー用のデフォルトのロケール非依存なタイトルを指定する単純な要素。メニューのタイトルは、その長い記述とみなされます。そして、もしメニュー用の短いタイトルが利用可能である場合、デコレータによってはロールオーバー用のテキストとして使う場合があります。もし指定されない場合、メニューの名前が使われます。</td> </tr> <tr> <td>short-title?</td> - <td>メニュー用のデフォルトのロケール特有の短いタイトル。短いタイトルは、もし利用可能である場合、デコレータによってはメニューのテキストとして使う場合があります。もし指定されない場合、タイトルのテキストが使われます。</td> + <td>メニュー用のデフォルトのロケール非依存な短いタイトル。短いタイトルは、もし利用可能である場合、デコレータによってはメニューのテキストとして使う場合があります。もし指定されない場合、タイトルのテキストが使われます。</td> </tr> <tr> <td><a href="guide-psml.html#PSML_Titles_and_Metadata">metadata</a>*</td> - <td>オプショナルで指定される、追加のロケール特有のタイトルと短いタイトル。</td> + <td>追加のロケール特有のタイトルと短いタイトルを指定します(省略可)。</td> </tr> <tr> <td><a href="#Menu_Options_Definition">options</a>*</td> @@ -280,15 +280,15 @@ </tr> <tr> <td>menu*</td> - <td>このメニュー定義に含まれる、ネストされたメニューを定義するのに使われる、他の順序付きメニュー要素。</td> + <td>このメニュー定義に含まれる、階層化されたメニューを定義するのに使われる、他の順序付きメニュー要素。</td> </tr> <tr> <td><a href="#Menu_Include_Definition">include</a>*</td> - <td>このメニュー定義に含める、他のメニューのネストしたメニュー、もしくは選択肢を指定します。含めるメニューの名前はこの順序付きのメニュー要素のテキストです。</td> + <td>このメニュー定義に含める、他のメニューの階層化したメニュー、もしくは選択肢を指定します。含めるメニューの名前はこの順序付きのメニュー要素のテキストです。</td> </tr> <tr> <td><a href="#Menu_Exclude_Definition">exclude</a>*</td> - <td>このメニュー定義から除外する、他のメニューの選択肢とネストしたメニューを指定します。除外するための要素に含まれるメニューの名前は、この順序付きのメニュー要素のテキストです。</td> + <td>このメニュー定義から除外する、他のメニューの選択肢と階層化したメニューを指定します。除外するための要素に含まれるメニューの名前は、この順序付きのメニュー要素のテキストです。</td> </tr> </table> <div class="original"> @@ -429,7 +429,7 @@ </p> </div> <p> -<options> 要素は、<a href="#Menu_Definition">メニュー</a>内に単一または複数の選択肢を定義します。この単純な要素は、ページ、もしくはフォルダ、もしくはメニューの選択肢のリンクを作るドキュメントのパスを指定します。複数の選択肢のパスを、パスおよび (もしくは) 正規表現パターンをカンマで区切ったリストとして指定することも可能です。相対パスは、現在のページからの相対パスとして解釈されます。'~' や '@' と言った特別なパターンを、現在のページを参照するために使うことができます。この要素は、メニュー要素とたくさんの属性を共有します。 +<options> 要素は、<a href="#Menu_Definition">メニュー</a>内に単一または複数の選択肢を定義します。この単純な要素の文字列は、ページ、もしくはフォルダ、もしくはリンクのメニューの選択肢を作るドキュメントのパスを指定します。複数の選択肢のパスを、パスおよび (もしくは) 正規表現パターンをカンマで区切ったリストとして指定することも可能です。相対パスは、現在のページからの相対パスとして解釈されます。「~」や「@」といった特別なパターンを、現在のページを参照するために使うことができます。この要素は、メニュー要素とたくさんの属性を共有します。 </p> <div class="original"> <table> @@ -470,11 +470,11 @@ </tr> <tr> <td>depth</td> - <td>選択肢のフォルダからのドキュメントの深さを指定します (0 以下の深さは無限大を表します)。メニューの選択肢は、可視ページをそれぞれ表示するか、サイトへのリンクを行うように作成されます。フォルダは、この設定によってネストしたメニューに変換されます。</td> + <td>選択肢のフォルダからのドキュメントの深さを指定します (0 以下の深さは無限大を表します)。メニューの選択肢は、サイトへのそれぞれの可視ページまたはリンクを表示するように作成されます。フォルダは、この設定によって階層化したメニューに変換されます。</td> </tr> <tr> <td>paths</td> - <td>ルートフォルダから指定された選択肢への順序付きのパスの選択肢を含むかどうかを指定する真偽値。この設定は「履歴」もしくは「ブレッドクラム」メニューを生成するのに使います。</td> + <td>ルートフォルダから指定された選択肢への順序付きのパスの選択肢を含むかどうかを指定する真偽値。この設定は「履歴」もしくは「パンくずリスト」メニューを生成するのに使います。</td> </tr> <tr> <td>regexp</td> @@ -482,15 +482,15 @@ </tr> <tr> <td>profile</td> - <td>選択肢の値を評価する際に使われるプロファイルロケータの名前を指定します。この属性は、選択肢とネストしたメニューのためのデフォルトのプロファイルの値も設定します。'*' の指定は、全てのプロファイルロケータの名前を受け入れます。これは、親メニューが選択したプロファイル名を上書きするのに使うことができます。</td> + <td>選択肢の値を評価する際に使われるプロファイルロケータの名前を指定します。この属性は、選択肢と階層化したメニューのためのデフォルトのプロファイルの値も設定します。「*」の指定は、全てのプロファイルロケータの名前を受け入れます。これは、親メニューが選択したプロファイル名を上書きするのに使うことができます。</td> </tr> <tr> <td>order</td> - <td>マッチする選択肢の順序を判断するための、カンマで区切られたマッチするパターンの正規表現のリスト、もしくは正規表現のドキュメントパスの値。この属性は、どの選択肢の要素に対してもデフォルトの選択肢の値として適用されます。しかし、複数の選択肢の子供へのマッチを再度順序づけることはありません。もし指定されない場合、複数の選択肢は、含まれるフォルダドキュメントのものとして返される順序に含まれます。この属性にマッチしない選択肢のパスは、順序づけられたものの後に追加されます。</td> + <td>マッチする選択肢の順序を判断するための、カンマで区切られたマッチするパターンの正規表現のリスト、もしくは正規表現のドキュメントパスの値。この属性は、どの選択肢の要素に対してもデフォルトの選択肢の値として適用されます。しかし、複数の選択肢の子供へのマッチを再度順序づけることはありません。もし指定されない場合、複数の選択肢は、含まれるフォルダドキュメントの順番で返される順序に含まれます。この属性にマッチしない選択肢のパスは、順序づけられたものの後に追加されます。</td> </tr> <tr> <td>skin</td> - <td>メニューの選択肢のレイアウトのヒントを定義するオプショナルなデコレータ。このヒントは、現時点では Jetspeed 2 のデコレータでは使われていません。</td> + <td>メニューの選択肢のレイアウトのヒントを定義するデコレータ(省略可)。このヒントは、現時点では Jetspeed 2 のデコレータでは使われていません。</td> </tr> </table> <div class="original"> @@ -521,7 +521,7 @@ </p> </div> <p> -<separator> 要素は、<a href="#Menu_Definition">メニュー</a> に含めるセパレータを定義します。セパレータは、<a href="#Menu_Options_Definition">選択肢</a> もしくはネストしたメニューが、メニューの定義内のこの要素以下に現れた場合のみ含まれます。セパレータのテキストは、この要素内のテキスト、もしくはテキストメニュー定義の要素内で指定することが可能です。セパレータ要素に記述可能な属性は 1 つしかありません。 +<separator> 要素は、<a href="#Menu_Definition">メニュー</a> に含めるセパレータを定義します。セパレータは、<a href="#Menu_Options_Definition">選択肢</a> もしくは階層化したメニューが、メニューの定義内のこの要素以下に現れた場合のみ含まれます。セパレータのテキストは、この要素内のテキスト、もしくはテキストメニュー定義の要素内で指定することが可能です。セパレータ要素に記述可能な属性は 1 つしかありません。 </p> <div class="original"> <table> @@ -542,7 +542,7 @@ </tr> <tr> <td>skin</td> - <td>メニューセパレータのレイアウトのヒントを定義するオプショナルのデコレータ。このヒントは、現時点では Jetspeed 2 のデコレータでは使われていません。</td> + <td>メニューセパレータのレイアウトのヒントを定義する省略可能なデコレータ。このヒントは、現時点では Jetspeed 2 のデコレータでは使われていません。</td> </tr> </table> <div class="original"> @@ -580,15 +580,15 @@ </tr> <tr> <td>title?</td> - <td>メニュー用のデフォルトのロケール特有のタイトルを指定する単純な要素。セパレータのタイトルは、その長い記述とみなされます。そして、もしセパレータのテキストが利用可能である場合、デコレータによってはロールオーバー用のテキストとして使う場合があります。</td> + <td>メニュー用のデフォルトのロケール非依存なタイトルを指定する単純な要素。セパレータのタイトルは、その長い記述とみなされます。そして、もしセパレータのテキストが利用可能である場合、デコレータによってはロールオーバー用のテキストとして使う場合があります。</td> </tr> <tr> <td>text?</td> - <td>メニュー用のデフォルトのロケール特有のテキストを指定する単純な要素。セパレータのテキストは必須で、この属性によって指定されようと、セパレータ要素内のテキストとして指定されようと、レイアウトデコレータがメニュー内に挿入するためのテキストとなります。</td> + <td>メニュー用のデフォルトのロケール非依存なテキストを指定する単純な要素。セパレータのテキストは必須で、この属性によって指定されようと、セパレータ要素内のテキストとして指定されようと、レイアウトデコレータがメニュー内に挿入するためのテキストとなります。</td> </tr> <tr> <td><a href="guide-psml.html#PSML_Titles_and_Metadata">metadata</a>*</td> - <td>オプショナルで指定される、ロケール特有の追加のタイトルとセパレータテキスト。</td> + <td>ロケール特有の追加のタイトルとセパレータテキスト(省略可)。</td> </tr> </table> <div class="original"> @@ -633,7 +633,7 @@ </p> </div> <p> -<include> 要素は、<a href="#Menu_Options_Definition">選択肢</a> または、他のメニューのネストした <a href="#Menu_Definition">メニュー</a> を含みます。含めるメニューの名前は、このエレメントのテキスト値として指定します。この要素に含める事のできる有効な属性は 1 つしかありません。 +<include> 要素は、<a href="#Menu_Options_Definition">選択肢</a> または、他のメニューの階層化した <a href="#Menu_Definition">メニュー</a> を含みます。含めるメニューの名前は、このエレメントのテキスト値として指定します。この要素に含めることのできる有効な属性は 1 つしかありません。 </p> <div class="original"> <table> @@ -654,7 +654,7 @@ </tr> <tr> <td>nest</td> - <td>指定したメニューが、ネストするためのものかどうかを制御する真偽値。もしこの属性に 'true' が指定された場合、含めるメニューはサブメニューとしてネストされます。そうでないのなら、全ての選択肢と指定したメニューのネストしたメニューは、このメニュー内にインラインで挿入されます。</td> + <td>指定したメニューが、階層化するためのものかどうかを制御する真偽値。もしこの属性に 'true' が指定された場合、含めるメニューはサブメニューとして階層化されます。そうでないのなら、全ての選択肢と指定したメニューの階層化したメニューは、このメニュー内にインラインで挿入されます。</td> </tr> </table> <div class="original"> @@ -686,7 +686,7 @@ </p> </div> <p> -<exclude> 要素は、<a href="#Menu_Options_Definition">選択肢</a> もしくは、他のメニューのネストした <a href="#Menu_Definition">メニュー</a> を除外します。このオプションは主に、このメニューから、ポータルページ内の、他のメニューに既に表示されているメニューの選択肢を消去するために使われます。除外するメニューの名前は、この単純な要素のテキスト値として指定します。 +<exclude> 要素は、<a href="#Menu_Options_Definition">選択肢</a> もしくは、他のメニューの階層化した <a href="#Menu_Definition">メニュー</a> を除外します。このオプションは主に、このメニューから、ポータルページ内の、他のメニューに既に表示されているメニューの選択肢を消去するために使われます。一致する選択肢またはメニューがメニュー定義内のこの要素より上に表示されている場合は、除外されます。除外するメニューの名前は、この単純な要素のテキスト値として指定します。 </p> <div class="original"> <p>Examples:</p> @@ -719,7 +719,7 @@ </p> </div> <p> -ページレイアウトデコレータは、ページが Jetspeed 2 パイプラインで描画されるとき、ポータルサイトコンポーネントからメニューをリクエストします。デコレータは、メニューが PSML で定義される事を期待します。カスタムメニューがポータルに表示される前に、デコレータは、カスタムメニューの描画を変更する必要があります。以下に、Velocity レイアウトデコレータの header.vm ファイルから抜き出した例を示します。 +ページレイアウトデコレータは、ページが Jetspeed 2 パイプラインで描画されるとき、ポータルサイトコンポーネントからメニューを要求します。デコレータは、メニューが PSML で定義されることを期待します。カスタムメニューがポータルに表示される前に、デコレータは、カスタムメニューの描画を変更する必要があります。以下に、Velocity レイアウトデコレータの header.vm ファイルから抜き出した例を示します。 </p> <div class="original"> <source><