Atomik Roundtrip 2.1: Reference > Chapter 12 Function Reference << >>

12.1.3 DTD Tab

The DTD Tab of the Roundtrip XML palette shows a hierarchical view of the DTD structure or schema document upon which an XML file, place holder document, or ruleset document is based.

As with the XML tab, some elements have disclosure triangles, which can be clicked to reveal the child elements of that element. Option- (Mac) or alt- (Windows) clicking an element will automatically open all the child elements of that element.

The hierarchical view of the DTD or schema structure is clarified by icons which allow you to distinguish the precise structural rules which exist for data within a given element.

Sequence list - indicates a sequence of elements (item1, item2, item3) in a DTD declaration.

Choice list - indicates a choice of elements (item1 | item2 | item3) in a DTD declaration.

Element appears one or more times in this context - indicates a ‘+’ in a DTD declaration.

Element is optional (appears once or not at all in this context) - indicates a ‘?’ in a DTD declaration.

Element appears multiple times in this context - incidates to ‘*’ in a DTD declaration.

The placement of these last three icons is important to their meaning. If the icon is placed before an element’s name (i.e.

), this means that the ‘+’ notation applies to the entirety of that element - in this example, the DTD equivalent would be: <!ELEMENT Magazine (Section)+>. Note; these notations are always declared in the parent element which contains that element, not that of the element itself.

If the icon is placed after a list (or choice or a sequence), then it applies to the entirety of that list. For example

means: <!ELEMENT Paragraph (#PCDATA | EMail | URL)*>

If the notation icon appears to the left of a specific item in a list, then that notification is specific to the item within that list, so, for example,

would be equivalent to: <!ELEMENT Graphic (Image, Caption?)>

It is also possible to view the DTD structure as a non-hierarchical alphabetical list of elements. This is particularly useful if your hierarchy is very complex and you wish to be able to locate an element without having to hunt through the hierarcy clicking on parent elements’ disclosure triangles. In order to view the list in flat mode, simply right click (windows) or control-click (Mac) on the DTD tab of the XML palette, and select ‘View Flat’ from the context menu which appears.