{"type":"doc","content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"1. Introduction","type":"text"}]},{"type":"paragraph","content":[{"text":"One of the most fundamental needs of a news organisation is to handle text. This chapter covers the basics of a simple NewsML-G2 News Item containing text content.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"We recommend reading the ","type":"text"},{"text":"Quick Start Guide to NewsML-G2 Basics","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]},{"text":" before this Quick Start Guide to Text.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"2. Example","type":"text"}]},{"type":"paragraph","content":[{"text":"Below is an example story and supporting information as might be displayed on the journalist’s editing screen at a fictional news provider, Acme News and Media (ANM):","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"9ba2b632-f8fa-49fc-959b-4dcae0e66536"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":2,"rowspan":1,"colwidth":[144.0,476.0]},"content":[{"type":"paragraph","content":[{"text":"Acme News and Media - Content Editing System","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[144.0]},"content":[{"type":"paragraph","content":[{"text":"Slugline","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[476.0]},"content":[{"type":"paragraph","content":[{"text":"US-Finance-Fed","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[144.0]},"content":[{"type":"paragraph","content":[{"text":"Created on","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[476.0]},"content":[{"type":"paragraph","content":[{"text":"2016-11-21 15:21:06","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[144.0]},"content":[{"type":"paragraph","content":[{"text":"Source","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[476.0]},"content":[{"type":"paragraph","content":[{"text":"ANM","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[144.0]},"content":[{"type":"paragraph","content":[{"text":"Author","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[476.0]},"content":[{"type":"paragraph","content":[{"text":"mjameson","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[144.0]},"content":[{"type":"paragraph","content":[{"text":"Latest edit","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[476.0]},"content":[{"type":"paragraph","content":[{"text":"2021-11-21 16:22:45","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[144.0]},"content":[{"type":"paragraph","content":[{"text":"Latest editor","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[476.0]},"content":[{"type":"paragraph","content":[{"text":"moiras","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[144.0]},"content":[{"type":"paragraph","content":[{"text":"Categories","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[476.0]},"content":[{"type":"paragraph","content":[{"text":"economy, finance, business, central bank, monetary policy","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[144.0]},"content":[{"type":"paragraph","content":[{"text":"Headline","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[476.0]},"content":[{"type":"paragraph","content":[{"text":"Fed to halt QE to avert \"bubble\"","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[144.0]},"content":[{"type":"paragraph","content":[{"text":"Byline","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[476.0]},"content":[{"type":"paragraph","content":[{"text":"By Meredith Jameson","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[144.0]},"content":[{"type":"paragraph","content":[{"text":"(Location) Date","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[476.0]},"content":[{"type":"paragraph","content":[{"text":"(Washington) 21/11/2021","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[144.0]},"content":[{"type":"paragraph","content":[{"text":"Body Text","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[476.0]},"content":[{"type":"paragraph","content":[{"text":"Et, sent luptat luptat, commy nim zzriureet vendreetue modo dolenis ex euisis nosto et lan ullandit lum doloreet vulla feugiam coreet, cons eleniam il ute facin veril et aliquis ad minis et lor sum del iriure dit la feugiamcommy nostrud min ullapat velisl duisismodip ero dipit nit utpatum sandrer cipisim nit lortis augiat nulla faccum at am, quam velenis nulput la auguerostrud magna commolore eliquatie exerate facilis modiamconsed dion henisse quipit at..","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"This screen contains nearly all of the information needed to create the NewsML-G2 document below.","type":"text"}]},{"type":"paragraph","content":[{"text":"LISTING: NewsML-G2 Text Document","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"(All Scheme Aliases used in the listing below indicate ","type":"text"},{"text":"IPTC NewsCodes","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.iptc.org/standards/NewsCodes/"}}]},{"text":" vocabularies, except for the following alias values: ex-","type":"text"},{"text":"geoloc, ex-is","type":"text","marks":[{"type":"em"}]},{"text":")","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n \n \n \n \n Acme News and Media LLC\n \n Copyright 2021-22 Acme News and Media LLC\n \n \n \n \n 2021-11-21T16:25:32-05:00\n \n \n \n 2016-11-21T15:21:06-05:00\n 2021-11-21T16:22:45-05:00\n \n New York, NY\n \n \n Meredith Jameson\n \n \n Associated Press\n \n \n \n economy, business and finance\n \n \n central bank\n \n \n money and monetary policy\n \n US-Finance-Fed\n Fed to halt QE to avert \"bubble\"\n \n \n \n \n \n \n \n Fed to halt QE to avert \"bubble\"\n \n By Meredith Jameson, Staff Reporter\n \n \n

(New York, NY - October 21) Et, sent luptat luptat, commy\n Nim zzriureet vendreetue modo\n dolenis ex euisis nosto et lan ullandit lum doloreet vulla\n feugiam coreet, cons eleniam il ute facin veril et aliquis ad\n minis et lor sum del iriure dit la feugiamcommy nostrud min ulla\n autpat velisl duisismodip ero dipit nit utpatum sandrer cipisim\n nit lortis augiat nulla faccum at am, quam velenis nulput la\n auguerostrud magna commolore eliquatie exerate facilis\n modiamconsed dion henisse quipit at. Ut la feu facilla feu\n faccumsan ecte modoloreet ad ex el utat.\n

Ugiating ea feugait utat, venim velent nim quis nulluptat num\n Volorem inci enim dolobor eetuer sendre ercin utpatio dolorpercing\n Et accum nullan voluptat wisis alit dolessim zzrilla commy nonulpu\n tpatinis exer sequatueros adit verit am nonse exerili quismodion\n esto cons dolutpat, si.\n

\n \n \n \n \n \n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"3. Document structure","type":"text"}]},{"type":"paragraph","content":[{"text":"The building blocks of the text document shown above are the ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" root element, with additional wrapping elements for metadata about the News Item (","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":"), metadata about the content (","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":") and the content itself (","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":"). The top level (root) element ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" attributes are:","type":"text"}]},{"type":"codeBlock","content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"This is followed by references to the Catalogs used to resolve QCodes in the Item, and Rights information:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n\n \n Acme News and Media LLC\n \n Copyright 2021-22 Acme News and Media LLC\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3.1. Item Metadata ","type":"text"}]},{"type":"paragraph","content":[{"text":"Note the three mandatory child elements of the mandatory ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Item Class","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Provider","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Version Created","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"A publication status is also mandatory, but the ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" element may be omitted, in which case the publication status defaults to \"usable\". However, it is recommended that the publication status is explicitly given, as in this example. As Acme News & Media is fictional, the Provider property does not use one of the IPTC Provider NewsCodes, and is expressed by a URI:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n \n 2021-11-21T16:25:32-05:00\n \n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3.2. Content Metadata ","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.2.1. Administrative Metadata","type":"text"}]},{"type":"paragraph","content":[{"text":"The administrative properties of the example text story are:","type":"text"}]},{"type":"codeBlock","content":[{"text":" 2016-11-21T15:21:06-05:00\n 2021-11-21T16:22:45-05:00","type":"text"}]},{"type":"paragraph","content":[{"text":"The place that the content was created uses the element:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n New York, NY\n","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" denotes where the story was written, not the place where the subject of the story took place. That would be expressed using ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":", part of Descriptive Metadata described below.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"The author of the article is expressed using the ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" element:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n Meredith Jameson\n","type":"text"}]},{"type":"paragraph","content":[{"text":"The Information Source for the article is also given. When used without a ","type":"text"},{"text":"@role","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" is used to denote the person or party that provided the original information on which the content is based. This is the relationship to be expressed here:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n Associated Press\n","type":"text"}]},{"type":"paragraph","content":[{"text":"The default language for the content is given as U.S. English:","type":"text"}]},{"type":"codeBlock","content":[{"text":"","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.2.2. Descriptive Metadata","type":"text"}]},{"type":"paragraph","content":[{"text":"In the example, the Subject properties use QCodes from the Controlled Vocabulary of ","type":"text"},{"text":"Media Topic NewsCodes","type":"text","marks":[{"type":"link","attrs":{"href":"https://cv.iptc.org/newscodes/mediatopic/"}}]},{"text":" that are owned and maintained by the IPTC and expressed as QCodes. Thus:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n economy, business and finance\n\n\n central bank\n\n\n money and monetary policy\n","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" property contains the value of the \"Slugline\" field of the story:","type":"text"}]},{"type":"codeBlock","content":[{"text":"US-Finance-Fed","type":"text"}]},{"type":"paragraph","content":[{"text":"In a similar fashion, the ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" property will contain the value of the \"Headline\" field:","type":"text"}]},{"type":"codeBlock","content":[{"text":"Fed to halt QE to avert \"bubble\"","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.2.3. Complete Content Metadata","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n 2016-11-21T15:21:06-05:00\n 2021-11-21T16:22:45-05:00\n \n New York, NY\n \n \n Meredith Jameson\n \n \n Associated Press\n \n \n \n economy, business and finance\n \n \n central bank\n \n \n money and monetary policy\n \n US-Finance-Fed\n Fed to halt QE to avert \"bubble\"\n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"4. Text content choices","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.2. Inline XML","type":"text"}]},{"type":"paragraph","content":[{"text":"The content of the NewsML-G2 document is enclosed by the ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" wrapper. In the example, IPTC's news text mark-up language ","type":"text"},{"text":"NITF (News Industry Text Format)","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.iptc.org/standards/NITF/"}}]},{"text":" is used to format the text content. As an XML standard, it is contained in an ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" child element of ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":", and uses ","type":"text"},{"text":"@contenttype","type":"text","marks":[{"type":"code"}]},{"text":" to denote the XML-based standard, using the IANA Media Type.","type":"text"}]},{"type":"paragraph","content":[{"text":"XHTML","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.w3.org/TR/xhtml1/"}}]},{"text":" is also a popular text mark-up choices among NewsML-G2 providers. The contents of ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" may be any XML language that can express generic or specialised news information, including ","type":"text"},{"text":"SportsML-G2","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.iptc.org/standards/sportsml-g2/"}}]},{"text":". Other languages such as XBRL (Extended Business Reporting Language) may also be used. The content inside ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" must be valid XML; in other words, it must be able to stand alone as a valid XML document in its own namespace.","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n \n\n \n\n \n \n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.3. Inline data","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" child element of ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" holds data encoded as a string in the same encoding as the full XML document, for example utf-8. Data not covered by this encoding, such as binary data, must use a special encoding resulting in a text string. In the case of binary data (images, graphics, video, audio etc) we recommend that the ","type":"text"},{"text":"encoding","type":"text","marks":[{"type":"code"}]},{"text":" attribute is used to express the encoding used, and the media type of the data expressed by the ","type":"text"},{"text":"contenttype","type":"text","marks":[{"type":"code"}]},{"text":" attribute, for example “image/jpeg”, “video/quicktime”. We suggest that base64 encoding is used as it can be easily decoded on the receiver side. The ","type":"text"},{"text":"encoding","type":"text","marks":[{"type":"em"}]},{"text":" is expressed using a QCode or IRI, and it is recommended to use the ","type":"text"},{"text":"IPTC Encoding NewsCodes","type":"text","marks":[{"type":"link","attrs":{"href":"http://cv.iptc.org/newscodes/encoding/"}}]},{"text":" (recommended Scheme Alias \"","type":"text"},{"text":"encd","type":"text","marks":[{"type":"code"}]},{"text":"\").","type":"text"}]},{"type":"paragraph","content":[{"text":"Any characters that are not within the definition of ","type":"text"},{"text":"xs:string","type":"text","marks":[{"type":"code"}]},{"text":", such as syntax characters used in HTML, must be escaped or placed within CDATA. and we recommend that the ","type":"text"},{"text":"contenttype","type":"text","marks":[{"type":"code"}]},{"text":" attribute is used (for example “text/plain”, “text/markdown”, “text/html”), but NOT the ","type":"text"},{"text":"encoding","type":"text","marks":[{"type":"code"}]},{"text":" attribute. See below for examples.","type":"text"}]},{"type":"paragraph","content":[{"text":"When encoding binary assets, we recommend that only relatively small objects are conveyed using ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":". Normally the ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" wrapper should be used to convey binary assets.","type":"text"}]},{"type":"table","attrs":{"layout":"wide","localId":"d37c6635-4832-413e-b05a-0f880237d456"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[216.0]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[744.0]},"content":[{"type":"paragraph","content":[{"text":"Definition","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[216.0]},"content":[{"type":"paragraph","content":[{"text":"Simplest example","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[744.0]},"content":[{"type":"codeBlock","content":[{"text":"\n Any text using utf-8 encoding and XML entities such as < or to escape special characters as required.\n","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[216.0]},"content":[{"type":"paragraph","content":[{"text":"Markdown","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[744.0]},"content":[{"type":"codeBlock","content":[{"text":"\n = Heading 1 *Here* is a markdown example. 4 < 5.\n","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[216.0]},"content":[{"type":"paragraph","content":[{"text":"Embedded GIF","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[744.0]},"content":[{"type":"codeBlock","content":[{"text":"6ABC467F324379DE=","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[216.0]},"content":[{"type":"paragraph","content":[{"text":"HTML5 embedded widget","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[744.0]},"content":[{"type":"codeBlock","content":[{"text":"\n ]]>\n","type":"text"}]}]}]}]}],"version":1}