123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578 |
- <!--
- ===========================================
- 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; >
|