| From | Sent On | Attachments |
|---|---|---|
| Paul Prescod | Jun 12, 2006 2:28 pm | |
| Robert D Anderson | Jun 12, 2006 3:11 pm | |
| Erik Hennum | Jun 12, 2006 4:07 pm | .gif, .gif, .gif, 7 more |
| Paul Prescod | Jun 12, 2006 6:09 pm | |
| Erik Hennum | Jun 13, 2006 8:10 am | |
| Paul Prescod | Jun 14, 2006 12:13 pm | |
| Robert D Anderson | Jun 14, 2006 12:53 pm | |
| Paul Prescod | Jun 14, 2006 1:10 pm | |
| Robert D Anderson | Jun 15, 2006 7:16 am | |
| JoAnn Hackos | Jun 15, 2006 7:34 am | |
| Paul Prescod | Jun 15, 2006 7:48 am | |
| JoAnn Hackos | Jun 15, 2006 7:52 am | |
| Esrig, Bruce (Bruce) | Jun 15, 2006 7:57 am | |
| Robert D Anderson | Jun 15, 2006 9:27 am | |
| Esrig, Bruce (Bruce) | Jun 15, 2006 9:39 am | |
| Robert D Anderson | Jun 15, 2006 9:43 am | |
| JoAnn Hackos | Jun 15, 2006 10:08 am | |
| Paul Prescod | Jun 15, 2006 11:19 am | |
| Paul Prescod | Jun 15, 2006 11:20 am | |
| JoAnn Hackos | Jun 15, 2006 11:22 am | |
| Robert D Anderson | Jun 16, 2006 7:09 am | |
| ma...@mekon.com | Jun 16, 2006 8:28 am | |
| JoAnn Hackos | Jun 16, 2006 10:51 am | |
| Robert D Anderson | Jun 16, 2006 6:13 pm | |
| Paul Prescod | Jun 16, 2006 6:24 pm | |
| Paul Prescod | Jun 19, 2006 9:56 am | |
| Robert D Anderson | Jun 19, 2006 10:12 am | |
| Robert D Anderson | Jun 19, 2006 11:26 am | |
| Esrig, Bruce (Bruce) | Jun 19, 2006 12:11 pm | |
| Robert D Anderson | Jun 19, 2006 12:20 pm | |
| Gershon L Joseph | Jun 26, 2006 7:48 am | |
| Grosso, Paul | Jun 26, 2006 8:51 am | |
| Robert D Anderson | Jun 26, 2006 3:04 pm | |
| Grosso, Paul | Jun 26, 2006 3:20 pm | |
| Paul Prescod | Jun 26, 2006 3:38 pm | |
| Robert D Anderson | Jun 26, 2006 5:03 pm | |
| Paul Prescod | Jun 26, 2006 5:59 pm | |
| Grosso, Paul | Jun 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.
Paul Prescod






.gif, .gif, .gif, 7 more