language
========
``iati-organisations/iati-organisation/document-link/language``
This is the reference page for the XML element ``language``.
.. index::
single: language
Definition
~~~~~~~~~~
The ISO 639-1 language code in which target document is written, e.g. "en". Can be repeated to describe multi-lingual documents.
Rules
~~~~~
This element may occur any number of times.
Attributes
~~~~~~~~~~
.. _iati-organisations/iati-organisation/document-link/language/.code:
@code
ISO 639-1 language code
This attribute is required.
This value must be of type xsd:string.
This value should be on the :doc:`Language codelist `.
Example Usage
~~~~~~~~~~~~~
| Example usage of ``language`` of a ``document-link`` in an ``iati-organisation``.
| The ``@language`` attribute declares a valid code (*en*) from the *Language* codelist.
| Note: This specifies the language of the document being linked to.
.. literalinclude:: ../../../organisation-standard-example-annotated.xml
:language: xml
:start-after:
:end-before:
| In some cases, a ``document-link`` may be in multiple languages. This is expressed by repeating the ``language`` element.
.. code-block:: xml
Annual Report 2013
Rapport annuel 2013
Changelog
~~~~~~~~~
2.01
^^^^
Freetext is `no longer allowed `__ within this element.
| In 2.01 this element usage rules were changed, to allow it to be repeated.
1.02
^^^^
Addition of a ``@language`` element as a child of the ``document-link`` element:
document-link/language/text() (0..1) - The ISO 639 code for the language
of the document
Developer tools
~~~~~~~~~~~~~~~
Find the source of this documentation on github:
* `Schema `_
* `Extra Documentation `_