This syntax for a reference to an element iwthin the map cannot be correct:
<map id="B" anchorref="map1.ditamap/a1²>
Because the fragment identifier part (the "a1" in this case) is here encoded
as a part of the main URL, which is not sensical unless "map1.ditamap"
happens to be a directory and "a1" is the filename of a map, which we can
assume was not the intent.
The correct syntax must then be that as defined in the general rules for
URIs, name "map1.ditamap#a1".
Cheers,
Eliot
On 11/30/10 7:06 AM, "Kristen Eberlein" <> wrote:
> 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.
>
> Question
> 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"/>
> </topicref>
> </map>
> 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>
> ...
> </map>
> 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?
>
> 2.1.2.2.3 DITA map elements
> http://docs.oasis-open.org/dita/v1.2/cs01/spec/archSpec/ditamap-elements.html#
> ditamap-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>
>
> 3.1.2.1.1 map
> http://docs.oasis-open.org/dita/v1.2/cs01/spec/langref/map.html#map
> The explanation for the @anchorref attribute suggests that the syntax should
> be the following:
>
> <map id="B" anchorref="map1.ditamap/a1²>
> ...
> </map>
>
>
> 2.1.3.4.2 URI-based (direct) addressing
> http://docs.oasis-open.org/dita/v1.2/cs01/spec/archSpec/uri-based-addressing.h
> tml#uri-based-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,
> Kris
> Kristen James Eberlein l DITA Architect and Technical Specialist l SDL
> Structured Content Technologies Division l (t) + 1 (919) 682-2290 l
> <mailto:>
> <http://www.sdl.com/>
> Please consider the environment before printing this e-mail
>
--
Eliot Kimber
Senior Solutions Architect
"Bringing Strategy, Content, and Technology Together"
Main: 512.554.9368
www.reallysi.com
www.rsuitecms.com
