1<!-- 2 =========================================== 3 NewsML Document Type Definition Version 1.0 4 =========================================== 5 International Press Telecommunications Council 6 6 October 2000 7 Copyright (c) IPTC, 2000 8 All rights reserved 9 NewsML is a trademark of IPTC 10 11 ====================================== 12 DO NOT REMOVE THESE LICENCE CONDITIONS 13 ====================================== 14 LICENCE OF THE IPTC NewsML TRADEMARK TO NON-MEMBERS OF THE IPTC 15 16Use of the IPTC trademark shall be licensed by the IPTC ("the Licensor") to a 17Non-Member ("the Licensee") in consideration of the following obligations 18undertaken by the Licensee under the terms of this contract. 19 20 1. The Licensee recognises the Licensor as the sole owner of the intellectual 21 property protected by the trademark. 22 23 2. The Licensee recognises that the Licensor has the right to grant licenses 24 of the intellectual property protected by the trademark and has agreed to 25 grant such a licence to the Licensee in the terms set out in this contract. 26 27 3. The Licensee shall not during the subsistence of this contract or at any 28 future time register to use in its own name as proprietor any of the 29 intellectual property protected by the trademark. 30 31 4. The Licensee shall not claim any right title or interest in the 32 intellectual property or any part of it save as is granted by this contract. 33 34 5. The Licensee shall immediately call to the attention of the Licensor the use 35 of any part of the intellectual property by any third party or any activity 36 of any third party which might in the opinion of the Licensee amount to 37 infringement of the rights protected by the trademark. 38 39 6. The Licensee shall not assign the benefit of this contract or grant any 40 sub-licence without the prior written consent of the Licensor. 41 42 7. Use of the IPTC trademark is licensed only to those Licensees who comply 43 with the requirements of the official published description of NewsML. 44 45 8. The Licensee promises to respect the integrity and quality standard of the 46 trademark and shall refrain from all acts and omissions which threaten the 47 integrity of the trademark as a mark of quality. 48 49 9. The Licensee shall communicate immediately to the IPTC any instances of 50 actual or suspected misuse or non-compliance with the official published 51 description of NewsML which come to the attention of the Licensee. 52 5310. The Licensee shall, at the request of the IPTC Management Committee acting 54 unanimously, accede to any reasonable request of the IPTC to inspect the 55 address of the Licensee to verify compliance and each Licensee shall afford 56 to the IPTC such assistance as is requested by the IPTC in response to the 57 latter's reasonable enquiries in instances of suspected non-compliance with 58 the official published description of NewsML requirements. 59 60The Licensee shall from time to time provide the IPTC with the full address of 61its place of business and that place will be deemed the Licensee's address. 62 63The IPTC reserves the right to terminate the use of the trademark by the 64Licensee at any time without notice or without the need to give reasons to the 65Licensee for such termination. 66 67This contract shall be governed and construed in accordance with the laws of 68England and Wales whose courts shall be courts of competent jurisdiction. 69--> 70<!-- 71 ================ 72 NOTE ON SPELLING 73 ================ 74NewsML element and attribute names use US-English spellings. With this 75exception, this DTD and its accompanying specification use British English 76spellings. 77--> 78<!-- 79 ============================= 80 PARAMETER ENTITY DECLARATIONS 81 ============================= 82--> 83<!-- 84================================================================================ 85 Attribute sets 86================================================================================ 87--> 88<!-- 89================================== assignment ================================== 90AssignedBy 91========== 92An identifier for the party assigning a piece of metadata. This can be a 93string that designates the party informally (for example, a person's name), 94or a pointer in the form a fragment identifier consisting of a # character 95followed by the Duid of a Topic corresponding to the party. 96 97Importance 98========== 99An indication of the importance the party assigning a piece of metadata 100attaches to it. The value of the Importance attribute is a formal name for a 101level of importance. Its meaning and permitted values are determined by a 102controlled vocabulary. 103 104Confidence 105========== 106An indication of the confidence with which a piece of metadata has been 107assigned. The value of the Confidence attribute is a formal name for a 108degree of confidence. Its meaning and permitted values are determined by a 109controlled vocabulary. 110 111HowPresent 112========== 113An indication of the way in which a piece of metadata applies. The value of 114the HowPresent attribute is a formal name for the way the metadata applies. 115Its meaning and permitted values are determined by a controlled vocabulary. 116 117DateAndTime 118=========== 119The date and (optionally) time at which a piece of metadata was assigned. 120 121Uses the format CCYYMMDDTHHMMSS{+or-}HHMM (century, year, month, day, time 122separator, hours, minutes, seconds, timezone separator, hours, minutes). If 123only the Date is needed, then the substring from T onwards may be omitted. 124 125This is the Basic Format defined by ISO 8601. CCYY is a 4-digit year number. 126MM is a 2-digit month number. DD is a 2-digit day number. T is the letter 'T'. 127HH is a 2-digit hour number (using a 24-hour clock). MM is a 2 digit minute 128number. (Note that midnight may be represented as 2400 or 240000 on the date 129of the day that is ending, or as 0000 or 000000 on the date of the day that is 130beginning.) 131 132{+or-} is the '+' character or the '-' character, and the following HHMM are 133hours and minutes of offset from Universal Co-ordinated Time (UTC) as defined 134by ISO 8601. If the time is being expressed in UTC, then the timezone offset 135may be '+0000' or '-0000'. If the time is behind UTC, the timezone separator 136is '-'. If the time is ahead of UTC the timezone separator is '+'. 137 138Example: 10:27 p.m. in New York on 31 December 2000 would be expressed as 139"20001231T222700-0500" as New York is five hours behind UTC in winter. 140At the same moment in London, the date and time would be expressed as 141time would be expressed as "20010101T032700+0000" or as , "20010101T00+0000", as 142in London, it is now 3:27 a.m. on 1 January 2001. At the same moment in Paris, 143the date and time would be expressed as "20010101T042700+0100", as Paris is one 144hour ahead of UTC in winter, and it is now 4:27 a.m. on 1 January 2001. 145================================================================================ 146 147--> 148<!ENTITY % assignment " AssignedBy CDATA #IMPLIED 149 Importance CDATA #IMPLIED 150 Confidence CDATA #IMPLIED 151 HowPresent CDATA #IMPLIED 152 DateAndTime CDATA #IMPLIED"> 153 154<!-- 155================================= formalname =================================== 156 157FormalName 158========== 159A string of characters whose meaning is determined by a controlled vocabulary. 160 161Vocabulary 162========== 163The Vocabulary attribute, if present, provides a pointer to a TopicSet which is 164the controlled vocabulary that can be used to resolve the meaning of the 165FormalName. The value of the Vocabulary attribute is an http URL or a NewsML 166URN, or the # character followed by the value of the Duid attribute of the a 167TopicSet in the current document. 168 169If there is no Vocabulary attribute, then the controlled vocabulary to be used 170is located by the following algorithm: 171- Proceed to the parent of the current element. 172- If it has a Catalog element as its immediate child, see whether that Catalog 173 contains a Resource element whose DefaultVocabularyFor child contains an XPath 174 pattern that is matched by the current element. If so, then the controlled 175 vocabulary is the resource identified by that Resource element. 176- If the parent does not meet the above condition, proceed to its parent and 177 check the same condition. 178- Continue until a vocabulary is found, or no further parent elements are 179 available because the root element has been reached and it too fails to meet 180 the condition. 181 182If there is no Vocabulary attribute and the above algorithm fails to identify 183a resource that serves as the controlled vocabulary, there is an error, which 184the NewsML system may signal to the user. 185 186The NewsML system may also signal an error if a vocabulary is successfully 187identified, but it contains no item that matches the value of the FormalName 188whose meaning is sought. 189 190Scheme 191====== 192The Scheme attribute, if present, serves to distinguish which of possibly 193multiple naming schemes in the controlled vocabulary is the one that governs 194this FormalName. For a match to be obtained within the controlled vocabulary, 195the rule is that the FormalName and the Scheme must both match. If there is 196no Scheme attribute on the current element, the match will be to an item in 197the vocabulary that has the current formal name and no scheme. If there is a 198Scheme attribute on the current element, then both the formal name and the 199scheme in the controlled vocabulary must match. 200================================================================================ 201--> 202<!ENTITY % formalname " FormalName CDATA #REQUIRED 203 Vocabulary CDATA #IMPLIED 204 Scheme CDATA #IMPLIED"> 205 206<!-- 207=================================== localid ==================================== 208 209Duid 210==== 211Duid is a "Document-unique Identifier". It must satisfy the rules for XML ID 212attributes: it must only contain name characters, and it must start with a 213name-start character (not a digit). Its value must be unique within any NewsML 214document. 215 216Every NewsML element type has Duid as an optional attribute. Combined with the 217Identifier element, providing a value for the Duid of any element in a NewsML 218document makes the element globally identifiable. The Identifier element gives 219global identification to the document, and the Duid provides local 220identification for the element within the document. 221 222Euid 223==== 224Euid is an "Element-unique Identifier". Its value must be unique among elements 225of the same element-type and having the same parent element. 226 227Use of Euid attribute makes it possible to identify any NewsML element within 228the context of its local branch of the NewsML document tree. This makes it 229possible to copy, or include by reference, subtrees into new combinations in 230ways that would break the uniqueness of Duids (thereby forcing new Duids to be 231allocated), but still being able to retain the identity of each element. If 232Euids are maintained at every level, it is possible to identify, for example 233"The ContentItem whose Euid is abc within the NewsComponent whose Euid is def". 234Such identification patterns would be preserved even after "pruning and 235grafting" of subtrees. 236================================================================================ 237--> 238<!ENTITY % localid " Duid ID #IMPLIED 239 Euid CDATA #IMPLIED"> 240 241<!-- 242================================================================================ 243 Content Models 244================================================================================ 245--> 246<!-- 247===================================== data ===================================== 248Where data is included, it may be directly in the form of a DataContent element, 249or in the form of DataContent wrapped in an Encoding element, or by reference 250through an Href attribute, in which case neither a DataContent nor an Encoding 251element will be present. 252================================================================================ 253--> 254<!ENTITY % data " (Encoding 255 | DataContent )?"> 256 257<!-- 258==================================== party ===================================== 259Person, organisation or company playing a specific role in the 260news workflow. The role being played is determined by the parent element. More 261information about it can be provided in the optional Comment subelements. 262================================================================================ 263 264--> 265<!ENTITY % party " (Comment* 266 , Party+ )"> 267 268<!-- 269 ========================= 270 ELEMENT TYPE DECLARATIONS 271 ========================= 272--> 273<!-- 274============================ AdministrativeMetadata ============================ 275Information about the provenance of a NewsComponent. 276================================================================================ 277--> 278<!ELEMENT AdministrativeMetadata (Catalog? , FileName? , SystemIdentifier? , Provider? , Creator? , Source* , Contributor* , Property* )> 279<!ATTLIST AdministrativeMetadata %localid; > 280<!-- 281 282================================ AssociatedWith ================================ 283A reference to a NewsItem with which this one is associated (for example, a 284series of articles, or a collection of photos, of which it is a part). The 285NewsItem attribute identifies the relevant NewsItem. Its value can be an 286http URL or a NewsML URN as described in the comment to PublicIdentifier. The 287Comment can be used to indicate the nature of the association. 288================================================================================ 289 290--> 291<!ELEMENT AssociatedWith (Comment* )> 292<!ATTLIST AssociatedWith %localid; 293 NewsItem CDATA #IMPLIED > 294<!-- 295================================ BasisForChoice ================================ 296The content of this element is an XPath statement or element-type name 297identifying information within each NewsComponent or ContentItem that can be 298used as a basis for choice between equivalent NewsComponents or ContentItems. 299The root of the XPath corresponds to the NewsComponent or ContentItem itself. 300The optional Rank attribute allows providers to place a numerical order on the 301importance they think should be attached to the different bases for choice. 302Smaller numbers represent higher importance. 303================================================================================ 304--> 305<!ELEMENT BasisForChoice (#PCDATA )> 306<!ATTLIST BasisForChoice %localid; 307 Rank CDATA #IMPLIED > 308<!-- 309 310==================================== ByLine ==================================== 311A natural-language statement of the author/creator information. 312================================================================================ 313--> 314<!ELEMENT ByLine (#PCDATA | Origin )*> 315<!ATTLIST ByLine %localid; 316 xml:lang CDATA #IMPLIED > 317<!-- 318=================================== Catalog ==================================== 319A container for Resource and TopicUse elements. Resource elements map URNs to 320URLs and indicate default vocabularies which apply to the formal names of 321certain elements within the subtree that begins with the immediate parent of 322the Catalog element. TopicUse elements indicate where in the NewsML document 323certain Topics are used. The optional Href attribute provides a pointer to 324a Catalog element elsewhere in this or another document. Its value consists of 325a # character followed by the value of the Duid attribute of the referenced 326Catalog element and preceded, if the referenced Catalog is not in the current 327document, by an http URL or a NewsML URN identifying the document or NewsItem 328in which the Catalog appears. If the Href attribute is present on a Catalog 329element, then that element should be empty. If it contains subelements, the 330NewsML system may signal an error. 331================================================================================ 332--> 333<!ELEMENT Catalog (Resource* , TopicUse* )> 334<!ATTLIST Catalog %localid; 335 Href CDATA #IMPLIED > 336<!-- 337=============================== Characteristics ================================ 338Information about the physical characteristics of a ContentItem. 339================================================================================ 340--> 341<!ELEMENT Characteristics (SizeInBytes? , Property* )> 342<!ATTLIST Characteristics %localid; > 343<!-- 344=================================== Comment ==================================== 345A natural-language description of, or statement about, the current element. The 346optional TranslationOf attribute is a pointer to another Comment element, of 347which this one is a direct translation. 348================================================================================ 349--> 350<!ELEMENT Comment (#PCDATA )> 351<!ATTLIST Comment %localid; 352 xml:lang CDATA #IMPLIED 353 TranslationOf IDREF #IMPLIED > 354<!-- 355================================= ContentItem ================================== 356A news object that carries or identifies content intended for presentation to 357humans. 358================================================================================ 359--> 360<!ELEMENT ContentItem (Comment* , Catalog? , MediaType? , Format? , MimeType? , Notation? , Characteristics? , %data; )> 361<!ATTLIST ContentItem %localid; 362 Href CDATA #IMPLIED > 363<!-- 364================================= Contributor ================================== 365An individual and/or company or organisation that modified or enhanced a news 366object after its creation. 367================================================================================ 368--> 369<!ELEMENT Contributor (%party; )> 370<!ATTLIST Contributor %localid; > 371<!-- 372================================== Copyright =================================== 373The copyright that pertains to a news object. 374================================================================================ 375--> 376<!ELEMENT Copyright (Comment* , CopyrightHolder , CopyrightDate )> 377<!ATTLIST Copyright %localid; 378 %assignment; > 379<!-- 380================================ CopyrightDate ================================= 381A natural-language statement of the copyright date. 382================================================================================ 383 384--> 385<!ELEMENT CopyrightDate (#PCDATA | Origin )*> 386<!ATTLIST CopyrightDate %localid; 387 xml:lang CDATA #IMPLIED > 388<!-- 389=============================== CopyrightHolder ================================ 390A natural-language statement indicating who owns the copyright. 391================================================================================ 392--> 393<!ELEMENT CopyrightHolder (#PCDATA | Origin )*> 394<!ATTLIST CopyrightHolder %localid; 395 xml:lang CDATA #IMPLIED > 396<!-- 397================================ CopyrightLine ================================= 398A natural-language statement of the copyright information. 399================================================================================ 400--> 401<!ELEMENT CopyrightLine (#PCDATA | Origin )*> 402<!ATTLIST CopyrightLine %localid; 403 xml:lang CDATA #IMPLIED > 404<!-- 405=================================== Creator ==================================== 406An individual and/or company or organisation that created a news object. 407================================================================================ 408--> 409<!ELEMENT Creator (%party; )> 410<!ATTLIST Creator %localid; > 411<!-- 412================================== CreditLine ================================== 413A natural-language statement of credit information. 414================================================================================ 415--> 416<!ELEMENT CreditLine (#PCDATA | Origin )*> 417<!ATTLIST CreditLine %localid; 418 xml:lang CDATA #IMPLIED > 419<!-- 420================================= DataContent ================================== 421The data that carries the content of a ContentItem. 422================================================================================ 423--> 424<!ELEMENT DataContent ANY> 425<!ATTLIST DataContent %localid; > 426<!-- 427================================= DateAndTime ================================== 428A formal representation of a date and, optionally, time, expressed in ISO 8601 429Basic Format, as described in the comment to the DateAndTime attribute within 430the assignment ENTITY declaration above. 431================================================================================ 432--> 433<!ELEMENT DateAndTime (#PCDATA )> 434<!ATTLIST DateAndTime %localid; > 435<!-- 436==================================== DateId ==================================== 437A date identifier of a NewsItem in short ISO 8601 Basic Format (CCYYMMDD), as 438described in the comment to the DateAndTime attribute within the assignment 439ENTITY declaration above. The DateId is part of the formal identification of the 440NewsItem, and must remain the same through successive revisions of the same 441NewsItem. 442================================================================================ 443--> 444<!ELEMENT DateId (#PCDATA )> 445 446<!-- 447================================== DateLabel =================================== 448A string representation of a date or date and time, used by human users to help 449identify a NewsItem. 450================================================================================ 451--> 452<!ELEMENT DateLabel (#PCDATA )> 453<!ATTLIST DateLabel %localid; > 454<!-- 455=================================== DateLine =================================== 456A natural-language statement of the date and/or place of creation. 457================================================================================ 458--> 459<!ELEMENT DateLine (#PCDATA | Origin )*> 460<!ATTLIST DateLine %localid; 461 xml:lang CDATA #IMPLIED > 462<!-- 463============================ DefaultVocabularyFor ============================== 464An indication that the parent Resource provides the default vocabulary that 465determines the meanings and permitted values of the data occurring in a 466particular part of a NewsML document subtree. The Context attribute is an 467XPath statement identifying the data to which the default vocabulary applies. 468The optional Scheme attribute identifies the relevant naming scheme if the 469Resource contains more than one naming scheme. If the Resource is a NewsML 470TopicSet, then the meaning of the data identified by the Context is provided 471by the Topic whose FormalName subelement matches that data. If the Resource is 472not a NewsML TopicSet, then the way in which it is interpreted in order to 473provide a meaning for the data is not defined by NewsML but by the authority 474that governs whatever format the Resource uses. 475 476Example: 477<DescriptiveMetadata> 478 <Catalog> 479 <Resource Duid="resource1"> 480 <Urn>urn:newsml:iptc.org:20001006:Ranking:1</Urn> 481 <Url>www.iptc.com/vocabularies/iptc-rank.xml</Url> 482 <DefaultVocabularyFor Context="@Confidence"/> 483 <DefaultVocabularyFor Context="@Importance"/> 484 </Resource> 485 <Resource Duid="resource2"> 486 <Urn>urn:newsml:iptc.org:20001006:TopicTypes:1</Urn> 487 <Url>www.iptc.com/vocabularies/iptc-topictype.xml</Url> 488 <DefaultVocabularyFor Context="TopicType@FormalName"/> 489 </Resource> 490 </Catalog> 491 <TopicSet> 492 <Topic Duid="topic1"> 493 <TopicType FormalName="Person"> 494 <Description Variant="Name">Bill Clinton</Description> 495 <Description Variant="Position">President of the USA</Description> 496 </Topic> 497 </TopicSet> 498 <TopicOccurrence 499 AssignedBy="Desk Editor" 500 Confidence="High" 501 HowPresent="principal subject" 502 Topic="#topic1"/> 503</DescriptiveMetadata> 504================================================================================ 505--> 506<!ELEMENT DefaultVocabularyFor EMPTY> 507<!ATTLIST DefaultVocabularyFor %localid; 508 Context CDATA #REQUIRED 509 Scheme CDATA #IMPLIED > 510<!-- 511==================================== Delete ==================================== 512An instruction to delete an element within a NewsItem. The NewsItem is 513the previous revision of the current one, and the element to be deleted is the 514one whose Duid value is equal to the value of the Delete element's DuidRef 515attribute. 516================================================================================ 517--> 518<!ELEMENT Delete EMPTY> 519<!ATTLIST Delete %localid; 520 DuidRef CDATA #REQUIRED > 521<!-- 522================================= DerivedFrom ================================== 523A reference to an NewsItem from which this one is derived. The NewsItem attribute 524identifies the relevant NewsItem. Its value can be an http URL or a NewsML URN 525as described in the comment to PublicIdentifier. 526================================================================================ 527--> 528<!ELEMENT DerivedFrom (Comment* )> 529<!ATTLIST DerivedFrom %localid; 530 NewsItem CDATA #IMPLIED > 531<!-- 532================================= Description ================================== 533A description that identifies a Topic, thereby indicating the meaning of a 534formal name associated with that Topic. The xml:lang attribute indicates what 535language the description is in. The optional Variant attribute allows multiple 536descriptions to be given in the same language, and meaningfully distinguished 537from one another. 538================================================================================ 539--> 540<!ELEMENT Description (#PCDATA )> 541<!ATTLIST Description %localid; 542 xml:lang CDATA #IMPLIED 543 Variant CDATA #IMPLIED > 544<!-- 545============================= DescriptiveMetadata ============================== 546Information describing the content of a NewsComponent. 547================================================================================ 548--> 549<!ELEMENT DescriptiveMetadata (Catalog? , Language* , Genre? , SubjectCode* , OfInterestTo* , TopicOccurrence* , Property* )> 550<!ATTLIST DescriptiveMetadata %localid; 551 %assignment; > 552<!-- 553=================================== Encoding =================================== 554The encoding of the data comprising the content of a ContentItem. 555================================================================================ 556--> 557<!ELEMENT Encoding %data;> 558<!ATTLIST Encoding %localid; 559 Notation CDATA #REQUIRED > 560<!-- 561=================================== EndDate ==================================== 562A natural-language statement of the date at which specified usage rights come 563to an end. 564================================================================================ 565--> 566<!ELEMENT EndDate (#PCDATA | Origin )*> 567<!ATTLIST EndDate %localid; 568 xml:lang CDATA #IMPLIED 569 %assignment; > 570<!-- 571=================================== FileName =================================== 572The suggested or actual storage file name for a NewsItem. 573================================================================================ 574--> 575<!ELEMENT FileName (#PCDATA )> 576<!ATTLIST FileName %localid; > 577<!-- 578================================= FirstCreated ================================= 579The date and, optionally, time at which a NewsItem was first created, expressed 580in ISO 8601 Basic Format, as described in the comment to the DateAndTime 581attribute within the assignment ENTITY declaration above. 582================================================================================ 583--> 584<!ELEMENT FirstCreated (#PCDATA )> 585<!ATTLIST FirstCreated %localid; > 586<!-- 587================================= FormalName =================================== 588A string of characters whose meaning is determined by a naming scheme within a 589controlled vocabulary. The controlled vocabulary may (but is not required to) 590take the form of a NewsML TopicSet. The optional Scheme attribute determines 591which naming scheme applies, when several exist within the same controlled 592vocabulary. 593================================================================================ 594--> 595<!ELEMENT FormalName (#PCDATA )> 596<!ATTLIST FormalName %localid; 597 Scheme CDATA #IMPLIED > 598<!-- 599==================================== Format ==================================== 600An indication of the format of a ContentItem. The value of the FormalName 601attribute is a formal name for the Format. Its meaning and permitted values are 602determined by a controlled vocabulary as described in the comment to the 603formalname ENTITY declaration above. 604================================================================================ 605--> 606<!ELEMENT Format EMPTY> 607<!ATTLIST Format %localid; 608 %formalname; > 609<!-- 610================================= FutureStatus ================================= 611An indication of the status a NewsItem will have at a specified future date. The 612value of the FormalName attribute is a formal name for the FutureStatus. Its 613meaning is determined by a controlled vocabulary as described in the comment 614to the formalname ENTITY declaration above. 615================================================================================ 616--> 617<!ELEMENT FutureStatus EMPTY> 618<!ATTLIST FutureStatus %localid; 619 %formalname; > 620<!-- 621==================================== Genre ===================================== 622An indication of the Genre of a NewsComponent. The value of the FormalName 623attribute is a formal name for the Genre. Its meaning and permitted values are 624determined by a controlled vocabulary as described in the comment to the 625formalname ENTITY declaration above. 626================================================================================ 627--> 628<!ELEMENT Genre EMPTY> 629<!ATTLIST Genre %localid; 630 %formalname; 631 %assignment; > 632<!-- 633================================== Geography =================================== 634A natural-language statement of the geographical area or areas to which 635specified usage rights apply. 636================================================================================ 637--> 638<!ELEMENT Geography (#PCDATA | Origin )*> 639<!ATTLIST Geography %localid; 640 xml:lang CDATA #IMPLIED 641 %assignment; > 642<!-- 643=================================== HeadLine =================================== 644A displayable headline. 645================================================================================ 646--> 647<!ELEMENT HeadLine (#PCDATA | Origin )*> 648<!ATTLIST HeadLine %localid; 649 xml:lang CDATA #IMPLIED > 650<!-- 651================================ Identification ================================ 652Identification information for the NewsItem. 653================================================================================ 654--> 655<!ELEMENT Identification (NewsIdentifier , NameLabel? , DateLabel? , Label* )> 656<!ATTLIST Identification %localid; > 657<!-- 658================================= InsertAfter ================================== 659An instruction to insert content after a designated element within a NewsItem. 660The content to be inserted is the content of the InsertAfter element. The 661NewsItem into which it is to be inserted is the previous revision of the current 662one, and the element after which it is to be inserted is the one whose Duid 663value is equal to the value of the InsertAfter element's DuidRef attribute. 664================================================================================ 665--> 666<!ELEMENT InsertAfter ANY> 667<!ATTLIST InsertAfter %localid; 668 DuidRef CDATA #REQUIRED > 669<!-- 670================================= InsertBefore ================================= 671An instruction to insert content before a designated element within a NewsItem. 672The content to be inserted is the content of the InsertBefore element. The 673NewsItem into which it is to be inserted is the previous revision of the current 674one, and the element before which it is to be inserted is the one whose Duid 675value is equal to the value of the InsertBefore element's DuidRef attribute. 676================================================================================ 677--> 678<!ELEMENT InsertBefore ANY> 679<!ATTLIST InsertBefore %localid; 680 DuidRef CDATA #REQUIRED > 681<!-- 682================================= Instruction ================================== 683An instruction from a news provider to the recipient of a NewsItem. A special 684case of Instruction is an indication of the effect the current revision of a 685NewsItem has on the status of any previous revisions of the NewsItem that may 686still be on the recipient's system. In this case, it will contain one or more 687RevisionStatus elements. Otherwise, the value of the FormalName attribute is a 688formal name for the Instruction, and its meaning is determined by a controlled 689vocabulary as described in the comment to the formalname ENTITY declaration 690above. 691================================================================================ 692--> 693<!ELEMENT Instruction (RevisionStatus* )> 694<!ATTLIST Instruction %localid; 695 %formalname; > 696<!-- 697================================= KeywordLine ================================== 698A displayable set of keywords relevant to a news object. This can be used by a 699NewsML system to assist manual or automated searches. 700================================================================================ 701--> 702<!ELEMENT KeywordLine (#PCDATA | Origin )*> 703<!ATTLIST KeywordLine %localid; 704 xml:lang CDATA #IMPLIED > 705<!-- 706==================================== Label ===================================== 707A human-readable label for a NewsItem. 708================================================================================ 709--> 710<!ELEMENT Label (LabelType , LabelText )> 711<!ATTLIST Label %localid; > 712<!-- 713=================================== LabelText ================================== 714The text that constitutes a Label of a given LabelType. 715================================================================================ 716--> 717<!ELEMENT LabelText (#PCDATA )> 718<!ATTLIST LabelText %localid; > 719<!-- 720================================= LabelType ==================================== 721A user-defined type of label. The value of the FormalName attribute is a formal 722name for the LabelType. Its meaning and permitted values are determined by a 723controlled vocabulary as described in the comment to the formalname ENTITY 724declaration above. 725================================================================================ 726--> 727<!ELEMENT LabelType EMPTY> 728<!ATTLIST LabelType %localid; 729 %formalname; > 730<!-- 731=================================== Language =================================== 732An indication of the, or a, language used in a content item. The value of the 733FormalName attribute is a formal name for the Language. Its meaning and 734permitted values are determined by a controlled vocabulary as described in the 735comment to the formalname ENTITY declaration above. 736================================================================================ 737--> 738<!ELEMENT Language EMPTY> 739<!ATTLIST Language %localid; 740 %formalname; 741 %assignment; > 742<!-- 743================================= Limitations ================================== 744A natural-language statement of the terms and conditions that apply to the 745specified usage rights. 746================================================================================ 747--> 748<!ELEMENT Limitations (#PCDATA | Origin )*> 749<!ATTLIST Limitations %localid; 750 xml:lang CDATA #IMPLIED 751 %assignment; > 752<!-- 753================================== MediaType =================================== 754An indication of the media type of a ContentItem. The value of the FormalName 755attribute is a formal name for the MediaType. Its meaning and permitted values 756are determined by a controlled vocabulary as described in the comment to the 757formalname ENTITY declaration above. 758================================================================================ 759--> 760<!ELEMENT MediaType EMPTY> 761<!ATTLIST MediaType %localid; 762 %formalname; > 763<!-- 764=================================== Metadata =================================== 765An container for a user-defined type of metadata. 766================================================================================ 767--> 768<!ELEMENT Metadata (Catalog? , MetadataType , Property+ )> 769<!ATTLIST Metadata %localid; > 770<!-- 771=============================== MetadataType =================================== 772An indication of the type of metadata that is represented by the Property 773elements within this Metadata element. The value of the FormalName attribute is 774a formal name for the MetadataType. Its meaning and permitted values are 775determined by a controlled vocabulary as described in the comment to the 776formalname ENTITY declaration above. 777================================================================================ 778--> 779<!ELEMENT MetadataType EMPTY> 780<!ATTLIST MetadataType %localid; 781 %formalname; > 782<!-- 783=================================== MimeType =================================== 784An indication of the MIME-type of a ContentItem. The value of the FormalName 785attribute is a formal name for the MimeType. Its meaning and permitted values 786are determined by a controlled vocabulary as described in the comment to the 787formalname ENTITY declaration above. 788================================================================================ 789--> 790<!ELEMENT MimeType EMPTY> 791<!ATTLIST MimeType %localid; 792 %formalname; > 793<!-- 794================================== NameLabel =================================== 795A string used by human users as a name to help identify a NewsItem. Its form is 796determined by the provider. It might be identical to the textual content of 797the SlugLine element, for example, but even if this is so, the system should not 798process the NameLabel as a slugline. Nothing can be assumed about the nature of 799the string within NameLabel beyond the fact that it can help to identify the 800NewsItem to humans. 801================================================================================ 802--> 803<!ELEMENT NameLabel (#PCDATA )> 804<!ATTLIST NameLabel %localid; > 805<!-- 806================================ NewsComponent ================================= 807A container for news objects, used to identify the role of news objects in 808relation to one another, and to ascribe metadata to them. The Essential 809attribute indicates whether the provider considers that this NewsComponent 810is essential to the meaning of the NewsComponent within which it is contained. 811The EquivalentsList attribute indicates whether or not the NewsItems or 812NewsItemRefs, NewsComponents or ContentItems contained within this one are 813equivalent to one another in content and/or meaning 814================================================================================ 815--> 816<!ELEMENT NewsComponent (Comment* , Catalog? , TopicSet* , Role? , BasisForChoice* , NewsLines? , AdministrativeMetadata? , RightsMetadata? , DescriptiveMetadata? , Metadata* , ( (NewsItem | NewsItemRef )+ | NewsComponent+ | ContentItem+ )? )> 817<!ATTLIST NewsComponent %localid; 818 Essential (yes | no ) 'no' 819 EquivalentsList (yes | no ) 'no' 820 xml:lang CDATA #IMPLIED > 821<!-- 822================================= NewsEnvelope ================================= 823Information about the transmission of one or more NewsItems as a NewsML 824document. 825================================================================================ 826--> 827<!ELEMENT NewsEnvelope (TransmissionId? , SentFrom? , SentTo? , DateAndTime , NewsService* , NewsProduct* , Priority? )> 828<!ATTLIST NewsEnvelope %localid; > 829<!-- 830================================ NewsIdentifier ================================ 831A globally unique identifier for a NewsItem. 832================================================================================ 833--> 834<!ELEMENT NewsIdentifier (ProviderId , DateId , NewsItemId , RevisionId , PublicIdentifier )> 835 836<!-- 837=================================== NewsItem =================================== 838A managed set of information representing a point of view, at a given time, on 839some event or events. Its Identification and NewsManagement provide 840manageability. It may contain either a NewsComponent, or one or more Updates 841that modify aspects of a previous Revision of the same NewsItem, or a 842TopicSet. 843================================================================================ 844--> 845<!ELEMENT NewsItem (Comment* , Catalog? , Identification , NewsManagement , (NewsComponent | Update+ | TopicSet )? )> 846<!ATTLIST NewsItem %localid; 847 xml:lang CDATA #IMPLIED > 848<!-- 849================================== NewsItemId ================================== 850An identifier for the NewsItem. The combination of NewsItemId and DateId must 851be unique among NewsItems that emanate from the same provider. Within these 852constraints, the NewsItemId can take any form the provider wishes. It may take 853the form of a name for the NewsItem that will be meaningful to humans, but this 854is not a requirement. The provider may optionally relate the values of 855NewsItemId to a controlled vocabulary, which is invoked by the Vocabulary 856attribute. The value ofthe Vocabulary attribute may be an http URL, a NewsML 857URN, or the # character followed by the value of the Duid attribute of a 858TopicSet in the current document. The Scheme attribute, if present, serves to 859distinguish which of possibly multiple naming schemes in the controlled 860vocabulary is the one that governs the NewsItemId. 861================================================================================ 862--> 863<!ELEMENT NewsItemId (#PCDATA )> 864<!ATTLIST NewsItemId Vocabulary CDATA #IMPLIED 865 Scheme CDATA #IMPLIED > 866<!-- 867================================= NewsItemRef ================================== 868A pointer to a NewsItem that is deemed to replace the NewsItemRef element. The 869NewsItem attribute is a pointer to the relevant NewsItem. Its value can be an 870http URL, or a NewsML URN as described in the comment to PublicIdentifier, or a 871fragment identifier consisting of a # character followed by the Duid of a 872NewsItem in the current document. 873================================================================================ 874--> 875<!ELEMENT NewsItemRef (Comment* )> 876<!ATTLIST NewsItemRef %localid; 877 NewsItem CDATA #IMPLIED > 878<!-- 879================================= NewsItemType ================================= 880An indication of the type of a NewsItem. The value of the FormalName attribute 881is a formal name for the NewsItemType. Its meaning and permitted values are 882determined by a controlled vocabulary as described in the comment to the 883formalname ENTITY declaration above. 884================================================================================ 885--> 886<!ELEMENT NewsItemType EMPTY> 887<!ATTLIST NewsItemType %localid; 888 %formalname; > 889<!-- 890=================================== NewsLine =================================== 891A newsline of a type not included in the NewsML specification. 892================================================================================ 893--> 894<!ELEMENT NewsLine (NewsLineType , NewsLineText+ )> 895<!ATTLIST NewsLine %localid; > 896<!-- 897=================================== NewsLineText =================================== 898The text of a NewsLine of user-defined type. 899================================================================================ 900--> 901<!ELEMENT NewsLineText (#PCDATA | Origin )*> 902<!ATTLIST NewsLineText %localid; 903 xml:lang CDATA #IMPLIED > 904<!-- 905================================ NewsLineType ================================== 906An indication of a user-defined NewsLine type. The value of the FormalName 907attribute is a formal name for the NewsLineType. Its meaning and permitted 908values are determined by a controlled vocabulary as described in the comment 909to the formalname ENTITY declaration above. 910================================================================================ 911--> 912<!ELEMENT NewsLineType EMPTY> 913<!ATTLIST NewsLineType %localid; 914 %formalname; > 915<!-- 916================================== NewsLines =================================== 917A container for all the NewsLines that a NewsComponent has. 918================================================================================ 919--> 920<!ELEMENT NewsLines ( (HeadLine , SubHeadLine? )* , ByLine* , DateLine* , CreditLine* , CopyrightLine* , RightsLine* , SeriesLine* , SlugLine* , KeywordLine* , NewsLine* )> 921<!ATTLIST NewsLines %localid; > 922<!-- 923================================ NewsManagement ================================ 924Information relevant to the management of a NewsItem. 925================================================================================ 926--> 927<!ELEMENT NewsManagement (NewsItemType , FirstCreated , ThisRevisionCreated , Status , StatusWillChange? , Urgency? , RevisionHistory? , DerivedFrom* , AssociatedWith* , Instruction* , Property* )> 928<!ATTLIST NewsManagement %localid; > 929<!-- 930==================================== NewsML ==================================== 931A NewsML document, which must contain a NewsEnvelope and one or more NewsItems, 932and may include a Catalog element and a TopicSet element. 933================================================================================ 934--> 935<!ELEMENT NewsML (Catalog? , TopicSet* , (NewsEnvelope , NewsItem+ ) )> 936<!ATTLIST NewsML %localid; > 937<!-- 938================================= NewsProduct ================================== 939An identifier for a product to which all the NewsItems in a NewsML document 940belong. The value of the FormalName attribute is a formal name for the 941NewsProduct. Its meaning and permitted values are determined by a controlled 942vocabulary as described in the comment to the formalname ENTITY declaration 943above. 944================================================================================ 945--> 946<!ELEMENT NewsProduct EMPTY> 947<!ATTLIST NewsProduct %localid; 948 %formalname; > 949<!-- 950================================= NewsService ================================== 951An identifier for a service to which all the NewsItems in a NewsML document 952belong. The value of the FormalName attribute is a formal name for the 953NewsService. Its meaning and permitted values are determined by a controlled 954vocabulary as described in the comment to the formalname ENTITY declaration 955above. 956================================================================================ 957--> 958<!ELEMENT NewsService EMPTY> 959<!ATTLIST NewsService %localid; 960 %formalname; > 961<!-- 962=================================== Notation =================================== 963An indication of the notation of a ContentItem. The value of the FormalName 964attribute is a formal name for the Notation. Its meaning and permitted values 965are determined by a controlled vocabulary as described in the comment to the 966formalname ENTITY declaration above. 967================================================================================ 968--> 969<!ELEMENT Notation EMPTY> 970<!ATTLIST Notation %localid; 971 %formalname; > 972<!-- 973================================= OfInterestTo ================================= 974An indication of the target audience of a NewsItem. The value of the FormalName 975attribute is a formal name for the target audience. Its meaning and permitted 976values are determined by a controlled vocabulary as described in the comment to 977the formalname ENTITY declaration above. 978================================================================================ 979--> 980<!ELEMENT OfInterestTo (Relevance? )> 981<!ATTLIST OfInterestTo %localid; 982 %formalname; 983 %assignment; > 984<!-- 985==================================== Origin ==================================== 986A wrapper for all or part of the text of a piece of text, which provides a 987pointer to an item of data corresponding formally to what is being described 988here in natural language. The Href attribute identifies the relevant data, and 989may be an http URL or a NewsML URN as described in the comment to 990PublicIdentifier, optionally including a fragment identifier. Alternatively, it 991can be a simple fragment identifier consisting of a # character followed by the 992value of the Duid of an element in the current document. 993================================================================================ 994--> 995<!ELEMENT Origin (#PCDATA | Origin )*> 996<!ATTLIST Origin %localid; 997 %assignment; 998 Href CDATA #IMPLIED > 999<!-- 1000=================================== Party ====================================== 1001An indication of the person, company or organisation that has a particular 1002relationship to this NewsItem in the news workflow. The value of the FormalName 1003attribute is a formal name for the Party. Its meaning and permitted values 1004are determined by a controlled vocabulary as described in the comment to the 1005formalname ENTITY declaration above. 1006================================================================================ 1007--> 1008<!ELEMENT Party EMPTY> 1009<!ATTLIST Party %localid; 1010 %formalname; 1011 Topic CDATA #IMPLIED > 1012<!-- 1013=================================== Priority =================================== 1014An indication of the priority notation of a NewsItem. The value of the 1015FormalName attribute is a formal name for the Priority. Its meaning and 1016permitted values are determined by a controlled vocabulary as described in 1017the comment to the formalname ENTITY declaration above. 1018================================================================================ 1019--> 1020<!ELEMENT Priority EMPTY> 1021<!ATTLIST Priority %localid; 1022 %formalname; > 1023<!-- 1024=================================== Property =================================== 1025A property of a NewsComponent or of a Topic. The property has a name and either 1026a simple Value or a complex value consisting of a set of further properties. 1027 1028Value 1029===== 1030A string representation of the value of a Property. 1031 1032ValueRef 1033======== 1034A pointer to the value of the Property. This might be a Topic in a TopicSet, or 1035any other piece of data. If both Value and ValueRef are provided, then ValueRef 1036identifies the actual value of the property, with Value simply providing a 1037string representation or mnemonic for it. 1038 1039 1040Example: 1041<Catalog> 1042 <Resource Duid="resource1"> 1043 <Urn>urn:newsml:reuters.com:20001001:Physical Characteristics:3</Urn> 1044 <Url>www.reuters.com/vocabs/physical.xml</Url> 1045 <Url>www.iptc.com/vocabularies/memberdefined/reuters/physical.xml</Url> 1046 <DefaultVocabularyFor Scheme="short" Context="Metadata/Property[@FormalName='Width']"/> 1047 </Resource> 1048</Catalog> 1049<Property FormalName="Width" Vocabulary="#resource1"> 1050 <Property FormalName="Unit" ValueRef="urn:newsml:iptc.org:20001006:units:1#cm"/> 1051 <Property FormalName="Quantity" Value="7.5"/> 1052</Property> 1053 1054AllowedValues 1055============= 1056The AllowedValues attribute, if present, is a pointer to a controlled vocabulary 1057that delimits the set of allowed values for the property. This may be an http 1058URL, or a NewsML URN, or a fragment identifier consisting of a # charactger 1059followed by the Duid of an element in the current document. The pointer must 1060reference either a Resource element that designates an external controlled 1061vocabulary, or a TopicSet element, that is itself the controlled vocabulary. 1062================================================================================ 1063--> 1064<!ELEMENT Property (Property* )> 1065<!ATTLIST Property %localid; 1066 %formalname; 1067 %assignment; 1068 Value CDATA #IMPLIED 1069 ValueRef CDATA #IMPLIED 1070 AllowedValues CDATA #IMPLIED > 1071<!-- 1072=================================== Provider =================================== 1073An individual and/or company or organisation that released a news object for 1074publication. 1075================================================================================ 1076--> 1077<!ELEMENT Provider (%party; )> 1078<!ATTLIST Provider %localid; > 1079<!-- 1080================================== ProviderId ================================== 1081An identifier for the news provider that produced the NewsItem. The 1082provider's ID is specified in the element content. This should be an Internet 1083domain name that is owned by the provider at the date identified by the DateId 1084subelement of the NewsIdentifier, or the name for the Provider drawn from a 1085controlled vocabulary identified by a URN specified in the Vocabulary attribute. 1086This will ensure that the identity of the provider can be inferred unambiguously 1087from the full NewsIdentifier. 1088 1089Example: 1090<NewsIdentifier> 1091 <ProviderId>iptc.org</ProviderId> 1092 <DateId>20001001</DateId> 1093 <NewsItemId>NewsML version 1.0</NewsItemId> 1094 <RevisionId>1</RevisionId 1095</NewsIdentifier> 1096 1097Because the domain name "iptc.org" was owned on 1 October 2000 by the 1098International Press Telecommunications Council (IPTC) and no-one else, it is 1099certain that IPTC is the provider in this case. 1100================================================================================ 1101--> 1102<!ELEMENT ProviderId (#PCDATA )> 1103<!ATTLIST ProviderId Vocabulary CDATA #IMPLIED > 1104<!-- 1105=============================== PublicIdentifier =============================== 1106A public identifier (in the sense defined by the XML 1,0 Specification) for a 1107NewsItem. This is the NewsML URN, and must be constructed as follows: 1108 1109If the ProviderId is a domain name 1110 1111urn:newsml:{ProviderId}:{DateId}:{NewsItemId}:{RevisionId}{RevisionId@Update} 1112 1113If the ProviderId is name drawn from a controlled vocabulary 1114 1115urn:newsml:|{ProviderId@Vocabulary}|{ProviderId}|:{DateId}:{NewsItemId}:{RevisionId}{RevisionId@Update} 1116 1117where {x} means "the content of the x subelement of the NewsIdentifier" and 1118{x@y} means "the value of the y attribute of the x subelement of the 1119NewsIdentifier", with the exception that if the Update attribute of the 1120RevisionId element has its default value of N, it is omitted from the URN, and 1121that the Vocabulary attribute of the ProviderId element is stripped of the 1122substring "urn:" with which it begins. The Vocabulary attribute of ProviderId 1123necessarily begins with the characters "urn:" because, as stated in the 1124comment to the ProviderId element above, it must take the form of a URN 1125identifying a controlled vocabulary. 1126 1127Note that the existence of this URN enables the NewsItem to be referenced 1128unambiguously by pointers from other XML elements or resources. Within such 1129pointers, if the RevisionId, its preceding : character and its following Update 1130qualifier are omitted, then the pointer designates the most recent revision at 1131the time it is resolved. 1132================================================================================ 1133--> 1134<!ELEMENT PublicIdentifier (#PCDATA )> 1135 1136<!-- 1137================================== Relevance =================================== 1138An indication of the relevance of a NewsItem to a given target audience. The 1139value of the FormalName attribute is a formal name for the Relevance. Its 1140meaning and permitted values are determined by a controlled vocabulary as 1141described in the comment to the formalname ENTITY declaration above. 1142================================================================================ 1143--> 1144<!ELEMENT Relevance EMPTY> 1145<!ATTLIST Relevance %localid; 1146 %formalname; 1147 %assignment; > 1148<!-- 1149=================================== Replace ==================================== 1150An instruction to replace a designated element within a NewsItem. The element 1151that is to replace the designated element is the content of the Replace element. 1152The NewsItem within which the replacement takes place is the previous revision 1153of the current one, and the element to be replaced is the one whose Duid 1154value is equal to the value of the Replace element's DuidRef attribute. 1155================================================================================ 1156--> 1157<!ELEMENT Replace ANY> 1158<!ATTLIST Replace %localid; 1159 DuidRef CDATA #REQUIRED > 1160<!-- 1161================================== Resource ==================================== 1162An indication where a given resource can be found, and whether it is to be used 1163as the default vocabulary for certain formal names within the current subtree 1164of a NewsML document. The Urn attribute provides a NewsML URN for the resource. 1165THe Url attribute(s) provide(s) a location or locations where the resource may 1166be found. The DefaultVocabularyFor element contains an XPath pattern. The 1167identified resource acts as default vocabulary for any element within the 1168subtree whose root is the parent of the current Catalog, that matches this XPath 1169pattern. 1170================================================================================ 1171--> 1172<!ELEMENT Resource (Urn? , Url* , DefaultVocabularyFor* )> 1173<!ATTLIST Resource %localid; > 1174<!-- 1175=============================== RevisionHistory ================================ 1176A pointer to a file containing the revision history of the NewsItem. 1177================================================================================ 1178--> 1179<!ELEMENT RevisionHistory EMPTY> 1180<!ATTLIST RevisionHistory %localid; 1181 Href CDATA #REQUIRED > 1182<!-- 1183================================== RevisionId ================================== 1184A positive integer indicating which Revision of a given NewsItem this is. Any 1185positive integer may be used, but it must always be the case that of two 1186instances of a NewsItem that have the same ProviderId, DateId and NewsItemId, 1187the one whose RevisionId has the larger value must be the more recent revision. 1188A RevisionId of 0 is not permitted. The PreviousRevision attribute must be 1189present, and its value must be equal to the content of the RevisionId element 1190of the NewsItem's previous revision, if there is one, and 0 if the NewsItem has 1191no previous revision. If the NewsItem contains an Update element or elements, 1192then the Update attribute must be set to U. If the NewsItem consists only of a 1193replacement set of NewsManagement data, then the Update attribute must be set 1194to A. If neither of these is the case, then the Update attribute must be set 1195to N. 1196================================================================================ 1197--> 1198<!ELEMENT RevisionId (#PCDATA )> 1199<!ATTLIST RevisionId PreviousRevision CDATA #REQUIRED 1200 Update CDATA #REQUIRED > 1201<!-- 1202================================ RevisionStatus ================================ 1203Indicates the status that previous revisions now has as a result of the release 1204of the current revision. The optional Revision attribute is an integer, equal to 1205the RevisionId of the revision in question. If it is not present, then the 1206status applies to ALL previous revisions, without exception. 1207================================================================================ 1208--> 1209<!ELEMENT RevisionStatus (Status )> 1210<!ATTLIST RevisionStatus %localid; 1211 Revision CDATA #IMPLIED > 1212<!-- 1213================================= RightsHolder ================================= 1214A string of text indicating who has the usage rights, optionally enriched with 1215pointers to further information about the relevant people, companies or 1216organisations. 1217================================================================================ 1218--> 1219<!ELEMENT RightsHolder (#PCDATA | Origin )*> 1220<!ATTLIST RightsHolder %localid; 1221 xml:lang CDATA #IMPLIED 1222 %assignment; > 1223<!-- 1224================================== RightsLine ================================== 1225A displayable version of rights information. Note that this is distinct from 1226copyright information. Copyright information is about who owns a news object; 1227rights information is about who is allowed to use it, in what way and under 1228what circumstances. 1229================================================================================ 1230--> 1231<!ELEMENT RightsLine (#PCDATA | Origin )*> 1232<!ATTLIST RightsLine %localid; 1233 xml:lang CDATA #IMPLIED > 1234<!-- 1235================================ RightsMetadata ================================ 1236Information about the rights pertaining to a NewsComponent. 1237================================================================================ 1238--> 1239<!ELEMENT RightsMetadata (Catalog? , Copyright* , UsageRights* , Property* )> 1240<!ATTLIST RightsMetadata %localid; 1241 %assignment; > 1242<!-- 1243===================================== Role ===================================== 1244An identifier of the role played by a NewsComponent within a NewsComponent 1245that contains it. The outermost NewsComponent within a NewsItem need not 1246specify a Role attribute value. The value of the FormalName attribute is a 1247formal name for the Role. Its meaning and permitted values are determined by 1248a controlled vocabulary as described in the comment to the formalname ENTITY 1249declaration above. 1250================================================================================ 1251--> 1252<!ELEMENT Role EMPTY> 1253<!ATTLIST Role %localid; 1254 %formalname; > 1255<!-- 1256=================================== SentFrom =================================== 1257An individual and/or company or organisation from whom the NewsML document is 1258being sent. 1259================================================================================ 1260--> 1261<!ELEMENT SentFrom (%party; )> 1262<!ATTLIST SentFrom %localid; > 1263<!-- 1264==================================== SentTo ==================================== 1265An individual and/or company or organisation to whom the NewsML document is 1266being sent. 1267================================================================================ 1268--> 1269<!ELEMENT SentTo (%party; )> 1270<!ATTLIST SentTo %localid; > 1271<!-- 1272================================== SeriesLine ================================== 1273A displayable version of information about a news object's place in a series. 1274================================================================================ 1275--> 1276<!ELEMENT SeriesLine (#PCDATA | Origin )*> 1277<!ATTLIST SeriesLine %localid; 1278 xml:lang CDATA #IMPLIED > 1279<!-- 1280================================== SizeInBytes ================================= 1281The exact size in bytes of a ContentItem's inline or referenced data object. 1282================================================================================ 1283--> 1284<!ELEMENT SizeInBytes (#PCDATA )> 1285<!ATTLIST SizeInBytes %localid; > 1286<!-- 1287=================================== SlugLine =================================== 1288A string of text, possibly embellished by hyperlinks and/or formatting, used to 1289display a NewsItem's slug line. (Note that the meaning of the term "slug line", 1290and the uses to which it is put, are a matter for individual providers to 1291define within their own workflow and business practice.) 1292================================================================================ 1293--> 1294<!ELEMENT SlugLine (#PCDATA | Origin )*> 1295<!ATTLIST SlugLine %localid; 1296 xml:lang CDATA #IMPLIED > 1297<!-- 1298==================================== Source ==================================== 1299An individual and/or company or organisation that provided source material for 1300a news object. The optional NewsItem attribute must be present in the case of 1301a syndicated NewsItem. It provides the URN of the NewsItem that is being 1302syndicated. Note that a sequence of Source elements can be used to indicate the 1303sequence of syndicators through which a NewsItem has passed. 1304================================================================================ 1305--> 1306<!ELEMENT Source (%party; )> 1307<!ATTLIST Source %localid; 1308 NewsItem CDATA #IMPLIED > 1309<!-- 1310================================== StartDate =================================== 1311A natural-language statement of the date at which specified usage rights come 1312into effect. 1313================================================================================ 1314--> 1315<!ELEMENT StartDate (#PCDATA | Origin )*> 1316<!ATTLIST StartDate %localid; 1317 xml:lang CDATA #IMPLIED 1318 %assignment; > 1319<!-- 1320==================================== Status =================================== 1321An indication of the Status of a NewsItem. The value of the FormalName 1322attribute is a formal name for the Status. Its meaning and permitted values 1323are determined by a controlled vocabulary as described in the comment to the 1324formalname ENTITY declaration above. 1325================================================================================ 1326--> 1327<!ELEMENT Status EMPTY> 1328<!ATTLIST Status %localid; 1329 %formalname; > 1330<!-- 1331=============================== StatusWillChange =============================== 1332Advance notification of a status change that will automatically occur at the 1333specified date and time. For example, an item with a Status of "embargoed" might 1334have a StatusWillChange element stating that the status will become "usable" at 1335a specified time. This is equivalent to announcing in advance the time at which 1336the embargo will end and the item will be released. 1337================================================================================ 1338--> 1339<!ELEMENT StatusWillChange (FutureStatus , DateAndTime )> 1340<!ATTLIST StatusWillChange %localid; > 1341<!-- 1342================================= SubHeadLine ================================== 1343A displayable subsidiary headline. 1344================================================================================ 1345--> 1346<!ELEMENT SubHeadLine (#PCDATA | Origin )*> 1347<!ATTLIST SubHeadLine %localid; 1348 xml:lang CDATA #IMPLIED > 1349<!-- 1350=================================== Subject ==================================== 1351An indication of the Subject of a NewsItem. The value of the FormalName 1352attribute is a formal name for the Subject. Its meaning and permitted values 1353are determined by a controlled vocabulary as described in the comment to the 1354formalname ENTITY declaration above. 1355================================================================================ 1356--> 1357<!ELEMENT Subject EMPTY> 1358<!ATTLIST Subject %localid; 1359 %formalname; 1360 %assignment; > 1361<!-- 1362================================= SubjectCode ================================== 1363A container for the IPTC Subject Codes that indicate the subject of a NewsItem, 1364as defined in the IPTC Information Interchange Model. It consists of one more 1365Subject, SubjectMatter and SubjectDetail elements, optionally amplified by one 1366or more SubjectQualifier elements. 1367================================================================================ 1368--> 1369<!ELEMENT SubjectCode ( (Subject | SubjectMatter | SubjectDetail ) , SubjectQualifier* )*> 1370<!ATTLIST SubjectCode %localid; 1371 %assignment; > 1372<!-- 1373================================ SubjectDetail ================================= 1374An indication of the SubjectDetail of a NewsItem. The value of the FormalName 1375attribute is a formal name for the SubjectDetail. Its meaning and permitted 1376values are determined by a controlled vocabulary as described in the comment 1377to the formalname ENTITY declaration above. 1378================================================================================ 1379--> 1380<!ELEMENT SubjectDetail EMPTY> 1381<!ATTLIST SubjectDetail %localid; 1382 %formalname; 1383 %assignment; > 1384<!-- 1385================================ SubjectMatter ================================= 1386An indication of the SubjectMatter of a NewsItem. The value of the FormalName 1387attribute is a formal name for the SubjectMatter. Its meaning and permitted 1388values are determined by a controlled vocabulary as described in the comment to 1389the formalname ENTITY declaration above. 1390================================================================================ 1391--> 1392<!ELEMENT SubjectMatter EMPTY> 1393<!ATTLIST SubjectMatter %localid; 1394 %formalname; 1395 %assignment; > 1396<!-- 1397=============================== SubjectQualifier =============================== 1398An indication of the SubjectQualifier of a NewsItem. The value of the FormalName 1399attribute is a formal name for the SubjectQualifier. Its meaning and permitted 1400values are determined by a controlled vocabulary as described in the comment to 1401the formalname ENTITY declaration above. 1402================================================================================ 1403--> 1404<!ELEMENT SubjectQualifier EMPTY> 1405<!ATTLIST SubjectQualifier %localid; 1406 %formalname; 1407 %assignment; > 1408<!-- 1409=============================== SystemIdentifier =============================== 1410A system identifier (in the sense defined by the XML 1,0 Specification) for a 1411NewsItem. 1412================================================================================ 1413--> 1414<!ELEMENT SystemIdentifier (#PCDATA )> 1415<!ATTLIST SystemIdentifier %localid; > 1416<!-- 1417============================= ThisRevisionCreated ============================== 1418The date and, optionally, time at which the current revision of a NewsItem was 1419created, expressed in ISO 8601 Basic Format, as described in the comment to the 1420DateAndTime attribute within the assignment ENTITY declaration above. 1421================================================================================ 1422--> 1423<!ELEMENT ThisRevisionCreated (#PCDATA )> 1424<!ATTLIST ThisRevisionCreated %localid; > 1425<!-- 1426==================================== Topic ===================================== 1427This element provides information about a thing (Topic) named by a formal 1428name or occurring in a NewsComponent. A Topic must have one or more TopicType 1429subelements, which state what type of Topic it is. The optional Details 1430attribute provides a pointer, in the form of a URL or URN, to additional 1431information about the Topic. 1432================================================================================ 1433--> 1434<!ELEMENT Topic (Comment* , Catalog? , TopicType+ , FormalName* , Description* , Property* )> 1435<!ATTLIST Topic %localid; 1436 Details CDATA #IMPLIED > 1437<!-- 1438=============================== TopicOccurrence ================================ 1439An indication that a particular topic occurs within the content of a 1440NewsComponent. The optional HowPresent attribute indicates the nature of that 1441topic's occurrence. The value of the Topic attribute must consist of a # 1442character followed by the value of the Duid attribute of a Topic in the current 1443document. 1444================================================================================ 1445--> 1446<!ELEMENT TopicOccurrence EMPTY> 1447<!ATTLIST TopicOccurrence %localid; 1448 %assignment; 1449 Topic CDATA #IMPLIED > 1450<!-- 1451================================== TopicSet ==================================== 1452A container for Topics. The value of the FormalName attribute is a formal name 1453for the TopicSet. Its meaning and permitted values are determined by a 1454controlled vocabulary as described in the comment to the formalname ENTITY 1455declaration above. 1456================================================================================ 1457--> 1458<!ELEMENT TopicSet (Comment* , Catalog? , TopicSetRef* , Topic* )> 1459<!ATTLIST TopicSet %localid; 1460 %formalname; > 1461<!-- 1462================================= TopicSetRef ================================== 1463A pointer to a TopicSet that is to be merged with the current one. The TopicSet 1464attribute is a pointer to the relevant TopicSet. Its value can be an http URL, 1465or a NewsML URN as described in the comment to PublicIdentifier, or a fragment 1466identifier consisting of a # character followed by the Duid of a TopicSet in the 1467current document. The presence of a TopicSetRef child in a TopicSet has the 1468effect that all the Topics in the referenced TopicSet are included by reference 1469within the current TopicSet. When this merging results in there exising two 1470FormalName grandchildren of the same TopicSet that have the same content and 1471the same Scheme attribute value, then the Topics whose children are in fact the 1472same topic, and are deemed to be merged. The merging of Topics need not be 1473performed physically by the system, but the meaning of the data is 1474exactly the same as if the merging were actually performed. Merging two 1475Topcis consists of creating a single Topic that contains all the children of 1476both, and eliminating duplicates. 1477================================================================================ 1478--> 1479<!ELEMENT TopicSetRef (Comment* )> 1480<!ATTLIST TopicSetRef %localid; 1481 TopicSet CDATA #IMPLIED > 1482<!-- 1483================================== TopicType =================================== 1484An indication of the type of a Topic. The value of the FormalName attribute is 1485a formal name for the TopicType. Its meaning and permitted values are determined 1486by a controlled vocabulary as described in the comment to the formalname ENTITY 1487declaration above. 1488================================================================================ 1489--> 1490<!ELEMENT TopicType EMPTY> 1491<!ATTLIST TopicType %localid; 1492 %formalname; > 1493<!-- 1494================================== TopicUse ==================================== 1495An indication of where a particular Topic is used in a NewsML document. The 1496value of the Topic attribute must consist of a # character followed by the 1497value of the Duid of a Topic in the current document. The value of the Context 1498attribute is an XPath pattern indicating the context where the referenced topic 1499is used within the subtree to which the current Catalog applies. If the Context 1500attribute is not present, the TopicUse element simply states that this topic is 1501present somewhere in the subtree. 1502================================================================================ 1503--> 1504<!ELEMENT TopicUse EMPTY> 1505<!ATTLIST TopicUse Topic CDATA #REQUIRED 1506 Context CDATA #IMPLIED > 1507<!-- 1508================================ TransmissionId ================================ 1509An identifier for the NewsML document transmission. This should be unique among 1510all distinct transmissions from the same publisher. If a transmission is 1511repeated (perhaps because the sender is not confident that it was successfully 1512received) then the same TransmissionId content may be used, but a Repeat 1513attribute should be provided to distinguish the second transmission from the 1514first. The form that the value of the Repeat attribute takes is determined by 1515the provider. Likewise, the format for the TransmissionId itself is for the 1516provider to decide. It could for example consist of a channel identifier 1517followed by a sequence number. 1518================================================================================ 1519--> 1520<!ELEMENT TransmissionId (#PCDATA )> 1521<!ATTLIST TransmissionId %localid; 1522 Repeat CDATA #IMPLIED > 1523<!-- 1524==================================== Update ==================================== 1525A modification to an existing NewsItem. This can be an insertion, replacement 1526or deletion. Note that the Update element cannot be used to modify the 1527NewsManagement or Identification element, or any of their descendants. 1528Modifications to these parts of the NewsItem can be made by issuing the 1529NewsItem under the current revision number, with only the Identification and 1530NewsManagement elements present. These will replace the previous Identification 1531and NewsManagement elements in their totality. 1532================================================================================ 1533--> 1534<!ELEMENT Update (InsertBefore | InsertAfter | Replace | Delete )*> 1535<!ATTLIST Update %localid; > 1536<!-- 1537=================================== Urgency ==================================== 1538An indication of the urgency of a NewsItem. The value of the FormalName 1539attribute is a formal name for the Urgency. Its meaning and permitted values 1540are determined by a controlled vocabulary as described in the comment to the 1541formalname ENTITY declaration above. 1542================================================================================ 1543--> 1544<!ELEMENT Urgency EMPTY> 1545<!ATTLIST Urgency %localid; 1546 %formalname; > 1547<!-- 1548===================================== Url ====================================== 1549A URL that can be used to locate a Resource. 1550================================================================================ 1551--> 1552<!ELEMENT Url (#PCDATA )> 1553<!ATTLIST Url %localid; > 1554<!-- 1555===================================== Urn ====================================== 1556A URN that provides a global identifier for a resource. This will typically (but 1557not necessarily) be a NewsML URN as described in the comment to PublicIdentifier. 1558================================================================================ 1559--> 1560<!ELEMENT Urn (#PCDATA )> 1561<!ATTLIST Urn %localid; > 1562<!-- 1563================================= UsageRights ================================== 1564Information about the usage rights pertaining to a NewsComponent. 1565================================================================================ 1566--> 1567<!ELEMENT UsageRights (UsageType? , Geography? , RightsHolder? , Limitations? , StartDate? , EndDate? )> 1568<!ATTLIST UsageRights %localid; 1569 %assignment; > 1570<!-- 1571================================== UsageType =================================== 1572A natural-language indication of the type of usage to which the rights apply. 1573================================================================================ 1574--> 1575<!ELEMENT UsageType (#PCDATA | Origin )*> 1576<!ATTLIST UsageType %localid; 1577 xml:lang CDATA #IMPLIED 1578 %assignment; > 1579