The repository

The DEXlib repository is organized as follows:

NOTE: The directory structure is based on the STEPmod directory structure, and designed so that it can be migrated to STEPmod with minimum change. Hence, all DEXlib specific files are contained within the dex folder sub directories.

css/

Contains the CSS stylesheets.

css/dex

The DEXlib specific files.

css/refdata

The DEXlib specific files. (REMOVE?)

data/

XML data for DEXlib.

data/basic

Contains boilerplate XML document fragments common to all DEX Specifications. E.g. contacts, abbreviations etc.

data/basic/dex

The DEXlib specific files.

data/busconcept

Contains ...

data/capabilities

Contains directories for the capabilities.

data/capability/[capability-name]

Each capability is stored in its own directory with the same name as the capability [capability-name]. Each capability directory contains files specific to the capability including XML data, images, etc.

data/dex/[capability-name]/dvlp

Sources for images and other development files.

data/dex/[capability-name]/images

Image files used by the Capability. The png format is preferred.

data/dex/[capability-name]/sys

Auto generated XML files for displaying the Capability.

data/dex

Contains directories for the DEX Specifications.

data/dex/[dex-name]

Each DEX Specification is stored in its own directory with the same name as the DEX Specification [dex-name]. Each directory contains files specific to the DEX Specification.

data/dex/[dex-name]/dvlp

Sources for images and other development files.

data/dex/[dex-name]/images

Image files used by the DEX Specification. The png format is preferred.

data/dex/[dex-name]/sys

Auto generated XML files for displaying the DEX Specification.

data/refdata

Use of the files directly in this folder is deprecated in favour of the RD files in the folders named by OASIS stage as described below.

data/refdata/developer-draft

Contains the RDF-XML OWL Reference Data files for individual users (in-development) and the plcs-std-rdl file that is at the Developer Draft stage.

data/refdata/committee-draft

Contains the RDF-XML OWL Reference Data in the plcs-std-rdl file that is at the Committee Draft stage.

data/refdata/public-review-draft

Contains the RDF-XML OWL Reference Data in the plcs-std-rdl file that is at the Public Review Draft stage.

data/refdata/committee-specification

Contains the RDF-XML OWL Reference Data in the plcs-std-rdl file that is at the Committee Specification stage and the related plcs-arm-lf-express and annotation property definition files.

data/terminology

Contains ...

data/testdata

Contains ...

docs/

Contains ...

downloads/

Contains ...

dtd/

Contains the repository DTD files.

dtd/dex

The DEX Specification specific DTDs.

dtd/refdata

The Reference Data specific DTDs.

etc/

Contains ...

help/

Contains all the help files. This root folder should be empty.

help/dex

The XML files used for the PLCS information pages.

help/dex/dvlp

Sources for images and other development files.

help/dex/images

The image files used for the PLCS information pages. The png format is preferred.

help/refdata

The Reference Data specific help - NOT USED!.

images/

DEXlib image files. This root folder should be empty.

images/dex

Contains images that are used in DEXlib, e.g. the issues symbol or the '+' and '-' boxes for navigation. Note that any images specific to a DEX Specification, Capability, etc., should appear in the relevant DEX Specification or capability directory. The same goes for the images used in the help section.

images/refdata

The Reference Data specific images.

logs/

Contains ...

sys/

Contains the XML for displaying the HTML frames for dexlib.

utils/

Contains a set of utility scripts for creating DEX Specifications, capabilities and other functionality.

utils/dex

The DEX Specification specific utilities.

utils/refdata

The Reference Data specific utilities.

xsl/

Contains everything pertaining to transforming the XML to HTML. This includes XSLT stylesheets.

xsl/dex

The DEXlib specific XSL files.

xsl/refdata

The Reference Data specific XSL.