Документация

Даний документ є перекладом статті «Amaya Documentation».
Оригінальна версія документа існує тільки на сайті W3C http://www.w3.org/Amaya/User/Overview.html
Даний переклад НЕ є офіційним документом W3C.
Всі Авторські Права Належать W3C.
Даний документ може містити помилки перекладу.

Супровідна документація цього релізу поки не закінчена, однак, її повинно бути достатньо для того, щоб зрозуміти, як використати й конфігурувати Amaya. Крім того, для розробників також доступна деяка документація.

Використання Amaya

• Посібник користувача по Amaya ((pdf формат).
• Презентація продукту Amaya і його основних характеристик у замітках W3C "Вступ до Amaya".
• Опис поточного стану реалізації каскадних стилів в Amaya.
• Примітка по використанню проксі з Amaya.
• Примітка по налагодженню Вашого WWW сервера на використання метода PUT.
• Шаблони які були введені в Amaya (ще в розробці)

Компіляція Amaya

Для тих, хто бажає перенести Amaya на нову платформу або адаптувати її до своїх потреб, є документ, що пояснює:

Як зібрати Amaya на платформах Unix з розподілених джерел коду.

Зборка Amaya на PC / Windows платформах має відмінності. Для більш докладної інформації про те, як скомпілювати й установити Amaya, див. Зборка Amaya під Windows NT.

Трансляція діалогів Amaya

Текст меню, діалогових вікон і повідомлень зберігаються у файлах, розташованих в Amaya/config directory: хх - amayadialogue, хх - amayamsg і хх - libdialogue, де хх являє собою код обраної мови (en, fr, etc). Всі ці файли створені Perl скриптом, стосовно до наступних трьох xml файлів:

1. елементи меню (base_am_dia.xml)
2. повідомлення і діалогові вікна amaya (base-am_msg.xml)
3. повідомлення і діалогові вікна бібліотеки thotlib thotlib (base_am_lib.xml)

Кращий спосіб додати нову мову, це відправити нам нову копію цих трьох файлів, з новою декларацією <language> в розділі <control>, а також новий запис <message> для кожного <label>.

Якщо у вас є доступ до бази CVS Amaya, Perl скрипт наступний: Amaya/tools/xmldialogues/scripts/Am_dial_managment.pl

Для розробників

Тим, хто бажає розширити або змінити Amaya, варто прочитати наступну документацію:

• Загальний огляд архітектури Amaya.
• Руководство Thot API пояснює, яким чином працює Thotlib. А також наводить список доступних функцій
• Посібник по додатку Thot пояснює, як створювати меню, а також механізм подій Thot.
• В посібнику з мови Thot наводиться синтаксис S, P й T мов.
• Сторінка Amaya-dev.html надає умовні позначки для написання коду в Thotlib й Amaya.

Продукт Amaya заснований на результатах досліджень функціонування движка Thot, проведених в INRIA.

Публікації

Деякі статті про Amaya були опубліковані в наукових журналах і конференціях:

• Techniques for Authoring Complex XML Documents (html, pdf формати), Вінсент Кінт, Ірен Ваттон,, DocEng 2004, ACM Symposium on Document Engineering
• Towards Active Web Clients (html, pdf), Вінсент Кінт, Ірен Ваттон, DocEng 2005, ACM Symposium on Document Engineering
• Templates, Microformats and Structured Editing pdf, html), Кампой Флорес, В. Кінт, І. Ваттон, DocEng 2006, ACM Symposium on Document Engineering