DTD for GMT Macros files
28.01.04: change names: group-ref to group-include, macro-ref(inside macro) to macro-include, link-simple to GMT-LINK, link-ext to GMT-LINK_EXT
17.03.04: add text-node and comment-node and description of new text-macros inside attribute-values
30.04.04: add macros-group-include and update description of text-macros inside attribute-values
Element: attribute-ref Description: with the attribute-ref element you can define an attribute for the element which is defined with the surrounding element-ref element; the GMT will not check if the name and the value of this attribute is valid for the element |
||||||||||||||||||||
|
||||||||||||||||||||
|
||||||||||||||||||||
attribute-ref is used in: element-ref.
|
Element: comment-node Description: creates a comment-node |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
comment-node is used in: element-ref, macro.
|
Element: constant-def Description: defines a string constant which can be used inside the value-attribute of attribute-ref, text-node and comment-node elements using $CONST_NAME$ or $const_name$ |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
constant-def is never used (root element?).
|
Element: element-ref Description: with the element-ref element you can define an element which may have attributes and can contains other elments; in the current version the GMT will not check if this is an valid element |
||||||||||
|
||||||||||
|
||||||||||
element-ref is used in: element-ref, macro.
|
Element: GMT-LINK Description: all occurences of link-simple will be replaced with <gmt-link link-id="%LINK-ID%"/> |
||
|
||
No Attributes. | ||
GMT-LINK is used in: element-ref, macro.
|
Element: GMT-LINK_EXT Description: all occurences of link-ext will be replaced with <gmt-link link-id="%LINK-ID%" comment="%INPUT% %TEXT%" created-at="%DATE%, %TIME%" created-by="%USER%"/> |
||
|
||
No Attributes. | ||
GMT-LINK_EXT is used in: element-ref, macro.
|
Element: gmt-macros Description: gmt-macros is the root element - it must have exactly 2 children: macros-def, group (=the top level group) |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
gmt-macros is never used (root element?).
|
Element: group Description: a group contains one or more sub-groups, group-refs, macro-refs or single-element-refs |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
group is used in: group, structure-def.
|
Element: group-include Description: with group-include you can include an existing group (i.e. defined somewhere else in the structure definition part); in the GMT it looks the same as the refered group (i.e. it seems that the refered group is defined twice) |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
group-include is used in: group, structure-def.
|
Element: group-link Description: represents a link to a group |
||||||||||||||||||||
|
||||||||||||||||||||
|
||||||||||||||||||||
group-link is used in: group, structure-def.
|
Element: label Description: inserts a label - useful together with separator to describe a part of a group |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
label is used in: group, structure-def.
|
Element: macro Description: the macro element defines a macro (i.e. a structure of XML elements which belongs togehter); a macro may contain one or more references to elements, other macros or to the special link-def "macro" |
||||||||||||||||||||
|
||||||||||||||||||||
|
||||||||||||||||||||
macro is used in: macros-def, macros-group.
|
Element: macro-include Description: copies the content of the referred macro into the current macro |
||||||||||
|
||||||||||
|
||||||||||
macro-include is used in: element-ref, macro.
|
Element: macro-ref Description: with macro-ref you can refer to an existing macro; if a macro-ref element is used in a macro definition (i.e. in a macro or element-ref element), the macro-ref element will be replaced with the contents of the refered macro |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
macro-ref is used in: group, structure-def.
|
Element: macros-def Description: the macros-def element contains all macro definitions: at least one macro-group or one macro |
||
|
||
No Attributes. | ||
macros-def is used in: gmt-macros.
|
Element: macros-group Description: with the macros-group element macros - which belongs togehter - can be combined; macros-group's are currently not shown in the macros view of the GMT - they are only useful when editing a macros file in a XML editor |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
macros-group is used in: macros-def, macros-group.
|
Element: macros-group-include Description: inserts a new group with containing the macros of referenced macros-group; convenient way to quick add new macros |
||||||||||
|
||||||||||
|
||||||||||
macros-group-include is used in: group.
|
Element: separator Description: inserts a separator (line) - use this to group macros/elements which belong together |
||
|
||
No Attributes. | ||
separator is used in: group, structure-def.
|
Element: single-element-ref Description: unlike element-ref a single-element-ref is used to define only a single element it's the same as a macro-ref refering to a macro with only a single element-ref; if you want to define attributes with to single element, you have to use macro-ref/macro |
||||||||||||||||||||
|
||||||||||||||||||||
|
||||||||||||||||||||
single-element-ref is used in: group, structure-def.
|
Element: structure-def Description: structure-def contains the root-group of the macros structure as shown in GMT's structure view |
||
|
||
No Attributes. | ||
structure-def is used in: gmt-macros.
|
Element: text-node Description: creates a text-node (PCDATA) |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
text-node is used in: element-ref, macro.
|