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] Issues with DITA 1.2 CD03: Obsolete file and broken cross-references

Hi Kris,


The c-terminology.dita file is fine; the terminology file with the broken xrefs is archspec/dita-terminology.dita . I’ve attached a copy of this file, in which I believe I’ve fixed the xrefs. These xrefs didn’t have @format, @scope, or @type attributes on them. I added all three attributes to all three xrefs in the file, and can generate working HTML output from the file on my machine.


Thanks for fixing the others.




Su-Laine Yeo
Solutions Consultant

JustSystems Canada, Inc.
Office: 778-327-6356


XMetaL Community Forums: http://forums.xmetal.com/





From: Kristen James Eberlein [mailto:kris@eberleinconsulting.com]
Sent: Tuesday, July 20, 2010 3:46 PM
To: dita-comment@lists.oasis-open.org
Subject: Re: [dita-comment] Issues with DITA 1.2 CD03: Obsolete file and broken cross-references


The problems with the obsolete file are fixed. I have completed the following actions:

  • Deleted keyref.dita
  • Corrected <xref> element in archspec/topicorientation.dita (" Disciplined, topic-oriented writing")
  • Corrected <xref> element in common/new-in_1_2.dita ("Appendix B.1.1 Changes from DITA 1.1 to DITA 1.2" )
  • Corrected <xref> element in archspec/ditalinking.dita (" DITA linking" )
  • Corrected <link> and conref'd <p> element in thekeysattribute.dita (" The keys attribute")

I could not find any cross references to keyref.dita in c-terminology.dita (" DITA terminology and notation"). I both scanned the file and then used Book Structure Viewer to verify that the only <xref> elements that it contains point to locations internal to  c-terminology.dita.

I transformed dita1.2-complete.ditamap and confirmed that it ran without errors.



Kristen James Eberlein
Principal consultant, Eberlein Consulting
Secretary, OASIS DITA Technical Committee
Charter member, OASIS DITA Adoption Committee
+1 919 682-2290; kriseberlein (skype)

>From the attached report, it looks like we need to fix <xref>s in the
following topics:
- p. 17 and 18 " DITA terminology and notation" 
- p.  24 " Disciplined, topic-oriented writing"
- p. 52 " DITA linking"
- p. 1203 "Appendix B.1.1 Changes from DITA 1.1 to DITA 1.2" 
We might also want to delete the keyref.dita file so that people don't
accidentally link to it in future.



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