Developers Information - XML Tags

Introduction

This section describes the XML elements (tags) that are used when writing an XML file for use in DEXlib.

The elements are defined in the following DTDs:

Basic text tags

This section describes the XML elements (tags) that are used for basic text layout.

<p> — Paragraph

Paragraphs are defined by the XML element (these are the same as the HTML elements of the same name):

        <!ELEMENT p (%text-elts;)*>
      

E.g. <p>A new paragraph.</p>

<ul|ol> — List

Lists are defined by the XML elements (these are the same as the HTML elements of the same name):

        <!ELEMENT ul (li+)>
        <!ELEMENT ol (li+)>
        <!ATTLIST ol
        type (1 | A | a | I | i) "1"
        start CDATA #IMPLIED>
        
        <!ELEMENT li (%text-elts;)*>
      

where <ul> is an unordered list, <ol> is an ordered list and <li> is a list item.

E.g. The following XML:

        <ul>
        <li>First item.</li>
        <li>Second item.</li>
        </ul>
      

results in:

<screen> — Screen output

Screen is used for...

Tags for referencing parts of DEXlib

This section describes the XML elements that can be used to establish hyperlinks to different parts of DEXlib.

Link to pages within the Information Pages section

To create a link to an internal DEXlib Information Page, the construct below is used.

        <help_ref file="source_page.xml">Page</help_ref>
      

Link to external pages

To create a link to an external web page, the construct below is used.

        <a href="http://www.iso.org"/>
      

<dex_ref> — Link to a DEX

are defined by the XML element:

      

where linkend is

NOTE    A list of all available DEX links is provided in the "Tools" section of DEXlib.

<capability_ref> — Link to a Capability

are defined by the XML element:

      

where linkend is

NOTE    A list of all available DEX links is provided in the "Tools" section of DEXlib.

<template_ref> — Link to a Template

are defined by the XML element:

       <!--  reference to a capability template -->
       <!--    name is the name of the template
         When the template is defined in a capability, provide the capability name 
         When the template is defined in a business_concept,  provide the business_concept and its context
-->
       <!ELEMENT template_ref EMPTY>
       <!ATTLIST template_ref
	name CDATA #REQUIRED
	capability CDATA #IMPLIED
	context CDATA #IMPLIED
	business_concept CDATA #IMPLIED>
      

where linkend is

NOTE    A list of all available DEX links is provided in the "Tools" section of DEXlib.

<express_ref> — Link to an EXPRESS object

are defined by the XML element:

      

where linkend is

NOTE    A list of all available DEX links is provided in the "Tools" section of DEXlib.

<express_extref> — Link to an external EXPRESS object

are defined by the XML element:

      

where linkend is

NOTE    A list of all available DEX links is provided in the "Tools" section of DEXlib.

<module_ref> — Link to a module

are defined by the XML element:

      

where linkend is

NOTE    A list of all available DEX links is provided in the "Tools" section of DEXlib.

<rdl_ref> — Link to an OWL Class

URLs to a class in an RDL are defined by the XML element:

        <!-- Setup an URL to a class in an RDL -->
        <!ELEMENT rdl_ref (#PCDATA)>
        <!-- id: the id of the class being referenced -->
        <!ATTLIST rdl_ref id CDATA #REQUIRED>
        <!-- urn: the urn of the RDL containing the class referenced -->
        <!ATTLIST rdl_ref urn CDATA #REQUIRED>