path: root/libxml2/test/valid/dtds/NewsMLv1.0.dtd

<!-- 

                   ===========================================

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