shins****@users*****
shins****@users*****
2006年 2月 23日 (木) 07:50:55 JST
Update of /cvsroot/jetspeed-japan/jetspeed-2-trans/ja/xdocs/guides In directory sf-cvs:/tmp/cvs-serv10798/ja/xdocs/guides Modified Files: guide-psml.xml Log Message: submitted by KATOH Yasufumi jetspeed-2-trans/ja/xdocs/guides/guide-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-psml.xml.diff?r1=1.1.1.1&r2=1.2 =================================================================== RCS file: jetspeed-2-trans/ja/xdocs/guides/guide-psml.xml,v retrieving revision 1.1.1.1 retrieving revision 1.2 diff -u -r1.1.1.1 -r1.2 --- guide-psml.xml 2005/12/16 03:43:36 1.1.1.1 +++ guide-psml.xml 2006/02/22 22:50:55 1.2 @@ -1,728 +1,1482 @@ -<?xml version="1.0"?> -<!-- -Copyright 2004-2005 The Apache Software Foundation - -Licensed under the Apache License, Version 2.0 (the "License"); -you may not use this file except in compliance with the License. -You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - -Unless required by applicable law or agreed to in writing, software -distributed under the License is distributed on an "AS IS" BASIS, -WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -See the License for the specific language governing permissions and -limitations under the License. ---> -<document> - <properties> - <title>PSML</title> - <subtitle>Documentation for Designers working with PSML</subtitle> - <authors> - <person name="David Sean Taylor" email="taylo****@apach*****"/> - <person name="Randy Watler" email="rwatl****@apach*****"/> - </authors> - </properties> - <body> -<section name="PSML"> -<ul> - <li><a href="#Page">Page</a></li> - <ul> - <li><a href="#Defaults">Defaults</a></li> - <li><a href="#Layout_Fragments">Layout Fragments</a></li> - <li><a href="#Portlet_Fragments">Portlet Fragments</a></li> - <li><a href="#Fragment_Properties">Fragment Properties</a></li> - <li><a href="#Preferences">Portlet Preferences</a></li> - </ul> - <li><a href="#Folder">Folder</a></li> - <li><a href="#Link">Link</a></li> - <li><a href="#Global_Page_Security">Global Page Security</a></li> - <li><a href="#PSML_Titles_and_Metadata">Titles and Metadata</a></li> - <li><a href="#PSML_Security_Constraints">Security Constraints</a></li> - <li><a href="#PSML_Menus">Menus</a></li> -</ul> - -<p> -PSML is an acronym for Portal Structure Markup Language. It was created to allow content structure and abstraction within Jetspeed. -PSML defines how portlets are aggregated, layed out, and decorated on a portal page. Note that page layout is not a part of the Java -Portlet Standard API. Thus PSML is a Jetspeed-specific implementation. Also note that PSML in Jetspeed-2 is different from PSML in -Jetspeed-1. This document can be used as a reference guide to the elements of a PSML resource. -</p> -<p> -PSML files also capture other portal site information related to pages, folders, links, and global security constraints. -Each of these primary PSML elements are captured in separate documents arranged in a hierarchy of directories in the file system. -Typically, this directory is accessed as a resource at /WEB-INF/pages within the jetspeed web application. -</p> -<p> -Here is an example PSML file for a portal site <a href="#Page">page</a>, (*.psml): -</p> -<source><![CDATA[ -<?xml version="1.0" encoding="UTF-8"?> -<page> - <!-- page info --> - <title>Welcome to Jetspeed 2</title> - <metadata name="title" xml:lang="fr">Ma Premiere Page de PSML</metadata> - <metadata name="title" xml:lang="es">臓Bienvenido a Jetspeed 2!</metadata> - <metadata name="title" xml:lang="hu">K旦sz旦nti a Jetspeed 2!</metadata> - - <!-- page decoration --> - <defaults skin="orange" layout-decorator="tigris" portlet-decorator="tigris"/> - - <!-- page fragments --> - <fragment id="100393" type="layout" name="jetspeed-layouts::VelocityOneColumn"> - <fragment id="100939" type="portlet" name="j2-admin::LocaleSelector"> - <property layout="OneColumn" name="row" value="0"/> - </fragment> - <fragment id="100345" type="layout" name="jetspeed-layouts::VelocityTwoColumns"> - <property layout="OneColumn" name="row" value="1"/> - <property layout="TwoColumns" name="sizes" value="33%,66%"/> - <fragment id="100121" type="portlet" name="j2-admin::LoginPortlet"> - <property layout="TwoColumns" name="row" value="0"/> - <property layout="TwoColumns" name="column" value="0"/> - </fragment> - <fragment id="100171" type="portlet" name="demo::UserInfoTest"> - <property layout="TwoColumns" name="row" value="0"/> - <property layout="TwoColumns" name="column" value="1"/> - </fragment> - </fragment> - </fragment> - - <!-- security constraints --> - <security-constraints> - <security-constraints-ref>public-view</security-constraints-ref> - </security-constraints> -</page> -]]></source> -<p> -Here is an example PSML file that defines portal site <a href="#Folder">folder</a>, (folder.metadata): -</p> -<source><![CDATA[ -<?xml version="1.0" encoding="UTF-8"?> -<folder> - <!-- folder description --> - <title>Root Folder</title> - <metadata name="title" xml:lang="fr">R辿pertoire racine</metadata> - <metadata name="title" xml:lang="es">Carpeta raiz</metadata> - - <!-- order of documents in folder --> - <document-order>Jetspeed2.link</document-order> - <document-order>Jetspeed2Wiki.link</document-order> - <document-order>apache_portals.link</document-order> - <document-order>apache.link</document-order> - - <!-- portal site menus --> - <menu name="page-navigations"> - <separator> - <text>Top Pages</text> - <metadata name="text" xml:lang="fr">Page haut</metadata> - <metadata name="text" xml:lang="es">P叩ginas m叩s populares</metadata> - </separator> - <options>/Administrative</options> - <separator> - <text>Profiled Pages</text> - <metadata name="text" xml:lang="es">P叩ginas del Perfil</metadata> - </separator> - <options regexp="true">/p[0-9][0-9][0-9].psml</options> - <separator> - <text>Non Java Pages</text> - <metadata name="text" xml:lang="es">Ejemplos sin java</metadata> - </separator> - <options>/non-java</options> - </menu> - - <!-- security constraints --> - <security-constraints> - <security-constraints-ref>public-view</security-constraints-ref> - </security-constraints> -</folder> -]]></source> -<p> -Here is an example PSML file for a portal site <a href="#Link">link</a>, (*.link): -</p> -<source><![CDATA[ -<?xml version="1.0" encoding="UTF-8"?> -<link target="top"> - <!-- link description --> - <title>Jetspeed 2 Home Page</title> - <url>http://portals.apache.org/jetspeed-2/</url> - <metadata name="title" xml:lang="es">Jetspeed 2</metadata> -</link> -]]></source> -<p> -Here is an example PSML file for the portal site <a href="#Global_Page_Security">page security</a>, (page.security): -</p> -<source><![CDATA[ -<?xml version="1.0" encoding="UTF-8"?> -<page-security> - <!-- global admin constraints --> - <security-constraints-def name="admin"> - <security-constraint> - <roles>admin</roles> - <permissions>view, edit</permissions> - </security-constraint> - </security-constraints-def> - <global-security-constraints-ref>admin</global-security-constraints-ref> - - <!-- public constraints --> - <security-constraints-def name="public-view"> - <security-constraint> - <users>*</users> - <permissions>view</permissions> - </security-constraint> - </security-constraints-def> - <security-constraints-def name="public-edit"> - <security-constraint> - <users>*</users> - <permissions>view, edit</permissions> - </security-constraint> - </security-constraints-def> -</page-security> -]]></source> -</section> -<section name='Page'> -<p> -The <page> element is a simple container to hold other PSML elements associated with a portal site page. -This element is persisted as a file with a '.psml' extension in the appropriate file system directory associated with the parent <a href="#Folder">folder</a>. -There are two valid attributes for the page element: -</p> -<table> - <tr> - <th>Attribute</th> - <th>Description</th> - </tr> - <tr> - <td>hidden</td> - <td>A boolean attribute used to indicate that a page should not appear in portal site menus or other navigational elements.</td> - </tr> - <tr> - <td>version</td> - <td>A general purpose version tracking attribute. Not currently used by Jetspeed2.</td> - </tr> -</table> -<p> -The <page> element contains a number of other PSML elements: -</p> -<table> - <tr> - <th>Element</th> - <th>Description</th> - </tr> - <tr> - <td>title?</td> - <td>Simple element containing text for the default page title. The title of the page is considered its long description and is used as rollover text in some decorators if the short title is available for the menu text. If not specified, Jetspeed2 will attempt to define a title from the name of the file that contains the page element.</td> - </tr> - <tr> - <td>short-title?</td> - <td>Optional simple element containing text of the default short title for the page. The short title, if available, is used as menu text in some decorators. If not specified, the title text is used.</td> - </tr> - <tr> - <td><a href="#Defaults">defaults</a></td> - <td>Specifies the decorations for the page and its fragments. Defaults are required for each page.</td> - </tr> - <tr> - <td><a href="#Layout_Fragments">fragment</a></td> - <td>The root of the fragment hierarchy. All pages require a root Fragment.</td> - </tr> - <tr> - <td><a href="#PSML_Titles_and_Metadata">metadata</a>*</td> - <td>Optionally specifies locale specific titles and short titles for the page.</td> - </tr> - <tr> - <td><a href="#Menus">menu</a>*</td> - <td>Optionally specifies additional or overrides inherited menu definitions for the page.</td> - </tr> - <tr> - <td><a href="#PSML_Security_Constraints">security-constraints</a>?</td> - <td>Optionally defines inline security constraints for the page. If not specified, the page inherits the security constraints effective in the parent <a href="#Folder">folder</a>.</td> - </tr> -</table> -<p>Example: <a href="#PSML">see intoductory examples above.</a></p> -</section> - -<section name='Defaults'> -<p> -The <a href="#Page">page</a> <defaults> element defines the default layout decorator and default portlet decorator. -The default layout decorator is applied to all layout fragments which do NOT have a decorator attribute. -The default portlet decorator is applied to all portlet fragments which do NOT have a decorator attribute. -There are three valid attributes on the defaults element: -</p> -<table> - <tr> - <th>Attribute</th> - <th>Description</th> - </tr> - <tr> - <td>layout-decorator</td> - <td>The name of the layout decorator used to render the page. This attribute is required.</td> - </tr> - <tr> - <td>portlet-decorator</td> - <td>The name of the default portlet decorator used to render the page fragments. This attribute is optional, but is almost always set.</td> - </tr> - <tr> - <td>skin</td> - <td>A general purpose decorator attribute that can be referenced in the decorators to control page and fragment presentation. Not currently used by Jetspeed2.</td> - </tr> -</table> -<p>Example:</p> -<source><![CDATA[ -<page> - ... - <defaults skin="orange" layout-decorator="tigris" portlet-decorator="tigris"/> - ... -</page> -]]></source> -</section> - -<section name='Layout Fragments'> -<p> -The <a href="#Page">page</a> layout <fragment> element is a hierarchical container used to hold <a href="#Portlet_Fragments">portlet fragments</a> and nested layout fragments. -The root fragment of a <a href="#Page">page</a> must be a layout fragment, even when only one portlet fragment is part of the page. -Layout fragments are subject to layout of the parent layout fragment and thus support the 'row' and 'column' <a href="#Fragment_Properties">layout properties</a>. -In addition, they also support the 'sizes' layout property used to control multicolumn layout proportions. -There are 3 required attributes for this element: -</p> -<table> - <tr> - <th>Attribute</th> - <th>Description</th> - </tr> - <tr> - <td>id</td> - <td>The required id is used to identify a fragment and <b>must</b> be unique across all fragments defined within the site. The value is opaque to Jetspeed2 and can follow any convention to guarantee uniqueness. Since fragments may be cached internally by Jetspeed2, any edits to exiting pages may require new ids to ensure the modifications are taken by Jetspeed2.</td> - </tr> - <tr> - <td>type</td> - <td>This required attribute must be set to 'layout' for all layout fragments.</td> - </tr> - <tr> - <td>name</td> - <td>The required name of the portlet used to implement the fragment layout. The portlet name generally takes the form of 'portlet-app-id:portlet-id' as specified in the portlet.xml files. Here are the supported Jetspeed2 layout portlet names: - <ul> - <li>jetspeed-layouts::FrameLayoutPortlet</li> - <li>jetspeed-layouts::VelocityOneColumn</li> - <li>jetspeed-layouts::VelocityOneColumnNoActions</li> - <li>jetspeed-layouts::VelocityThreeColumns</li> - <li>jetspeed-layouts::VelocityThreeColumnsNoActions</li> - <li>jetspeed-layouts::VelocityThreeColumnsTable</li> - <li>jetspeed-layouts::VelocityTwoColumns</li> - <li>jetspeed-layouts::VelocityTwoColumns2575</li> - <li>jetspeed-layouts::VelocityTwoColumns2575NoActions</li> - <li>jetspeed-layouts::VelocityTwoColumnsNoActions</li> - <li>jetspeed-layouts::VelocityTwoColumnsSmallLeft</li> - <li>jetspeed-layouts::VelocityTwoColumnsSmallLeftNoActions</li> - <li>jetspeed-layouts::VelocityTwoColumnsTable</li> - </ul> - </td> - </tr> -</table> -<p> -The layout <fragment> element contains a number of other PSML elements: -</p> -<table> - <tr> - <th>Element</th> - <th>Description</th> - </tr> - <tr> - <td><a href="#Portlet_Fragments">fragment*</a></td> - <td>Specified fragment elements can be either portlet fragments to be laid out by this layout fragment or nested layout fragments. All child fragments will have required <a href="#Fragment_Properties">property</a> elements to specify their positions in this layout. Specifying no fragments within a layout fragment will result in no content being generated.</td> - </tr> - <tr> - <td><a href="#Fragment_Properties">property*</a></td> - <td>Layout fragments can have an optional 'sizes' property that can be used to specify multicolumn layout proportions. Nested layout fragments may also have 'row' and/or 'column' properties to identify its positional location in the parent layout.</td> - </tr> - <tr> - <td><a href="#PSML_Security_Constraints">security-constraints</a>?</td> - <td>Optionally defines inline security constraints for the fragment and its child fragments. Unlike, page, folder, and link constraints, only 'view' permissions can be constrained. If not specified, the fragment inherits the security constraints effective in the <a href="#Page">page</a>.</td> - </tr> -</table> -<p>Example:</p> -<source><![CDATA[ -<page> - ... - <fragment id="100393" type="layout" name="jetspeed-layouts::VelocityOneColumn"> - <fragment id="100939" type="portlet" name="j2-admin::LocaleSelector"> - <property layout="OneColumn" name="row" value="0"/> - </fragment> - <fragment id="100345" type="layout" name="jetspeed-layouts::VelocityTwoColumns"> - <property layout="OneColumn" name="row" value="1"/> - <property layout="TwoColumns" name="sizes" value="33%,66%"/> - <fragment id="100121" type="portlet" name="j2-admin::LoginPortlet"> - <property layout="TwoColumns" name="row" value="0"/> - <property layout="TwoColumns" name="column" value="0"/> - </fragment> - <fragment id="100171" type="portlet" name="demo::UserInfoTest"> - <property layout="TwoColumns" name="row" value="0"/> - <property layout="TwoColumns" name="column" value="1"/> - </fragment> - </fragment> - </fragment> - ... -</page> -]]></source> -</section> - -<section name='Portlet Fragments'> -<p> -The portlet <fragment> element is used to identify portlets on the page. Portlet fragments are subject to layout of the parent layout fragment and thus support the 'row' and 'column' <a href="#Fragment_Properties">layout properties</a> as required by the layout. -There are many valid attributes for this element: -</p> -<table> - <tr> - <th>Attribute</th> - <th>Description</th> - </tr> - <tr> - <td>id</td> - <td>The required id is used to identify a fragment and <b>must</b> be unique across all fragments defined within the site. The value is opaque to Jetspeed2 and can follow any convention to guarantee uniqueness. Since fragments may be cached internally by Jetspeed2, any edits to exiting pages may require new ids to ensure the modifications are taken by Jetspeed2.</td> - </tr> - <tr> - <td>type</td> - <td>This required attribute must be set to 'portlet' for all portlet fragments.</td> - </tr> - <tr> - <td>name</td> - <td>The required name of the portlet used to populate the fragment content. The portlet name generally takes the form of 'portlet-app-id:portlet-id' as specified in the portlet.xml files.</td> - </tr> - <tr> - <td>skin</td> - <td>A general purpose decorator attribute that can be referenced in the portlet decorators to control fragment presentation. Not currently used by Jetspeed2.</td> - </tr> - <tr> - <td>decorator</td> - <td>The name of the default portlet decorator used to render the fragments. This attribute is optional, but if it is not specified, the <a href="#Defaults">defaults</a> for the page must specify a default portlet decorator.</td> - </tr> - <tr> - <td>state</td> - <td>The initial state of the fragment portlet; 'hidden' is currently the only valid value for this attribute.</td> - </tr> -</table> -<p> -The portlet <fragment> element contains other PSML elements: -</p> -<table> - <tr> - <th>Element</th> - <th>Description</th> - </tr> - <tr> - <td><a href="#Fragment_Properties">property*</a></td> - <td>Parent fragments may have 'row' and/or 'column' properties to identify positional location in the parent layout.</td> - </tr> - <tr> - <td>title?</td> - <td>Optional simple text element containing title for fragment portlet, overridding titles set in portlet.xml.</td> - </tr> - <tr> - <td><a href="#Preferences">preference*</a></td> - <td>Specifies initial user preference settings for fragment portlet, overridding any portlet preferences set in portlet.xml. User preferences, in turn, override these values.</td> - </tr> - <tr> - <td><a href="#PSML_Security_Constraints">security-constraints</a>?</td> - <td>Optionally defines inline security constraints for the fragment. Unlike, page, folder, and link constraints, only 'view' permissions can be constrained. If not specified, the fragment inherits the security constraints effective in the <a href="#Page">page</a>.</td> - </tr> -</table> -<p>Example:</p> -<source><![CDATA[ -<fragment id="100393" type="layout" name="jetspeed-layouts::VelocityOneColumn"> - ... - <fragment id="100939" type="portlet" name="j2-admin::LocaleSelector"> - <property layout="OneColumn" name="row" value="0"/> - </fragment> - ... -</fragment> -]]></source> -</section> - -<section name='Fragment Properties'> -<p> -The <a href="#Portlet_Fragments">fragment</a> <property> element is use to specify named properties for fragments. These properties are used commonly to specify layout portlet parameters and portlet positional location within the page. The property element has 3 supported attributes: -</p> -<table> - <tr> - <th>Attribute</th> - <th>Description</th> - </tr> - <tr> - <td>layout <i>(deprecated)</i> </td> - <td>The symbolic name of the layout fragment portlet the property is associated with. This attribute is supported for compatibility reasons. The strictly hierarchical structure of layout and portlet fragments implies that any single fragment and its properties can be subject to one layout fragment portlet.</td> - </tr> - <tr> - <td>name</td> - <td>The fragment property name. Jetspeed2 layout portlets support the 'row', 'column' and 'sizes' properties.</td> - </tr> - <tr> - <td>value</td> - <td>The fragment property value. The 'row' and 'column' properties accept 0-based indicies values. The 'sizes' property accepts HTML frameset tag 'rows' and 'cols' attributes sytax, (i.e. '25%,75%').</td> - </tr> -</table> -<p>Examples:</p> -<source><![CDATA[ -<fragment id="100876" type="portlet" name="j2-admin::LoginPortlet"> - ... - <property layout="TwoColumns" name="row" value="2"/> - <property layout="TwoColumns" name="column" value="1"/> - ... -</fragment> -]]></source> -<source><![CDATA[ -<fragment id="103456" type="layout" name="jetspeed-layouts::VelocityTwoColumns"> - ... - <property layout="TwoColumns" name="sizes" value="33%,66%"/> - ... -</fragment> -]]></source> -</section> - -<section name='Preferences'> -<p> -The <a href="#Portlet_Fragments">portlet fragment</a> <preference> elements allows for the defining of portlet preferences. -This provides an eaiser avenue for the setting of default portlet prefences for a portlet -instance on a page without having to duplicate a portlet definition within -the portlet application's portlet.xml. -</p> -<p> -Preference precedence: User Defined > Fragment Defined > portlet.xml Defined. -</p> -<p>The <preference> element attributes:</p> -<table> - <tr> - <th>Attribute</th> - <th>Description</th> - </tr> - <tr> - <td>name</td> - <td>The name of the preference.</td> - </tr> - <tr> - <td>readOnly</td> - <td>Boolean indicating whether or not the user can change the value of this preference.</td> - </tr> -</table> -<p>The <preference> element contains these elements:</p> -<table> - <tr> - <th>Element</th> - <th>Description</th> - </tr> - <tr> - <td>value+</td> - <td>Simple text element containing a value associated with the named preference.</td> - </tr> -</table> -<p>Example:</p> -<source><![CDATA[ -<fragment id="uhtemp-1012" type="portlet" name="demo::BookmarkPortlet"> - ... - <preference name="Google" readOnly="false"> - <value>http://www.google.com</value> - </preference> - ... -</fragment> -]]></source> -</section> - -<section name='Folder'> -<p> -The <folder> element is a simple container to hold other PSML elements associated with a portal site folder. -This element is persisted as a folder.metadata file in the associated file system directory. -There are two valid attributes for the folder element: -</p> -<table> - <tr> - <th>Attribute</th> - <th>Description</th> - </tr> - <tr> - <td>hidden</td> - <td>A boolean attribute used to indicate that a folder should not appear in portal site menus or other navigational elements.</td> - </tr> - <tr> - <td>version</td> - <td>A general purpose version tracking attribute. Not currently used by Jetspeed2.</td> - </tr> -</table> -<p> -The <folder> element contains a number of other PSML elements: -</p> -<table> - <tr> - <th>Element</th> - <th>Description</th> - </tr> - <tr> - <td>title?</td> - <td>Simple element containing text for the default folder title. The title of the folder is considered its long description and is used as rollover text in some decorators if the short title is available for the menu text. If not specified, Jetspeed2 will attempt to define a title from the name of the file that contains the folder element.</td> - </tr> - <tr> - <td>short-title?</td> - <td>Optional simple element containing text of the default short title for the folder. The short title, if available, is used as menu text in some decorators. If not specified, the title text is used.</td> - </tr> - <tr> - <td>default-page?</td> - <td>Optional simple element containing text with the default page or subfolder name for the folder. The default page is used when the folder is directly referenced in the portal. The name of any <a href="#Page">page</a> or folder in this folder, (including '..' for the parent folder), can be specified. If no default page is set, the page named 'default-page.psml' will be used; if 'default-page.psml' does not exist, the first page in the folder will become the default.</td> - </tr> - - <tr> - <td>document-order*</td> - <td>An optional collection of simple elements containing text names used to define a sort order for <a href="#Page">page</a>, subfolder, and <a href="#Link">link</a> members. Members with matching names will be arranged in the order these elements are defined. Other members will be sorted by their names and will appear in menus and other lists after the matching members. Regular expressions for name matching are not supported.</td> - </tr> - - <tr> - <td><a href="#PSML_Titles_and_Metadata">metadata</a>*</td> - <td>Optionally specifies locale specific titles and short titles for the folder.</td> - </tr> - <tr> - <td><a href="#Menus">menu</a>*</td> - <td>Optionally specifies additional or overrides inherited menu definitions for the folder.</td> - </tr> - <tr> - <td><a href="#PSML_Security_Constraints">security-constraints</a>?</td> - <td>Optionally defines inline security constraints for the folder. If not specified, the folder inherits the security constraints effective in the parent folder.</td> - </tr> -</table> -<p>Example: <a href="#PSML">see intoductory examples above.</a></p> -</section> - -<section name='Link'> -<p> -The <link> element is a simple container to hold other PSML elements associated with a portal link used to reference content external to the portal site. -This element is persisted as a file with a '.link' extension in the appropriate file system directory associated with the parent <a href="#Folder">folder</a>. -There are two valid attributes for the link element: -</p> -<table> - <tr> - <th>Attribute</th> - <th>Description</th> - </tr> - <tr> - <td>target</td> - <td>An optional target frame name in which to open the external content. If not specified, the linked content will replace the portal in the browser.</td> - </tr> - <tr> - <td>version</td> - <td>A general purpose version tracking attribute. Not currently used by Jetspeed2.</td> - </tr> -</table> -<p> -The <link> element contains a number of other PSML elements: -</p> -<table> - <tr> - <th>Element</th> - <th>Description</th> - </tr> - <tr> - <td>title?</td> - <td>Simple element containing text for the default link title. The title of the link is considered its long description and is used as rollover text in some decorators if the short title is available for the menu text. If not specified, Jetspeed2 will attempt to define a title from the name of the file that contains the link element.</td> - </tr> - <tr> - <td>short-title?</td> - <td>Optional simple element containing text of the default short title for the link. The short title, if available, is used as menu text in some decorators. If not specified, the title text is used.</td> - </tr> - <tr> - <td>url</td> - <td>The required content url element. The text of this element will be used to navigate the specified target frame in the browser.</td> - </tr> - <tr> - <td><a href="#PSML_Titles_and_Metadata">metadata</a>*</td> - <td>Optionally specifies locale specific titles and short titles for the link.</td> - </tr> - <tr> - <td><a href="#PSML_Security_Constraints">security-constraints</a>?</td> - <td>Optionally defines inline security constraints for the link. If not specified, the link inherits the security constraints effective in the parent <a href="#Folder">folder</a>.</td> - </tr> -</table> -<p>Example: <a href="#PSML">see intoductory examples above.</a></p> -</section> - -<section name='Global Page Security'> -<p> -The <page-security> element is a simple container to hold other PSML elements used to declare global security constraints and their definitions.. -This element is persisted as the page.security file and is always located in the root directory of the PSML file system directories. -There is only one valid attribute for the page security element: -</p> -<table> - <tr> - <th>Attribute</th> - <th>Description</th> - </tr> - <tr> - <td>version</td> - <td>A general purpose version tracking attribute. Not currently used by Jetspeed2.</td> - </tr> -</table> -<p> -The <page-security> element contains two security constraints related PSML elements: -</p> -<table> - <tr> - <th>Element</th> - <th>Description</th> - </tr> - <tr> - <td><a href="#PSML_Security_Constraints">security-constraints-def</a>*</td> - <td>Optionally defines a collection of security constraints defined by name. These security constraints are referenced in <a href="#Page">pages</a>, <a href="#Layout_Fragments">fragments</a>, <a href="#Folder">folders</a>, and <a href="#Link">links</a> and in this element to facilitate reuse and security maintenance.</td> - </tr> - <tr> - <td><a href="#PSML_Security_Constraints">global-security-constraints-ref</a>*</td> - <td>Optionally defines security constraints references to be applied to all security constraints in the site. The text of each simple element references a named security constraints definition specified here in this element.</td> - </tr> -</table> -<p>Example: <a href="#PSML">see intoductory examples above.</a></p> -</section> - -<section name='PSML Titles and Metadata'> -<p> -The <a href="#Page">page</a>, <a href="#Folder">folder</a>, and <a href="#Link">link</a> <metadata> element is used to define locale specific title and short title text. -Any number of these elements may appear within a containing PSML element, but multiple named values should not be specified for a single locale. -The PSML xml documents are normally declared with the UTF-8 encoding to support a wide variety of character sets. -</p> -<table> - <tr> - </tr> - <th>Attribute</th> - <th>Description</th> - <tr> - <td>name</td> - <td>Name of the metadata text. This name should be either 'title' or 'short-title' to specify locale specific title text.</td> - </tr> - <tr> - <td>xml:lang</td> - <td>The locale language or language/country selector for the metadata text. The conventional Java Locale names are expected, (ISO-639 and ISO-3166). Valid values would include 'en' and 'en_US'.</td> - </tr> -</table> -<p>Example:</p> -<source><![CDATA[ -<page> - ... - <metadata name="title" xml:lang="fr">Ma Premiere Page de PSML</metadata> - <metadata name="title" xml:lang="es">臓Bienvenido a Jetspeed 2!</metadata> - <metadata name="title" xml:lang="hu">K旦sz旦nti a Jetspeed 2!</metadata> - ... -</page> -]]></source> -</section> - -<section name="PSML Security Constraints"> -<p> -The <security-constraints>, <security-constraints-def>, and <global-security-constraints-ref> elements that appear in <a href="#Page">pages</a>, <a href="#Layout_Fragments">fragments</a>, <a href="#Folder">folders</a>, <a href="#Link">links</a>, and the <a href="#Global_Page_Security">page security</a> elements above are documented separately in the the Declarative Security Constraints Guide. -</p> -<p> -<a href='guide-security-declarative-psml.html'>Declarative Security Constraints Guide</a> -</p> -</section> - -<section name="PSML Menus"> -<p> -The <menu> element that appears in <a href="#Page">page</a> and <a href="#Folder">folder</a> elements above are documented separately in the the Declarative Menus Guide. -</p> -<p> -<a href='guide-menus-declarative-psml.html'>Declarative Menus Guide</a> -</p> -</section> - -</body> -</document> - +<?xml version="1.0"?> +<!-- +Copyright 2004-2005 The Apache Software Foundation + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> +<document> + <properties> + <title>PSML</title> + <subtitle>Documentation for Designers working with PSML</subtitle> + <authors> + <person name="David Sean Taylor" email="taylo****@apach*****"/> + <person name="Randy Watler" email="rwatl****@apach*****"/> + </authors> + <translators> + <person name="加藤泰文" email="karma****@prog*****" /> + </translators> + </properties> + <body> +<section name="[PSML] PSML"> +<div class="original"> +<ul> + <li><a href="#Page">Page</a></li> + <ul> + <li><a href="#Defaults">Defaults</a></li> + <li><a href="#Layout_Fragments">Layout Fragments</a></li> + <li><a href="#Portlet_Fragments">Portlet Fragments</a></li> + <li><a href="#Fragment_Properties">Fragment Properties</a></li> + <li><a href="#Preferences">Portlet Preferences</a></li> + </ul> + <li><a href="#Folder">Folder</a></li> + <li><a href="#Link">Link</a></li> + <li><a href="#Global_Page_Security">Global Page Security</a></li> + <li><a href="#PSML_Titles_and_Metadata">Titles and Metadata</a></li> + <li><a href="#PSML_Security_Constraints">Security Constraints</a></li> + <li><a href="#PSML_Menus">Menus</a></li> +</ul> +</div> +<ul> + <li><a href="#Page">ページ</a></li> + <ul> + <li><a href="#Defaults">デフォルト</a></li> + <li><a href="#Layout_Fragments">ページフラグメント</a></li> + <li><a href="#Portlet_Fragments">ポートレットフラグメント</a></li> + <li><a href="#Fragment_Properties">フラグメントプロパティ</a></li> + <li><a href="#Preferences">ポートレットプリファレンス</a></li> + </ul> + <li><a href="#Folder">フォルダ</a></li> + <li><a href="#Link">リンク</a></li> + <li><a href="#Global_Page_Security">大域的なページセキュリティ</a></li> + <li><a href="#PSML_Titles_and_Metadata">タイトルとメタデータ</a></li> + <li><a href="#PSML_Security_Constraints">セキュリティ制限</a></li> + <li><a href="#PSML_Menus">メニュー</a></li> +</ul> + +<div class="original"> +<p> +PSML is an acronym for Portal Structure Markup Language. It was created to allow content structure and abstraction within Jetspeed. +PSML defines how portlets are aggregated, layed out, and decorated on a portal page. Note that page layout is not a part of the Java +Portlet Standard API. Thus PSML is a Jetspeed-specific implementation. Also note that PSML in Jetspeed-2 is different from PSML in +Jetspeed-1. This document can be used as a reference guide to the elements of a PSML resource. +</p> +</div> +<p> +PSML は Portal Structure Markup Language の頭文字を取った物です。PSML は Jetspeed 内のコンテンツの構造化と抽象化を行うために作成されます。PSML はポータルページ上でポートレットがどのように集約され、レイアウトされ、装飾されるかを定義します。ページレイアウトは、Java ポートレット標準 API の守備範囲ではないことに注意してください。なので PSML は Jetspeed 特有の実装です。そして、Jetspeed 2 の PSML は Jetspeed 1 の PSML とも違うことに注意してください。このドキュメントは PSML リソースのエレメントのリファレンスガイドとして使えます。 +</p> +<div class="original"> +<p> +PSML files also capture other portal site information related to pages, folders, links, and global security constraints. +Each of these primary PSML elements are captured in separate documents arranged in a hierarchy of directories in the file system. +Typically, this directory is accessed as a resource at /WEB-INF/pages within the jetspeed web application. +</p> +</div> +<p> +PSML ファイルは、ページやフォルダやリンクや広域的なセキュリティ制限と関係する他のポータルサイトの情報も記録します。これらの主要な PSML の要素のそれぞれは、ファイルシステム上のディレクトリ構造内に配置された別々のドキュメント内に記録されます。一般的に、このディレクトリは Jetspeed ウェブアプリケーション内の /WEB-INF/pages にあるリソースとしてアクセスされます。 +</p> +<div class="original"> +<p> +Here is an example PSML file for a portal site <a href="#Page">page</a>, (*.psml): +</p> +</div> +<p> +以下にポータルサイトの <a href="#Page">ページ</a> 用の PSML ファイル (*.psml) の例を示します。 +</p> +<div class="original"> +<source><![CDATA[ +<?xml version="1.0" encoding="UTF-8"?> +<page> + <!-- page info --> + <title>Welcome to Jetspeed 2</title> + <metadata name="title" xml:lang="fr">Ma Premiere Page de PSML</metadata> + <metadata name="title" xml:lang="es">臓Bienvenido a Jetspeed 2!</metadata> + <metadata name="title" xml:lang="hu">K旦sz旦nti a Jetspeed 2!</metadata> + + <!-- page decoration --> + <defaults skin="orange" layout-decorator="tigris" portlet-decorator="tigris"/> + + <!-- page fragments --> + <fragment id="100393" type="layout" name="jetspeed-layouts::VelocityOneColumn"> + <fragment id="100939" type="portlet" name="j2-admin::LocaleSelector"> + <property layout="OneColumn" name="row" value="0"/> + </fragment> + <fragment id="100345" type="layout" name="jetspeed-layouts::VelocityTwoColumns"> + <property layout="OneColumn" name="row" value="1"/> + <property layout="TwoColumns" name="sizes" value="33%,66%"/> + <fragment id="100121" type="portlet" name="j2-admin::LoginPortlet"> + <property layout="TwoColumns" name="row" value="0"/> + <property layout="TwoColumns" name="column" value="0"/> + </fragment> + <fragment id="100171" type="portlet" name="demo::UserInfoTest"> + <property layout="TwoColumns" name="row" value="0"/> + <property layout="TwoColumns" name="column" value="1"/> + </fragment> + </fragment> + </fragment> + + <!-- security constraints --> + <security-constraints> + <security-constraints-ref>public-view</security-constraints-ref> + </security-constraints> +</page> +]]></source> +</div> +<source><![CDATA[ +<?xml version="1.0" encoding="UTF-8"?> +<page> + <!-- ページの情報 --> + <title>Welcome to Jetspeed 2</title> + <metadata name="title" xml:lang="fr">Ma Premiere Page de PSML</metadata> + <metadata name="title" xml:lang="es">臓Bienvenido a Jetspeed 2!</metadata> + <metadata name="title" xml:lang="hu">K旦sz旦nti a Jetspeed 2!</metadata> + + <!-- ページの装飾 --> + <defaults skin="orange" layout-decorator="tigris" portlet-decorator="tigris"/> + + <!-- ページフラグメント --> + <fragment id="100393" type="layout" name="jetspeed-layouts::VelocityOneColumn"> + <fragment id="100939" type="portlet" name="j2-admin::LocaleSelector"> + <property layout="OneColumn" name="row" value="0"/> + </fragment> + <fragment id="100345" type="layout" name="jetspeed-layouts::VelocityTwoColumns"> + <property layout="OneColumn" name="row" value="1"/> + <property layout="TwoColumns" name="sizes" value="33%,66%"/> + <fragment id="100121" type="portlet" name="j2-admin::LoginPortlet"> + <property layout="TwoColumns" name="row" value="0"/> + <property layout="TwoColumns" name="column" value="0"/> + </fragment> + <fragment id="100171" type="portlet" name="demo::UserInfoTest"> + <property layout="TwoColumns" name="row" value="0"/> + <property layout="TwoColumns" name="column" value="1"/> + </fragment> + </fragment> + </fragment> + + <!-- セキュリティ制限 --> + <security-constraints> + <security-constraints-ref>public-view</security-constraints-ref> + </security-constraints> +</page> +]]></source> +<div class="original"> +<p> +Here is an example PSML file that defines portal site <a href="#Folder">folder</a>, (folder.metadata): +</p> +</div> +<p> +以下に、ポータルサイトの <a href="#Folder">フォルダ</a> (folder.metadata) 用の定義を行う PSML ファイルの例を示します。 +</p> +<div class="original"> +<source><![CDATA[ +<?xml version="1.0" encoding="UTF-8"?> +<folder> + <!-- folder description --> + <title>Root Folder</title> + <metadata name="title" xml:lang="fr">R辿pertoire racine</metadata> + <metadata name="title" xml:lang="es">Carpeta raiz</metadata> + + <!-- order of documents in folder --> + <document-order>Jetspeed2.link</document-order> + <document-order>Jetspeed2Wiki.link</document-order> + <document-order>apache_portals.link</document-order> + <document-order>apache.link</document-order> + + <!-- portal site menus --> + <menu name="page-navigations"> + <separator> + <text>Top Pages</text> + <metadata name="text" xml:lang="fr">Page haut</metadata> + <metadata name="text" xml:lang="es">P叩ginas m叩s populares</metadata> + </separator> + <options>/Administrative</options> + <separator> + <text>Profiled Pages</text> + <metadata name="text" xml:lang="es">P叩ginas del Perfil</metadata> + </separator> + <options regexp="true">/p[0-9][0-9][0-9].psml</options> + <separator> + <text>Non Java Pages</text> + <metadata name="text" xml:lang="es">Ejemplos sin java</metadata> + </separator> + <options>/non-java</options> + </menu> + + <!-- security constraints --> + <security-constraints> + <security-constraints-ref>public-view</security-constraints-ref> + </security-constraints> +</folder> +]]></source> +</div> +<source><![CDATA[ +<?xml version="1.0" encoding="UTF-8"?> +<folder> + <!-- フォルダの説明 --> + <title>Root Folder</title> + <metadata name="title" xml:lang="fr">R辿pertoire racine</metadata> + <metadata name="title" xml:lang="es">Carpeta raiz</metadata> + + <!-- フォルダ内のドキュメントの順序 --> + <document-order>Jetspeed2.link</document-order> + <document-order>Jetspeed2Wiki.link</document-order> + <document-order>apache_portals.link</document-order> + <document-order>apache.link</document-order> + + <!-- ポータルサイトのメニュー --> + <menu name="page-navigations"> + <separator> + <text>Top Pages</text> + <metadata name="text" xml:lang="fr">Page haut</metadata> + <metadata name="text" xml:lang="es">P叩ginas m叩s populares</metadata> + </separator> + <options>/Administrative</options> + <separator> + <text>Profiled Pages</text> + <metadata name="text" xml:lang="es">P叩ginas del Perfil</metadata> + </separator> + <options regexp="true">/p[0-9][0-9][0-9].psml</options> + <separator> + <text>Non Java Pages</text> + <metadata name="text" xml:lang="es">Ejemplos sin java</metadata> + </separator> + <options>/non-java</options> + </menu> + + <!-- セキュリティ制限 --> + <security-constraints> + <security-constraints-ref>public-view</security-constraints-ref> + </security-constraints> +</folder> +]]></source> +<p> +Here is an example PSML file for a portal site <a href="#Link">link</a>, (*.link): +</p> +<source><![CDATA[ +<?xml version="1.0" encoding="UTF-8"?> +<link target="top"> + <!-- link description --> + <title>Jetspeed 2 Home Page</title> + <url>http://portals.apache.org/jetspeed-2/</url> + <metadata name="title" xml:lang="es">Jetspeed 2</metadata> +</link> +]]></source> +<div class="original"> +<p> +Here is an example PSML file for the portal site <a href="#Global_Page_Security">page security</a>, (page.security): +</p> +</div> +<p> +以下に、ポータルサイトの <a href="#Global_Page_Security">ページのセキュリティ</a> (page.security) 用の PSML ファイルの例を示します。 +</p> +<div class="original"> +<source><![CDATA[ +<?xml version="1.0" encoding="UTF-8"?> +<page-security> + <!-- global admin constraints --> + <security-constraints-def name="admin"> + <security-constraint> + <roles>admin</roles> + <permissions>view, edit</permissions> + </security-constraint> + </security-constraints-def> + <global-security-constraints-ref>admin</global-security-constraints-ref> + + <!-- public constraints --> + <security-constraints-def name="public-view"> + <security-constraint> + <users>*</users> + <permissions>view</permissions> + </security-constraint> + </security-constraints-def> + <security-constraints-def name="public-edit"> + <security-constraint> + <users>*</users> + <permissions>view, edit</permissions> + </security-constraint> + </security-constraints-def> +</page-security> +]]></source> +</div> + +<source><![CDATA[ +<?xml version="1.0" encoding="UTF-8"?> +<page-security> + <!-- 広域的な管理者の制限 --> + <security-constraints-def name="admin"> + <security-constraint> + <roles>admin</roles> + <permissions>view, edit</permissions> + </security-constraint> + </security-constraints-def> + <global-security-constraints-ref>admin</global-security-constraints-ref> + + <!-- パブリックな制限 --> + <security-constraints-def name="public-view"> + <security-constraint> + <users>*</users> + <permissions>view</permissions> + </security-constraint> + </security-constraints-def> + <security-constraints-def name="public-edit"> + <security-constraint> + <users>*</users> + <permissions>view, edit</permissions> + </security-constraint> + </security-constraints-def> +</page-security> +]]></source> +</section> +<section name='[Page] Page'> +<div class="original"> +<p> +The <page> element is a simple container to hold other PSML elements associated with a portal site page. +This element is persisted as a file with a '.psml' extension in the appropriate file system directory associated with the parent <a href="#Folder">folder</a>. +There are two valid attributes for the page element: +</p> +</div> +<p> +<page> 要素は、ポータルサイトのページに関連する他の PSML 要素を保持するための単純な入れ物です。この要素は、親である<a href="#Folder">フォルダ</a>を構成する適切なファイルシステムディレクトリ内に、'.psml' という拡張子を持つファイルとして存在します。二つの有効な属性がページエレメントの属性として存在します。 +</p> +<div class="original"> +<table> + <tr> + <th>Attribute</th> + <th>Description</th> + </tr> + <tr> + <td>hidden</td> + <td>A boolean attribute used to indicate that a page should not appear in portal site menus or other navigational elements.</td> + </tr> + <tr> + <td>version</td> + <td>A general purpose version tracking attribute. Not currently used by Jetspeed2.</td> + </tr> +</table> +</div> +<table> + <tr> + <th>属性</th> + <th>説明</th> + </tr> + <tr> + <td>hidden</td> + <td>ページがポータルサイトのサイトメニューまたは他のナビゲーション用の要素に表れるかどうかを指示するための真偽値の属性。</td> + </tr> + <tr> + <td>version</td> + <td>一般的な目的のバージョントラッキングのための属性。Jetspeed 2 では現在使われていません。</td> + </tr> +</table> +<div class="original"> +<p> +The <page> element contains a number of other PSML elements: +</p> +</div> +<p> +<page> 要素は多くの他の PSML 要素を含みます。 +</p> +<div class="original"> +<table> + <tr> + <th>Element</th> + <th>Description</th> + </tr> + <tr> + <td>title?</td> + <td>Simple element containing text for the default page title. The title of the page is considered its long description and is used as rollover text in some decorators if the short title is available for the menu text. If not specified, Jetspeed2 will attempt to define a title from the name of the file that contains the page element.</td> + </tr> + <tr> + <td>short-title?</td> + <td>Optional simple element containing text of the default short title for the page. The short title, if available, is used as menu text in some decorators. If not specified, the title text is used.</td> + </tr> + <tr> + <td><a href="#Defaults">defaults</a></td> + <td>Specifies the decorations for the page and its fragments. Defaults are required for each page.</td> + </tr> + <tr> + <td><a href="#Layout_Fragments">fragment</a></td> + <td>The root of the fragment hierarchy. All pages require a root Fragment.</td> + </tr> + <tr> + <td><a href="#PSML_Titles_and_Metadata">metadata</a>*</td> + <td>Optionally specifies locale specific titles and short titles for the page.</td> + </tr> + <tr> + <td><a href="#Menus">menu</a>*</td> + <td>Optionally specifies additional or overrides inherited menu definitions for the page.</td> + </tr> + <tr> + <td><a href="#PSML_Security_Constraints">security-constraints</a>?</td> + <td>Optionally defines inline security constraints for the page. If not specified, the page inherits the security constraints effective in the parent <a href="#Folder">folder</a>.</td> + </tr> +</table> +</div> +<table> + <tr> + <th>要素</th> + <th>説明</th> + </tr> + <tr> + <td>title?</td> + <td>デフォルトのページタイトルを表すテキストを含むシンプルな要素。ページのタイトルは、その長い記述とみなされます。もしメニューテキスト用の短いタイトルが利用可能であれば、一部のデコレータでロールオーバー用のテキストとして使われます。もし指定されていなければ、Jetspeed 2 は page 要素を含むファイルのファイル名からタイトルを決めようと試みます。</td> + </tr> + <tr> + <td>short-title?</td> + <td>ページのデフォルトの短いタイトルのテキストを含む単純なオプショナル要素。短いタイトルは、もし利用可能であれば、一部のデコレータ内のメニューテキストとして使われます。もし指定されない場合は title のテキストが使われます。</td> + </tr> + <tr> + <td><a href="#Defaults">defaults</a></td> + <td>ページとそのフラグメントのための装飾を指定します。Defaults はページ毎に必要です。</td> + </tr> + <tr> + <td><a href="#Layout_Fragments">fragment</a></td> + <td>フラグメントの階層構造のルート。全てのページにルートのフラグメントが必要です。</td> + </tr> + <tr> + <td><a href="#PSML_Titles_and_Metadata">metadata</a>*</td> + <td>オプショナルで指定される、ページ用のロケール特有のタイトルと短いタイトル。</td> + </tr> + <tr> + <td><a href="#Menus">menu</a>*</td> + <td>オプショナルで指定される、ページ用の追加または上書きされた継承したメニュー定義の指定。</td> + </tr> + <tr> + <td><a href="#PSML_Security_Constraints">security-constraints</a>?</td> + <td>オプショナルで定義される、ページ用のインラインのセキュリティ制限の定義。もし指定されなければ、ページは親<a href="#Folder">フォルダ</a>内の有効なセキュリティ制限を継承します。</td> + </tr> +</table> +<div class="original"> +<p>Example: <a href="#PSML">see intoductory examples above.</a></p> +</div> +<p>例: <a href="#PSML">イントロで示した例を参照してください。</a></p> +</section> + +<section name='[Defaults] Defaults'> +<div class="original"> +<p> +The <a href="#Page">page</a> <defaults> element defines the default layout decorator and default portlet decorator. +The default layout decorator is applied to all layout fragments which do NOT have a decorator attribute. +The default portlet decorator is applied to all portlet fragments which do NOT have a decorator attribute. +There are three valid attributes on the defaults element: +</p> +</div> +<p> +<a href="#Page">Page</a> 内の <defaults> 要素は、デフォルトのレイアウトデコレータと、デフォルトのポートレットデコレータを定義します。デフォルトのレイアウトデコレータは、デコレータ属性を持たない全てのレイアウトフラグメントに対して適用されます。デフォルトのポートレットデコレータは、デコレータ属性を持たない全てのポートレットフラグメントに対して適用されます。defaults 要素には三つの有効な属性があります。 +</p> +<div class="original"> +<table> + <tr> + <th>Attribute</th> + <th>Description</th> + </tr> + <tr> + <td>layout-decorator</td> + <td>The name of the layout decorator used to render the page. This attribute is required.</td> + </tr> + <tr> + <td>portlet-decorator</td> + <td>The name of the default portlet decorator used to render the page fragments. This attribute is optional, but is almost always set.</td> + </tr> + <tr> + <td>skin</td> + <td>A general purpose decorator attribute that can be referenced in the decorators to control page and fragment presentation. Not currently used by Jetspeed2.</td> + </tr> +</table> +</div> +<table> + <tr> + <th>Attribute</th> + <th>Description</th> + </tr> + <tr> + <td>layout-decorator</td> + <td>ページをレンダリングする時に使うレイアウトデコレータの名前。この属性は必須です。</td> + </tr> + <tr> + <td>portlet-decorator</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[ +<page> + ... + <defaults skin="orange" layout-decorator="tigris" portlet-decorator="tigris"/> + ... +</page> +]]></source> +</div> +<source><![CDATA[ +<page> + ... + <defaults skin="orange" layout-decorator="tigris" portlet-decorator="tigris"/> + ... +</page> +]]></source> +</section> + +<section name='[Layout Fragments] Layout Fragments'> +<div class="original"> +<p> +The <a href="#Page">page</a> layout <fragment> element is a hierarchical container used to hold <a href="#Portlet_Fragments">portlet fragments</a> and nested layout fragments. +The root fragment of a <a href="#Page">page</a> must be a layout fragment, even when only one portlet fragment is part of the page. +Layout fragments are subject to layout of the parent layout fragment and thus support the 'row' and 'column' <a href="#Fragment_Properties">layout properties</a>. +In addition, they also support the 'sizes' layout property used to control multicolumn layout proportions. +There are 3 required attributes for this element: +</p> +</div> +<p> +<a href="#Page">ページ</a> のレイアウト <fragment> 要素は階層構造のコンテナです。これは <a href="#Portlet_Fragments">ポートレットフラグメント</a>と、ネストされたレイアウトフラグメントを保持するのに使われます。<a href="#Page">ページ</a>のルートのフラグメントは、ページに一つしかポートレットがないときでも、レイアウトフラグメントでなければなりません。レイアウトフラグメントは親となるレイアウトフラグメントのレイアウトに従属します。なので "row" と "column" の <a href="#Fragment_Properties">レイアウトプロパティ</a>をサポートします。加えて、レイアウトフラグメントは 'sizes' レイアウトプロパティもサポートします。これは、複数列のレイアウトの列の割合をコントロールするのに使われます。この要素には三つの必須の属性があります。 +</p> +<div class="original"> +<table> + <tr> + <th>Attribute</th> + <th>Description</th> + </tr> + <tr> + <td>id</td> + <td>The required id is used to identify a fragment and <b>must</b> be unique across all fragments defined within the site. The value is opaque to Jetspeed2 and can follow any convention to guarantee uniqueness. Since fragments may be cached internally by Jetspeed2, any edits to exiting pages may require new ids to ensure the modifications are taken by Jetspeed2.</td> + </tr> + <tr> + <td>type</td> + <td>This required attribute must be set to 'layout' for all layout fragments.</td> + </tr> + <tr> + <td>name</td> + <td>The required name of the portlet used to implement the fragment layout. The portlet name generally takes the form of 'portlet-app-id:portlet-id' as specified in the portlet.xml files. Here are the supported Jetspeed2 layout portlet names: + <ul> + <li>jetspeed-layouts::FrameLayoutPortlet</li> + <li>jetspeed-layouts::VelocityOneColumn</li> + <li>jetspeed-layouts::VelocityOneColumnNoActions</li> + <li>jetspeed-layouts::VelocityThreeColumns</li> + <li>jetspeed-layouts::VelocityThreeColumnsNoActions</li> + <li>jetspeed-layouts::VelocityThreeColumnsTable</li> + <li>jetspeed-layouts::VelocityTwoColumns</li> + <li>jetspeed-layouts::VelocityTwoColumns2575</li> + <li>jetspeed-layouts::VelocityTwoColumns2575NoActions</li> + <li>jetspeed-layouts::VelocityTwoColumnsNoActions</li> + <li>jetspeed-layouts::VelocityTwoColumnsSmallLeft</li> + <li>jetspeed-layouts::VelocityTwoColumnsSmallLeftNoActions</li> + <li>jetspeed-layouts::VelocityTwoColumnsTable</li> + </ul> + </td> + </tr> +</table> +</div> +<table> + <tr> + <th>属性</th> + <th>説明</th> + </tr> + <tr> + <td>id</td> + <td>必須である id は、フラグメントを特定するのに使います。そして、サイト内で定義される全てのフラグメントに渡ってユニークで<b>なければなりません</b>。この値は Jetspeed2 に対して透過的でなく、一意性を保証するためのどのような仕様にも従う事が可能です。フラグメントは Jetspeed 2 で内部的にキャッシュされる可能性があるので、既存のページに対する任意の編集が、Jetspeed 2 が行う変更を保証するために新しい id を必要とするかも知れません。</td> + </tr> + <tr> + <td>type</td> + <td>この必須の属性はレイアウトフラグメント全てで 'layout' と指定しなければなりません。</td> + </tr> + <tr> + <td>name</td> + <td>必須であるポートレット名は、フラグメントレイアウトを実装するのに使われます。ポートレット名は一般的に、portletxml ファイルで指定された 'portlet-app-id:portlet-id' の形を取ります。以下が Jetspeed 2 でサポートされるレイアウトポートレットの名前です。 + <ul> + <li>jetspeed-layouts::FrameLayoutPortlet</li> + <li>jetspeed-layouts::VelocityOneColumn</li> + <li>jetspeed-layouts::VelocityOneColumnNoActions</li> + <li>jetspeed-layouts::VelocityThreeColumns</li> + <li>jetspeed-layouts::VelocityThreeColumnsNoActions</li> + <li>jetspeed-layouts::VelocityThreeColumnsTable</li> + <li>jetspeed-layouts::VelocityTwoColumns</li> + <li>jetspeed-layouts::VelocityTwoColumns2575</li> + <li>jetspeed-layouts::VelocityTwoColumns2575NoActions</li> + <li>jetspeed-layouts::VelocityTwoColumnsNoActions</li> + <li>jetspeed-layouts::VelocityTwoColumnsSmallLeft</li> + <li>jetspeed-layouts::VelocityTwoColumnsSmallLeftNoActions</li> + <li>jetspeed-layouts::VelocityTwoColumnsTable</li> + </ul> + </td> + </tr> +</table> +<div class="original"> +<p> +The layout <fragment> element contains a number of other PSML elements: +</p> +</div> +<p> +レイアウト <fragment> 要素はたくさんの他の PSML 要素を含みます。 +</p> +<div class="original"> +<table> + <tr> + <th>Element</th> + <th>Description</th> + </tr> + <tr> + <td><a href="#Portlet_Fragments">fragment*</a></td> + <td>Specified fragment elements can be either portlet fragments to be laid out by this layout fragment or nested layout fragments. All child fragments will have required <a href="#Fragment_Properties">property</a> elements to specify their positions in this layout. Specifying no fragments within a layout fragment will result in no content being generated.</td> + </tr> + <tr> + <td><a href="#Fragment_Properties">property*</a></td> + <td>Layout fragments can have an optional 'sizes' property that can be used to specify multicolumn layout proportions. Nested layout fragments may also have 'row' and/or 'column' properties to identify its positional location in the parent layout.</td> + </tr> + <tr> + <td><a href="#PSML_Security_Constraints">security-constraints</a>?</td> + <td>Optionally defines inline security constraints for the fragment and its child fragments. Unlike, page, folder, and link constraints, only 'view' permissions can be constrained. If not specified, the fragment inherits the security constraints effective in the <a href="#Page">page</a>.</td> + </tr> +</table> +</div> +<table> + <tr> + <th>要素</th> + <th>説明</th> + </tr> + <tr> + <td><a href="#Portlet_Fragments">fragment*</a></td> + <td>指定された fragment 要素は、レイアウトフラグメントによってレイアウトされるポートレットフラグメント、またはネストされたレイアウトフラグメントのどちらにも成り得ます。全ての子フラグメントにはこのレイアウトの位置を指定するための <a href="#Fragment_Properties">property</a> 要素が必須です。レイアウトフラグメント内に指定されるフラグメントがない場合は結果としてコンテンツは生成されません。</td> + </tr> + <tr> + <td><a href="#Fragment_Properties">property*</a></td> + <td>レイアウトフラグメントはオプショナルで 'sizes' プロパティを持つことが可能です。これは複数列の形状の明細を指定するのに使うことが可能です。ネストされたレイアウトフラグメントは、親レイアウト内の位置を特定するために 'row' または 'column' またはその両方のプロパティも持つかもしれません。</td> + </tr> + <tr> + <td><a href="#PSML_Security_Constraints">security-constraints</a>?</td> + <td>フラグメントとそのフラグメントの子フラグメントに対して、インラインのセキュリティ制限をオプオショナルで定義します。ページ、リンクの制約と違って、'view' パーミッションのみが制限されます。もし指定されなければ、フラグメントは <a href="#Page">ページ</a> 内で有効なセキュリティ制限を継承します。</td> + </tr> +</table> +<div class="origianal"> +<p>Example:</p> +</div> +<p>例:</p> +<div class="original"> +<source><![CDATA[ +<page> + ... + <fragment id="100393" type="layout" name="jetspeed-layouts::VelocityOneColumn"> + <fragment id="100939" type="portlet" name="j2-admin::LocaleSelector"> + <property layout="OneColumn" name="row" value="0"/> + </fragment> + <fragment id="100345" type="layout" name="jetspeed-layouts::VelocityTwoColumns"> + <property layout="OneColumn" name="row" value="1"/> + <property layout="TwoColumns" name="sizes" value="33%,66%"/> + <fragment id="100121" type="portlet" name="j2-admin::LoginPortlet"> + <property layout="TwoColumns" name="row" value="0"/> + <property layout="TwoColumns" name="column" value="0"/> + </fragment> + <fragment id="100171" type="portlet" name="demo::UserInfoTest"> + <property layout="TwoColumns" name="row" value="0"/> + <property layout="TwoColumns" name="column" value="1"/> + </fragment> + </fragment> + </fragment> + ... +</page> +]]></source> +</div> +<page> + ... + <fragment id="100393" type="layout" name="jetspeed-layouts::VelocityOneColumn"> + <fragment id="100939" type="portlet" name="j2-admin::LocaleSelector"> + <property layout="OneColumn" name="row" value="0"/> + </fragment> + <fragment id="100345" type="layout" name="jetspeed-layouts::VelocityTwoColumns"> + <property layout="OneColumn" name="row" value="1"/> + <property layout="TwoColumns" name="sizes" value="33%,66%"/> + <fragment id="100121" type="portlet" name="j2-admin::LoginPortlet"> + <property layout="TwoColumns" name="row" value="0"/> + <property layout="TwoColumns" name="column" value="0"/> + </fragment> + <fragment id="100171" type="portlet" name="demo::UserInfoTest"> + <property layout="TwoColumns" name="row" value="0"/> + <property layout="TwoColumns" name="column" value="1"/> + </fragment> + </fragment> + </fragment> + ... +</page> +</section> + +<section name='[Portlet Fragments] ポートレットフラグメント'> +<div class="original"> +<p> +The portlet <fragment> element is used to identify portlets on the page. Portlet fragments are subject to layout of the parent layout fragment and thus support the 'row' and 'column' <a href="#Fragment_Properties">layout properties</a> as required by the layout. +There are many valid attributes for this element: +</p> +</div> +<p>ポートレットの <fragment> 要素は、ページのポートレットを識別するために使われます。ポートレットフラグメントは、親レイアウトフラグメントのレイアウトの影響を受けます。なので、レイアウトで定められている 'row' と 'column' <a href="#Fragment_Properties">レイアウトプロパティ</a> をサポートします。この要素に対しては多数の有効な属性が存在します。 +</p> +<div class="original"> +<table> + <tr> + <th>Attribute</th> + <th>Description</th> + </tr> + <tr> + <td>id</td> + <td>The required id is used to identify a fragment and <b>must</b> be unique across all fragments defined within the site. The value is opaque to Jetspeed2 and can follow any convention to guarantee uniqueness. Since fragments may be cached internally by Jetspeed2, any edits to exiting pages may require new ids to ensure the modifications are taken by Jetspeed2.</td> + </tr> + <tr> + <td>type</td> + <td>This required attribute must be set to 'portlet' for all portlet fragments.</td> + </tr> + <tr> + <td>name</td> + <td>The required name of the portlet used to populate the fragment content. The portlet name generally takes the form of 'portlet-app-id:portlet-id' as specified in the portlet.xml files.</td> + </tr> + <tr> + <td>skin</td> + <td>A general purpose decorator attribute that can be referenced in the portlet decorators to control fragment presentation. Not currently used by Jetspeed2.</td> + </tr> + <tr> + <td>decorator</td> + <td>The name of the default portlet decorator used to render the fragments. This attribute is optional, but if it is not specified, the <a href="#Defaults">defaults</a> for the page must specify a default portlet decorator.</td> + </tr> + <tr> + <td>state</td> + <td>The initial state of the fragment portlet; 'hidden' is currently the only valid value for this attribute.</td> + </tr> +</table> +</div> +<table> + <tr> + <th>属性</th> + <th>説明</th> + </tr> + <tr> + <td>id</td> + <td>必須である id は、フラグメントを特定するのに使います。そして、サイト内で定義される全てのフラグメントに渡って、ユニークで<b>なければなりません</b>。この値は Jetspeed2 に対して透過的でなく、一意性を保証するためのどのような仕様にも従う事が可能です。フラグメントは Jetspeed 2 で内部的にキャッシュされる可能性があるので、既存のページに対する任意の編集が、Jetspeed 2 が行う変更を保証するために新しい id を必要とするかも知れません。</td> + </tr> + <tr> + <td>type</td> + <td>この必須の属性は全てのポートレットフラグメントで 'portlet' と指定しなければなりません。</td> + </tr> + <tr> + <td>name</td> + <td>必須であるポートレット名は、フラグメントコンテンツを流し込むのに使われます。ポートレット名は一般的に portlet.xml ファイルで指定された 'portlet-app-id:portlet-id' の形を取ります。</td> + </tr> + <tr> + <td>skin</td> + <td>フラグメントの表示のコントロールのための、ポートレットデコレータ内で参照する可能性のある一般的な目的のデコレータ属性。現時点では Jetspeed 2 では使っていません。</td> + </tr> + <tr> + <td>decorator</td> + <td>デフォルトのポートレットデコレータ名は、フラグメントのレンダリングに使われます。この属性はオプショナルです。しかし、この属性が指定されない場合は、ページの <a href="#Defaults">defaults</a> がデフォルトのポートレットデコレータを指定しなければいけません。</td> + </tr> + <tr> + <td>state</td> + <td>フラグメントポートレットの初期状態; 現時点ではこの属性に対しては、唯一 'hidden' が有効な値です。</td> + </tr> +</table> +<div class="original"> +<p> +The portlet <fragment> element contains other PSML elements: +</p> +</div> +<p> +ポートレットの <fragment> 要素は他の PSML 要素を含みます。 +</p> +<div class="original"> +<table> + <tr> + <th>Element</th> + <th>Description</th> + </tr> + <tr> + <td><a href="#Fragment_Properties">property*</a></td> + <td>Parent fragments may have 'row' and/or 'column' properties to identify positional location in the parent layout.</td> + </tr> + <tr> + <td>title?</td> + <td>Optional simple text element containing title for fragment portlet, overridding titles set in portlet.xml.</td> + </tr> + <tr> + <td><a href="#Preferences">preference*</a></td> + <td>Specifies initial user preference settings for fragment portlet, overridding any portlet preferences set in portlet.xml. User preferences, in turn, override these values.</td> + </tr> + <tr> + <td><a href="#PSML_Security_Constraints">security-constraints</a>?</td> + <td>Optionally defines inline security constraints for the fragment. Unlike, page, folder, and link constraints, only 'view' permissions can be constrained. If not specified, the fragment inherits the security constraints effective in the <a href="#Page">page</a>.</td> + </tr> +</table> +</div> +<table> + <tr> + <th>要素</th> + <th>説明</th> + </tr> + <tr> + <td><a href="#Fragment_Properties">property*</a></td> + <td>親フラグメントは、親レイアウト内の位置を特定するために、'row' または 'column' またはその両方のプロパティを持つかも知れません。</td> + </tr> + <tr> + <td>title?</td> + <td>フラグメントポートレットのタイトルを含む、オプショナルの単純なテキストの要素。portlet.xml でセットされたタイトルを上書きします。</td> + </tr> + <tr> + <td><a href="#Preferences">preference*</a></td> + <td>フラグメントポートレットにたいして、設定される初期のユーザプリファレンスを指定します。portlet.xml 内で指定された、どのようなポートレットプリファレンスも上書きされます。</td> + </tr> + <tr> + <td><a href="#PSML_Security_Constraints">security-constraints</a>?</td> + <td>フラグメントに対するインラインのセキュリティ制限をオプショナルで定義します。ページ、フォルダの制約と違って、'view' パーミッションだけを制限出来ます。もし指定されない場合は、そのフラグメントは <a href="#Page">page</a> 内で有効なセキュリティ制限を継承します。</td> + </tr> +</table> +<div class="original"> +<p>Example:</p> +</div> +<p>例:</p> +<div class="original"> +<source><![CDATA[ +<fragment id="100393" type="layout" name="jetspeed-layouts::VelocityOneColumn"> + ... + <fragment id="100939" type="portlet" name="j2-admin::LocaleSelector"> + <property layout="OneColumn" name="row" value="0"/> + </fragment> + ... +</fragment> +]]></source> +</div> +<source><![CDATA[ +<fragment id="100393" type="layout" name="jetspeed-layouts::VelocityOneColumn"> + ... + <fragment id="100939" type="portlet" name="j2-admin::LocaleSelector"> + <property layout="OneColumn" name="row" value="0"/> + </fragment> + ... +</fragment> +]]></source> +</section> + +<section name='[Fragment Properties] フラグメントのプロパティ'> +<div class="original"> +<p> +The <a href="#Portlet_Fragments">fragment</a> <property> element is use to specify named properties for fragments. These properties are used commonly to specify layout portlet parameters and portlet positional location within the page. The property element has 3 supported attributes: +</p> +</div> +<p><a href="#Portlet_Fragments">フラグメント</a>の <property> 要素はフラグメントのプロパティの名前を指定するのに使われます。これらのプロパティは一般にレイアウトポートレットのパラメータとページ内のポートレットの位置を指定するために使われます。プロパティ要素は三つの属性をサポートします。</p> +<div class="original"> +<table> + <tr> + <th>Attribute</th> + <th>Description</th> + </tr> + <tr> + <td>layout <i>(deprecated)</i> </td> + <td>The symbolic name of the layout fragment portlet the property is associated with. This attribute is supported for compatibility reasons. The strictly hierarchical structure of layout and portlet fragments implies that any single fragment and its properties can be subject to one layout fragment portlet.</td> + </tr> + <tr> + <td>name</td> + <td>The fragment property name. Jetspeed2 layout portlets support the 'row', 'column' and 'sizes' properties.</td> + </tr> + <tr> + <td>value</td> + <td>The fragment property value. The 'row' and 'column' properties accept 0-based indicies values. The 'sizes' property accepts HTML frameset tag 'rows' and 'cols' attributes sytax, (i.e. '25%,75%').</td> + </tr> +</table> +</div> +<table> + <tr> + <th>属性</th> + <th>説明</th> + </tr> + <tr> + <td>layout <i>(廃止予定)</i> </td> + <td>プロパティが紐付いているフラグメントポートレットの識別名。この属性は互換性のために用意されています。レイアウトとポートレットフラグメントの厳密な階層構造は、どのような単一のフラグメントとそのプロパティも、一つのレイアウトポートレットの影響下にある可能性があることを意味します。</td> + </tr> + <tr> + <td>name</td> + <td>フラグメントプロパティの名前。Jetspeed 2 のレイアウトポートレットは 'row'、'column'、'sizes' プロパティをサポートします。</td> + </tr> + <tr> + <td>value</td> + <td>フラグメントプロパティの値。'row' と 'column' プロパティはゼロベースの指標値を受け取ります。'sizes' プロパティは HTML frameset タグの 'rows' と 'cols' 属性の書式 (例えば '25%,75%' 等) を受け取ります。</td> + </tr> +</table> +<div class="original"> +<p>Example:</p> +</div> +<p>例:</p> +<div class="original"> +<source><![CDATA[ +<fragment id="100876" type="portlet" name="j2-admin::LoginPortlet"> + ... + <property layout="TwoColumns" name="row" value="2"/> + <property layout="TwoColumns" name="column" value="1"/> + ... +</fragment> +]]></source> +</div> +<source><![CDATA[ +<fragment id="100876" type="portlet" name="j2-admin::LoginPortlet"> + ... + <property layout="TwoColumns" name="row" value="2"/> + <property layout="TwoColumns" name="column" value="1"/> + ... +</fragment> +]]></source> +<div class="original"> +<source><![CDATA[ +<fragment id="103456" type="layout" name="jetspeed-layouts::VelocityTwoColumns"> + ... + <property layout="TwoColumns" name="sizes" value="33%,66%"/> + ... +</fragment> +]]></source> +</div> +<source><![CDATA[ +<fragment id="103456" type="layout" name="jetspeed-layouts::VelocityTwoColumns"> + ... + <property layout="TwoColumns" name="sizes" value="33%,66%"/> + ... +</fragment> +]]></source> +</section> + +<section name='[Preferences] プリファレンス'> +<div class="original"> +<p> +The <a href="#Portlet_Fragments">portlet fragment</a> <preference> elements allows for the defining of portlet preferences. +This provides an eaiser avenue for the setting of default portlet prefences for a portlet +instance on a page without having to duplicate a portlet definition within +the portlet application's portlet.xml. +</p> +</div> +<p> +<a href="#Portlet_Fragments">ポートレットフラグメント</a> の <preference> 要素は、ポートレットプリファレンスを定義します。これは、ポートレットアプリケーションの portlet.xml 内に、ポートレットの定義を何度も行う必要なく、ページ上のポートレットインスタンスのための、デフォルトのポートレットプリファレンスの設定を、簡単に行う手段を提供します。 +</p> +<div class="original"> +<p> +Preference precedence: User Defined > Fragment Defined > portlet.xml Defined. +</p> +</div> +<p> +プリファレンスの優先度: ユーザ定義 > フラグメント定義 > portlet.xml での定義 +</p> +<div class="original"> +<p>The <preference> element attributes:</p> +</div> +<p> +<preference> 要素の属性は以下のようなものです。 +</p> +<div class="original"> +<table> + <tr> + <th>Attribute</th> + <th>Description</th> + </tr> + <tr> + <td>name</td> + <td>The name of the preference.</td> + </tr> + <tr> + <td>readOnly</td> + <td>Boolean indicating whether or not the user can change the value of this preference.</td> + </tr> +</table> +</div> +<table> + <tr> + <th>属性</th> + <th>説明</th> + </tr> + <tr> + <td>name</td> + <td>プリファレンスの名前。</td> + </tr> + <tr> + <td>readOnly</td> + <td>ユーザがこのプリファレンス値を変えることが出来るかどうかを示す真偽値。</td> + </tr> +</table> +<div class="original"> +<p>The <preference> element contains these elements:</p> +</div> +<p><preference> 要素は以下の要素を含みます。</p> +<div class="original"> +<table> + <tr> + <th>Element</th> + <th>Description</th> + </tr> + <tr> + <td>value+</td> + <td>Simple text element containing a value associated with the named preference.</td> + </tr> +</table> +</div> +<table> + <tr> + <th>要素</th> + <th>説明</th> + </tr> + <tr> + <td>value+</td> + <td>指定したプリファレンスと関係する値を含む単純なテキスト要素。</td> + </tr> +</table> +<div class="original"> +<p>Example:</p> +</div> +<p>例:</p> +<div class="original"> +<source><![CDATA[ +<fragment id="uhtemp-1012" type="portlet" name="demo::BookmarkPortlet"> + ... + <preference name="Google" readOnly="false"> + <value>http://www.google.com</value> + </preference> + ... +</fragment> +]]></source> +</div> +<source><![CDATA[ +<fragment id="uhtemp-1012" type="portlet" name="demo::BookmarkPortlet"> + ... + <preference name="Google" readOnly="false"> + <value>http://www.google.com</value> + </preference> + ... +</fragment> +]]></source> +</section> + +<section name='[Folder] フォルダ'> +<div class="original"> +<p> +The <folder> element is a simple container to hold other PSML elements associated with a portal site folder. +This element is persisted as a folder.metadata file in the associated file system directory. +There are two valid attributes for the folder element: +</p> +</div> +<p> +<folder> 要素は、ポータルサイトのフォルダと関係する他の PSML 要素を保持する単純な入れ物です。この要素は、関係するファイルシステムディレクトリ内の folder.metadata ファイルとして存在しつづけます。フォルダの要素には二つの有効な属性が存在します。 +</p> +<div class="original"> +<table> + <tr> + <th>Attribute</th> + <th>Description</th> + </tr> + <tr> + <td>hidden</td> + <td>A boolean attribute used to indicate that a folder should not appear in portal site menus or other navigational elements.</td> + </tr> + <tr> + <td>version</td> + <td>A general purpose version tracking attribute. Not currently used by Jetspeed2.</td> + </tr> +</table> +</div> +<table> + <tr> + <th>属性</th> + <th>説明</th> + </tr> + <tr> + <td>hidden</td> + <td>フォルダが、ポータルサイトのメニューや他のナビゲーション用の要素に、表示されるかどうかを示す真偽値の属性。</td> + </tr> + <tr> + <td>version</td> + <td>一般的な用途のバージョントラッキングの属性。現時点では Jetspeed 2 では使われていません。</td> + </tr> +</table> +<div class="original"> +<p> +The <folder> element contains a number of other PSML elements: +</p> +</div> +<p><folder> 要素は多くの他の PSML 要素を含みます。</p> +<div class="original"> +<table> + <tr> + <th>Element</th> + <th>Description</th> + </tr> + <tr> + <td>title?</td> + <td>Simple element containing text for the default folder title. The title of the folder is considered its long description and is used as rollover text in some decorators if the short title is available for the menu text. If not specified, Jetspeed2 will attempt to define a title from the name of the file that contains the folder element.</td> + </tr> + <tr> + <td>short-title?</td> + <td>Optional simple element containing text of the default short title for the folder. The short title, if available, is used as menu text in some decorators. If not specified, the title text is used.</td> + </tr> + <tr> + <td>default-page?</td> + <td>Optional simple element containing text with the default page or subfolder name for the folder. The default page is used when the folder is directly referenced in the portal. The name of any <a href="#Page">page</a> or folder in this folder, (including '..' for the parent folder), can be specified. If no default page is set, the page named 'default-page.psml' will be used; if 'default-page.psml' does not exist, the first page in the folder will become the default.</td> + </tr> + + <tr> + <td>document-order*</td> + <td>An optional collection of simple elements containing text names used to define a sort order for <a href="#Page">page</a>, subfolder, and <a href="#Link">link</a> members. Members with matching names will be arranged in the order these elements are defined. Other members will be sorted by their names and will appear in menus and other lists after the matching members. Regular expressions for name matching are not supported.</td> + </tr> + + <tr> + <td><a href="#PSML_Titles_and_Metadata">metadata</a>*</td> + <td>Optionally specifies locale specific titles and short titles for the folder.</td> + </tr> + <tr> + <td><a href="#Menus">menu</a>*</td> + <td>Optionally specifies additional or overrides inherited menu definitions for the folder.</td> + </tr> + <tr> + <td><a href="#PSML_Security_Constraints">security-constraints</a>?</td> + <td>Optionally defines inline security constraints for the folder. If not specified, the folder inherits the security constraints effective in the parent folder.</td> + </tr> +</table> +</div> +<table> + <tr> + <th>要素</th> + <th>説明</th> + </tr> + <tr> + <td>title?</td> + <td>デフォルトのフォルダのタイトルを含む単純な要素。フォルダのタイトルは、自身の長い記述とみなされます。もし短いタイトル名が利用可能であれば、一部のデコレータでロールオーバー用のテキストとして使われます。もし指定されていなければ、Jetspeed 2 はフォルダ要素を含むファイル名からタイトルを決めようと試みます。</td> + </tr> + <tr> + <td>short-title?</td> + <td>フォルダのデフォルトの短いタイトルのテキストを含むオプショナルな単純要素。もし短いタイトルが利用可能であれば、一部のデコレータでメニューテキストとして使われます。もし指定されない場合は、title のテキストが使われます。</td> + </tr> + <tr> + <td>default-page?</td> + <td>フォルダのデフォルトページまたはサブフォルダのテキストを含む単純なオプショナル要素。デフォルトページは、フォルダが直接ポータルから参照されるときに使われます。このフォルダ内のどのような <a href="#Page">ページ</a>やフォルダを (親フォルダとして使われる '..' も含む) 指定することも可能です。もしデフォルトページが設定されない場合は、'default-page.psml' が使われます。もし 'default-page.psml' が存在しない場合は、フォルダ内の最初のページがデフォルトになります。</td> + </tr> + + <tr> + <td>document-order*</td> + <td><a href="#Page">page</a>、サブフォルダ、<a href="#Link">link</a> と言った構成要素のソートの順番を定義するのに使われる、構成要素のテキスト名を含む単純なオプショナル要素。名前にマッチする構成要素は、その要素が定義された順番に配置されます。他の構成要素は名前でソートされます。そして、メニューや他のリストでは、一致した構成要素の後に表示されます。正規表現による一致はサポートしません。</td> + </tr> + + <tr> + <td><a href="#PSML_Titles_and_Metadata">metadata</a>*</td> + <td>オプショナルで指定されるロケール固有のフォルダのタイトルや短いタイトル。</td> + </tr> + <tr> + <td><a href="#Menus">menu</a>*</td> + <td>オプショナルで指定される、追加の、または継承したものを上書きするフォルダのメニュー定義。</td> + </tr> + <tr> + <td><a href="#PSML_Security_Constraints">security-constraints</a>?</td> + <td>オプショナルで定義される、フォルダ用のインラインのセキュリティ制限の定義。もし指定されなければ、フォルダは親フォルダ内の有効なセキュリティ制限を継承します。</td> + </tr> +</table> +<div class="original"> +<p>Example: <a href="#PSML">see intoductory examples above.</a></p> +</div> +<p>例: <a href="#PSML">序文の例を参照してください。</a></p> +</section> + +<section name='[Link] Link'> +<div class="original"> +<p> +The <link> element is a simple container to hold other PSML elements associated with a portal link used to reference content external to the portal site. +This element is persisted as a file with a '.link' extension in the appropriate file system directory associated with the parent <a href="#Folder">folder</a>. +There are two valid attributes for the link element: +</p> +</div> +<p> +<link> 要素は、ポータルサイトの外部のコンテンツを参照するのに使われるポータルリンクに関連づけられている、他の PSML 要素を保持するシンプルな入れ物です。この要素は、親<a href="#Folder">フォルダ</a>と関連づけられている、適切なファイルシステムのディレクトリ内に存在する '.link' という拡張子のファイルとして存在します。この要素には二つの有効な属性があります。 +</p> +<div class="original"> +<table> + <tr> + <th>Attribute</th> + <th>Description</th> + </tr> + <tr> + <td>target</td> + <td>An optional target frame name in which to open the external content. If not specified, the linked content will replace the portal in the browser.</td> + </tr> + <tr> + <td>version</td> + <td>A general purpose version tracking attribute. Not currently used by Jetspeed2.</td> + </tr> +</table> +</div> +<table> + <tr> + <th>属性</th> + <th>説明</th> + </tr> + <tr> + <td>target</td> + <td>オプショナルで指定される、外部コンテンツを開くためのターゲットとなるフレームの名前。もし指定されなければ、リンクされたコンテンツはブラウザで開いているポータルと置き換わります。</td> + </tr> + <tr> + <td>version</td> + <td>一般的な用途のバージョントラッキングの属性。現時点では Jetspeed 2 では使われていません。</td> + </tr> +</table> +<div class="original"> +<p> +The <link> element contains a number of other PSML elements: +</p> +</div> +<p> +<link> 要素は多数の他の PSML 要素を含みます。 +</p> +<div class="original"> +<table> + <tr> + <th>Element</th> + <th>Description</th> + </tr> + <tr> + <td>title?</td> + <td>Simple element containing text for the default link title. The title of the link is considered its long description and is used as rollover text in some decorators if the short title is available for the menu text. If not specified, Jetspeed2 will attempt to define a title from the name of the file that contains the link element.</td> + </tr> + <tr> + <td>short-title?</td> + <td>Optional simple element containing text of the default short title for the link. The short title, if available, is used as menu text in some decorators. If not specified, the title text is used.</td> + </tr> + <tr> + <td>url</td> + <td>The required content url element. The text of this element will be used to navigate the specified target frame in the browser.</td> + </tr> + <tr> + <td><a href="#PSML_Titles_and_Metadata">metadata</a>*</td> + <td>Optionally specifies locale specific titles and short titles for the link.</td> + </tr> + <tr> + <td><a href="#PSML_Security_Constraints">security-constraints</a>?</td> + <td>Optionally defines inline security constraints for the link. If not specified, the link inherits the security constraints effective in the parent <a href="#Folder">folder</a>.</td> + </tr> +</table> +</div> +<table> + <tr> + <th>要素</th> + <th>説明</th> + </tr> + <tr> + <td>title?</td> + <td>デフォルトのリンクタイトル用のテキストを含むシンプルな要素。リンクのタイトルは、その長い記述とみなされます。もしメニューテキスト用の短いタイトルが利用可能であれば、一部のデコレータでロールオーバー用のテキストとして使われます。もし指定されていなければ、Jetspeed 2 は link 要素を含むファイルのファイル名からタイトルを決めようと試みます。</td> + </tr> + <tr> + <td>short-title?</td> + <td>リンクのデフォルトの短いタイトルのテキストを含むシンプルなオプショナル要素。もし短いタイトルが利用可能であれば、一部のデコレータでメニューテキストとして使われます。</td> + </tr> + <tr> + <td>url</td> + <td>コンテンツの URL のための必須の要素。この要素のテキストは、指定されたブラウザのターゲットフレームをナビゲートするのに使われます。</td> + </tr> + <tr> + <td><a href="#PSML_Titles_and_Metadata">metadata</a>*</td> + <td>オプショナルで指定される、ロケール固有のリンクのタイトルや短いタイトル。</td> + </tr> + <tr> + <td><a href="#PSML_Security_Constraints">security-constraints</a>?</td> + <td>オプショナルで指定される、リンクのためのセキュリティ制限。もし指定されなければ、リンクは親<a href="#Folder">フォルダ</a>内の有効なセキュリティ制限を継承します。</td> + </tr> +</table> +<div class="original"> +<p>Example: <a href="#PSML">see intoductory examples above.</a></p> +</div> +<p>例: <a href="#PSML">序文の例を参照してください。</a></p> +</section> + +<section name='[Global Page Security] グローバルなページのセキュリティ'> +<div class="original"> +<p> +The <page-security> element is a simple container to hold other PSML elements used to declare global security constraints and their definitions.. +This element is persisted as the page.security file and is always located in the root directory of the PSML file system directories. +There is only one valid attribute for the page security element: +</p> +</div> +<p> +<page-security> 要素はグローバルなセキュリティ制限と、その定義を宣言するために使われる、他の PSML 要素を保持するためのシンプルな入れ物です。この要素は page.security ファイルとして存在し、常に PSML ファイルのシステムディレクトリのルートディレクトリに存在します。page-security 要素の有効な属性は一つだけ存在します。 +</p> +<div class="original"> +<table> + <tr> + <th>Attribute</th> + <th>Description</th> + </tr> + <tr> + <td>version</td> + <td>A general purpose version tracking attribute. Not currently used by Jetspeed2.</td> + </tr> +</table> +</div> +<table> + <tr> + <th>属性</th> + <th>説明</th> + </tr> + <tr> + <td>version</td> + <td>一般的な用途のバージョントラッキングの属性。現時点では Jetspeed 2 では使われていません。</td> + </tr> +</table> +<div class="original"> +<p> +The <page-security> element contains two security constraints related PSML elements: +</p> +</div> +<p> +<page-security> 要素は PSML 要素に関連する二つのセキュリティ制限を含みます。 +</p> +<div class="original"> +<table> + <tr> + <th>Element</th> + <th>Description</th> + </tr> + <tr> + <td><a href="#PSML_Security_Constraints">security-constraints-def</a>*</td> + <td>Optionally defines a collection of security constraints defined by name. These security constraints are referenced in <a href="#Page">pages</a>, <a href="#Layout_Fragments">fragments</a>, <a href="#Folder">folders</a>, and <a href="#Link">links</a> and in this element to facilitate reuse and security maintenance.</td> + </tr> + <tr> + <td><a href="#PSML_Security_Constraints">global-security-constraints-ref</a>*</td> + <td>Optionally defines security constraints references to be applied to all security constraints in the site. The text of each simple element references a named security constraints definition specified here in this element.</td> + </tr> +</table> +</div> +<table> + <tr> + <th>要素</th> + <th>説明</th> + </tr> + <tr> + <td><a href="#PSML_Security_Constraints">security-constraints-def</a>*</td> + <td>オプショナルで定義されるセキュリティ制限のコレクションの名前。これらのセキュリティ制限は<a href="#Page">ページ</a>、<a href="#Layout_Fragments">フラグメント</a>、<a href="#Folder">フォルダ</a>、<a href="#Link">リンク</a>内で、そして再利用とセキュリティのメンテナンスを容易にするために、この要素内で再定義されます。</td> + </tr> + <tr> + <td><a href="#PSML_Security_Constraints">global-security-constraints-ref</a>*</td> + <td>サイト内の全てのセキュリティ制限を適用するために、オプショナルで定義されるセキュリティ制限参照。それぞれのシンプルな要素のテキストは、このエレメント内のここで指定された名前のセキュリティ制限の定義を参照します。</td> + </tr> +</table> +<div class="original"> +<p>Example: <a href="#PSML">see intoductory examples above.</a></p> +</div> +<p>例: <a href="#PSML">序文の例を参照してください。</a></p> +</section> + +<section name='[PSML Titles and Metadata] PSML タイトルとメタデータ'> +<div class="original"> +<p> +The <a href="#Page">page</a>, <a href="#Folder">folder</a>, and <a href="#Link">link</a> <metadata> element is used to define locale specific title and short title text. +Any number of these elements may appear within a containing PSML element, but multiple named values should not be specified for a single locale. +The PSML xml documents are normally declared with the UTF-8 encoding to support a wide variety of character sets. +</p> +</div> +<p> +<a href="#Page">ページ</a>, <a href="#Folder">フォルダ</a>, <a href="#Link">リンク</a> の <metadata> 要素はロケール特有のタイトルと短いタイトルのテキストを定義するのに使われます。これらの要素は何度でも、含まれる PSML 要素内で表れるかも知れません。しかし、複数の値が一つのロケールにたいして指定してはいけません。PSML xml 文書は、普通は広範囲のキャラクタセットをサポートするために、UTF-8 エンコーディングで宣言されます。 +</p> +<div class="original"> +<table> + <tr> + </tr> + <th>Attribute</th> + <th>Description</th> + <tr> + <td>name</td> + <td>Name of the metadata text. This name should be either 'title' or 'short-title' to specify locale specific title text.</td> + </tr> + <tr> + <td>xml:lang</td> + <td>The locale language or language/country selector for the metadata text. The conventional Java Locale names are expected, (ISO-639 and ISO-3166). Valid values would include 'en' and 'en_US'.</td> + </tr> +</table> +</div> +<table> + <tr> + </tr> + <th>属性</th> + <th>説明</th> + <tr> + <td>name</td> + <td>メタデータテキストの名前。この名前は、ロケール特有のタイトルテキストを指定するための、'title' と 'short-title' のどちらかを指定してください。</td> + </tr> + <tr> + <td>xml:lang</td> + <td>メタデータテキストのためのロケール言語または言語／国セレクタ。標準の Java ロケール名が期待されます (ISO-639 と ISO-3166)。有効な値として 'en' や 'en_US' を含みます。</td> + </tr> +</table> +<div class="original"> +<p>Example:</p> +</div> +<p>例:</p> +<div class="original"> +<source><![CDATA[ +<page> + ... + <metadata name="title" xml:lang="fr">Ma Premiere Page de PSML</metadata> + <metadata name="title" xml:lang="es">臓Bienvenido a Jetspeed 2!</metadata> + <metadata name="title" xml:lang="hu">K旦sz旦nti a Jetspeed 2!</metadata> + ... +</page> +]]></source> +</div> +<source><![CDATA[ +<page> + ... + <metadata name="title" xml:lang="fr">Ma Premiere Page de PSML</metadata> + <metadata name="title" xml:lang="es">臓Bienvenido a Jetspeed 2!</metadata> + <metadata name="title" xml:lang="hu">K旦sz旦nti a Jetspeed 2!</metadata> + ... +</page> +]]></source> +</section> + +<section name="[PSML Security Constraints] PSML セキュリティ制限"> +<div class="original"> +<p> +The <security-constraints>, <security-constraints-def>, and <global-security-constraints-ref> elements that appear in <a href="#Page">pages</a>, <a href="#Layout_Fragments">fragments</a>, <a href="#Folder">folders</a>, <a href="#Link">links</a>, and the <a href="#Global_Page_Security">page security</a> elements above are documented separately in the the Declarative Security Constraints Guide. +</p> +</div> +<p> +<a href="#Page">pages</a>、<a href="#Layout_Fragments">fragments</a>、<a href="#Folder">folders</a>、 <a href="#Link">links</a>、<a href="#Global_Page_Security">page security</a> 要素内で現れる <security-constraints>、<security-constraints-def>、<global-security-constraints-ref> 要素については別のドキュメントであるセキュリティ制限の宣言に関するドキュメントに記述があります。 +</p> +<div class="original"> +<p> +<a href='guide-security-declarative-psml.html'>Declarative Security Constraints Guide</a> +</p> +</div> +<p> +<a href='guide-security-declarative-psml.html'>セキュリティ制限の宣言ガイド</a> +</p> +</section> + +<section name="[PSML Menus] PSML メニュー"> +<div class="original"> +<p> +The <menu> element that appears in <a href="#Page">page</a> and <a href="#Folder">folder</a> elements above are documented separately in the the Declarative Menus Guide. +</p> +</div> +<p> +<a href="#Page">ページ</a> and <a href="#Folder">フォルダ</a> 要素内で現れる <menu> 要素は別のドキュメントであるメニューの宣言ガイドに記述があります。 +</p> +<div class="original"> +<p> +<a href='guide-menus-declarative-psml.html'>Declarative Menus Guide</a> +</p> +</div> +<p> +<a href='guide-menus-declarative-psml.html'>メニューの宣言ガイド</a> +</p> + +</section> + +</body> +</document> +
