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: Fw: [dita] content model issues in LwDITA grammar files


I found this view from Chris (link forwarded below) to be quite helpful, and they helped me dig into the grammar files a bit more. I found several items that are not technically valid for something derived from DITA 1.3, because they would allow something that the base model prohibits. Fortunately these are all pretty minor, but all need to change:

  • The <alt> element should not allow <image> in the content model (not allowed in DITA 1.3, and would not really make sense anyway)
  • The <body> element should not allow <fn>
  • Technically, the content model for <dl> should be dlentry+ rather than dlentry* (base DITA requires at least one, so should LwDITA)
  • Same for lists, <ol> and <ul> should change the content model from a star (li)* to a plus (li)+
  • Same for simpletable, it should change the strow from zero-to-many (strow*) to one-or-more (strow+)
  • Same for sthead, it should change the stentry from zero-to-many (stentry*) to one-or-more (stentry+) [Oddly, base DITA does have a model of zero-to-many in the ordinary <strow>, but <sthead> requires at least one entry]
  • The <pre> element should not allow <image>
  • <data> has different definitions in map and topic, as Alan pointed out recently (should be the same)
  • Trivial issue, in both maps and topics, the class attributes for the highlight elements should start with "+" instead of "-" as with other domain elements (and to match the DITA 1.3 definitions)
Regards,

Robert D. Anderson
DITA-OT lead and Co-editor DITA 1.3 specification,
Digital Services Group


E-mail: robander@us.ibm.com
Digital Services Group
11501 BURNET RD,, TX, 78758-3400, AUSTIN, USA

----- Forwarded by Robert D Anderson/Rochester/IBM on 06/09/2017 10:37 AM -----

From: Chris Nitchie <chris.nitchie@oberontech.com>
To: "dita@lists.oasis-open.org" <dita@lists.oasis-open.org>
Date: 06/09/2017 09:04 AM
Subject: [dita] Easily-browsed content models for Lightweight DITA
Sent by: <dita@lists.oasis-open.org>




I have a tool that generates cross-linked documentation based on DTD files, so I ran that over the Lightweight DITA DTDs and put it up on Titania for purposes of my own review. Here’s the link in case others find it useful.

https://td-demo.titaniasoftware.com/portals/ui/lwdita-dtd/

Chris



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