xml:lang в схемах XML документа

Коли використовувати xml:lang

Контент, що безпосередньо пов'язаний з XML документом (або міститься безпосередньо в документі або розглядається як частина документа коли він обробляється або надається) має використовувати атрибут xml:lang для зазначення мови контенту. xml:lang має резервуватися для авторів контенту для безпосереднього позначення будь-якого природного мовного контенту, що вони можуть мати.

xml:lang визначається в XML 1.0 як загальний атрибут, що може використовуватися для визначення мови будь-якого контенту element (елемента). Сюди включається як текст, який можна прочитати, так і інший контент (такий як вбудовані об'єкти, такі як зображення та звукові файли), що міститься в element (елементі) в якому він з'явився. Значення xml:lang приміняється до будь-яких sub-elements, що містяться в element (елементі). Це також приміняється до значень атрибуту, які пов'язані з element та sub-elements (Хоча використання природної мови в атрибутах це не найкраща ідея). Значення атрибуту xml:lang - це language тег, що визначається в BCP 47.

Наприклад, ось xml:lang у element (елементі) t:

<t xml:lang="en"> 
   This is some text contained by the 't' element. The use
   of the xml:lang attribute indicates the language so that, for
   example, the correct font could be applied when rendered or
   the correct spell-checker could be used when proofing the
   document. If we didn't have xml:lang, we might have problems
   with embedded content, such as the phrase <span xml:lang="fr">
   C'est la vie</span>, which is in another language.
</t>

Цей приклад показує, як xml:lang застосовується до атрибуту:

Коли слід використовувати свій власний element (елемент) або attribute (атрибут)

Коли значення мови - насправді є атрибутом або meta даними для деякого зовнішнього контенту, тоді xml:lang не слід використовувати. У цих випадках ви хочете зберегти інформацію про мову, але мова безпосередньо не відноситься до контенту XML документа (або містить такий контент, як зображення, які обробляються як частина документа). У цьому випадку ви повинні визначити елемент або атрибут використовуючи іншу назву і не слід використовувати атрибут xml:lang. Для вибору значення елемента або атрибута слід використовувати BCP 47, так само, як для xml:lang.

Деякі приклади цього можуть включати в себе:

• element (елемент) в XML документі описує вашу колекцію DVD для того, щоб визначити, які мови доступні на звуковій доріжці
• element (елемент) в клієнтській базі даних із полем для мови якій користувач віддає перевагу
• attribute (атрибут) link element (елемента посилання) (такий як a в XHTML), що вказує на написану на іншій мові версію цього документа

Вам слід створити ваш власний element (елемент) (або attribute (атрибут)) тоді, коли є необхідність передати значення мови (як частина структури даних або як meta дані для зовнішнього документу), а не щоб вказати мову конкретної частини контенту. Не використовуйте xml:lang для опису значень зовнішньї мови - це дозволить уникнути створення проблем для авторів контенту, яким необхідно відмічати контент для обробки текстів.

Наприклад, документ XML може виглядати так:

<item type="DVD"> 
  <title xml:lang="fr">Cyrano de Bergerac</title>    
  <!-- indicates the language of the film title -->
  <runningTime value="137" />                        
  <!-- not language affected -->
  <dialogue>en</dialogue>                            
  <!-- indicates the language of the dialogue -->
  <subtitles track="1" language="zh-Hant" />         
  <!-- this track contains Traditional Chinese subtitles -->
  <subtitles track="2" language="zh-Hans" /> 
</item>

У цьому прикладі атрибут xml:lang передає інформацію про природну мову тексту, який з'являється в цьому документі. Елемент dialogue (діалог) та атрибут language (мова) елемента subtitles (підзаголовки) визначені в схемі XML документа і передають значення природної мови, яка з ними пов'язана. Наприклад, він передає інформацію, із subtitles (підзаголовки), що написані на Track (запис) #1 або показані на Традиційній Китайській мові (zh-Hant).