Top Menu

Delivered-To: mailing list jetspeed-dev@portals.apache.org Received: (qmail 70733 invoked by uid 99); 8 Dec 2005 22:34:03 -0000 Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 08 Dec 2005 14:34:03 -0800 X-ASF-Spam-Status: No, hits=-9.4 required=10.0 tests=ALL_TRUSTED,NO_REAL_NAME X-Spam-Check-By: apache.org Received: from [209.237.227.194] (HELO minotaur.apache.org) (209.237.227.194) by apache.org (qpsmtpd/0.29) with SMTP; Thu, 08 Dec 2005 14:34:02 -0800 Received: (qmail 36974 invoked by uid 65534); 8 Dec 2005 22:33:42 -0000 Message-ID: <20051208223342.36972.qmail@minotaur.apache.org> Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r355250 - in /portals/jetspeed-2/trunk/xdocs/guides: guide-menus-declarative-psml.xml guide-psml.xml Date: Thu, 08 Dec 2005 22:33:41 -0000 To: jetspeed-dev@portals.apache.org From: rwatler@apache.org X-Mailer: svnmailer-1.0.5 X-Virus-Checked: Checked by ClamAV on apache.org X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N Author: rwatler Date: Thu Dec 8 14:33:40 2005 New Revision: 355250 URL: http://svn.apache.org/viewcvs?rev=355250&view=rev Log: declarative menus guide checkpoint Modified: portals/jetspeed-2/trunk/xdocs/guides/guide-menus-declarative-psml.xml portals/jetspeed-2/trunk/xdocs/guides/guide-psml.xml Modified: portals/jetspeed-2/trunk/xdocs/guides/guide-menus-declarative-psml.xml URL: http://svn.apache.org/viewcvs/portals/jetspeed-2/trunk/xdocs/guides/guide-menus-declarative-psml.xml?rev=355250&r1=355249&r2=355250&view=diff ============================================================================== --- portals/jetspeed-2/trunk/xdocs/guides/guide-menus-declarative-psml.xml (original) +++ portals/jetspeed-2/trunk/xdocs/guides/guide-menus-declarative-psml.xml Thu Dec 8 14:33:40 2005 @@ -25,7 +25,333 @@

-Document In Progress! +Declarative menus are used to add new or customize default navigation elements in displayed portal pages. +These PSML declarations are part of the page and folder elements. +As with other PSML elements, effective menu declarations available for a given page are those that are explicity +defined in the page along with all defined in parent folders. For this reason, global site menus are defined in +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. +

+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. +The Portal Site Component is responsible for fleshing out the dynamic menu definition options with page specific PSML +elements from the site. For instance, a global menu declaration would typically be involved in the following +sequence of events while a portal page is being composed: +

The portal layout decorator would request a menu definition by name,
the definition would be inherited by the current page and located in the root folder PSML,
the Portal Site Component would interpret the menu definition in the context of the current page and populate page, folder, and link menu options,
the decorator would display the menu rendering titles and text from the menu definition itself and the computed menu options into portal navigation content.

+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: +

pages: relative pages menu used to define the page tabs above the portal.
breadcrumbs: paths to page used to provide history links below the page tabs.
navigations: relative subfolders and root level links menu used to define the navigation pane beside the portal.
back: parent folder menu used to define the single "back" link above the portal page tabs.

+As one would expect, these built in menu definitions can be overridden by declaring menus in the site PSML with the same name. +

Menu Definition

Options
Separator
Include
Exclude

Page Layout Decorators
Portal Site Component

+ +

+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: +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Attribute	Description
name	Identifies menu name for retrieval from template code and/or menu reference. This attribute is required for top level nodes and ignored for nested menus.
options	Specifies root document path for this menu if deep inclusion of documents and folders is specified by this menu. This attribute may also define document paths that specify 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.
depth	Specifies deep inclusion of documents from option folders, (depth < 0 specifies infinite depth). Menu options are created to represent each visible page or link in the site; folders are converted into nested menus constrained by this setting.
paths	Boolean attribute to control the inclusion of ordered path options from root folder to the specified options. This setting is used to generate "history" or "bread crumb" menus.
regexp	A boolean attribute the specifies whether wild card/regular expression processing be performed on options values. File system command line regular expression syntax is supported.
profile	Specified name of Profile Locator to be used when evaluating option values. This attribute also sets the default profile value for options and nested menus. Specifying '*' forces the acceptance of all Profile Locator names; this can be used to override parent menu selects a profile name.
order	Comma separated list of regexp patterns matched against list or regular expression document path values to determine order of matched options. This attribute will be applied as a default options value for any options elements, but is not used to reorder multiple options children matches. If not specified, multiple options are included in the order returned by the underlying folder document orderings. Option paths not matched by this attribute are appended after ordered matches.
skin	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.

+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: +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Element	Description
title?	Simple element text specifies default locale-independent title for the menu. The title of the menu 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, the name of the menu will be used.
short-title?	Simple element text specifies default locale-independent short title for the menu. The short title, if available, is used as menu text in some decorators. If not specified, the title text is used.
metadata*	Optionally specifies additional locale-specific titles and short titles.
options*	This ordered menu element specifies content elements for this menu definition.
separator*	An ordered menu element used to specify text lines to be included inline in this menu definition.
menu*	Another ordered menu element used to define a nested menu contained in this menu definition.
include*	Specifies a menu to nest within or options from a another menu to be included in this menu definition. The name of the menu to include is the text of this ordered menu element.
exclude*	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.

Examples:

+ + /some-top-page.psml,/custom/some-other-page.psml + +]]> + +]]> + +]]> + + Top Menu + Haut + /group-pages/* + + + -- Top Pages -- + Top Pages + + /* + + Custom Pages + + /custom-folder/ + + top-role-pages + More Top Pages + top-role-pages + +]]> +

The definitions for the default global menu declarations supported internally by the Portal Site Component:

+ +]]> + +]]> + + Folders + ./*/ + page-navigations + Additional Links + /*.link + +]]> + +]]> +

Note that the separator text of these definitions is localized internally.

+ +

+The <options> element defines a single or multiple options within a menu. 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: +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Attribute	Description
depth	Specifies deep inclusion of documents from option folders, (depth < 0 specifies infinite depth). Menu options are created to represent each visible page or link in the site; folders are converted into nested menus constrained by this setting.
paths	Boolean attribute to control the inclusion of ordered path options from root folder to the specified options. This setting is used to generate "history" or "bread crumb" menus.
regexp	A boolean attribute the specifies whether wild card/regular expression processing be performed on options values. File system command line regular expression syntax is supported.
profile	Specified name of Profile Locator to be used when evaluating option values. This attribute also sets the default profile value for options and nested menus. Specifying '*' forces the acceptance of all Profile Locator names; this can be used to override parent menu selects a profile name.
order	Comma separated list of regexp patterns matched against list or regular expression document path values to determine order of matched options. This attribute will be applied as a default options value for any options elements, but is not used to reorder multiple options children matches. If not specified, multiple options are included in the order returned by the underlying folder document orderings. Option paths not matched by this attribute are appended after ordered matches.
skin	Optional decorator defined layout hint for the menu options. This hint is not currently used by Jetspeed2 decorators.

Example:

+ + ... + /some-top-page.psml,/custom/some-other-page.psml,/*.link + ... + +]]> +

+ +

+The <separator> element defines a separator to be included in a menu. The separator will be included only if options 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: +

+ + + + + + + + + +

Attribute	Description
skin	Optional decorator defined layout hint for the menu separator. This hint is not currently used by Jetspeed2 decorators.

+The <separator> element contains a number of other menu definition PSML elements: +

+ + + + + + + + + + + + + + + + + +

Element	Description
title?	Simple element text specifies default locale-independent title for the separator. The title of the separator is considered its long description and is used as rollover text in some decorators if the separator text is available.
text?	Simple element text specifies default locale-independent text for the separator. The required separator text, whether specified by this attribute or as the contained text of the separator element, is the text to be inserted in the menu by the layout decorator.
metadata*	Optionally specifies additional locale-specific titles and separator text.

Examples:

+ + ... + ------------- + ... + + -- Top 10 Pages -- + Haut Pages + Top 10 pages as voted by the Jetspeed2 users! + + ... + +]]> +

+ +

+The <include> element includes options or nested menus 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: +

+ + + + + + + + + +

Attribute	Description
nest	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.

Examples:

+ + ... + navigations + ... + +]]> +

+ +

+The <exclude> element excludes options or nested menus 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. +

Examples:

+ + ... + pages + ... + +]]> +

+ +

Modified: portals/jetspeed-2/trunk/xdocs/guides/guide-psml.xml URL: http://svn.apache.org/viewcvs/portals/jetspeed-2/trunk/xdocs/guides/guide-psml.xml?rev=355250&r1=355249&r2=355250&view=diff ============================================================================== --- portals/jetspeed-2/trunk/xdocs/guides/guide-psml.xml (original) +++ portals/jetspeed-2/trunk/xdocs/guides/guide-psml.xml Thu Dec 8 14:33:40 2005 @@ -209,7 +209,7 @@ title? - 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. + 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. short-title? @@ -553,7 +553,7 @@ title? - 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. + 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. short-title? @@ -615,7 +615,7 @@ title? - 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. + 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. short-title? @@ -673,7 +673,7 @@

Example: see intoductory examples above.

The page, folder, and link <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. --------------------------------------------------------------------- To unsubscribe, e-mail: jetspeed-dev-unsubscribe@portals.apache.org For additional commands, e-mail: jetspeed-dev-help@portals.apache.org