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

 


Help: OASIS Mailing Lists Help | MarkMail Help

dita-comment message

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


Subject: Re: [dita-comment] Does the specs allow making conrefs from topics to maps?


Thanks Kris,

All clear now.

Regards,
Radu

Radu Coravu
<oXygen/>  XML Editor, Schema Editor and XSLT Editor/Debugger
http://www.oxygenxml.com

On 1/28/2015 10:46 PM, Kristen James Eberlein wrote:
Radu -- It is perfectly appropriate to conref from a task to topic. Or a
title from a map into a topic (or vice versa).

The statement that you quoted from the 1.2 spec -- "When pulling content
with the conref mechanism – if the referenced element is the same type
as the referencing element, and the list of domains declared on the
domains attribute in the referenced topic or map instance is the same as
or a subset of the list of domains declared in the referencing document,
the element set allowed in the referenced element is guaranteed to be
the same as, or a subset of, the element set allowed in the referencing
element." -- was not intended to be the whole story.

That is, the content of the sentence is perfectly true -- but it should
NOT be read to mean that the domains on the referenced element must be
the same or a subset of the domains on the referencing element. If they
are the same, super; if not, processors *SHOULD* generalize.

The sentence that followed this content in the 1.2 spec was " A
processor resolving a conref should tolerate specializations of valid
elements and should generalize elements in the pulled content fragment
as needed for the referencing context."

I'll talk with Robert Anderson about whether we need to modify the 1.3
draft spec to make this clearer.

Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 682-2290; kriseberlein (skype)

On 1/28/2015 4:23 AM, Radu Coravu wrote:
Hi guys,

Any updates on this one?

According to the same domains limitation the specs imposes when making
a conref, it would also seem that you cannot conref from a topic
content which is located in a task because the task domains are a
superset of the topic domains.

Regards,
Radu

Radu Coravu
<oXygen/>  XML Editor, Schema Editor and XSLT Editor/Debugger
http://www.oxygenxml.com

On 1/22/2015 8:38 AM, Radu Coravu wrote:
Dear DITA TC,

This all started here:

http://www.oxygenxml.com/forum/post32583.html

The question would be if from a DITA topic I can make a conref to an
element defined in a DITA Map, the particular example discussed in the
forum thread is about reusing indexterms.

The DITA 1.2 specs states:

http://docs.oasis-open.org/dita/v1.2/os/spec/archSpec/conref.html

    When pulling content with the conref mechanism – if the referenced
element is the same type as the referencing element, and the list of
domains declared
on the domains attribute in the referenced topic or map instance is
the same as or a subset of the list of domains declared in the
referencing document,
the element set allowed in the referenced element is guaranteed to be
the same as, or a subset of, the element set allowed in the
referencing element.


I checked and the @domains attribute of the DITA Map seems to be a
superset of the DITA topic @domains attribute. From what the specs says,
in order for a conref from a topic to a map to be considered valid, the
map domains should be a subset of the topic domains in order for a
conref from a topic to a map to be considered properly valid.

So what's your opinion on this?

Regards,
Radu

Radu Coravu
<oXygen/>  XML Editor, Schema Editor and XSLT Editor/Debugger
http://www.oxygenxml.com




-- This publicly archived list offers a means to provide input to the
OASIS Darwin Information Typing Architecture (DITA) TC. In order to
verify user consent to the Feedback License terms and to minimize spam
in the list archive, subscription is required before posting. Subscribe:
dita-comment-subscribe@lists.oasis-open.org Unsubscribe:
dita-comment-unsubscribe@lists.oasis-open.org List help:
dita-comment-help@lists.oasis-open.org List archive:
http://lists.oasis-open.org/archives/dita-comment/ Feedback License:
http://www.oasis-open.org/who/ipr/feedback_license.pdf List Guidelines:
http://www.oasis-open.org/maillists/guidelines.php Committee:
http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita Join
OASIS: http://www.oasis-open.org/join/




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