Overview of the Custom.xml File
The Custom.dtd file defines the legal building blocks for the site-specific documents.
The structure of the XML is as follows:
-
Sections. Information is presented in two columns, using the left and right portions of the page.
This data uses the
<leftsection>and<rightsection>elements. Each section must include at least one group. -
Groups. Collections of related categories of documents are presented in the left or right half of the page (such as General Interest or Training).
This data uses the
<group>element.-
Heading (using the
<head>element)-
Heading title (using the
<htitle>element) -
(Optional) Heading description (using the
<hdesc>element)
-
-
(Optional) One or more subheadings (using the
<subhead>element)-
Subheading title (using the
<stitle>element) -
(Optional) Subheading description (using the
<sdesc>element)
-
-
At least one document element.
-
-
Documents. Titles and links that specify site-specific documents (such as Guidelines for managing resource pools and Analyzing Performance) are presented within groups.
This data relies on the
<document>element.-
Document title (using the
<dtitle>element) -
Document file name (using the
<dfn>element)Specify the path of the file relative to the
pdfdirectory (see Where to Find the Files for details on the PPM Server file organization). -
(Possibly optional) Document type (using the
<dtype>element)If the file format is not PDF, the file format must also be included (see Supported File Types for details).
-
-
Title. The name of the custom page can be uniquely specified (such as "XYZ Company" as shown in Figure 4-3. Custom, site-specific documents).
For your convenience, the Custom.dtd file is included in Sample Files. The content for this XML file is optional; however, an "empty" file similar to the following must be provided.
<?xml version="1.0" ?>
<!DOCTYPE custom SYSTEM "../Custom.dtd">
<custom>
<leftsection>
<group></group>
</leftsection>
<rightsection>
<group></group>
</rightsection>
<title></title>
</custom>
