I want to wrap up the various e-mails on this thread. Is the following an accurate example of how keys are resolved?
Example
Assume that each map contains a different definition for the key named product.
Contents of root map
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd">
<map title="Example of how keys resolve">
<mapref href="map-one.ditamap"/>
<mapref href="map-two.ditamap"/>
<topicref href="”stuff.dita”>
<topicref href="widget-A.dita" keys="product"/>
</topicref>
<topicref href="”widget-C.dita”" keys=”product” />
</map>
Content of map-one.ditamap
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd">
<map title="Submap one">
<mapref href="map-three.ditamap"/>
<keydef keys=”product” href="”widget-B.dita”/>
</map>
Order in which keys take precedence
1. First key definition in the root map in document order. In this example, the key product is bound to widget-A.dita.
2. First key definition in map-one.ditamap.
3. First key definition in map-two.ditamap
4. First key definition in map-three.ditamap
Basic principles
· Within an individual DITA map, keys are resolved in document order.
· When a root map contains sub maps, the maps are handled in breadth-first order.
Best regards,
Kris
Kristen James Eberlein l DITA Architect and Technical Specialist l SDL Structured Content Technologies Division l (t) + 1 (919) 682-2290 l keberlein@sdl.com
Please consider the environment before printing this e-mail