Home Forums DITA and XMetaL Discussion customized template Reply To: customized template

Derek Read

Reply to: customized template

Your first example looks like a valid DITA concept (minus the XML prolog) but your second document is not.

Perhaps you have specialized DITA? If you have then you will need to ensure your specialized DITA DTDs are valid and then follow the procedure in Help under “Working with DITA” > “DITA Specializations” to configure XMetaL Author Enterprise to recognize your DTDs as DITA.

If you have not specialized DITA then your issue is that you are creating an invalid concept. The element you wish to insert is not allowed in a concept. You will not be able to insert this element using the Element List (it will not be listed as a choice). If you do insert the element (perhaps by typing it in using Plain Text view or while using another application) a validation error will be displayed when XMetaL validates the document. The error will be similar to: “Unknown tag name. The tag name 'volume' is not defined.”

The concept document type does not support a “volume” element. In addition, in a DITA concept the first element must be “title”. No other element can appear before it.
[quote=DITA spec – concept element content model]( (title) then (titlealts) (optional) then (abstract or shortdesc) (optional) then (prolog) (optional) then (conbody) (optional) then (related-links) (optional) then (concept) (any number) )

DITA does define a “volume” element, but not in a concept. The element is only allowed inside the bookmap document type (a bookmap is a specialized type of map).

To see details of the content model for any DITA element place your insertion point (text cursor) directly inside the element while the document is open in Tags On or Normal view and press Alt+F1. It is usually easiest to position your insert point for this while in Tags On view.

To understand how XMetaL Author helps you create valid XML read the Help topic “Authoring structured content” and the subtopics below it titled “Validation and rules checking” and “Working with elements”.