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 again,

 

I should mention that I’m not entirely sure if the lack of @format, @scope, or @type attributes was the problem. I was able to generate working HTML output with both the old and the new versions, and I wasn’t able to generate PDF output at all with either version.

 

Su-Laine

 

From: Su-Laine Yeo
Sent: Tuesday, July 20, 2010 4:39 PM
To: 'Kristen James Eberlein'; dita-comment@lists.oasis-open.org
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

 

Su-Laine Yeo
Solutions Consultant

JustSystems Canada, Inc.
Office: 778-327-6356
syeo@justsystems.com

www.justsystems.com

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 ("2.1.2.1.2.1 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 ("2.1.3.3 DITA linking" )
  • Corrected <link> and conref'd <p> element in thekeysattribute.dita ("3.4.2.2 The keys attribute")

I could not find any cross references to keyref.dita in c-terminology.dita ("2.1.1.2 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.

Best,

Kris

Kristen James Eberlein
Principal consultant, Eberlein Consulting
Secretary, OASIS DITA Technical Committee
Charter member, OASIS DITA Adoption Committee
www.eberleinconsulting.com
+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 "2.1.1.2 DITA terminology and notation" 
- p.  24 "2.1.2.1.2.1 Disciplined, topic-oriented writing"
- p. 52 "2.1.3.3 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]