OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

dita message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Question about syntax for the @anchorref attribute

Hi, TC members.


I’ve been asked about the correct syntax for the @anchorref attribute on the <map> element. As I’ve read through various spec topics, I’ve gotten confused. I think this might be an area that that we need to consider for future clarification.



In map1.ditamap, an anchor is defined with an @id attribute set to “a1”.

<map id="A">

   <title>MyComponent tasks</title>

   <topicref navtitle="Start here" href=""start.dita"" toc="yes">

     <navref mapref="othermap2.ditamap"/>

     <navref mapref="othermap3.ditamap"/>

     <anchor id="a1"/>



In map2.ditamap, which contains the content to be pulled into map1.ditamap at the anchor point, what syntax should be used for the @anchorref attribute?

 <map id="B" anchorref="?">

   <title>This map is pulled into the MyComponent task map</title>



And I assume that map2.ditamap must be referenced somewhere in map1.ditamap in order for the <anchor> element to be resolved?

Topics in the DITA 1.2 spec


The topics in the DITA 1.2 spec suggest several distinct possibilities; which is correct? DITA map elements


Read down to the “Example of maps that use the <anchor> element and the @anchorref attribute” section; it suggests that the syntax should be as follows:


<map anchorref="a1">


</map> map


The explanation for the @anchorref attribute suggests that the syntax should be the following:

<map id="B" anchorref="map1.ditamap/a1”>


</map> URI-based (direct) addressing


The section titled “URI reference syntax examples” lists the following syntax for targeting an element within a map:


"http://example.com/map.ditamap#elementID" (and a value of "ditamap" for the format attribute)

Best regards,


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


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]