Summary of bookmap elements

Note: this is a list of GUESSES about the semantics of 
elements based upon their element type names, content models and occurrence 
patterns.

At the bottom is a list of 
potential problems in the specialization hierarchy as discovered by a prototype 
tool that works with XMetaL.

 

bookmap/abbrevlist

  Bases 
  map/topicref 
  Derived types 
  (none) 
  Children 
  (none) 
  Parents 
  booklists 

Indication to the processing software that the author would like an 
abbreviation list generated at the particular location. Question: how should 
this be generated?

 

bookmap/abstract

  Bases 
  map/topicref 
  Derived types 
  (none) 
  Children 
  (none) 
  Parents 
  bookmap 

Per wikipedia: http://en.wikipedia.org/wiki/Abstract_(summary)

An abstract is a brief summary of a research article, thesis, review, 
conference proceeding or any in-depth analysis of a particular subject or 
discipline, and is often used to help the reader quickly ascertain the paper's 
purpose. When used, an abstract always appears at the beginning of a manuscript, 
acting as the point-of-entry for any given scientific paper or patent 
application.

bookmap/amendments

  Bases 
  map/topicref 
  Derived types 
  (none) 
  Children 
  (none) 
  Parents 
  bookmap,part 

???

bookmap/appendix

  Bases 
  map/topicref 
  Derived types 
  (none) 
  Children 
  topicmeta,topicref,topichead,topicgroup 
  Parents 
  bookmap,part 

Per wikitionary: http://en.wiktionary.org/wiki/appendix

A text added to the end of a book or an article, containing information that 
is important to but not in the focus of the main text

bookmap/approved

  Bases 
  topic/data 
  Derived types 
  (none) 
  Children 
  data,authorinformation,revisionid,started,completed,summary 
  Parents 
  bookchangehistory 

Information about an approval event in the publication history of a book. 

bookmap/bibliolist

  Bases 
  map/topicref 
  Derived types 
  (none) 
  Children 
  (none) 
  Parents 
  booklists 

Per wikipedia: http://en.wikipedia.org/wiki/Bibliography

A bibliography is a list, either indicative or comprehensive, of works... 
mentioned in, or relevant to, a particular work.

bookmap/bookchangehistory

  Bases 
  topic/data 
  Derived types 
  (none) 
  Children 
  reviewed,edited,tested,approved,bookevent 
  Parents 
  bookmeta 

The history of the book's creation and publishing lifecycle.

Question: for primarily internal purposes?

Question: why is this applicable to books but not other maps? And why not 
even to topics? Why no "topicchangehistory?"

Question: why isn't there an event type for "publish"?

Question: is the element type correct? Approval, review and "test" do not 
neccessarily imply "change". 

bookmap/bookevent

  Bases 
  topic/data 
  Derived types 
  (none) 
  Children 
  bookeventtype,data,authorinformation,revisionid,started,completed,summary 
  Parents 
  bookchangehistory 

An event in the publication history of a book. If there is a more specific 
element representing the kind of event then you should use it: review, edit, 
test or approval. 

Question: Why aren't those elements derived from this one? Bookeventtype 
could be optional and implied by a processing override.

bookmap/bookeventtype

  Bases 
  topic/data 
  Derived types 
  (none) 
  Children 
  (none) 
  Parents 
  bookevent 

The type of a book event. For example, "updated" or "indexed".

bookmap/bookid

  Bases 
  topic/data 
  Derived types 
  (none) 
  Children 
  bookpartno,edition,isbn,booknumber,volume,maintainer 
  Parents 
  bookmeta 

Publisher's identifying information. The part number, edition, ISBN number, 
and so on. 

bookmap/booklibrary

  Bases 
  topic/ph 
  Derived types 
  (none) 
  Children 
  ph,term,q,boolean,state,keyword,tm,image 
  Parents 
  booktitle 

The part of the title representing the library??? I guess library represents 
what others might call a book series?

bookmap/booklist

  Bases 
  map/topicref 
  Derived types 
  (none) 
  Children 
  (none) 
  Parents 
  booklists 

To be used in specializations to include and/or indicate the location of 
lists that summarize the contents of the book. For example it might be a list of 
program listings or authors of topics.

bookmap/booklists

  Bases 
  map/topicref 
  Derived types 
  (none) 
  Children 
  toc,figurelist,tablelist,abbrevlist,trademarklist,bibliolist,glossarylist,indexlist,booklist 

  Parents 
  bookmap 

A container for various kinds of lists summarizing the contents of the 
book.

bookmap/bookmap

  Bases 
  map/map 
  Derived types 
  (none) 
  Children 
  title,booktitle,bookmeta,booklists,draftintro,abstract,dedication,preface,chapter,appendix,notices,specialnotices,amendments,part,colophon,topicref,topichead,topicgroup,reltable 

  Parents 
  (none) 

Root element for bookmap maps.

bookmap/bookmeta

  Bases 
  map/topicmeta 
  Derived types 
  (none) 
  Children 
  linktext,searchtitle,shortdesc,source,critdates,permissions,audience,category,keywords,prodinfo,othermeta,resourceid,bookid,bookchangehistory,bookrights,publisherinformation,data,authorinformation 

  Parents 
  bookmap 

Metadata for the book.

bookmap/booknumber

  Bases 
  topic/ph 
  Derived types 
  (none) 
  Children 
  (none) 
  Parents 
  bookid 

The book number in a library or series??? How is this different than 
volume???

bookmap/bookowner

  Bases 
  topic/data 
  Derived types 
  (none) 
  Children 
  data,authorinformation 
  Parents 
  bookrights 

The entity owning the copyright for the book.

bookmap/bookpartno

  Bases 
  topic/ph 
  Derived types 
  (none) 
  Children 
  (none) 
  Parents 
  bookid 

The number that the publisher uses to indentify the book for tracking 
purposes. Like a stock keeping unit or order number.

bookmap/bookrestriction

  Bases 
  topic/data 
  Derived types 
  (none) 
  Children 
  (none) 
  Parents 
  bookrights 

A string like "All Rights Reserved" representing the publisher's copyright 
restrictions.

bookmap/bookrights

  Bases 
  topic/data 
  Derived types 
  (none) 
  Children 
  copyrfirst,copyrlast,bookowner,bookrestriction,summary 
  Parents 
  bookmeta 

Legal rights associated with a book.

bookmap/booktitle

  Bases 
  topic/title 
  Derived types 
  (none) 
  Children 
  booklibrary,mainbooktitle,booktitlealt 
  Parents 
  bookmap 

A potentially segmented title for a book.

bookmap/booktitlealt

  Bases 
  topic/ph 
  Derived types 
  (none) 
  Children 
  ph,term,q,boolean,state,keyword,tm,image 
  Parents 
  booktitle 

Alternative title of a book??? 

Question: Is this a sub-title? If not, is it really "part" of the title?

bookmap/chapter

  Bases 
  map/topicref 
  Derived types 
  (none) 
  Children 
  topicmeta,topicref,topichead,topicgroup 
  Parents 
  bookmap,part 

A reference to a topic representing a chapter. 

Per wikipedia:

"One of the main divisions of a ... book."

bookmap/colophon

  Bases 
  map/topicref 
  Derived types 
  (none) 
  Children 
  (none) 
  Parents 
  bookmap 

Per wikipedia: http://en.wikipedia.org/wiki/Colophon_(publishing)

In publishing, a colophon describes details of the production of a book. This 
information generally includes the typefaces used, and often the names of their 
designers; the paper, ink and details of the binding materials and methods may 
also receive mention. In the case of technical books, a colophon may specify the 
software used to prepare the text and diagrams for publication. 

bookmap/completed

  Bases 
  topic/ph 
  Derived types 
  (none) 
  Children 
  year,month,day,month,day,year,day,month,year 
  Parents 
  approved,bookevent,edited,published,reviewed,tested 

The date of completion of some sort of book event.

bookmap/copyrfirst

  Bases 
  topic/ph 
  Derived types 
  (none) 
  Children 
  year 
  Parents 
  bookrights 

The start date of a copyright period.

bookmap/copyrlast

  Bases 
  topic/ph 
  Derived types 
  (none) 
  Children 
  year 
  Parents 
  bookrights 

The end date of a copyright period.

bookmap/day

  Bases 
  topic/ph 
  Derived types 
  (none) 
  Children 
  (none) 
  Parents 
  completed,completed,completed,started,started,started 

The day portion of a date.

bookmap/dedication

  Bases 
  map/topicref 
  Derived types 
  (none) 
  Children 
  (none) 
  Parents 
  bookmap 

According to wikipedia: http://en.wikipedia.org/wiki/Dedication

"A dedication is ... included by authors who wish to address their work to a 
person or group, or commemorate them at the beginning. In the days when authors 
depended largely on the generosity of patrons for their income, these 
dedications were often elaborate and sometimes florid texts, humble to the point 
of obsequiousness, addressed to the usually aristocratic patron. More recent 
dedications of books are brief, often naming the author's spouse or significant 
other, and often consist of no more than a line dedicating the work to them, and 
often a quotation from some other literary work, or an epigram of the author's 
own invention."

bookmap/draftintro

  Bases 
  map/topicref 
  Derived types 
  (none) 
  Children 
  topicmeta,topicref,topichead,topicgroup 
  Parents 
  bookmap 

???

bookmap/edited

  Bases 
  topic/data 
  Derived types 
  (none) 
  Children 
  data,authorinformation,revisionid,started,completed,summary 
  Parents 
  bookchangehistory 

Information about an editing event in the history of a book.

bookmap/edition

  Bases 
  topic/ph 
  Derived types 
  (none) 
  Children 
  (none) 
  Parents 
  bookid 

The edition number that a publisher uses to identify a book.

bookmap/figurelist

  Bases 
  map/topicref 
  Derived types 
  (none) 
  Children 
  (none) 
  Parents 
  booklists 

A list of figures in the book. Generated or authored?

bookmap/glossarylist

  Bases 
  map/topicref 
  Derived types 
  (none) 
  Children 
  topicmeta,topicref,topichead,topicgroup 
  Parents 
  booklists 

A glossary. According to Wikipedia: 
http://en.wikipedia.org/wiki/Dedication

"a list of terms with the definitions for those terms. Traditionally, a 
glossary appears at the end a book and includes terms within that book which are 
either newly introduced or at least uncommon."

bookmap/indexlist

  Bases 
  map/topicref 
  Derived types 
  (none) 
  Children 
  (none) 
  Parents 
  booklists 

An index. According to wikipedia: 
http://en.wikipedia.org/wiki/Index_(publishing)

"Ideally, an index is not simply a list of the major terms in a publication 
(which is more properly called a concordance), but an organized map of its 
contents, including cross-references, grouping of like concepts, and other 
useful intellectual analysis."

"In books, indexes are usually placed near the end (this is commonly known as 
"BoB" or back-of-book indexing). They complement the table of contents by 
enabling access to information by subject, whereas contents listings enable 
access through broad categories arranged in the order they occur."

bookmap/isbn

  Bases 
  topic/ph 
  Derived types 
  (none) 
  Children 
  (none) 
  Parents 
  bookid 

From Wikipedia: http://en.wikipedia.org/wiki/ISBN

"The International Standard Book Number, or ISBN (sometimes pronounced 
"is-ben"), is a unique[1] identifier for books, intended to be used 
commercially."

bookmap/mainbooktitle

  Bases 
  topic/ph 
  Derived types 
  (none) 
  Children 
  ph,term,q,boolean,state,keyword,tm,image 
  Parents 
  booktitle 

The primary title for a book.

bookmap/maintainer

  Bases 
  topic/data 
  Derived types 
  (none) 
  Children 
  data,authorinformation 
  Parents 
  bookid 

???

bookmap/month

  Bases 
  topic/ph 
  Derived types 
  (none) 
  Children 
  (none) 
  Parents 
  completed,completed,completed,started,started,started 
bookmap/notices

  Bases 
  map/topicref 
  Derived types 
  (none) 
  Children 
  topicmeta,topicref,topichead,topicgroup 
  Parents 
  bookmap,part 

???

bookmap/part

  Bases 
  map/topicref 
  Derived types 
  (none) 
  Children 
  topicmeta,chapter,appendix,notices,specialnotices,amendments 
  Parents 
  bookmap 

A container for several chapter-like topics.

bookmap/preface

  Bases 
  map/topicref 
  Derived types 
  (none) 
  Children 
  topicmeta,topicref,topichead,topicgroup 
  Parents 
  bookmap 

From Wikipedia: http://en.wikipedia.org/wiki/Preface

"A preface is an introduction to a book written by the author of the book. An 
introductory essay written by a different person is a foreword and precedes an 
author's preface. The preface often closes with acknowledgements of those who 
assisted in the project. A preface is usually signed (and the date and place of 
writing often follow the typeset signature); a foreword by another person is 
always signed."

bookmap/printlocation

  Bases 
  topic/ph 
  Derived types 
  (none) 
  Children 
  (none) 
  Parents 
  publisherinformation 

The location of printing for a book.

bookmap/published

  Bases 
  topic/data 
  Derived types 
  (none) 
  Children 
  data,authorinformation,publishtype,revisionid,started,completed,summary 
  Parents 
  publisherinformation 
bookmap/publisherinformation

  Bases 
  topic/data 
  Derived types 
  (none) 
  Children 
  printlocation,published,data,authorinformation 
  Parents 
  bookmeta 
bookmap/publishtype

  Bases 
  topic/data 
  Derived types 
  (none) 
  Children 
  (none) 
  Parents 
  published 
bookmap/reviewed

  Bases 
  topic/data 
  Derived types 
  (none) 
  Children 
  data,authorinformation,revisionid,started,completed,summary 
  Parents 
  bookchangehistory 

Information about a review event in the publication history of a book.

bookmap/revisionid

  Bases 
  topic/ph 
  Derived types 
  (none) 
  Children 
  (none) 
  Parents 
  approved,bookevent,edited,published,reviewed,tested 
bookmap/specialnotices

  Bases 
  map/topicref 
  Derived types 
  (none) 
  Children 
  topicmeta,topicref,topichead,topicgroup 
  Parents 
  bookmap,part 
bookmap/started

  Bases 
  topic/ph 
  Derived types 
  (none) 
  Children 
  year,month,day,month,day,year,day,month,year 
  Parents 
  approved,bookevent,edited,published,reviewed,tested 
bookmap/summary

  Bases 
  topic/ph 
  Derived types 
  (none) 
  Children 
  keyword,term 
  Parents 
  approved,bookevent,bookrights,edited,published,reviewed,tested 

Summary of what happened during a book creation event.

bookmap/tablelist

  Bases 
  map/topicref 
  Derived types 
  (none) 
  Children 
  (none) 
  Parents 
  booklists 

A list of tables in the book.

bookmap/tested

  Bases 
  topic/data 
  Derived types 
  (none) 
  Children 
  data,authorinformation,revisionid,started,completed,summary 
  Parents 
  bookchangehistory 

Information about a testing event in the publication history of a book. In 
this context, "tested" might mean to test code samples or technical details of 
the publishing process such as link integrity.

bookmap/toc

  Bases 
  map/topicref 
  Derived types 
  (none) 
  Children 
  (none) 
  Parents 
  booklists 

Table of contents for the book.

bookmap/trademarklist

  Bases 
  map/topicref 
  Derived types 
  (none) 
  Children 
  (none) 
  Parents 
  booklists 

A reference to a topic listing the trademarks referenced in the book.

Question: why is this book-specific?

bookmap/volume

  Bases 
  topic/ph 
  Derived types 
  (none) 
  Children 
  (none) 
  Parents 
  bookid 

From Wikitionay: http://en.wiktionary.org/wiki/volume

"A single book of a publication issued in multi-book format, such as an 
encyclopedia. (The letter "G" was found in volume 4.)"

bookmap/year

  Bases 
  topic/ph 
  Derived types 
  (none) 
  Children 
  (none) 
  Parents 
  completed,completed,completed,copyrfirst,copyrlast,started,started,started 
  

The year in a date.

SPECIALIZATION ERROR:Empty class attribute: on fig

SPECIALIZATION ERROR:Empty class attribute: on simpletable

SPECIALIZATION ERROR:Base topic/ph of type xnal-d/organizationnamedetails 
does not have a child that is a base type of xnal-d/otherinfo

SPECIALIZATION ERROR:Base topic/data of type xnal-d/personname does not have 
a child that is a base type of xnal-d/resource