Home Forums DITA and XMetaL Discussion "Please select or create a DITA topic file" Reply To: "Please select or create a DITA topic file"

Derek Read

Reply to: "Please select or create a DITA topic file"

[replying to this old message now, which we dealt with offline, because others are finding it and wondering if they have the same issue]

One requirement that is not stressed in the help for configuring XMetaL Author Enterprise to use a specialized DITA DTD is that all references in the DTD must resolve in order for all DITA functionality to function properly.

XMetaL Author Enterprise itself (using its own XML parser, the one it uses to validate and for “Rules Checking”) can use catalog files to locate files it cannot otherwise find. This is why you may get no errors while authoring and why XMetaL's editing view may treat the file as DITA, providing most DITA editing capabilities. However, for a number of features (including the Map Editor) we use some 3rd party parsers (like MSXML) and these do no support catalog lookup. For this reason, [u]all references in the DTD must resolve exactly[/u]. This means that the paths such as “….topic.mod” or “topic.mod” and similar must be exact.

This is true for all versions up to and including 7.0. At some point we would like to replace these 3rd party parsers with our own to eliminate this particular requirement. I don't see us getting that work done for 8.0 (other features are more important) so this might be a requirement for some time.

If anyone has similar issues and cannot resolve them it is best to submit a case to XMetaL Support. Include your specialized DTD and let them know where you are placing it. The location is important precisely because paths must resolve.

It is also a good idea to check to see that your specialized DTD has been written correctly. A good reference for creating specialized DITA DTDs is Eliot Kimber's tutorials that he currently hosts here: http://www.xiruss.org/tutorials/dita-specialization/