atom feed38 messages in org.oasis-open.lists.ditaRE: [dita] Complexity of bookmap cont...
FromSent OnAttachments
Paul PrescodJun 12, 2006 2:28 pm 
Robert D AndersonJun 12, 2006 3:11 pm 
Erik HennumJun 12, 2006 4:07 pm.gif, .gif, .gif, 7 more
Paul PrescodJun 12, 2006 6:09 pm 
Erik HennumJun 13, 2006 8:10 am 
Paul PrescodJun 14, 2006 12:13 pm 
Robert D AndersonJun 14, 2006 12:53 pm 
Paul PrescodJun 14, 2006 1:10 pm 
Robert D AndersonJun 15, 2006 7:16 am 
JoAnn HackosJun 15, 2006 7:34 am 
Paul PrescodJun 15, 2006 7:48 am 
JoAnn HackosJun 15, 2006 7:52 am 
Esrig, Bruce (Bruce)Jun 15, 2006 7:57 am 
Robert D AndersonJun 15, 2006 9:27 am 
Esrig, Bruce (Bruce)Jun 15, 2006 9:39 am 
Robert D AndersonJun 15, 2006 9:43 am 
JoAnn HackosJun 15, 2006 10:08 am 
Paul PrescodJun 15, 2006 11:19 am 
Paul PrescodJun 15, 2006 11:20 am 
JoAnn HackosJun 15, 2006 11:22 am 
Robert D AndersonJun 16, 2006 7:09 am 
ma...@mekon.comJun 16, 2006 8:28 am 
JoAnn HackosJun 16, 2006 10:51 am 
Robert D AndersonJun 16, 2006 6:13 pm 
Paul PrescodJun 16, 2006 6:24 pm 
Paul PrescodJun 19, 2006 9:56 am 
Robert D AndersonJun 19, 2006 10:12 am 
Robert D AndersonJun 19, 2006 11:26 am 
Esrig, Bruce (Bruce)Jun 19, 2006 12:11 pm 
Robert D AndersonJun 19, 2006 12:20 pm 
Gershon L JosephJun 26, 2006 7:48 am 
Grosso, PaulJun 26, 2006 8:51 am 
Robert D AndersonJun 26, 2006 3:04 pm 
Grosso, PaulJun 26, 2006 3:20 pm 
Paul PrescodJun 26, 2006 3:38 pm 
Robert D AndersonJun 26, 2006 5:03 pm 
Paul PrescodJun 26, 2006 5:59 pm 
Grosso, PaulJun 27, 2006 7:06 am 
Subject:RE: [dita] Complexity of bookmap content model
From:Paul Prescod (paul@xmetal.com)
Date:Jun 14, 2006 12:13:24 pm
List:org.oasis-open.lists.dita

Let me ask this again in a few ways.

1. Do current bookmap users see this content model as complex?

2. If not, how do you manage the complexity in your head? How do you remember what elements can go in what places?

3. Is there anyone out there who would argue against simplifying the model on a technical or usability basis?

4. Is there anyone who would argue against simplifying it on a procedural basis ("too late. Will slow us down?")

5. What do people think about the particular simplification proposal at the bottom? Putting aside issues of title, the main ideas are

* group front-matter and backmatter into their own (topichead-like) elements.

* to group the portion of the tree designed for creating relationships but not generating the table of contents (to help make the TOC predictable)

=====

Note the sort of document that the current model can generate:

<bookmap>

<title></title> <part><appendix></appendix><appendix></appendix></part> <part><chapter></chapter><chapter></chapter></part> <colophon/> <topicref></topicref> <topicref></topicref> <topichead></topichead></bookmap>

* Chapters after appendices. * Topicrefs after colophon. * Topicheads after the colophon

What should a TOC generator do with a topicref after the appendices and colophon are done?

Are the appendices within parts before chapters meant to be gathered for the end of the book or published in-place in the middle of the document?

-----Original Message----- From: Paul Prescod [mailto:paul@xmetal.com] Sent: Monday, June 12, 2006 2:29 PM To: di@lists.oasis-open.org Subject: [dita] Complexity of bookmap content model

Is anyone else concerned about the complexity of this content model?

<!ELEMENT bookmap (((%title;) | (%booktitle;))?, (%bookmeta;)?, ( (%booklists;) | (%draftintro;) | (%abstract;) | (%dedication;) | (%preface;))*, (%chapter;)*, ( ( (%appendix;)*, (%notices;)?, (%specialnotices;)*, (%amendments;)? ) | (%part;)* ), (%colophon;)?, (%topicref; | %reltable;)*)>

I don't mind its size as much as its complexity.

Even with validating editors like XMetaL, content models with many alternatives can be confusing. "I put an appendix in and now I can't put a part in before it. Why not?"

Also: why do we want to allow multiple abstracts, dedications, prefaces, etc.

I could imagine something more like:

<!ELEMENT bookmap (title, bookmeta?, frontmatter?, chapter*, part*, backmatter?, colophon?, relationships? )

I would expect the elements frontmatter, backmatter and relationships to be topicheads.