narrative
=========
``iati-organisations/iati-organisation/recipient-region-budget/recipient-region/narrative``
This is the reference page for the XML element ``narrative``.
.. index::
single: narrative
Definition
~~~~~~~~~~
The free text name or description of the item being described. This can
be repeated in multiple languages.
Rules
~~~~~
The text in this element must be of type xsd:string.
This element may occur any number of times.
Attributes
~~~~~~~~~~
.. _iati-organisations/iati-organisation/recipient-region-budget/recipient-region/narrative/.xml:lang:
@xml:lang
A code specifying the language of text in this element. It is recommended that wherever possible only codes from ISO 639-1 are used. If not present, the default language is assumed.
This value should be on the :doc:`Language codelist `.
Example Usage
~~~~~~~~~~~~~
The ``narrative`` child element can be used to declare freetext for the ``recipient-region`` element.
| Note: Both the ``recipient-region`` and ``recipient-country`` elements still allow both a ``@code`` and descriptive text to be specified. This is to cover the isolated cases where the organisation publishing the data may not agree with name of a country or region given by the lookup codelists IATI uses. Example in the case of a ``recipient-region`` element:
.. code-block:: xml
Middle East, regional (As per WHO Eastern Mediterranean Region)
| The ``narrative`` element can be repeated for any language additional to the default language set in ``iati-activity``, by using the ``@xml:lang`` attribute. Example not shown.
Changelog
~~~~~~~~~
2.02
^^^^
The optional ``recipient-region-budget`` element was `added `__.
Developer tools
~~~~~~~~~~~~~~~
Find the source of this documentation on github:
* `Schema `_
* `Extra Documentation `_