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: "Fragments of DITA content"


http://docs.oasis-open.org/dita/v1.0/archspec/conref.html

 

“The target of a conref must be in a valid DITA topic or DITA map. Fragments of DITA content do not contain enough information on their own to allow the conref processor to determine the validity of a reference to them.”

 

What is the basis for this statement? Could some describe how the first of these documents contains more conref-processor-relevant information than the second?

 

1.

<?xml version="1.0"?>

<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Composite//EN" "ditabase.dtd">

<!-- Created with XMetaL 4.6 (http://www.xmetal.com) -->

<topic id="topic_5"><title>Title</title>

<body>

<p id="reusable">This is a reuable paragraph.</p></body></topic>

 

 

2.

<?xml version="1.0"?>

<!DOCTYPE p PUBLIC "-//OASIS//DTD DITA Composite//EN" "ditabase.dtd">

<!-- Created with XMetaL 4.6 (http://www.xmetal.com) -->

<p id="reusable">This is a reuable paragraph.</p>

 

Perhaps the spec could be clearer if it were explicit about what information the latter lacks.

 

 

As a best practice I actually prefer the former. The title element makes it easier to find the fragment. But a rationale based upon information management best practice is different than one based upon the needs of a conref processor.

 

 Paul Prescod

 



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