[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: DITA 1.2 suggestion--Inserting a ditamap into a bookmap
This is a DITA 1.2 suggestion to improve how one inserts
a ditamap reference into a bookmap.
The problem is that, to reference a ditamap from a bookmap,
one might have a bookmap that looks like this:
<bookmap>
<chapter href=somefile.ditamap format=ditamap/>
</bookmap>
However, this can be very misleading since the things in
the referenced ditamap file may or may not be chapters.
Having to use chapter to reference a ditamap from a
bookmap is therefore very confusing to users.
We could allow topicref in bookmap's everywhere chapter and
part are currently allowed. That would permit:
<bookmap>
<topicref href=somefile.ditamap format=ditamap/>
</bookmap>
However, allowing topicref would open to door to references
to other things besides ditamaps.
The preferred solution would be to create something like "mapref"
as a specialization of topicref with a fixed value for format
of "ditamap" and possibly a fixed value for scope of "local".
(I'm less sure about scope, but I can't think of a case where it
makes sense to have a topicref to a DITA map that isn't available
at the time of composition.) That would allow users to enter:
<bookmap>
<mapref href=somefile.ditamap/>
</bookmap>
which would be a lot less confusing than the current situation.
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]