shins****@users*****
shins****@users*****
2006年 3月 22日 (水) 22:23:05 JST
Update of /cvsroot/jetspeed-japan/jetspeed-2-trans/ja/xdocs/guides In directory sf-cvs:/tmp/cvs-serv17478/ja/xdocs/guides Modified Files: guide-menus-declarative-psml.xml Log Message: submitted by KATOH Yasufumi jetspeed-2-trans/ja/xdocs/guides/guide-menus-declarative-psml.xml 1.1.1.1 -> 1.2 (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.1.1.1&r2=1.2 =================================================================== RCS file: jetspeed-2-trans/ja/xdocs/guides/guide-menus-declarative-psml.xml,v retrieving revision 1.1.1.1 retrieving revision 1.2 diff -u -r1.1.1.1 -r1.2 --- guide-menus-declarative-psml.xml 2005/12/16 03:43:36 1.1.1.1 +++ guide-menus-declarative-psml.xml 2006/03/22 13:23:04 1.2 @@ -21,9 +21,13 @@ <authors> <person name="Randy Watler" email="rwatl****@apach*****"/> </authors> + <translators> + <person name="加藤泰文" email="karma****@prog*****" /> + </translators> </properties> <body> -<section name="Declarative Menus"> +<section name="[Declarative Menus] メニューの宣言"> +<div class="original"> <p> Declarative menus are used to add new or customize default navigation elements in displayed portal pages. These PSML declarations are part of the <a href="guide-psml.html#Page">page</a> and <a href="guide-psml.html#Folder">folder</a> elements. @@ -32,6 +36,11 @@ the PSML associated with the site root folder. Menu definitions in a specific page or folder override menus with the same name found in parent folders. </p> +</div> +<p> +メニューの宣言は、表示されているポータルページに新しいナビゲーション要素を追加したり、デフォルトのものをカスタマイズしたりするために使われます。これらの PSML 宣言は、<a href="guide-psml.html#Page">page</a> と <a href="guide-psml.html#Folder">folder</a> 要素の一部分です。他の PSML 要素と同様に、メニュー宣言は、親フォルダで定義された全てに加えて、ページ内で明示的に定義されるものが有効となります。このため、グローバルなサイトのメニューは、サイトのルートフォルダに関連づけられている PSML ファイル内で定義されます。特定のページやフォルダのメニューの定義は、親フォルダで定義されている同じ名前のメニューを上書きします。 +</p> +<div class="original"> <p> Portal layout decorators access page menu declarations by name while rendering portal content. Menus are used to create dynamic navigation panes, portal page tabs, bread crumb links, and pull downs. @@ -45,6 +54,17 @@ <li>the decorator would display the menu rendering titles and text from the menu definition itself and the computed menu options into portal navigation content.</li> </ol> </p> +</div> +<p> +ポータルのレイアウトデコレータは、ポータルのコンテンツを描画している時に、名前でページメニューの宣言にアクセスします。メニューは、ダイナミックなナビゲーションペインや、ポータルページのタブや、ブレッドクラム機能 (訳注：よくページ上部に表示されるような、現在のページのウェブサイト内での階層構造をリストアップしたもの。例えば「ホーム＞商品＞デジタルカメラ」のように、どういうルートをたどって今のページに至ったかを示す。)や、プルダウンメニューを作成するのに使われます。ポータルサイトコンポーネントは、サイトのページ固有の 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> +</ol> +</p> +<div class="original"> <p> There are default global menu declarations supported internally by the Portal Site Component that do not need to be explicitly defined in any page or folder PSML elements of the site: @@ -56,6 +76,18 @@ </ul> As one would expect, these built in menu definitions can be overridden by declaring menus in the site PSML with the same name. </p> +</div> +<p> +ポータルサイトコンポーネントによって内部的にサポートされた共通のメニュー定義が存在し、サイトのページやフォルダの PSML 要素に明示的には定義の必要がありません。 +<ul> + <li><b>pages</b>: ポータル上のページタブを定義するのに使われる、相対的なページメニュー。</li> + <li><b>bredcrumbs</b>: ページタブ以下にリンクの履歴を提供するのに使われる、ページへのパス。</li> + <li><b>navigations</b>: ポータルの横のナビゲーションパネルを定義するのに使われる、相対サブフォルダとルートレベルのリンクメニュー</li> + <li><b>back</b>: ポータルページタブ上の、以前のページへ一つ戻るためのリンクを定義するのに使われる、親フォルダのメニュー。</li> +</ul> +メニュー定義内で構築されるこれらは、期待どおり、サイトの PSML 内で同じ名前で宣言されるメニューに上書きされます。 +</p> +<div class="original"> <p> <ul> <li><a href="#Menu_Definition">Menu Definition</a></li> @@ -69,13 +101,33 @@ <li><a href="#Portal_Site_Component">Portal Site Component</a></li> </ul> </p> +</div> +<p> +<ul> + <li><a href="#Menu_Definition">メニューの定義</a></li> + <ul> + <li><a href="#Menu_Options_Definition">メニューの選択肢の定義</a></li> + <li><a href="#Menu_Separator_Definition">メニューのセパレータの定義</a></li> + <li><a href="#Menu_Include_Definition">メニューのインクルードの定義</a></li> + <li><a href="#Menu_Exclude_Definition">メニューの除外の定義</a></li> + </ul> + <li><a href="#Page_Layout_Decorators">ページレイアウトデコレータ</a></li> + <li><a href="#Portal_Site_Component">ポータルサイトコンポーネント</a></li> +</ul> +</p> </section> -<section name='Menu Definition'> +<section name='[Menu Definition] メニューの定義'> +<div class="original"> <p> The <menu> element defines a menu to be used by the layout decorators or a nested menu within another menu. There are many valid attributes for the menu element: </p> +</div> +<p> +<menu> 要素は、レイアウトデコレータもしくは他のメニュー内のネストされたメニューによって使われるメニューを定義します。menu 要素には、たくさんの有効な属性が存在します。 +</p> +<div class="original"> <table> <tr> <th>Attribute</th> @@ -114,9 +166,54 @@ <td>Optional decorator defined layout hint for the menu. This attribute is also used as the default skin value for options and nested menus. This hint is not currently used by Jetspeed2 decorators.</td> </tr> </table> +</div> +<table> + <tr> + <th>属性</th> + <th>説明</th> + </tr> + <tr> + <td>name</td> + <td>テンプレートコードおよび(または)メニュー参照からの検索のためのメニュー名を指定します。この属性は、トップレベルのノードで必須で、ネストされたメニューでは無視されます。</td> + </tr> + <tr> + <td>options</td> + <td>メニューの指定に、ドキュメントとフォルダの深い階層が存在する場合、メニューのためのルートドキュメントのパスを指定します。この属性は、ページ、フォルダ、メニューの選択肢のリンクの指定を行うドキュメントパスも定義します。カンマで区切ったパスおよび (または) 正規表現のパターンを、複数のオプションパスとして指定可能です。相対パスは、現在のページからの相対パスとして解釈されます。'~' や '@' といった特別なパターンを、現在のページを参照するために使うことが出来ます。</td> + </tr> + <tr> + <td>depth</td> + <td>オプションフォルダからのドキュメントの深さを指定します (0 以下の深さの指定は無限大を表す)。メニューの選択肢は、それぞれの可視ページを表示するか、サイトへのリンクを行うために作成されます。フォルダはこの設定によってネストしたメニューに変換されます。</td> + </tr> + <tr> + <td>paths</td> + <td>ルートフォルダから指定された選択肢への順序付きのパスオプションを含むかどうかを指定する真偽値。この設定は「履歴」もしくは「ブレッドクラム」メニューを生成するのに使います。</td> + </tr> + <tr> + <td>regexp</td> + <td>選択肢の値としてワイルドカードや正規表現が使われるかどうかを指定する真偽属性。ファイルシステムのコマンドラインの正規表現をサポートします。</td> + </tr> + <tr> + <td>profile</td> + <td>オプションの値を評価する際に使われるプロファイルロケータの名前を指定します。この属性は、オプションとネストしたメニューのためのデフォルトのプロファイルの値も設定します。'*' の指定は、全てのプロファイルロケータの名前を受け入れます。これは、親メニューが選択したプロファイル名を上書きするのに使うことが出来ます。</td> + </tr> + <tr> + <td>order</td> + <td>マッチする選択肢の順序を判断するための、カンマで区切られたマッチするパターンの正規表現のリスト、もしくは正規表現のドキュメントパスの値。この属性は、どの選択肢の要素に対してもデフォルトの選択肢の値として適用されます。しかし、複数の選択肢の子供へのマッチを再度順序づけることはありません。もし指定されない場合、複数の選択肢は、含まれるフォルダドキュメントのものとして返される順序に含まれます。この属性にマッチしない選択肢のパスは、順序づけられたものの後に追加されます。</td> + </tr> + <tr> + <td>skin</td> + <td>メニューのためのレイアウトのヒントを定義するオプショナルなデコレータ。この属性は、選択肢やネストしたメニューのデフォルトスキンの値としても使われます。このヒントは、現時点では Jetspeed 2 のデコレータでは使われていません。</td> + </tr> +</table> +<div class="original"> <p> The <menu> element contains a number of other menu definition PSML elements. With the exception of the title and metadata elements, the relative order of these elements determines the order that the layout decorators present them: </p> +</div> +<p> +<menu> 要素は、多数の他のメニュー定義の PSML 要素を含みます。タイトルとメタデータ要素を除いて、これらの要素の相対的な順序は、レイアウトデコレータがそれらを提示する順序を決定します。 +</p> +<div class="original"> <table> <tr> <th>Element</th> @@ -155,18 +252,78 @@ <td>Specifies options and nested menus from another menu to be excluded from this menu definition. The name of the menu with elements to exclude is the text of this ordered menu element.</td> </tr> </table> +</div> +<table> + <tr> + <th>要素</th> + <th>説明</th> + </tr> + <tr> + <td>title?</td> + <td>メニュー用のデフォルトのロケール特有のタイトルを指定する単純な要素。メニューのタイトルは、その長い記述とみなされます。そして、もしメニューの短いタイトルが利用可能である場合、デコレータによってはロールオーバー用のテキストとして使う場合があります。もし指定されない場合、メニューの名前が使われます。</td> + </tr> + <tr> + <td>short-title?</td> + <td>メニュー用のデフォルトのロケール特有の短いタイトル。短いタイトルは、もし利用可能である場合、デコレータによってはメニューのテキストとして使う場合があります。もし指定されない場合、タイトルのテキストが使われます。</td> + </tr> + <tr> + <td><a href="guide-psml.html#PSML_Titles_and_Metadata">metadata</a>*</td> + <td>オプショナルで指定される、追加のロケール特有のタイトルと短いタイトル。</td> + </tr> + <tr> + <td><a href="#Menu_Options_Definition">options</a>*</td> + <td>この順序付きのメニュー要素は、このメニュー定義のためのコンテンツ要素を指定します。</td> + </tr> + <tr> + <td><a href="#Menu_Separator_Definition">separator</a>*</td> + <td>このメニュー定義内で、インラインで含まれるテキスト行を指定するために使われる、順序付きのメニュー要素。</td> + </tr> + <tr> + <td>menu*</td> + <td>このメニュー定義に含まれる、ネストされたメニューを定義するのに使われる、他の順序付きメニュー要素。</td> + </tr> + <tr> + <td><a href="#Menu_Include_Definition">include</a>*</td> + <td>このメニュー定義に含める、他のメニューのネストしたメニュー、もしくは選択肢を指定します。含めるメニューの名前はこの順序付きのメニュー要素のテキストです。</td> + </tr> + <tr> + <td><a href="#Menu_Exclude_Definition">exclude</a>*</td> + <td>このメニュー定義から除外する、他のメニューの選択肢とネストしたメニューを指定します。除外するための要素に含まれるメニューの名前は、この順序付きのメニュー要素のテキストです。</td> + </tr> +</table> +<div class="original"> <p>Examples:</p> +</div> +<p>例:</p> +<div class="original"> +<source><![CDATA[ +<menu name="simple"> + <options>/some-top-page.psml,/custom/some-other-page.psml</options> +</menu> +]]></source> +</div> <source><![CDATA[ <menu name="simple"> <options>/some-top-page.psml,/custom/some-other-page.psml</options> </menu> ]]></source> +<div class="original"> +<source><![CDATA[ +<menu name="top-2-levels" options="/" depth="2" skin="dhtml-pull-down"/> +]]></source> +</div> <source><![CDATA[ <menu name="top-2-levels" options="/" depth="2" skin="dhtml-pull-down"/> ]]></source> +<div class="original"> <source><![CDATA[ <menu name="top-role-pages" regexp="true" options="/*" profile="roles"/> ]]></source> +</div> +<source><![CDATA[ +<menu name="top-role-pages" regexp="true" options="/*" profile="roles"/> +]]></source> +<div class="original"> <source><![CDATA[ <menu name="top-custom"> <title>Top Menu</title> @@ -188,13 +345,60 @@ <include nest="true">top-role-pages</include> </menu> ]]></source> +</div> +<source><![CDATA[ +<menu name="top-custom"> + <title>Top Menu</title> + <metadata name="title" xml:lang="fr">Haut</metadata> + <options regexp="true" profile="groups">/group-pages/*</options> + <menu options="/" profile="page"> + <separator> + <text>-- Top Pages --</text> + <title>Top Pages</title> + </separator> + <options regexp="true">/*</options> + <separator> + <title>Custom Pages</title> + </separator> + <options depth="2">/custom-folder/</options> + </menu> + <exclude>top-role-pages</exclude> + <separator>More Top Pages</separator> + <include nest="true">top-role-pages</include> +</menu> +]]></source> +<div class="original"> <p>The definitions for the default global menu declarations supported internally by the Portal Site Component:</p> +</div> +<p>デフォルトの共通メニュー宣言のための定義は、内部的にポータルサイトコンポーネントによってサポートされます。 +</p> +<div class="original"> <source><![CDATA[ <menu name="pages" regexp="true" options="*.psml"/> ]]></source> +</div> +<source><![CDATA[ +<menu name="pages" regexp="true" options="*.psml"/> +]]></source> +<div class="original"> <source><![CDATA[ <menu name="breadcrumbs" options="~" paths="true"/> ]]></source> +</div> +<source><![CDATA[ +<menu name="breadcrumbs" options="~" paths="true"/> +]]></source> +<div class="original"> +<source><![CDATA[ +<menu name="navigations"> + <separator>Folders</separator> + <options regexp="true">./*/</options> + <include>page-navigations</include> + <separator>Additional Links</separator> + <options regexp="true">/*.link</options> +</menu> +]]></source> +</div> <source><![CDATA[ <menu name="navigations"> <separator>Folders</separator> @@ -204,16 +408,30 @@ <options regexp="true">/*.link</options> </menu> ]]></source> +<div class="original"> +<source><![CDATA[ +<menu name="back" options="../"/> +]]></source> +</div> <source><![CDATA[ <menu name="back" options="../"/> ]]></source> +<div class="original"> <p>Note that the separator text of these definitions is localized internally.</p> +</div> +<p>これらの定義のセパレータのテキストは、内部的に変換されることに注意してください。</p> </section> -<section name='Menu Options Definition'> +<section name='[Menu Options Definition] メニューの選択肢の定義'> +<div class="original"> <p> The <options> element defines a single or multiple options within a <a href="#Menu_Definition">menu</a>. The text of this simple element specifies document paths that yield page, folder, or link menu options. Multiple option paths can be specified as a comma separated list of paths and/or regular expression patterns. Relative paths are interpreted as relative to the current page. Special patterns, '~' or '@', can be used to reference the current page. This element shares many attributes in common with the menu element: </p> +</div> +<p> +<options> 要素は、<a href="#Menu_Definition">メニュー</a>内に単一または複数の選択肢を定義します。この単純な要素は、ページ、もしくはフォルダ、もしくはメニューの選択肢のリンクを作るドキュメントのパスを指定します。複数の選択肢のパスを、パスおよび (もしくは) 正規表現パターンをカンマで区切ったリストとして指定することも可能です。相対パスは、現在のページからの相対パスとして解釈されます。'~' や '@' と言った特別なパターンを、現在のページを参照するために使うことが出来ます。この要素は、メニュー要素とたくさんの属性を共有します。 +</p> +<div class="original"> <table> <tr> <th>Attribute</th> @@ -244,7 +462,42 @@ <td>Optional decorator defined layout hint for the menu options. This hint is not currently used by Jetspeed2 decorators.</td> </tr> </table> +</div> +<table> + <tr> + <th>属性</th> + <th>説明</th> + </tr> + <tr> + <td>depth</td> + <td>選択肢のフォルダからのドキュメントの深さを指定します (0 以下の深さは無限大を表します)。メニューの選択肢は、可視ページをそれぞれ表示するか、サイトへのリンクを行うように作成されます。フォルダは、この設定によってネストしたメニューに変換されます。</td> + </tr> + <tr> + <td>paths</td> + <td>ルートフォルダから指定された選択肢への順序付きのパスの選択肢を含むかどうかを指定する真偽値。この設定は「履歴」もしくは「ブレッドクラム」メニューを生成するのに使います。</td> + </tr> + <tr> + <td>regexp</td> + <td>選択肢の値としてワイルドカードや正規表現が使われるかどうかを指定する真偽属性。ファイルシステムのコマンドラインの正規表現をサポートします。</td> + </tr> + <tr> + <td>profile</td> + <td>選択肢の値を評価する際に使われるプロファイルロケータの名前を指定します。この属性は、選択肢とネストしたメニューのためのデフォルトのプロファイルの値も設定します。'*' の指定は、全てのプロファイルロケータの名前を受け入れます。これは、親メニューが選択したプロファイル名を上書きするのに使うことが出来ます。</td> + </tr> + <tr> + <td>order</td> + <td>マッチする選択肢の順序を判断するための、カンマで区切られたマッチするパターンの正規表現のリスト、もしくは正規表現のドキュメントパスの値。この属性は、どの選択肢の要素に対してもデフォルトの選択肢の値として適用されます。しかし、複数の選択肢の子供へのマッチを再度順序づけることはありません。もし指定されない場合、複数の選択肢は、含まれるフォルダドキュメントのものとして返される順序に含まれます。この属性にマッチしない選択肢のパスは、順序づけられたものの後に追加されます。</td> + </tr> + <tr> + <td>skin</td> + <td>メニューの選択肢のレイアウトのヒントを定義するオプショナルなデコレータ。このヒントは、現時点では Jetspeed 2 のデコレータでは使われていません。</td> + </tr> +</table> +<div class="original"> <p>Example:</p> +</div> +<p>例:</p> +<div class="original"> <source><![CDATA[ <menu> ... @@ -252,13 +505,25 @@ ... </menu> ]]></source> +</div> +<menu> + ... + <options regexp="true" order="*.psml,*.link">/some-top-page.psml,/custom/some-other-page.psml,/*.link</options> + ... +</menu> </section> -<section name='Menu Separator Definition'> +<section name='[Menu Separator Definition] メニューのセパレータの定義'> +<div class="original"> <p> The <separator> element defines a separator to be included in a <a href="#Menu_Definition">menu</a>. The separator will be included only if <a href="#Menu_Options_Definition">options</a> or nested menus appear below this element within a menu definition. The text of the separator can be specified in the contained text of this element or in the text menu definition element. There is only one attribute accepted by the separator element: </p> +</div> +<p> +<separator> 要素は、<a href="#Menu_Definition">メニュー</a> に含めるセパレータを定義します。セパレータは、<a href="#Menu_Options_Definition">選択肢</a> もしくはネストしたメニューが、メニューの定義内のこの要素以下に現れた場合のみ含まれます。セパレータのテキストは、この要素内のテキスト、もしくはテキストメニュー定義の要素内で指定することが可能です。セパレータ要素に記述可能な属性は一つしかありません。 +</p> +<div class="original"> <table> <tr> <th>Attribute</th> @@ -269,9 +534,26 @@ <td>Optional decorator defined layout hint for the menu separator. This hint is not currently used by Jetspeed2 decorators.</td> </tr> </table> +</div> +<table> + <tr> + <th>属性</th> + <th>説明</th> + </tr> + <tr> + <td>skin</td> + <td>メニューセパレータのレイアウトのヒントを定義するオプショナルのデコレータ。このヒントは、現時点では Jetspeed 2 のデコレータでは使われていません。</td> + </tr> +</table> +<div class="original"> <p> The <separator> element contains a number of other menu definition PSML elements: </p> +</div> +<p> +<separator> 要素は、たくさんの他のメニュー定義の PSML 要素を含みます。 +</p> +<div class="original"> <table> <tr> <th>Element</th> @@ -290,7 +572,44 @@ <td>Optionally specifies additional locale-specific titles and separator text.</td> </tr> </table> +</div> +<table> + <tr> + <th>要素</th> + <th>説明</th> + </tr> + <tr> + <td>title?</td> + <td>メニュー用のデフォルトのロケール特有のタイトルを指定する単純な要素。セパレータのタイトルは、その長い記述とみなされます。そして、もしセパレータのテキストが利用可能である場合、デコレータによってはロールオーバー用のテキストとして使う場合があります。</td> + </tr> + <tr> + <td>text?</td> + <td>メニュー用のデフォルトのロケール特有のテキストを指定する単純な要素。セパレータのテキストは必須で、この属性によって指定されようと、セパレータ要素内のテキストとして指定されようと、レイアウトデコレータがメニュー内に挿入するためのテキストとなります。</td> + </tr> + <tr> + <td><a href="guide-psml.html#PSML_Titles_and_Metadata">metadata</a>*</td> + <td>オプショナルで指定される、ロケール特有の追加のタイトルとセパレータテキスト。</td> + </tr> +</table> +<div class="original"> <p>Examples:</p> +</div> +<p>例:</p> +<div class="original"> +<source><![CDATA[ +<menu> + ... + <separator>-------------</separator> + ... + <separator> + <text>-- Top 10 Pages --</text> + <metadata name="text" xml:lang="fr">Haut Pages</metadata> + <title>Top 10 pages as voted by the Jetspeed2 users!</title> + </separator> + ... +</menu> +]]></source> +</div> <source><![CDATA[ <menu> ... @@ -306,11 +625,17 @@ ]]></source> </section> -<section name='Menu Include Definition'> +<section name='[Menu Include Definition] メニューをインクルードするための定義'> +<div class="original"> <p> The <include> element includes <a href="#Menu_Options_Definition">options</a> or nested <a href="#Menu_Definition">menus</a> from another menu. The name of the menu to include is specified as the text value of this element. There is only one valid attribute for the include element: </p> +</div> +<p> +<include> 要素は、<a href="#Menu_Options_Definition">選択肢</a> または、他のメニューのネストした <a href="#Menu_Definition">メニュー</a> を含みます。含めるメニューの名前は、このエレメントのテキスト値として指定します。この要素に含める事の出来る有効な属性は一つしかありません。 +</p> +<div class="original"> <table> <tr> <th>Attribute</th> @@ -321,7 +646,30 @@ <td>Boolean flag that controls whether the specified menu is to be nested. If this attribute is set to 'true', the included menu will be nested as a submenu; otherewise, all options and nested menus from the specified menu will be inserted inline into this menu.</td> </tr> </table> +</div> +<table> + <tr> + <th>属性</th> + <th>説明</th> + </tr> + <tr> + <td>nest</td> + <td>指定したメニューが、ネストするためのものかどうかを制御する真偽値。もしこの属性に 'true' が指定された場合、含めるメニューはサブメニューとしてネストされます。そうでないのなら、全ての選択肢と指定したメニューのネストしたメニューは、このメニュー内にインラインで挿入されます。</td> + </tr> +</table> +<div class="original"> <p>Examples:</p> +</div> +<p>例:</p> +<div class="original"> +<source><![CDATA[ +<menu> + ... + <include nest="true">navigations</include> + ... +</menu> +]]></source> +</div> <source><![CDATA[ <menu> ... @@ -331,11 +679,28 @@ ]]></source> </section> -<section name='Menu Exclude Definition'> +<section name='[Menu Exclude Definition] メニューの除外を行うための定義'> +<div class="original"> <p> The <exclude> element excludes <a href="#Menu_Options_Definition">options</a> or nested <a href="#Menu_Definition">menus</a> from another menu. This option is used primarily to remove menu options that already appear on the portal page in another menu from this menu. Matching options or menus will be excluded only if they appear above this element within a menu definition. The name of the menu to include is specified as the text value of this simple element. </p> +</div> +<p> +<exclude> 要素は、<a href="#Menu_Options_Definition">選択肢</a> もしくは、他のメニューのネストした <a href="#Menu_Definition">メニュー</a> を除外します。このオプションは主に、このメニューから、ポータルページ内の、他のメニューに既に表示されているメニューの選択肢を消去するために使われます。除外するメニューの名前は、この単純な要素のテキスト値として指定します。 +</p> +<div class="original"> <p>Examples:</p> +</div> +<p>例:</p> +<div class="original"> +<source><![CDATA[ +<menu> + ... + <exclude>pages</exclude> + ... +</menu> +]]></source> +</div> <source><![CDATA[ <menu> ... @@ -345,12 +710,18 @@ ]]></source> </section> -<section name='Page Layout Decorators'> +<section name='[Page Layout Decorators] ページレイアウトデコレータ'> +<div class="original"> <p> The page layout decorators request menus from the Portal Site Component when the page is being rendered in the Jetspeed2 pipeline. The decorators expect certain menus to be provided by the PSML declarations. Before custom menus can be displayed in the portal, the decorators need to be modified to render the custom menu. Here is an example taken from a Velocity layout decorator header.vm file: </p> +</div> +<p> +ページレイアウトデコレータは、ページが Jetspeed 2 パイプラインで描画されるとき、ポータルサイトコンポーネントからメニューをリクエストします。デコレータは、メニューが PSML で定義される事を期待します。カスタムメニューがポータルに表示される前に、デコレータは、カスタムメニューの描画を変更する必要があります。以下に、Velocity レイアウトデコレータの header.vm ファイルから抜き出した例を示します。 +</p> +<div class="original"> <source><![CDATA[ ... #set($pagesStandardMenu = $site.getMenu("pages")) @@ -361,6 +732,18 @@ #end ... ]]></source> +</div> +<source><![CDATA[ +... +#set($pagesStandardMenu = $site.getMenu("pages")) +#if(!$pagesStandardMenu.empty) + <div class="tabs"> +#includeTabsNavigation($pagesStandardMenu $LEFT_TO_RIGHT) + </div> +#end +... +]]></source> +<div class="original"> <p> This code block renders the standard pages tabs menu within a portal page. The Portal Site Component is exposed as the <i>$site</i> Velocity context variable. The test for an empty menu definition is designed to ensure that empty menus are not rendered into the page @@ -368,6 +751,11 @@ of nested menus with recursive invocations of the macro. In this case, the decorator is expecting only page options. Here is the macro implementation used to render the pages tabs menu: </p> +</div> +<p> +このコードは、ポータルページ内の標準的なページのタブメニューの描画をブロックします。ポータルサイトコンポーネントは Velocity のコンテキスト変数 <i>$site</i> として表れます。空のメニュー定義のための判断は、空のメニューがページコンテンツ内に描画されない事を保証するために設計されています。最後に、デコレータマクロが、メニューコンテンツを展開するために実行されます。一般に、再帰的なマクロの起動でネストしたメニューを描画する事をサポートするために、このアプローチを取ります。この場合、デコレータはページオプションだけを期待します。以下に、ページのタブメニューを描画するのに使われるマクロ実装を示します。 +</p> +<div class="original"> <source><![CDATA[ #macro (includeTabsNavigation $_menu $_orientation) <table border="0" cellpadding="0" cellspacing="0"> @@ -394,10 +782,43 @@ </table> #end ]]></source> +</div> +<source><![CDATA[ +#macro (includeTabsNavigation $_menu $_orientation) + <table border="0" cellpadding="0" cellspacing="0"> + <tr> + #foreach($element in $_menu.elements.iterator()) + #if($element.elementType == "option") + #set($tabTitle = $element.getTitle($preferedLocale)) + #set($tabName = $element.getShortTitle($preferedLocale)) + #if($_orientation == $LEFT_TO_RIGHT) + #if($element.isSelected($site)) + <td class="LTabLeft" nowrap="true"> </td> + <td class="LTab" align="center" valign="middle" nowrap="true" title="$!tabTitle">${tabName}</td> + <td class="LTabRight" nowrap="true"> </td> + #else + #set($tabUrl = $jetspeed.getAbsoluteUrl($element.url)) + <td class="LTabLeftLow" nowrap="true"> </td> + <td class="LTabLow" align="center" valign="middle" nowrap="true" title="$!tabTitle"><a href="$tabUrl">${tabName}</a></td> + <td class="LTabRightLow" nowrap="true"> </td> + #end + #end + #end + #end + </tr> + </table> +#end +]]></source> +<div class="original"> <p> This macro iterates over the computed page menu options supplied by the Portal Site Component, rendering a series of table data HTML elements that make up each displayed tab. The whole menu is rendered as a HTML table with a single row. </p> +</div> +<p> +このマクロは、ポータルサイトコンポーネントによって提供される、ページメニューの選択肢の計算全てに渡って反復されます。これは、表示されるタブそれぞれを作るための HTML 要素のテーブルデータを描画します。全てのメニューは、単一の行の HTML テーブルとして描画されます。 +</p> +<div class="original"> <p> The declarative menu Portal Site Component objects exposed to the layout decorators are documented in the <a href="../multiproject/jetspeed-api/apidocs/index.html">Jetspeed API</a>. Here is a list of the primary interfaces @@ -412,14 +833,32 @@ Please refer to the <a href="../multiproject/jetspeed-api/apidocs/index.html">javadocs</a> for these interfaces and sample Velocity decorators for more information. </p> +</div> +<p> +レイアウトデコーレータによって表示する、宣言型のメニューポータルサイトコンポーネントオブジェクトは、<a href="../multiproject/jetspeed-api/apidocs/index.html">Jetspeed API</a> の文書に記述されます。以下に、このインタフェースを作るためのプライマリのインタフェースのリストを以下に挙げます。 +<ul> + <li><a href="../multiproject/jetspeed-api/apidocs/org/apache/jetspeed/portalsite/Menu.html">org.apache.jetspeed.portalsite.Menu</a></li> + <li><a href="../multiproject/jetspeed-api/apidocs/org/apache/jetspeed/portalsite/MenuElement.html">org.apache.jetspeed.portalsite.MenuElement</a></li> + <li><a href="../multiproject/jetspeed-api/apidocs/org/apache/jetspeed/portalsite/MenuOption.html">org.apache.jetspeed.portalsite.MenuOption</a></li> + <li><a href="../multiproject/jetspeed-api/apidocs/org/apache/jetspeed/portalsite/MenuSeparator.html">org.apache.jetspeed.portalsite.MenuSeparator</a></li> + <li><a href="../multiproject/jetspeed-api/apidocs/org/apache/jetspeed/portalsite/PortalSiteRequestContext.html">org.apache.jetspeed.portalsite.PortalSiteRequestContext</a></li> +</ul> +更に情報が欲しい場合は、これらのインタフェースの <a href="../multiproject/jetspeed-api/apidocs/index.html">javadoc</a> とサンプルの Velocity デコレータを参照してください。 +</p> +<div class="original"> <p> Jetspeed2 provides many sample decorators including those that will render tabs, navigation panes with nested submenus, history breadcrumb links, and even DHTML JSCookMenu nested pulldown menus... all from the declarative menu elements documented here. </p> +</div> +<p> +Jetspeed 2 には、タブやネストしたサブメニューを持つナビゲーションペインや、閲覧履歴のブレッドクラムリンクや、ネストしたプルダウンメニューの DHTML JSCookMenu さえも、ここで述べた宣言型のメニュー要素全ての、たくさんのサンプルのデコレータが含まれています。 +</p> </section> -<section name='Portal Site Component'> +<section name='[Portal Site Component] ポータルサイトコンポーネント'> +<div class="original"> <p> The Jetspeed2 Portal Site Component has two closely related responsibilities: <ol> @@ -429,12 +868,26 @@ At first glance, these functions seem relatively simple: searching within and traversing the <a href="guide-psml.html">PSML site definition</a>. However, once the complexities of the <a href="guide-profiler.html">Profiler</a> aggregation and <a href="guide-security-declarative-psml.html">Security Constraints</a> filtering are taken into account, the mapping is no longer trivial. </p> +</div> +<p> +Jetspeed 2 のポータルサイトコンポーネントには、二つの密接に関係した役割があります。 +<ol> + <li>ユーザからのポータルのリクエスト URI を、サイト内の PSML <a href="guide-psml.html#Page">ページ</a> もしくは <a href="guide-psml.html#Folder">フォルダ</a> 要素にマップします。そして、</li> + <li>サイトでユーザが利用可能なものを反映した、サイトのナビゲーションメニューと、メニューの選択肢を構築します。</li> +</ol> +一見、これらの機能は、<a href="guide-psml.html">PSML サイト定義</a> を検索し、走査するだけの、比較的シンプルなものであるように見えます。しかし、一度 <a href="guide-profiler.html">プロファイラ</a> の集約と<a href="guide-security-declarative-psml.html">セキュリティ制約</a> のフィルタリングの複雑さが採り入れられると、マッピングはもはや単純ではなくなります。 +</p> +<div class="original"> <p> It is important to note that menu options are matched against the Portal Site Component mapped view of the PSML site. The document paths specified in the menu elements are not the physical paths used to navigate the PSML folders and pages. Instead, paths that mirror portal requests are used to select PSML elements to include as menu options. In this manner, profiling and security are automatically factored into the menu option population... rather as if running the request url mapping in reverse. </p> +</div> +<p> +メニューの選択肢は、PSML サイトのポータルサイトコンポーネントがマッチさせるビューと一致していることに注意することが重要です。メニュー要素の指定するドキュメントのバスは、PSML フォルダやページを指し示すために使われる物理パスではありません。代わりに、ポータルリクエストをミラーするパスは、メニューの選択肢として含める PSML 要素を選択するのに使われます。このように、プロファイリングとセキュリティは、あたかも実行中のリクエスト URI を逆にマップするかのように、メニューの選択肢の集団に自動的に含まれます。 +</p> </section> </body>
