You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1579 lines
78 KiB
1579 lines
78 KiB
<!--
|
|
===========================================
|
|
NewsML Document Type Definition Version 1.0
|
|
===========================================
|
|
International Press Telecommunications Council
|
|
6 October 2000
|
|
Copyright (c) IPTC, 2000
|
|
All rights reserved
|
|
NewsML is a trademark of IPTC
|
|
|
|
======================================
|
|
DO NOT REMOVE THESE LICENCE CONDITIONS
|
|
======================================
|
|
LICENCE OF THE IPTC NewsML TRADEMARK TO NON-MEMBERS OF THE IPTC
|
|
|
|
Use of the IPTC trademark shall be licensed by the IPTC ("the Licensor") to a
|
|
Non-Member ("the Licensee") in consideration of the following obligations
|
|
undertaken by the Licensee under the terms of this contract.
|
|
|
|
1. The Licensee recognises the Licensor as the sole owner of the intellectual
|
|
property protected by the trademark.
|
|
|
|
2. The Licensee recognises that the Licensor has the right to grant licenses
|
|
of the intellectual property protected by the trademark and has agreed to
|
|
grant such a licence to the Licensee in the terms set out in this contract.
|
|
|
|
3. The Licensee shall not during the subsistence of this contract or at any
|
|
future time register to use in its own name as proprietor any of the
|
|
intellectual property protected by the trademark.
|
|
|
|
4. The Licensee shall not claim any right title or interest in the
|
|
intellectual property or any part of it save as is granted by this contract.
|
|
|
|
5. The Licensee shall immediately call to the attention of the Licensor the use
|
|
of any part of the intellectual property by any third party or any activity
|
|
of any third party which might in the opinion of the Licensee amount to
|
|
infringement of the rights protected by the trademark.
|
|
|
|
6. The Licensee shall not assign the benefit of this contract or grant any
|
|
sub-licence without the prior written consent of the Licensor.
|
|
|
|
7. Use of the IPTC trademark is licensed only to those Licensees who comply
|
|
with the requirements of the official published description of NewsML.
|
|
|
|
8. The Licensee promises to respect the integrity and quality standard of the
|
|
trademark and shall refrain from all acts and omissions which threaten the
|
|
integrity of the trademark as a mark of quality.
|
|
|
|
9. The Licensee shall communicate immediately to the IPTC any instances of
|
|
actual or suspected misuse or non-compliance with the official published
|
|
description of NewsML which come to the attention of the Licensee.
|
|
|
|
10. The Licensee shall, at the request of the IPTC Management Committee acting
|
|
unanimously, accede to any reasonable request of the IPTC to inspect the
|
|
address of the Licensee to verify compliance and each Licensee shall afford
|
|
to the IPTC such assistance as is requested by the IPTC in response to the
|
|
latter's reasonable enquiries in instances of suspected non-compliance with
|
|
the official published description of NewsML requirements.
|
|
|
|
The Licensee shall from time to time provide the IPTC with the full address of
|
|
its place of business and that place will be deemed the Licensee's address.
|
|
|
|
The IPTC reserves the right to terminate the use of the trademark by the
|
|
Licensee at any time without notice or without the need to give reasons to the
|
|
Licensee for such termination.
|
|
|
|
This contract shall be governed and construed in accordance with the laws of
|
|
England and Wales whose courts shall be courts of competent jurisdiction.
|
|
-->
|
|
<!--
|
|
================
|
|
NOTE ON SPELLING
|
|
================
|
|
NewsML element and attribute names use US-English spellings. With this
|
|
exception, this DTD and its accompanying specification use British English
|
|
spellings.
|
|
-->
|
|
<!--
|
|
=============================
|
|
PARAMETER ENTITY DECLARATIONS
|
|
=============================
|
|
-->
|
|
<!--
|
|
================================================================================
|
|
Attribute sets
|
|
================================================================================
|
|
-->
|
|
<!--
|
|
================================== assignment ==================================
|
|
AssignedBy
|
|
==========
|
|
An identifier for the party assigning a piece of metadata. This can be a
|
|
string that designates the party informally (for example, a person's name),
|
|
or a pointer in the form a fragment identifier consisting of a # character
|
|
followed by the Duid of a Topic corresponding to the party.
|
|
|
|
Importance
|
|
==========
|
|
An indication of the importance the party assigning a piece of metadata
|
|
attaches to it. The value of the Importance attribute is a formal name for a
|
|
level of importance. Its meaning and permitted values are determined by a
|
|
controlled vocabulary.
|
|
|
|
Confidence
|
|
==========
|
|
An indication of the confidence with which a piece of metadata has been
|
|
assigned. The value of the Confidence attribute is a formal name for a
|
|
degree of confidence. Its meaning and permitted values are determined by a
|
|
controlled vocabulary.
|
|
|
|
HowPresent
|
|
==========
|
|
An indication of the way in which a piece of metadata applies. The value of
|
|
the HowPresent attribute is a formal name for the way the metadata applies.
|
|
Its meaning and permitted values are determined by a controlled vocabulary.
|
|
|
|
DateAndTime
|
|
===========
|
|
The date and (optionally) time at which a piece of metadata was assigned.
|
|
|
|
Uses the format CCYYMMDDTHHMMSS{+or-}HHMM (century, year, month, day, time
|
|
separator, hours, minutes, seconds, timezone separator, hours, minutes). If
|
|
only the Date is needed, then the substring from T onwards may be omitted.
|
|
|
|
This is the Basic Format defined by ISO 8601. CCYY is a 4-digit year number.
|
|
MM is a 2-digit month number. DD is a 2-digit day number. T is the letter 'T'.
|
|
HH is a 2-digit hour number (using a 24-hour clock). MM is a 2 digit minute
|
|
number. (Note that midnight may be represented as 2400 or 240000 on the date
|
|
of the day that is ending, or as 0000 or 000000 on the date of the day that is
|
|
beginning.)
|
|
|
|
{+or-} is the '+' character or the '-' character, and the following HHMM are
|
|
hours and minutes of offset from Universal Co-ordinated Time (UTC) as defined
|
|
by ISO 8601. If the time is being expressed in UTC, then the timezone offset
|
|
may be '+0000' or '-0000'. If the time is behind UTC, the timezone separator
|
|
is '-'. If the time is ahead of UTC the timezone separator is '+'.
|
|
|
|
Example: 10:27 p.m. in New York on 31 December 2000 would be expressed as
|
|
"20001231T222700-0500" as New York is five hours behind UTC in winter.
|
|
At the same moment in London, the date and time would be expressed as
|
|
time would be expressed as "20010101T032700+0000" or as , "20010101T00+0000", as
|
|
in London, it is now 3:27 a.m. on 1 January 2001. At the same moment in Paris,
|
|
the date and time would be expressed as "20010101T042700+0100", as Paris is one
|
|
hour ahead of UTC in winter, and it is now 4:27 a.m. on 1 January 2001.
|
|
================================================================================
|
|
|
|
-->
|
|
<!ENTITY % assignment " AssignedBy CDATA #IMPLIED
|
|
Importance CDATA #IMPLIED
|
|
Confidence CDATA #IMPLIED
|
|
HowPresent CDATA #IMPLIED
|
|
DateAndTime CDATA #IMPLIED">
|
|
|
|
<!--
|
|
================================= formalname ===================================
|
|
|
|
FormalName
|
|
==========
|
|
A string of characters whose meaning is determined by a controlled vocabulary.
|
|
|
|
Vocabulary
|
|
==========
|
|
The Vocabulary attribute, if present, provides a pointer to a TopicSet which is
|
|
the controlled vocabulary that can be used to resolve the meaning of the
|
|
FormalName. The value of the Vocabulary attribute is an http URL or a NewsML
|
|
URN, or the # character followed by the value of the Duid attribute of the a
|
|
TopicSet in the current document.
|
|
|
|
If there is no Vocabulary attribute, then the controlled vocabulary to be used
|
|
is located by the following algorithm:
|
|
- Proceed to the parent of the current element.
|
|
- If it has a Catalog element as its immediate child, see whether that Catalog
|
|
contains a Resource element whose DefaultVocabularyFor child contains an XPath
|
|
pattern that is matched by the current element. If so, then the controlled
|
|
vocabulary is the resource identified by that Resource element.
|
|
- If the parent does not meet the above condition, proceed to its parent and
|
|
check the same condition.
|
|
- Continue until a vocabulary is found, or no further parent elements are
|
|
available because the root element has been reached and it too fails to meet
|
|
the condition.
|
|
|
|
If there is no Vocabulary attribute and the above algorithm fails to identify
|
|
a resource that serves as the controlled vocabulary, there is an error, which
|
|
the NewsML system may signal to the user.
|
|
|
|
The NewsML system may also signal an error if a vocabulary is successfully
|
|
identified, but it contains no item that matches the value of the FormalName
|
|
whose meaning is sought.
|
|
|
|
Scheme
|
|
======
|
|
The Scheme attribute, if present, serves to distinguish which of possibly
|
|
multiple naming schemes in the controlled vocabulary is the one that governs
|
|
this FormalName. For a match to be obtained within the controlled vocabulary,
|
|
the rule is that the FormalName and the Scheme must both match. If there is
|
|
no Scheme attribute on the current element, the match will be to an item in
|
|
the vocabulary that has the current formal name and no scheme. If there is a
|
|
Scheme attribute on the current element, then both the formal name and the
|
|
scheme in the controlled vocabulary must match.
|
|
================================================================================
|
|
-->
|
|
<!ENTITY % formalname " FormalName CDATA #REQUIRED
|
|
Vocabulary CDATA #IMPLIED
|
|
Scheme CDATA #IMPLIED">
|
|
|
|
<!--
|
|
=================================== localid ====================================
|
|
|
|
Duid
|
|
====
|
|
Duid is a "Document-unique Identifier". It must satisfy the rules for XML ID
|
|
attributes: it must only contain name characters, and it must start with a
|
|
name-start character (not a digit). Its value must be unique within any NewsML
|
|
document.
|
|
|
|
Every NewsML element type has Duid as an optional attribute. Combined with the
|
|
Identifier element, providing a value for the Duid of any element in a NewsML
|
|
document makes the element globally identifiable. The Identifier element gives
|
|
global identification to the document, and the Duid provides local
|
|
identification for the element within the document.
|
|
|
|
Euid
|
|
====
|
|
Euid is an "Element-unique Identifier". Its value must be unique among elements
|
|
of the same element-type and having the same parent element.
|
|
|
|
Use of Euid attribute makes it possible to identify any NewsML element within
|
|
the context of its local branch of the NewsML document tree. This makes it
|
|
possible to copy, or include by reference, subtrees into new combinations in
|
|
ways that would break the uniqueness of Duids (thereby forcing new Duids to be
|
|
allocated), but still being able to retain the identity of each element. If
|
|
Euids are maintained at every level, it is possible to identify, for example
|
|
"The ContentItem whose Euid is abc within the NewsComponent whose Euid is def".
|
|
Such identification patterns would be preserved even after "pruning and
|
|
grafting" of subtrees.
|
|
================================================================================
|
|
-->
|
|
<!ENTITY % localid " Duid ID #IMPLIED
|
|
Euid CDATA #IMPLIED">
|
|
|
|
<!--
|
|
================================================================================
|
|
Content Models
|
|
================================================================================
|
|
-->
|
|
<!--
|
|
===================================== data =====================================
|
|
Where data is included, it may be directly in the form of a DataContent element,
|
|
or in the form of DataContent wrapped in an Encoding element, or by reference
|
|
through an Href attribute, in which case neither a DataContent nor an Encoding
|
|
element will be present.
|
|
================================================================================
|
|
-->
|
|
<!ENTITY % data " (Encoding
|
|
| DataContent )?">
|
|
|
|
<!--
|
|
==================================== party =====================================
|
|
Person, organisation or company playing a specific role in the
|
|
news workflow. The role being played is determined by the parent element. More
|
|
information about it can be provided in the optional Comment subelements.
|
|
================================================================================
|
|
|
|
-->
|
|
<!ENTITY % party " (Comment*
|
|
, Party+ )">
|
|
|
|
<!--
|
|
=========================
|
|
ELEMENT TYPE DECLARATIONS
|
|
=========================
|
|
-->
|
|
<!--
|
|
============================ AdministrativeMetadata ============================
|
|
Information about the provenance of a NewsComponent.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT AdministrativeMetadata (Catalog? , FileName? , SystemIdentifier? , Provider? , Creator? , Source* , Contributor* , Property* )>
|
|
<!ATTLIST AdministrativeMetadata %localid; >
|
|
<!--
|
|
|
|
================================ AssociatedWith ================================
|
|
A reference to a NewsItem with which this one is associated (for example, a
|
|
series of articles, or a collection of photos, of which it is a part). The
|
|
NewsItem attribute identifies the relevant NewsItem. Its value can be an
|
|
http URL or a NewsML URN as described in the comment to PublicIdentifier. The
|
|
Comment can be used to indicate the nature of the association.
|
|
================================================================================
|
|
|
|
-->
|
|
<!ELEMENT AssociatedWith (Comment* )>
|
|
<!ATTLIST AssociatedWith %localid;
|
|
NewsItem CDATA #IMPLIED >
|
|
<!--
|
|
================================ BasisForChoice ================================
|
|
The content of this element is an XPath statement or element-type name
|
|
identifying information within each NewsComponent or ContentItem that can be
|
|
used as a basis for choice between equivalent NewsComponents or ContentItems.
|
|
The root of the XPath corresponds to the NewsComponent or ContentItem itself.
|
|
The optional Rank attribute allows providers to place a numerical order on the
|
|
importance they think should be attached to the different bases for choice.
|
|
Smaller numbers represent higher importance.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT BasisForChoice (#PCDATA )>
|
|
<!ATTLIST BasisForChoice %localid;
|
|
Rank CDATA #IMPLIED >
|
|
<!--
|
|
|
|
==================================== ByLine ====================================
|
|
A natural-language statement of the author/creator information.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT ByLine (#PCDATA | Origin )*>
|
|
<!ATTLIST ByLine %localid;
|
|
xml:lang CDATA #IMPLIED >
|
|
<!--
|
|
=================================== Catalog ====================================
|
|
A container for Resource and TopicUse elements. Resource elements map URNs to
|
|
URLs and indicate default vocabularies which apply to the formal names of
|
|
certain elements within the subtree that begins with the immediate parent of
|
|
the Catalog element. TopicUse elements indicate where in the NewsML document
|
|
certain Topics are used. The optional Href attribute provides a pointer to
|
|
a Catalog element elsewhere in this or another document. Its value consists of
|
|
a # character followed by the value of the Duid attribute of the referenced
|
|
Catalog element and preceded, if the referenced Catalog is not in the current
|
|
document, by an http URL or a NewsML URN identifying the document or NewsItem
|
|
in which the Catalog appears. If the Href attribute is present on a Catalog
|
|
element, then that element should be empty. If it contains subelements, the
|
|
NewsML system may signal an error.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Catalog (Resource* , TopicUse* )>
|
|
<!ATTLIST Catalog %localid;
|
|
Href CDATA #IMPLIED >
|
|
<!--
|
|
=============================== Characteristics ================================
|
|
Information about the physical characteristics of a ContentItem.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Characteristics (SizeInBytes? , Property* )>
|
|
<!ATTLIST Characteristics %localid; >
|
|
<!--
|
|
=================================== Comment ====================================
|
|
A natural-language description of, or statement about, the current element. The
|
|
optional TranslationOf attribute is a pointer to another Comment element, of
|
|
which this one is a direct translation.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Comment (#PCDATA )>
|
|
<!ATTLIST Comment %localid;
|
|
xml:lang CDATA #IMPLIED
|
|
TranslationOf IDREF #IMPLIED >
|
|
<!--
|
|
================================= ContentItem ==================================
|
|
A news object that carries or identifies content intended for presentation to
|
|
humans.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT ContentItem (Comment* , Catalog? , MediaType? , Format? , MimeType? , Notation? , Characteristics? , %data; )>
|
|
<!ATTLIST ContentItem %localid;
|
|
Href CDATA #IMPLIED >
|
|
<!--
|
|
================================= Contributor ==================================
|
|
An individual and/or company or organisation that modified or enhanced a news
|
|
object after its creation.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Contributor (%party; )>
|
|
<!ATTLIST Contributor %localid; >
|
|
<!--
|
|
================================== Copyright ===================================
|
|
The copyright that pertains to a news object.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Copyright (Comment* , CopyrightHolder , CopyrightDate )>
|
|
<!ATTLIST Copyright %localid;
|
|
%assignment; >
|
|
<!--
|
|
================================ CopyrightDate =================================
|
|
A natural-language statement of the copyright date.
|
|
================================================================================
|
|
|
|
-->
|
|
<!ELEMENT CopyrightDate (#PCDATA | Origin )*>
|
|
<!ATTLIST CopyrightDate %localid;
|
|
xml:lang CDATA #IMPLIED >
|
|
<!--
|
|
=============================== CopyrightHolder ================================
|
|
A natural-language statement indicating who owns the copyright.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT CopyrightHolder (#PCDATA | Origin )*>
|
|
<!ATTLIST CopyrightHolder %localid;
|
|
xml:lang CDATA #IMPLIED >
|
|
<!--
|
|
================================ CopyrightLine =================================
|
|
A natural-language statement of the copyright information.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT CopyrightLine (#PCDATA | Origin )*>
|
|
<!ATTLIST CopyrightLine %localid;
|
|
xml:lang CDATA #IMPLIED >
|
|
<!--
|
|
=================================== Creator ====================================
|
|
An individual and/or company or organisation that created a news object.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Creator (%party; )>
|
|
<!ATTLIST Creator %localid; >
|
|
<!--
|
|
================================== CreditLine ==================================
|
|
A natural-language statement of credit information.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT CreditLine (#PCDATA | Origin )*>
|
|
<!ATTLIST CreditLine %localid;
|
|
xml:lang CDATA #IMPLIED >
|
|
<!--
|
|
================================= DataContent ==================================
|
|
The data that carries the content of a ContentItem.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT DataContent ANY>
|
|
<!ATTLIST DataContent %localid; >
|
|
<!--
|
|
================================= DateAndTime ==================================
|
|
A formal representation of a date and, optionally, time, expressed in ISO 8601
|
|
Basic Format, as described in the comment to the DateAndTime attribute within
|
|
the assignment ENTITY declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT DateAndTime (#PCDATA )>
|
|
<!ATTLIST DateAndTime %localid; >
|
|
<!--
|
|
==================================== DateId ====================================
|
|
A date identifier of a NewsItem in short ISO 8601 Basic Format (CCYYMMDD), as
|
|
described in the comment to the DateAndTime attribute within the assignment
|
|
ENTITY declaration above. The DateId is part of the formal identification of the
|
|
NewsItem, and must remain the same through successive revisions of the same
|
|
NewsItem.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT DateId (#PCDATA )>
|
|
|
|
<!--
|
|
================================== DateLabel ===================================
|
|
A string representation of a date or date and time, used by human users to help
|
|
identify a NewsItem.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT DateLabel (#PCDATA )>
|
|
<!ATTLIST DateLabel %localid; >
|
|
<!--
|
|
=================================== DateLine ===================================
|
|
A natural-language statement of the date and/or place of creation.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT DateLine (#PCDATA | Origin )*>
|
|
<!ATTLIST DateLine %localid;
|
|
xml:lang CDATA #IMPLIED >
|
|
<!--
|
|
============================ DefaultVocabularyFor ==============================
|
|
An indication that the parent Resource provides the default vocabulary that
|
|
determines the meanings and permitted values of the data occurring in a
|
|
particular part of a NewsML document subtree. The Context attribute is an
|
|
XPath statement identifying the data to which the default vocabulary applies.
|
|
The optional Scheme attribute identifies the relevant naming scheme if the
|
|
Resource contains more than one naming scheme. If the Resource is a NewsML
|
|
TopicSet, then the meaning of the data identified by the Context is provided
|
|
by the Topic whose FormalName subelement matches that data. If the Resource is
|
|
not a NewsML TopicSet, then the way in which it is interpreted in order to
|
|
provide a meaning for the data is not defined by NewsML but by the authority
|
|
that governs whatever format the Resource uses.
|
|
|
|
Example:
|
|
<DescriptiveMetadata>
|
|
<Catalog>
|
|
<Resource Duid="resource1">
|
|
<Urn>urn:newsml:iptc.org:20001006:Ranking:1</Urn>
|
|
<Url>www.iptc.com/vocabularies/iptc-rank.xml</Url>
|
|
<DefaultVocabularyFor Context="@Confidence"/>
|
|
<DefaultVocabularyFor Context="@Importance"/>
|
|
</Resource>
|
|
<Resource Duid="resource2">
|
|
<Urn>urn:newsml:iptc.org:20001006:TopicTypes:1</Urn>
|
|
<Url>www.iptc.com/vocabularies/iptc-topictype.xml</Url>
|
|
<DefaultVocabularyFor Context="TopicType@FormalName"/>
|
|
</Resource>
|
|
</Catalog>
|
|
<TopicSet>
|
|
<Topic Duid="topic1">
|
|
<TopicType FormalName="Person">
|
|
<Description Variant="Name">Bill Clinton</Description>
|
|
<Description Variant="Position">President of the USA</Description>
|
|
</Topic>
|
|
</TopicSet>
|
|
<TopicOccurrence
|
|
AssignedBy="Desk Editor"
|
|
Confidence="High"
|
|
HowPresent="principal subject"
|
|
Topic="#topic1"/>
|
|
</DescriptiveMetadata>
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT DefaultVocabularyFor EMPTY>
|
|
<!ATTLIST DefaultVocabularyFor %localid;
|
|
Context CDATA #REQUIRED
|
|
Scheme CDATA #IMPLIED >
|
|
<!--
|
|
==================================== Delete ====================================
|
|
An instruction to delete an element within a NewsItem. The NewsItem is
|
|
the previous revision of the current one, and the element to be deleted is the
|
|
one whose Duid value is equal to the value of the Delete element's DuidRef
|
|
attribute.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Delete EMPTY>
|
|
<!ATTLIST Delete %localid;
|
|
DuidRef CDATA #REQUIRED >
|
|
<!--
|
|
================================= DerivedFrom ==================================
|
|
A reference to an NewsItem from which this one is derived. The NewsItem attribute
|
|
identifies the relevant NewsItem. Its value can be an http URL or a NewsML URN
|
|
as described in the comment to PublicIdentifier.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT DerivedFrom (Comment* )>
|
|
<!ATTLIST DerivedFrom %localid;
|
|
NewsItem CDATA #IMPLIED >
|
|
<!--
|
|
================================= Description ==================================
|
|
A description that identifies a Topic, thereby indicating the meaning of a
|
|
formal name associated with that Topic. The xml:lang attribute indicates what
|
|
language the description is in. The optional Variant attribute allows multiple
|
|
descriptions to be given in the same language, and meaningfully distinguished
|
|
from one another.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Description (#PCDATA )>
|
|
<!ATTLIST Description %localid;
|
|
xml:lang CDATA #IMPLIED
|
|
Variant CDATA #IMPLIED >
|
|
<!--
|
|
============================= DescriptiveMetadata ==============================
|
|
Information describing the content of a NewsComponent.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT DescriptiveMetadata (Catalog? , Language* , Genre? , SubjectCode* , OfInterestTo* , TopicOccurrence* , Property* )>
|
|
<!ATTLIST DescriptiveMetadata %localid;
|
|
%assignment; >
|
|
<!--
|
|
=================================== Encoding ===================================
|
|
The encoding of the data comprising the content of a ContentItem.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Encoding %data;>
|
|
<!ATTLIST Encoding %localid;
|
|
Notation CDATA #REQUIRED >
|
|
<!--
|
|
=================================== EndDate ====================================
|
|
A natural-language statement of the date at which specified usage rights come
|
|
to an end.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT EndDate (#PCDATA | Origin )*>
|
|
<!ATTLIST EndDate %localid;
|
|
xml:lang CDATA #IMPLIED
|
|
%assignment; >
|
|
<!--
|
|
=================================== FileName ===================================
|
|
The suggested or actual storage file name for a NewsItem.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT FileName (#PCDATA )>
|
|
<!ATTLIST FileName %localid; >
|
|
<!--
|
|
================================= FirstCreated =================================
|
|
The date and, optionally, time at which a NewsItem was first created, expressed
|
|
in ISO 8601 Basic Format, as described in the comment to the DateAndTime
|
|
attribute within the assignment ENTITY declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT FirstCreated (#PCDATA )>
|
|
<!ATTLIST FirstCreated %localid; >
|
|
<!--
|
|
================================= FormalName ===================================
|
|
A string of characters whose meaning is determined by a naming scheme within a
|
|
controlled vocabulary. The controlled vocabulary may (but is not required to)
|
|
take the form of a NewsML TopicSet. The optional Scheme attribute determines
|
|
which naming scheme applies, when several exist within the same controlled
|
|
vocabulary.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT FormalName (#PCDATA )>
|
|
<!ATTLIST FormalName %localid;
|
|
Scheme CDATA #IMPLIED >
|
|
<!--
|
|
==================================== Format ====================================
|
|
An indication of the format of a ContentItem. The value of the FormalName
|
|
attribute is a formal name for the Format. Its meaning and permitted values are
|
|
determined by a controlled vocabulary as described in the comment to the
|
|
formalname ENTITY declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Format EMPTY>
|
|
<!ATTLIST Format %localid;
|
|
%formalname; >
|
|
<!--
|
|
================================= FutureStatus =================================
|
|
An indication of the status a NewsItem will have at a specified future date. The
|
|
value of the FormalName attribute is a formal name for the FutureStatus. Its
|
|
meaning is determined by a controlled vocabulary as described in the comment
|
|
to the formalname ENTITY declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT FutureStatus EMPTY>
|
|
<!ATTLIST FutureStatus %localid;
|
|
%formalname; >
|
|
<!--
|
|
==================================== Genre =====================================
|
|
An indication of the Genre of a NewsComponent. The value of the FormalName
|
|
attribute is a formal name for the Genre. Its meaning and permitted values are
|
|
determined by a controlled vocabulary as described in the comment to the
|
|
formalname ENTITY declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Genre EMPTY>
|
|
<!ATTLIST Genre %localid;
|
|
%formalname;
|
|
%assignment; >
|
|
<!--
|
|
================================== Geography ===================================
|
|
A natural-language statement of the geographical area or areas to which
|
|
specified usage rights apply.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Geography (#PCDATA | Origin )*>
|
|
<!ATTLIST Geography %localid;
|
|
xml:lang CDATA #IMPLIED
|
|
%assignment; >
|
|
<!--
|
|
=================================== HeadLine ===================================
|
|
A displayable headline.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT HeadLine (#PCDATA | Origin )*>
|
|
<!ATTLIST HeadLine %localid;
|
|
xml:lang CDATA #IMPLIED >
|
|
<!--
|
|
================================ Identification ================================
|
|
Identification information for the NewsItem.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Identification (NewsIdentifier , NameLabel? , DateLabel? , Label* )>
|
|
<!ATTLIST Identification %localid; >
|
|
<!--
|
|
================================= InsertAfter ==================================
|
|
An instruction to insert content after a designated element within a NewsItem.
|
|
The content to be inserted is the content of the InsertAfter element. The
|
|
NewsItem into which it is to be inserted is the previous revision of the current
|
|
one, and the element after which it is to be inserted is the one whose Duid
|
|
value is equal to the value of the InsertAfter element's DuidRef attribute.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT InsertAfter ANY>
|
|
<!ATTLIST InsertAfter %localid;
|
|
DuidRef CDATA #REQUIRED >
|
|
<!--
|
|
================================= InsertBefore =================================
|
|
An instruction to insert content before a designated element within a NewsItem.
|
|
The content to be inserted is the content of the InsertBefore element. The
|
|
NewsItem into which it is to be inserted is the previous revision of the current
|
|
one, and the element before which it is to be inserted is the one whose Duid
|
|
value is equal to the value of the InsertBefore element's DuidRef attribute.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT InsertBefore ANY>
|
|
<!ATTLIST InsertBefore %localid;
|
|
DuidRef CDATA #REQUIRED >
|
|
<!--
|
|
================================= Instruction ==================================
|
|
An instruction from a news provider to the recipient of a NewsItem. A special
|
|
case of Instruction is an indication of the effect the current revision of a
|
|
NewsItem has on the status of any previous revisions of the NewsItem that may
|
|
still be on the recipient's system. In this case, it will contain one or more
|
|
RevisionStatus elements. Otherwise, the value of the FormalName attribute is a
|
|
formal name for the Instruction, and its meaning is determined by a controlled
|
|
vocabulary as described in the comment to the formalname ENTITY declaration
|
|
above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Instruction (RevisionStatus* )>
|
|
<!ATTLIST Instruction %localid;
|
|
%formalname; >
|
|
<!--
|
|
================================= KeywordLine ==================================
|
|
A displayable set of keywords relevant to a news object. This can be used by a
|
|
NewsML system to assist manual or automated searches.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT KeywordLine (#PCDATA | Origin )*>
|
|
<!ATTLIST KeywordLine %localid;
|
|
xml:lang CDATA #IMPLIED >
|
|
<!--
|
|
==================================== Label =====================================
|
|
A human-readable label for a NewsItem.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Label (LabelType , LabelText )>
|
|
<!ATTLIST Label %localid; >
|
|
<!--
|
|
=================================== LabelText ==================================
|
|
The text that constitutes a Label of a given LabelType.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT LabelText (#PCDATA )>
|
|
<!ATTLIST LabelText %localid; >
|
|
<!--
|
|
================================= LabelType ====================================
|
|
A user-defined type of label. The value of the FormalName attribute is a formal
|
|
name for the LabelType. Its meaning and permitted values are determined by a
|
|
controlled vocabulary as described in the comment to the formalname ENTITY
|
|
declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT LabelType EMPTY>
|
|
<!ATTLIST LabelType %localid;
|
|
%formalname; >
|
|
<!--
|
|
=================================== Language ===================================
|
|
An indication of the, or a, language used in a content item. The value of the
|
|
FormalName attribute is a formal name for the Language. Its meaning and
|
|
permitted values are determined by a controlled vocabulary as described in the
|
|
comment to the formalname ENTITY declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Language EMPTY>
|
|
<!ATTLIST Language %localid;
|
|
%formalname;
|
|
%assignment; >
|
|
<!--
|
|
================================= Limitations ==================================
|
|
A natural-language statement of the terms and conditions that apply to the
|
|
specified usage rights.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Limitations (#PCDATA | Origin )*>
|
|
<!ATTLIST Limitations %localid;
|
|
xml:lang CDATA #IMPLIED
|
|
%assignment; >
|
|
<!--
|
|
================================== MediaType ===================================
|
|
An indication of the media type of a ContentItem. The value of the FormalName
|
|
attribute is a formal name for the MediaType. Its meaning and permitted values
|
|
are determined by a controlled vocabulary as described in the comment to the
|
|
formalname ENTITY declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT MediaType EMPTY>
|
|
<!ATTLIST MediaType %localid;
|
|
%formalname; >
|
|
<!--
|
|
=================================== Metadata ===================================
|
|
An container for a user-defined type of metadata.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Metadata (Catalog? , MetadataType , Property+ )>
|
|
<!ATTLIST Metadata %localid; >
|
|
<!--
|
|
=============================== MetadataType ===================================
|
|
An indication of the type of metadata that is represented by the Property
|
|
elements within this Metadata element. The value of the FormalName attribute is
|
|
a formal name for the MetadataType. Its meaning and permitted values are
|
|
determined by a controlled vocabulary as described in the comment to the
|
|
formalname ENTITY declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT MetadataType EMPTY>
|
|
<!ATTLIST MetadataType %localid;
|
|
%formalname; >
|
|
<!--
|
|
=================================== MimeType ===================================
|
|
An indication of the MIME-type of a ContentItem. The value of the FormalName
|
|
attribute is a formal name for the MimeType. Its meaning and permitted values
|
|
are determined by a controlled vocabulary as described in the comment to the
|
|
formalname ENTITY declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT MimeType EMPTY>
|
|
<!ATTLIST MimeType %localid;
|
|
%formalname; >
|
|
<!--
|
|
================================== NameLabel ===================================
|
|
A string used by human users as a name to help identify a NewsItem. Its form is
|
|
determined by the provider. It might be identical to the textual content of
|
|
the SlugLine element, for example, but even if this is so, the system should not
|
|
process the NameLabel as a slugline. Nothing can be assumed about the nature of
|
|
the string within NameLabel beyond the fact that it can help to identify the
|
|
NewsItem to humans.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT NameLabel (#PCDATA )>
|
|
<!ATTLIST NameLabel %localid; >
|
|
<!--
|
|
================================ NewsComponent =================================
|
|
A container for news objects, used to identify the role of news objects in
|
|
relation to one another, and to ascribe metadata to them. The Essential
|
|
attribute indicates whether the provider considers that this NewsComponent
|
|
is essential to the meaning of the NewsComponent within which it is contained.
|
|
The EquivalentsList attribute indicates whether or not the NewsItems or
|
|
NewsItemRefs, NewsComponents or ContentItems contained within this one are
|
|
equivalent to one another in content and/or meaning
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT NewsComponent (Comment* , Catalog? , TopicSet* , Role? , BasisForChoice* , NewsLines? , AdministrativeMetadata? , RightsMetadata? , DescriptiveMetadata? , Metadata* , ( (NewsItem | NewsItemRef )+ | NewsComponent+ | ContentItem+ )? )>
|
|
<!ATTLIST NewsComponent %localid;
|
|
Essential (yes | no ) 'no'
|
|
EquivalentsList (yes | no ) 'no'
|
|
xml:lang CDATA #IMPLIED >
|
|
<!--
|
|
================================= NewsEnvelope =================================
|
|
Information about the transmission of one or more NewsItems as a NewsML
|
|
document.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT NewsEnvelope (TransmissionId? , SentFrom? , SentTo? , DateAndTime , NewsService* , NewsProduct* , Priority? )>
|
|
<!ATTLIST NewsEnvelope %localid; >
|
|
<!--
|
|
================================ NewsIdentifier ================================
|
|
A globally unique identifier for a NewsItem.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT NewsIdentifier (ProviderId , DateId , NewsItemId , RevisionId , PublicIdentifier )>
|
|
|
|
<!--
|
|
=================================== NewsItem ===================================
|
|
A managed set of information representing a point of view, at a given time, on
|
|
some event or events. Its Identification and NewsManagement provide
|
|
manageability. It may contain either a NewsComponent, or one or more Updates
|
|
that modify aspects of a previous Revision of the same NewsItem, or a
|
|
TopicSet.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT NewsItem (Comment* , Catalog? , Identification , NewsManagement , (NewsComponent | Update+ | TopicSet )? )>
|
|
<!ATTLIST NewsItem %localid;
|
|
xml:lang CDATA #IMPLIED >
|
|
<!--
|
|
================================== NewsItemId ==================================
|
|
An identifier for the NewsItem. The combination of NewsItemId and DateId must
|
|
be unique among NewsItems that emanate from the same provider. Within these
|
|
constraints, the NewsItemId can take any form the provider wishes. It may take
|
|
the form of a name for the NewsItem that will be meaningful to humans, but this
|
|
is not a requirement. The provider may optionally relate the values of
|
|
NewsItemId to a controlled vocabulary, which is invoked by the Vocabulary
|
|
attribute. The value ofthe Vocabulary attribute may be an http URL, a NewsML
|
|
URN, or the # character followed by the value of the Duid attribute of a
|
|
TopicSet in the current document. The Scheme attribute, if present, serves to
|
|
distinguish which of possibly multiple naming schemes in the controlled
|
|
vocabulary is the one that governs the NewsItemId.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT NewsItemId (#PCDATA )>
|
|
<!ATTLIST NewsItemId Vocabulary CDATA #IMPLIED
|
|
Scheme CDATA #IMPLIED >
|
|
<!--
|
|
================================= NewsItemRef ==================================
|
|
A pointer to a NewsItem that is deemed to replace the NewsItemRef element. The
|
|
NewsItem attribute is a pointer to the relevant NewsItem. Its value can be an
|
|
http URL, or a NewsML URN as described in the comment to PublicIdentifier, or a
|
|
fragment identifier consisting of a # character followed by the Duid of a
|
|
NewsItem in the current document.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT NewsItemRef (Comment* )>
|
|
<!ATTLIST NewsItemRef %localid;
|
|
NewsItem CDATA #IMPLIED >
|
|
<!--
|
|
================================= NewsItemType =================================
|
|
An indication of the type of a NewsItem. The value of the FormalName attribute
|
|
is a formal name for the NewsItemType. Its meaning and permitted values are
|
|
determined by a controlled vocabulary as described in the comment to the
|
|
formalname ENTITY declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT NewsItemType EMPTY>
|
|
<!ATTLIST NewsItemType %localid;
|
|
%formalname; >
|
|
<!--
|
|
=================================== NewsLine ===================================
|
|
A newsline of a type not included in the NewsML specification.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT NewsLine (NewsLineType , NewsLineText+ )>
|
|
<!ATTLIST NewsLine %localid; >
|
|
<!--
|
|
=================================== NewsLineText ===================================
|
|
The text of a NewsLine of user-defined type.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT NewsLineText (#PCDATA | Origin )*>
|
|
<!ATTLIST NewsLineText %localid;
|
|
xml:lang CDATA #IMPLIED >
|
|
<!--
|
|
================================ NewsLineType ==================================
|
|
An indication of a user-defined NewsLine type. The value of the FormalName
|
|
attribute is a formal name for the NewsLineType. Its meaning and permitted
|
|
values are determined by a controlled vocabulary as described in the comment
|
|
to the formalname ENTITY declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT NewsLineType EMPTY>
|
|
<!ATTLIST NewsLineType %localid;
|
|
%formalname; >
|
|
<!--
|
|
================================== NewsLines ===================================
|
|
A container for all the NewsLines that a NewsComponent has.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT NewsLines ( (HeadLine , SubHeadLine? )* , ByLine* , DateLine* , CreditLine* , CopyrightLine* , RightsLine* , SeriesLine* , SlugLine* , KeywordLine* , NewsLine* )>
|
|
<!ATTLIST NewsLines %localid; >
|
|
<!--
|
|
================================ NewsManagement ================================
|
|
Information relevant to the management of a NewsItem.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT NewsManagement (NewsItemType , FirstCreated , ThisRevisionCreated , Status , StatusWillChange? , Urgency? , RevisionHistory? , DerivedFrom* , AssociatedWith* , Instruction* , Property* )>
|
|
<!ATTLIST NewsManagement %localid; >
|
|
<!--
|
|
==================================== NewsML ====================================
|
|
A NewsML document, which must contain a NewsEnvelope and one or more NewsItems,
|
|
and may include a Catalog element and a TopicSet element.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT NewsML (Catalog? , TopicSet* , (NewsEnvelope , NewsItem+ ) )>
|
|
<!ATTLIST NewsML %localid; >
|
|
<!--
|
|
================================= NewsProduct ==================================
|
|
An identifier for a product to which all the NewsItems in a NewsML document
|
|
belong. The value of the FormalName attribute is a formal name for the
|
|
NewsProduct. Its meaning and permitted values are determined by a controlled
|
|
vocabulary as described in the comment to the formalname ENTITY declaration
|
|
above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT NewsProduct EMPTY>
|
|
<!ATTLIST NewsProduct %localid;
|
|
%formalname; >
|
|
<!--
|
|
================================= NewsService ==================================
|
|
An identifier for a service to which all the NewsItems in a NewsML document
|
|
belong. The value of the FormalName attribute is a formal name for the
|
|
NewsService. Its meaning and permitted values are determined by a controlled
|
|
vocabulary as described in the comment to the formalname ENTITY declaration
|
|
above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT NewsService EMPTY>
|
|
<!ATTLIST NewsService %localid;
|
|
%formalname; >
|
|
<!--
|
|
=================================== Notation ===================================
|
|
An indication of the notation of a ContentItem. The value of the FormalName
|
|
attribute is a formal name for the Notation. Its meaning and permitted values
|
|
are determined by a controlled vocabulary as described in the comment to the
|
|
formalname ENTITY declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Notation EMPTY>
|
|
<!ATTLIST Notation %localid;
|
|
%formalname; >
|
|
<!--
|
|
================================= OfInterestTo =================================
|
|
An indication of the target audience of a NewsItem. The value of the FormalName
|
|
attribute is a formal name for the target audience. Its meaning and permitted
|
|
values are determined by a controlled vocabulary as described in the comment to
|
|
the formalname ENTITY declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT OfInterestTo (Relevance? )>
|
|
<!ATTLIST OfInterestTo %localid;
|
|
%formalname;
|
|
%assignment; >
|
|
<!--
|
|
==================================== Origin ====================================
|
|
A wrapper for all or part of the text of a piece of text, which provides a
|
|
pointer to an item of data corresponding formally to what is being described
|
|
here in natural language. The Href attribute identifies the relevant data, and
|
|
may be an http URL or a NewsML URN as described in the comment to
|
|
PublicIdentifier, optionally including a fragment identifier. Alternatively, it
|
|
can be a simple fragment identifier consisting of a # character followed by the
|
|
value of the Duid of an element in the current document.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Origin (#PCDATA | Origin )*>
|
|
<!ATTLIST Origin %localid;
|
|
%assignment;
|
|
Href CDATA #IMPLIED >
|
|
<!--
|
|
=================================== Party ======================================
|
|
An indication of the person, company or organisation that has a particular
|
|
relationship to this NewsItem in the news workflow. The value of the FormalName
|
|
attribute is a formal name for the Party. Its meaning and permitted values
|
|
are determined by a controlled vocabulary as described in the comment to the
|
|
formalname ENTITY declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Party EMPTY>
|
|
<!ATTLIST Party %localid;
|
|
%formalname;
|
|
Topic CDATA #IMPLIED >
|
|
<!--
|
|
=================================== Priority ===================================
|
|
An indication of the priority notation of a NewsItem. The value of the
|
|
FormalName attribute is a formal name for the Priority. Its meaning and
|
|
permitted values are determined by a controlled vocabulary as described in
|
|
the comment to the formalname ENTITY declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Priority EMPTY>
|
|
<!ATTLIST Priority %localid;
|
|
%formalname; >
|
|
<!--
|
|
=================================== Property ===================================
|
|
A property of a NewsComponent or of a Topic. The property has a name and either
|
|
a simple Value or a complex value consisting of a set of further properties.
|
|
|
|
Value
|
|
=====
|
|
A string representation of the value of a Property.
|
|
|
|
ValueRef
|
|
========
|
|
A pointer to the value of the Property. This might be a Topic in a TopicSet, or
|
|
any other piece of data. If both Value and ValueRef are provided, then ValueRef
|
|
identifies the actual value of the property, with Value simply providing a
|
|
string representation or mnemonic for it.
|
|
|
|
|
|
Example:
|
|
<Catalog>
|
|
<Resource Duid="resource1">
|
|
<Urn>urn:newsml:reuters.com:20001001:Physical Characteristics:3</Urn>
|
|
<Url>www.reuters.com/vocabs/physical.xml</Url>
|
|
<Url>www.iptc.com/vocabularies/memberdefined/reuters/physical.xml</Url>
|
|
<DefaultVocabularyFor Scheme="short" Context="Metadata/Property[@FormalName='Width']"/>
|
|
</Resource>
|
|
</Catalog>
|
|
<Property FormalName="Width" Vocabulary="#resource1">
|
|
<Property FormalName="Unit" ValueRef="urn:newsml:iptc.org:20001006:units:1#cm"/>
|
|
<Property FormalName="Quantity" Value="7.5"/>
|
|
</Property>
|
|
|
|
AllowedValues
|
|
=============
|
|
The AllowedValues attribute, if present, is a pointer to a controlled vocabulary
|
|
that delimits the set of allowed values for the property. This may be an http
|
|
URL, or a NewsML URN, or a fragment identifier consisting of a # charactger
|
|
followed by the Duid of an element in the current document. The pointer must
|
|
reference either a Resource element that designates an external controlled
|
|
vocabulary, or a TopicSet element, that is itself the controlled vocabulary.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Property (Property* )>
|
|
<!ATTLIST Property %localid;
|
|
%formalname;
|
|
%assignment;
|
|
Value CDATA #IMPLIED
|
|
ValueRef CDATA #IMPLIED
|
|
AllowedValues CDATA #IMPLIED >
|
|
<!--
|
|
=================================== Provider ===================================
|
|
An individual and/or company or organisation that released a news object for
|
|
publication.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Provider (%party; )>
|
|
<!ATTLIST Provider %localid; >
|
|
<!--
|
|
================================== ProviderId ==================================
|
|
An identifier for the news provider that produced the NewsItem. The
|
|
provider's ID is specified in the element content. This should be an Internet
|
|
domain name that is owned by the provider at the date identified by the DateId
|
|
subelement of the NewsIdentifier, or the name for the Provider drawn from a
|
|
controlled vocabulary identified by a URN specified in the Vocabulary attribute.
|
|
This will ensure that the identity of the provider can be inferred unambiguously
|
|
from the full NewsIdentifier.
|
|
|
|
Example:
|
|
<NewsIdentifier>
|
|
<ProviderId>iptc.org</ProviderId>
|
|
<DateId>20001001</DateId>
|
|
<NewsItemId>NewsML version 1.0</NewsItemId>
|
|
<RevisionId>1</RevisionId
|
|
</NewsIdentifier>
|
|
|
|
Because the domain name "iptc.org" was owned on 1 October 2000 by the
|
|
International Press Telecommunications Council (IPTC) and no-one else, it is
|
|
certain that IPTC is the provider in this case.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT ProviderId (#PCDATA )>
|
|
<!ATTLIST ProviderId Vocabulary CDATA #IMPLIED >
|
|
<!--
|
|
=============================== PublicIdentifier ===============================
|
|
A public identifier (in the sense defined by the XML 1,0 Specification) for a
|
|
NewsItem. This is the NewsML URN, and must be constructed as follows:
|
|
|
|
If the ProviderId is a domain name
|
|
|
|
urn:newsml:{ProviderId}:{DateId}:{NewsItemId}:{RevisionId}{RevisionId@Update}
|
|
|
|
If the ProviderId is name drawn from a controlled vocabulary
|
|
|
|
urn:newsml:|{ProviderId@Vocabulary}|{ProviderId}|:{DateId}:{NewsItemId}:{RevisionId}{RevisionId@Update}
|
|
|
|
where {x} means "the content of the x subelement of the NewsIdentifier" and
|
|
{x@y} means "the value of the y attribute of the x subelement of the
|
|
NewsIdentifier", with the exception that if the Update attribute of the
|
|
RevisionId element has its default value of N, it is omitted from the URN, and
|
|
that the Vocabulary attribute of the ProviderId element is stripped of the
|
|
substring "urn:" with which it begins. The Vocabulary attribute of ProviderId
|
|
necessarily begins with the characters "urn:" because, as stated in the
|
|
comment to the ProviderId element above, it must take the form of a URN
|
|
identifying a controlled vocabulary.
|
|
|
|
Note that the existence of this URN enables the NewsItem to be referenced
|
|
unambiguously by pointers from other XML elements or resources. Within such
|
|
pointers, if the RevisionId, its preceding : character and its following Update
|
|
qualifier are omitted, then the pointer designates the most recent revision at
|
|
the time it is resolved.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT PublicIdentifier (#PCDATA )>
|
|
|
|
<!--
|
|
================================== Relevance ===================================
|
|
An indication of the relevance of a NewsItem to a given target audience. The
|
|
value of the FormalName attribute is a formal name for the Relevance. Its
|
|
meaning and permitted values are determined by a controlled vocabulary as
|
|
described in the comment to the formalname ENTITY declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Relevance EMPTY>
|
|
<!ATTLIST Relevance %localid;
|
|
%formalname;
|
|
%assignment; >
|
|
<!--
|
|
=================================== Replace ====================================
|
|
An instruction to replace a designated element within a NewsItem. The element
|
|
that is to replace the designated element is the content of the Replace element.
|
|
The NewsItem within which the replacement takes place is the previous revision
|
|
of the current one, and the element to be replaced is the one whose Duid
|
|
value is equal to the value of the Replace element's DuidRef attribute.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Replace ANY>
|
|
<!ATTLIST Replace %localid;
|
|
DuidRef CDATA #REQUIRED >
|
|
<!--
|
|
================================== Resource ====================================
|
|
An indication where a given resource can be found, and whether it is to be used
|
|
as the default vocabulary for certain formal names within the current subtree
|
|
of a NewsML document. The Urn attribute provides a NewsML URN for the resource.
|
|
THe Url attribute(s) provide(s) a location or locations where the resource may
|
|
be found. The DefaultVocabularyFor element contains an XPath pattern. The
|
|
identified resource acts as default vocabulary for any element within the
|
|
subtree whose root is the parent of the current Catalog, that matches this XPath
|
|
pattern.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Resource (Urn? , Url* , DefaultVocabularyFor* )>
|
|
<!ATTLIST Resource %localid; >
|
|
<!--
|
|
=============================== RevisionHistory ================================
|
|
A pointer to a file containing the revision history of the NewsItem.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT RevisionHistory EMPTY>
|
|
<!ATTLIST RevisionHistory %localid;
|
|
Href CDATA #REQUIRED >
|
|
<!--
|
|
================================== RevisionId ==================================
|
|
A positive integer indicating which Revision of a given NewsItem this is. Any
|
|
positive integer may be used, but it must always be the case that of two
|
|
instances of a NewsItem that have the same ProviderId, DateId and NewsItemId,
|
|
the one whose RevisionId has the larger value must be the more recent revision.
|
|
A RevisionId of 0 is not permitted. The PreviousRevision attribute must be
|
|
present, and its value must be equal to the content of the RevisionId element
|
|
of the NewsItem's previous revision, if there is one, and 0 if the NewsItem has
|
|
no previous revision. If the NewsItem contains an Update element or elements,
|
|
then the Update attribute must be set to U. If the NewsItem consists only of a
|
|
replacement set of NewsManagement data, then the Update attribute must be set
|
|
to A. If neither of these is the case, then the Update attribute must be set
|
|
to N.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT RevisionId (#PCDATA )>
|
|
<!ATTLIST RevisionId PreviousRevision CDATA #REQUIRED
|
|
Update CDATA #REQUIRED >
|
|
<!--
|
|
================================ RevisionStatus ================================
|
|
Indicates the status that previous revisions now has as a result of the release
|
|
of the current revision. The optional Revision attribute is an integer, equal to
|
|
the RevisionId of the revision in question. If it is not present, then the
|
|
status applies to ALL previous revisions, without exception.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT RevisionStatus (Status )>
|
|
<!ATTLIST RevisionStatus %localid;
|
|
Revision CDATA #IMPLIED >
|
|
<!--
|
|
================================= RightsHolder =================================
|
|
A string of text indicating who has the usage rights, optionally enriched with
|
|
pointers to further information about the relevant people, companies or
|
|
organisations.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT RightsHolder (#PCDATA | Origin )*>
|
|
<!ATTLIST RightsHolder %localid;
|
|
xml:lang CDATA #IMPLIED
|
|
%assignment; >
|
|
<!--
|
|
================================== RightsLine ==================================
|
|
A displayable version of rights information. Note that this is distinct from
|
|
copyright information. Copyright information is about who owns a news object;
|
|
rights information is about who is allowed to use it, in what way and under
|
|
what circumstances.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT RightsLine (#PCDATA | Origin )*>
|
|
<!ATTLIST RightsLine %localid;
|
|
xml:lang CDATA #IMPLIED >
|
|
<!--
|
|
================================ RightsMetadata ================================
|
|
Information about the rights pertaining to a NewsComponent.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT RightsMetadata (Catalog? , Copyright* , UsageRights* , Property* )>
|
|
<!ATTLIST RightsMetadata %localid;
|
|
%assignment; >
|
|
<!--
|
|
===================================== Role =====================================
|
|
An identifier of the role played by a NewsComponent within a NewsComponent
|
|
that contains it. The outermost NewsComponent within a NewsItem need not
|
|
specify a Role attribute value. The value of the FormalName attribute is a
|
|
formal name for the Role. Its meaning and permitted values are determined by
|
|
a controlled vocabulary as described in the comment to the formalname ENTITY
|
|
declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Role EMPTY>
|
|
<!ATTLIST Role %localid;
|
|
%formalname; >
|
|
<!--
|
|
=================================== SentFrom ===================================
|
|
An individual and/or company or organisation from whom the NewsML document is
|
|
being sent.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT SentFrom (%party; )>
|
|
<!ATTLIST SentFrom %localid; >
|
|
<!--
|
|
==================================== SentTo ====================================
|
|
An individual and/or company or organisation to whom the NewsML document is
|
|
being sent.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT SentTo (%party; )>
|
|
<!ATTLIST SentTo %localid; >
|
|
<!--
|
|
================================== SeriesLine ==================================
|
|
A displayable version of information about a news object's place in a series.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT SeriesLine (#PCDATA | Origin )*>
|
|
<!ATTLIST SeriesLine %localid;
|
|
xml:lang CDATA #IMPLIED >
|
|
<!--
|
|
================================== SizeInBytes =================================
|
|
The exact size in bytes of a ContentItem's inline or referenced data object.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT SizeInBytes (#PCDATA )>
|
|
<!ATTLIST SizeInBytes %localid; >
|
|
<!--
|
|
=================================== SlugLine ===================================
|
|
A string of text, possibly embellished by hyperlinks and/or formatting, used to
|
|
display a NewsItem's slug line. (Note that the meaning of the term "slug line",
|
|
and the uses to which it is put, are a matter for individual providers to
|
|
define within their own workflow and business practice.)
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT SlugLine (#PCDATA | Origin )*>
|
|
<!ATTLIST SlugLine %localid;
|
|
xml:lang CDATA #IMPLIED >
|
|
<!--
|
|
==================================== Source ====================================
|
|
An individual and/or company or organisation that provided source material for
|
|
a news object. The optional NewsItem attribute must be present in the case of
|
|
a syndicated NewsItem. It provides the URN of the NewsItem that is being
|
|
syndicated. Note that a sequence of Source elements can be used to indicate the
|
|
sequence of syndicators through which a NewsItem has passed.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Source (%party; )>
|
|
<!ATTLIST Source %localid;
|
|
NewsItem CDATA #IMPLIED >
|
|
<!--
|
|
================================== StartDate ===================================
|
|
A natural-language statement of the date at which specified usage rights come
|
|
into effect.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT StartDate (#PCDATA | Origin )*>
|
|
<!ATTLIST StartDate %localid;
|
|
xml:lang CDATA #IMPLIED
|
|
%assignment; >
|
|
<!--
|
|
==================================== Status ===================================
|
|
An indication of the Status of a NewsItem. The value of the FormalName
|
|
attribute is a formal name for the Status. Its meaning and permitted values
|
|
are determined by a controlled vocabulary as described in the comment to the
|
|
formalname ENTITY declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Status EMPTY>
|
|
<!ATTLIST Status %localid;
|
|
%formalname; >
|
|
<!--
|
|
=============================== StatusWillChange ===============================
|
|
Advance notification of a status change that will automatically occur at the
|
|
specified date and time. For example, an item with a Status of "embargoed" might
|
|
have a StatusWillChange element stating that the status will become "usable" at
|
|
a specified time. This is equivalent to announcing in advance the time at which
|
|
the embargo will end and the item will be released.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT StatusWillChange (FutureStatus , DateAndTime )>
|
|
<!ATTLIST StatusWillChange %localid; >
|
|
<!--
|
|
================================= SubHeadLine ==================================
|
|
A displayable subsidiary headline.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT SubHeadLine (#PCDATA | Origin )*>
|
|
<!ATTLIST SubHeadLine %localid;
|
|
xml:lang CDATA #IMPLIED >
|
|
<!--
|
|
=================================== Subject ====================================
|
|
An indication of the Subject of a NewsItem. The value of the FormalName
|
|
attribute is a formal name for the Subject. Its meaning and permitted values
|
|
are determined by a controlled vocabulary as described in the comment to the
|
|
formalname ENTITY declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Subject EMPTY>
|
|
<!ATTLIST Subject %localid;
|
|
%formalname;
|
|
%assignment; >
|
|
<!--
|
|
================================= SubjectCode ==================================
|
|
A container for the IPTC Subject Codes that indicate the subject of a NewsItem,
|
|
as defined in the IPTC Information Interchange Model. It consists of one more
|
|
Subject, SubjectMatter and SubjectDetail elements, optionally amplified by one
|
|
or more SubjectQualifier elements.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT SubjectCode ( (Subject | SubjectMatter | SubjectDetail ) , SubjectQualifier* )*>
|
|
<!ATTLIST SubjectCode %localid;
|
|
%assignment; >
|
|
<!--
|
|
================================ SubjectDetail =================================
|
|
An indication of the SubjectDetail of a NewsItem. The value of the FormalName
|
|
attribute is a formal name for the SubjectDetail. Its meaning and permitted
|
|
values are determined by a controlled vocabulary as described in the comment
|
|
to the formalname ENTITY declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT SubjectDetail EMPTY>
|
|
<!ATTLIST SubjectDetail %localid;
|
|
%formalname;
|
|
%assignment; >
|
|
<!--
|
|
================================ SubjectMatter =================================
|
|
An indication of the SubjectMatter of a NewsItem. The value of the FormalName
|
|
attribute is a formal name for the SubjectMatter. Its meaning and permitted
|
|
values are determined by a controlled vocabulary as described in the comment to
|
|
the formalname ENTITY declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT SubjectMatter EMPTY>
|
|
<!ATTLIST SubjectMatter %localid;
|
|
%formalname;
|
|
%assignment; >
|
|
<!--
|
|
=============================== SubjectQualifier ===============================
|
|
An indication of the SubjectQualifier of a NewsItem. The value of the FormalName
|
|
attribute is a formal name for the SubjectQualifier. Its meaning and permitted
|
|
values are determined by a controlled vocabulary as described in the comment to
|
|
the formalname ENTITY declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT SubjectQualifier EMPTY>
|
|
<!ATTLIST SubjectQualifier %localid;
|
|
%formalname;
|
|
%assignment; >
|
|
<!--
|
|
=============================== SystemIdentifier ===============================
|
|
A system identifier (in the sense defined by the XML 1,0 Specification) for a
|
|
NewsItem.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT SystemIdentifier (#PCDATA )>
|
|
<!ATTLIST SystemIdentifier %localid; >
|
|
<!--
|
|
============================= ThisRevisionCreated ==============================
|
|
The date and, optionally, time at which the current revision of a NewsItem was
|
|
created, expressed in ISO 8601 Basic Format, as described in the comment to the
|
|
DateAndTime attribute within the assignment ENTITY declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT ThisRevisionCreated (#PCDATA )>
|
|
<!ATTLIST ThisRevisionCreated %localid; >
|
|
<!--
|
|
==================================== Topic =====================================
|
|
This element provides information about a thing (Topic) named by a formal
|
|
name or occurring in a NewsComponent. A Topic must have one or more TopicType
|
|
subelements, which state what type of Topic it is. The optional Details
|
|
attribute provides a pointer, in the form of a URL or URN, to additional
|
|
information about the Topic.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Topic (Comment* , Catalog? , TopicType+ , FormalName* , Description* , Property* )>
|
|
<!ATTLIST Topic %localid;
|
|
Details CDATA #IMPLIED >
|
|
<!--
|
|
=============================== TopicOccurrence ================================
|
|
An indication that a particular topic occurs within the content of a
|
|
NewsComponent. The optional HowPresent attribute indicates the nature of that
|
|
topic's occurrence. The value of the Topic attribute must consist of a #
|
|
character followed by the value of the Duid attribute of a Topic in the current
|
|
document.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT TopicOccurrence EMPTY>
|
|
<!ATTLIST TopicOccurrence %localid;
|
|
%assignment;
|
|
Topic CDATA #IMPLIED >
|
|
<!--
|
|
================================== TopicSet ====================================
|
|
A container for Topics. The value of the FormalName attribute is a formal name
|
|
for the TopicSet. Its meaning and permitted values are determined by a
|
|
controlled vocabulary as described in the comment to the formalname ENTITY
|
|
declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT TopicSet (Comment* , Catalog? , TopicSetRef* , Topic* )>
|
|
<!ATTLIST TopicSet %localid;
|
|
%formalname; >
|
|
<!--
|
|
================================= TopicSetRef ==================================
|
|
A pointer to a TopicSet that is to be merged with the current one. The TopicSet
|
|
attribute is a pointer to the relevant TopicSet. Its value can be an http URL,
|
|
or a NewsML URN as described in the comment to PublicIdentifier, or a fragment
|
|
identifier consisting of a # character followed by the Duid of a TopicSet in the
|
|
current document. The presence of a TopicSetRef child in a TopicSet has the
|
|
effect that all the Topics in the referenced TopicSet are included by reference
|
|
within the current TopicSet. When this merging results in there exising two
|
|
FormalName grandchildren of the same TopicSet that have the same content and
|
|
the same Scheme attribute value, then the Topics whose children are in fact the
|
|
same topic, and are deemed to be merged. The merging of Topics need not be
|
|
performed physically by the system, but the meaning of the data is
|
|
exactly the same as if the merging were actually performed. Merging two
|
|
Topcis consists of creating a single Topic that contains all the children of
|
|
both, and eliminating duplicates.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT TopicSetRef (Comment* )>
|
|
<!ATTLIST TopicSetRef %localid;
|
|
TopicSet CDATA #IMPLIED >
|
|
<!--
|
|
================================== TopicType ===================================
|
|
An indication of the type of a Topic. The value of the FormalName attribute is
|
|
a formal name for the TopicType. Its meaning and permitted values are determined
|
|
by a controlled vocabulary as described in the comment to the formalname ENTITY
|
|
declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT TopicType EMPTY>
|
|
<!ATTLIST TopicType %localid;
|
|
%formalname; >
|
|
<!--
|
|
================================== TopicUse ====================================
|
|
An indication of where a particular Topic is used in a NewsML document. The
|
|
value of the Topic attribute must consist of a # character followed by the
|
|
value of the Duid of a Topic in the current document. The value of the Context
|
|
attribute is an XPath pattern indicating the context where the referenced topic
|
|
is used within the subtree to which the current Catalog applies. If the Context
|
|
attribute is not present, the TopicUse element simply states that this topic is
|
|
present somewhere in the subtree.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT TopicUse EMPTY>
|
|
<!ATTLIST TopicUse Topic CDATA #REQUIRED
|
|
Context CDATA #IMPLIED >
|
|
<!--
|
|
================================ TransmissionId ================================
|
|
An identifier for the NewsML document transmission. This should be unique among
|
|
all distinct transmissions from the same publisher. If a transmission is
|
|
repeated (perhaps because the sender is not confident that it was successfully
|
|
received) then the same TransmissionId content may be used, but a Repeat
|
|
attribute should be provided to distinguish the second transmission from the
|
|
first. The form that the value of the Repeat attribute takes is determined by
|
|
the provider. Likewise, the format for the TransmissionId itself is for the
|
|
provider to decide. It could for example consist of a channel identifier
|
|
followed by a sequence number.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT TransmissionId (#PCDATA )>
|
|
<!ATTLIST TransmissionId %localid;
|
|
Repeat CDATA #IMPLIED >
|
|
<!--
|
|
==================================== Update ====================================
|
|
A modification to an existing NewsItem. This can be an insertion, replacement
|
|
or deletion. Note that the Update element cannot be used to modify the
|
|
NewsManagement or Identification element, or any of their descendants.
|
|
Modifications to these parts of the NewsItem can be made by issuing the
|
|
NewsItem under the current revision number, with only the Identification and
|
|
NewsManagement elements present. These will replace the previous Identification
|
|
and NewsManagement elements in their totality.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Update (InsertBefore | InsertAfter | Replace | Delete )*>
|
|
<!ATTLIST Update %localid; >
|
|
<!--
|
|
=================================== Urgency ====================================
|
|
An indication of the urgency of a NewsItem. The value of the FormalName
|
|
attribute is a formal name for the Urgency. Its meaning and permitted values
|
|
are determined by a controlled vocabulary as described in the comment to the
|
|
formalname ENTITY declaration above.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Urgency EMPTY>
|
|
<!ATTLIST Urgency %localid;
|
|
%formalname; >
|
|
<!--
|
|
===================================== Url ======================================
|
|
A URL that can be used to locate a Resource.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Url (#PCDATA )>
|
|
<!ATTLIST Url %localid; >
|
|
<!--
|
|
===================================== Urn ======================================
|
|
A URN that provides a global identifier for a resource. This will typically (but
|
|
not necessarily) be a NewsML URN as described in the comment to PublicIdentifier.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT Urn (#PCDATA )>
|
|
<!ATTLIST Urn %localid; >
|
|
<!--
|
|
================================= UsageRights ==================================
|
|
Information about the usage rights pertaining to a NewsComponent.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT UsageRights (UsageType? , Geography? , RightsHolder? , Limitations? , StartDate? , EndDate? )>
|
|
<!ATTLIST UsageRights %localid;
|
|
%assignment; >
|
|
<!--
|
|
================================== UsageType ===================================
|
|
A natural-language indication of the type of usage to which the rights apply.
|
|
================================================================================
|
|
-->
|
|
<!ELEMENT UsageType (#PCDATA | Origin )*>
|
|
<!ATTLIST UsageType %localid;
|
|
xml:lang CDATA #IMPLIED
|
|
%assignment; >
|