OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-tc message

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

Subject: Re: [docbook-tc] Proposed new Dublin Core elements

2nd Draft Proposal for new DocBook elements to support Dublin Core
Version 1.1
8 February 2002

This is the revised proposal for getting complete Dublin
Core coverage in DocBook.  While reading it you should have
at hand the HTML table mapping Dublin Core to DocBook that
is attached).

The following Dublin Core elements are already covered by
DocBook 4.1.2 elements and nothing new is needed.  Please refer
to the HTML table for explanations.


The following Dublin Core elements are not covered by
DocBook elements, but can be inferred from them.
I think no new elements are needed for them either.


Below is a description of four new elements being proposed
to support Dublin Core metadata:
  <biblioid>  (already in 4.2b1)

The first three have similar structure since they are
describing resources.

1.  biblioid
This element is already proposed for DocBook 4.2, and
provides a unique identifier for the current document.
The class list here has been modified to replace urn with uri
and to add libraryofcongress.

<!ELEMENT biblioid %ho; (%docinfo.char.mix;)*>

<!ATTLIST biblioid
                class   (uri|doi|isbn|issn|
                         libraryofcongress|pubnumber|other) #IMPLIED
                otherclass      CDATA   #IMPLIED

For example:

    <biblioid class="uri">

2.  Source.
It is useful to record if a document or element
(text or graphic) has been derived from another resource.
I propose a new <source> element that is structured
identically to the <biblioid> element that is new to DocBook 4.2.
It could appear inside any *info element, including the
<objectinfo> element used for mediaobjects.

<!ELEMENT source %ho; (%docinfo.char.mix;)*>

<!ATTLIST source
		class	(uri|doi|isbn|issn|
                         libraryofcongress|pubnumber|other) #IMPLIED
		otherclass	CDATA	#IMPLIED


<!ENTITY % source.role.attrib "%role.attrib;">

For example:

      <source otherclass="Corel Draw 6">/lib/imagesrc/filesys.cdr</source>
    <imagedata fileref="filesys.png"/>

3.  Relation
This element would capture relationships with other
resources that are not already expressed with the various
DocBook linking elements.  
I propose a new <relation> element that is structured
similarly to the <biblioid> element to meet that need.
It could appear inside any *info element, including
the <objectinfo> element in mediaobjects.

The content of <relation> would be the identifier of the
other resource.  The class or otherclass attribute would
identify the scheme used in naming the resource.  A "type"
attribute would capture the relationship type, and would
use the enumerated Dublin Core relation qualifiers.
That enumerated list can be extended in the DTD using
a 'local.relation.types' parameter entity.  Or an
ad hoc type can be designated in the 'othertype' attribute.

<!ELEMENT relation %ho; (%docinfo.char.mix;)*>

<!ATTLIST relation 
		class	(uri|doi|isbn|issn|
                         libraryofcongress|pubnumber|other) #IMPLIED
		otherclass	CDATA	#IMPLIED
		othertype	CDATA	#IMPLIED

<!ENTITY % relation.type.attrib
               "type     (IsVersionOf
                         %local.relation.types;)       #IMPLIED"

For example:

    <relation class="isbn" type="Replaces">1-57870-080-9</relation>

4.  Coverage
This element's content describes the coverage domain of the
current document or element.  It uses the enumerated Dublin
Core qualifiers for spacial and temporary schemes,
extendable with other schemes.  An element could have both
spatial and temporal coverage attributes.  A coverage element
could appear in any *info element.

<!ELEMENT coverage %ho; (%docinfo.char.mix;)*>
<!ATTLIST coverage 
		spatial	(dcmipoint|iso3166|dcmibox|tgn|other) #IMPLIED
		otherspatial	CDATA	#IMPLIED
		temporal (dcmiperiod|w3c-dtf|other) #IMPLIED
		othertemporal	CDATA	#IMPLIED

For (lack of a better) example:

    <title>Enterprise Warp Drive Manual</title>
    <coverage othertemporal="Stardate model year">2077.3-2078.2</coverage>

Bob Stayton                                 400 Encinal Street
Publications Architect                      Santa Cruz, CA  95060
Technical Publications                      voice: (831) 427-7796
Caldera International, Inc.                 fax:   (831) 429-1887
                                            email: bobs@caldera.com
Title: Dublin Core in DocBook

Dublin Core in DocBook

Version 1.1

8 February 2002

Bob Stayton

This table summaries the Dublin Core Elements[1] and how they map to DocBook elements in the DocBook 4.1.2 DTD. For more information on Dublin Core, see:

[1] http://dublincore.org/documents/1998/09/dces/

[2] http://dublincore.org/documents/1999/08/05/resource-typelist/
DC ElementDC LabelDescriptionDocBook equivalent
TitleTitleThe name given to the resource, usually by the Creator or Publisher.<title>
Author or CreatorCreatorThe person or organization primarily responsible for creating the intellectual content of the resource. For example, authors in the case of written documents, artists, photographers, or illustrators in the case of visual resources. <author>, <corpauthor>
Subject and KeywordsSubjectThe topic of the resource. Typically, subject will be expressed as keywords or phrases that describe the subject or content of the resource. The use of controlled vocabularies and formal classification schemas is encouraged. <keywordset> for freely chosen words, <subjectset> for controlled vocabulary.
DescriptionDescriptionA textual description of the content of the resource, including abstracts in the case of document-like objects or content descriptions in the case of visual resources. <abstract>?
PublisherPublisherThe entity responsible for making the resource available in its present form, such as a publishing house, a university department, or a corporate entity. <publishername>
ContributorContributorA person or organization not specified in a Creator element who has made significant intellectual contributions to the resource but whose contribution is secondary to any person or organization specified in a Creator element (for example, editor, transcriber, and illustrator). <othercredit>, <collab>, <editor>, possibly another <author> with a role attribute.
DateDateA date associated with the creation or availability of the resource. Recommended best practice is defined in a profile of ISO 8601 ( http://www.w3.org/TR/NOTE-datetime ) that includes (among others) dates of the forms YYYY and YYYY-MM-DD. In this scheme, the date 1994-11-05 corresponds to November 5, 1994. <date>, <pubdate>
TypeTypeThe category of the resource, such as home page, novel, poem, working paper, technical report, essay, dictionary. For the sake of interoperability, Type should be selected from an enumerated list that is under development in the workshop series. no element matches the Dublin Core Types [2]. Implied values: text, image. This could be a new metadata element.
FormatFormatThe data format and, optionally, dimensions (e.g., size, duration) of the resource. The format is used to identify the software and possibly hardware that might be needed to display or operate the resource. For the sake of interoperability, the format should be selected from an enumerated list that is currently under development in the workshop series. no element describes this. The XML is an implied text/xml value. When processed to another format, then other format values apply. This does not need a new element, IMHO.
Resource IdentifierIdentifierA string or number used to uniquely identify the resource. Examples for networked resources include URLs and URNs (when implemented). Other globally-unique identifiers, such as International Standard Book Numbers (ISBN) or other formal names would also be candidates for this element. <biblioid> (starting with DocBook 4.2)
SourceSourceInformation about a second resource from which the present resource is derived. While it is generally recommended that elements contain information about the present resource only, this element may contain metadata for the second resource when it is considered important for discovery of the present resource. no element matches this. An XML document could refer to a data repository from which it is derived, or formatted output could refer to its XML source. Possibly a new DocBook metadata element.
LanguageLanguageThe language of the intellectual content of the resource. Recommended best practice is defined in RFC 1766 http://info.internet.isi.edu/in-notes/rfc/files/rfc1766.txt <lang>
RelationRelationAn identifier of a second resource and its relationship to the present resource. This element is used to express linkages among related resources. For the sake of interoperability, relationships should be selected from an enumerated list that is currently under development in the workshop series. <xref>, <link>, <ulink>, <olink>. Also, any number of implied relationships among a document's elements (next, previous, etc.). XLink elements can also express relations to other resources. This is a potentially very rich area.
CoverageCoverageThe spatial and/or temporal characteristics of the intellectual content of the resource. Spatial coverage refers to a physical region (e.g., celestial sector) using place names or coordinates (e.g., longitude and latitude). Temporal coverage refers to what the resource is about rather than when it was created or made available (the latter belonging in the Date element). Temporal coverage is typically specified using named time periods (e.g., Neolithic) or the same date/time format ( http://www.w3.org/TR/NOTE-datetime ) as recommended for the Date element. no element matches this. Could be a new metadata element.
Rights ManagementRightsA rights management statement, an identifier that links to a rights management statement, or an identifier that links to a service providing information about rights management for the resource. <copyright>, <legalnotice>

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

Powered by eList eXpress LLC