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.

The time between recipient-country-budget/period-start/@iso-date and recipient-country-budget/period-end/@iso-date must not be over a year

The time between recipient-org-budget/period-start/@iso-date and recipient-org-budget/period-end/@iso-date must not be over a year

@xml-lang must exist, otherwise all lang must exist.

@default-currency must exist, otherwise all currency must exist.

Attributes¶

@code

ISO 639-1 language code

This attribute is required.

This value must be of type xsd:string.

This value should be on the Language codelist.

The time between recipient-country-budget/period-start/@iso-date and recipient-country-budget/period-end/@iso-date must not be over a year

The time between recipient-org-budget/period-start/@iso-date and recipient-org-budget/period-end/@iso-date must not be over a year

@xml-lang must exist, otherwise all lang must exist.

@default-currency must exist, otherwise all currency must exist.

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" />
   <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: