language

iati-organisations/iati-organisation/document-link/language

This is the reference page for the XML element 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

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.
 <document-link format="application/vnd.oasis.opendocument.text" url="http://www.example.org/docs/report_en.odt">
  <title>
    <narrative>Annual Report 2013</narrative>
    <narrative xml:lang="fr">Rapport annuel 2013</narrative>
   </title>
   <category code="B01" />
   <language code="en" />
   <document-date iso-date="2014-02-05" />
   <recipient-country code="AF" />
  </document-link>
In some cases, a document-link may be in multiple languages. This is expressed by repeating the language element.
<document-link format="application/vnd.oasis.opendocument.text" url="http:www.example.org/docs/report.odt">
        <title>
                <narrative>Annual Report 2013</narrative>
                <narrative xml:lang="fr">Rapport annuel 2013</narrative>
        </title>
        <category code="B01" />
        <language code="en" />
        <language code="fr" />
</document-link>

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: