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: 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

 



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