Home Forums DITA and XMetaL Discussion Error: topicref not allowed in container Reply To: Error: topicref not allowed in container

Derek Read

Reply to: Error: topicref not allowed in container

A Brief History of the Map Editor
(to give you an idea of how it is progressing)

Note: Every version of the product has included support for editing 'regular' DITA maps in the Map Editor.

XMetaL Author 4.6 DITA Edition (an add-on for XMetaL Author):
Our first release to include DITA support included the Map Editor (embedded in the Resource Manager) but only supported viewing and editing regular DITA maps. Bookmap did not exist so it was not even considered.

XMetaL Author Enterprise 5.0:
Bookmap was beginning to appear at this time as people began contemplating moving to DITA 1.1. XMetaL Author Enterprise 5.0 did not support it however as there was no demand.

XMetaL Author Enterprise 5.0 SP1:
This is the first edition to include support for viewing bookmaps in the Map Editor as read only content. Bookmap editing was supported in the “XML view” (Tags On, Normal and of course Plain Text).

This allowed bookmaps to be opened in the Map Editor and used as a navigation aid for locating and opening topics. This was a common demand from larger organizations where the majority of people only edit topics and never or rarely modify maps. Those people that needed to create and modify maps (a specialized role) could do so in “XML view” (Tags On view primarily) or in some cases they use another tool (often an integral part of their CMS system).

At this point the feature was considered a “preview” as enabling DITA 1.1 required one additional configuration step after installing the product.

XMetaL Author Enterprise 5.1:
The feature was improved (mostly bug fixes) but remained largely the same. The main difference with 5.1 was that it was the first release we shipped to enable DITA 1.1 editing out of the box (with the option to use DITA 1.0 if desired). This meant that no additional configuration step was needed to enable the viewing of bookmaps for navigation and it was no longer considered a “preview” feature.

XMetaL Author Enterprise 5.5:
More improvements were made but the Map Editor still only supported bookmaps for navigational purposes in this release. Improvements included support for CMS integrations based on XMetaL Connector which would allow people to open topics from a CMS from within the Map Editor.

XMetaL Author Enterprise 6.0:
The first release to support editing of bookmaps and specialized maps in the Map Editor. However, validation (aka: “Rules Checking”) is not performed and it is possible to insert elements in the wrong place, or leave out required elements. This means you must be aware of the valid structure of bookmaps (or your own specialized map) when using the Map Editor.

See the warnings in the Tools > DITA Options dialog on the Map Editor tab related to enabling the editing of bookmaps and specialized maps: “…allow editing bookmaps and other specialized maps in the Map Editor pane only if you know the rules for these structures well enough to not make them valid”.

Future Plans (7.0?):
In the future we plan to make the Map Editor a validating editor similar to Tags On view. The primary goal of this new functionality would be to stop you from putting elements in the wrong place and creating an invalid map structure. Ideally this functionality will be included with our next release (probably numbered 7.0).

Information above gleaned from readme files: http://forums.xmetal.com/index.php/topic,108.0.html