Design for 12017

Design for item

What user need will be met by this feature?

Users can use the same metadata structure in ditamap as the one defined in topic/prolog while the old format of metadata is still valid. With the same metadata structure in ditamap and topic, users can easily copy the metadata content from map to topic or vice versa by using conref.

What is the technical design for the change?

The change in DITA standard affects two modules in preprocess, conref resolution and move metadata.

Conref which pull content from map to topic is different from that between topics because it doesn't need to specify topic id. Right now conref.xsl can handle this kind of reference but we still need to make sure that it can work between different specilizations.

Move metadata needs to process the new metadata structure in ditamap. Fortunately, the code currently read the metadata from ditamap according to their @class value and doesn't depend on the actual structure of the metadata. Therefore, the code can process the new metadata after the dtd refactor and doesn't need to be updated. However, we still need to make sure the code can work on different specializations.

What sections of the toolkit will be impacted by the change?

Conref resolution and move metadata module in preprocess needs to pass verification test. Right now, they don't need to be updated.

See also

none