Sausalito Developer's Guide - Parent Directory

3—2 Chapter 3: User Interface
Beta Draft 11. Copyright ' 2001. Cobalt Networks, Inc. All Rights Reserved.
Each node on the navigation graph is defined in a XML file. You must have a basic
understanding of how XML works to use navigation; for XML information, see
http://www.sun.com/xml/
Navigation node XML files are located under /usr/sausalito/ui/menu directory. These
files are very simple. It does not matter where or in what subdirectories these files are placed.
All graph related information are contained within the files. Directories can be used to group
these files into a more maintainable manner. To add a node, create a new XML file under the
directory. To remove a node, remove the file. Each XML file contains all the information the
navigation system needs to know about a node.
XML Elements
There are three elements navigation node XML files can use. They are item, parent, and
access elements. Each of the files must contain one and only one item element. Each item
element contains zero to many parent elements. The parent elements can be viewed as
links from the children to the parent node. A collection of nodes and links together composes
a site map. Each parent element can have zero or more access elements.
With no access element, the parent link has no access control and anybody can traverse the
link. With one access element, access is granted if and only if this requirement is met. With
more than one access element, access is granted if any one of the multiple requirements are
met; this is a OR condition.
Table 3—2, Table 3—3, and Table 3—4 lists possible attributes of these elements.
Table 3—2 Item Element Attributes
Name Type Description
id [a-zA-Z0-9_\-]+ id must be unique among XML files. Therefore, it is advisable to prepend package
or vendor tag to the id. See Using Unique Names on page 3—6
label internationalizable
string
description internationalizable
string
label is a short readable string that labels the node. Navigation managers can
display a list of labels for users to navigate to. The interpolate function of I18n
module is used to internationalize this string.
Labels can sometimes be too short. A description is used complement the label
in describing the node s content. The interpolate function of I18n module is used
to internationalize this string.