Amaya
Скачати Amaya
Списки листів
Документація
Розробники проекту
Amaya є головним чином інструментом для авторського створення документів з функціями перегляду. Керування посиланнями й можливість
віддаленої публікації є основними функціями гіпертекстового редактора, і ці функції вимагають повної інтеграції функцій редагування й перегляду.
Ви можете скачати дистрибутив Amaya у різних форматах, і для цього ви можете використати або ftp, або http:
Так, пакети dmg доступні:
- amaya-macosx-Version.dmg for PowerPC - PowerBook
- amaya-macintel-9.55-2.dmg for Intel - MacBook
Див. сторінку http://www.w3.org/Amaya/User/BinDist.html
Так, і Ви можете заплатити за неї, за умови, що авторське право зберігається.
Так, ми закликаємо людей до проведення тестів із продуктом Amaya і його поліпшенню. Він навіть може бути використаний у комерційних програмах. Якщо ви вносите поліпшення в даний продукт, ми рекомендуємо Вам звернутися до нас. Ви не можете вносити зміни й при цьому продовжувати називати продукт тією ж торговою маркою або спотворювати інформацю про походження продукту і його можливостей, і відповідальності, пов'язаної з використанням продукту. Ви можете робити обґрунтовані твердження, наприклад, що він заснований на коді Amaya, або що він відповідає Рекомендованій Спецификації W3C.
Мова C має ряд переваг, які чудово відповідають нашим цілям. Це дуже компактна й ефективна мова, Amaya також заснована на вже існуючій
бібліотеці редагування Thotlib, що також написана в C. Цілком логічно продовжувати розвивати код Amaya мовою C.
Значна частина інтерфейсу користувача тепер написана на C++.
Так, Amaya відповідає вимогам Y2K.
За умовчанням Amaya працює з англійською мовою, і супроводжується документацією англійською мовою. Інші діалоги (французький, німецький,
іспанський, португальський, італійський,фінський, російський) і інші версії інтерактивної документації (французької,німецької, іспанської, російської)
також можуть бути закачані й надані користувачам, як описано в розділі http://www.w3.org/Amaya/User/BinDist.html
Елемент Мова Діалогу в діалозі
Edit/Preferences/General визначає мову для всіх меню й повідомлень Amaya. За умовчанням мова «американська
англійська» (в меню позначена як en).
У цей час доступно тільки сім альтернативних мов: англійська (en), французька (fr), німецька (de), італійська (it), іспанська (es), португальська (pt),
і Фінляндії (fi). При запуску, Amaya завантажує файли діалогу відповідно до поточної мови діалогу: en-, fr-, або de-, it-, es-, pt-, або fi файлів,
відповідно. Ці файли діалогу знаходяться у каталозі
Amaya/config.
Спочатку продукт називався Tamaya. Дерево під такою назвою зростало в офісі розробників; воно ж зображено й зараз на логотипі редактора. Але
потім виявилося, що "Tamaya" - торговий знак якоїсь французької компанії. Тому редактор був перейменований в Amaya.
Основна причина полягає в тому, що Amaya не може створити свою тимчасову робочу директорію.
У таблиці, наведеній нижче, показане розташування даного каталогу за умовчанням при використанні різних платформ:
Платформа
|
каталог Amaya
|
Unix and Mac OSX
|
$HOME/.amaya
|
Windows 95/ Windows 98
|
AMAYA-INSTALL-DIR\users\username або, якщо користувач не має акаунта при вході до Windows
AMAYA-INSTALL-DIR\users\default
|
Windows NT/XP
|
$HOMEDRIVE:\$HOMEPATH\amaya
по умовчанню c:\Documents and Settings\$user_name\amaya
|
Якщо зазначеної директорії не існує, вам необохідно вручну прописувати розташування директорії за допомогою глобальної змінної AMAYA_USER_HOME.
Ця змінна повинна вказувати на існуючий і дозволений шлях до директорії, у яку Amaya буде генерувати свої робочі файли й підкаталоги.
Працюючи із платформою Windows вам належить встановити цю змінну в System Properties (або через панель керування в "System" , або через Мій комп'ютер -> Властивості контекстного меню) сторінка "Advanced" – "Змінні оточення". Таким чином, настроювання будуть дійсними для кожного
процесу.
set AMAYA_USER_HOME=C:\Documents and Settings\XX\Amaya
Не залишайте пробіли в імені змінної й значенні, також не використовуйте лапки.
Працюючи із платформами Unix
- У випадку помилки GDK, ви можете спробувати виконати команду "xset
fp", а потім повторіть спробу запустити amaya.
- Якщо всі необхідні для виконуючого файлу динамічні бібліотеки присутні, можна запустити amaya через strace, щоб дізнатися, у чому
саме помилка.
strace /usr/share/Amaya-R.V/wx/bin/amaya
Amaya WX використовує бібліотеку стандартизованих підпрограм і функцій OpenGL для візуалізації сторінок, що дозволяє краще здійснювати
підтримку SVG й анімації. Недоліком є те, що Amaya сильно залежить від драйверів відео карти, якщо драйвер з помилками, є імовірність некоректної
роботи Amaya.
На платформах Unix Amaya іде з бібліотекою Mesa для реалізації базових елементів бібліотеки OpenGL. Mesa - програмна реалізація OpenGL, отже, при
роботі із платформою Unix, Amaya не залежить від драйверів відеокарти. Якщо Amaya не запускається або запускається дуже повільно на платформах
Unix, проблема в чомусь іншому.
На платформах Windows, Amaya використовує апаратну реалізацію OpenGL, тому Amaya дуже залежить від драйверів відео карти Якщо додаток не
запускається або запускається дуже повільно, ми рекомендуємо користувачам перевірити:
- Оновлення драйверів їхньої відеокарти, якщо таке є в наявності. Це оновлення можна знайти або на сайті MicroSoft (див. розділ
«драйвери») або на сайті виробника відеокарти.
- Спробуйте сповільнити апаратне прискорення відео карти:
Panneau
de configuration → Affichage →Paramètres → Avancé →
Dépannage
Так, але в цей час реалізація MathML 2,0 в Amaya ще не остаточна. 2.0. Додаток не реалізовує основну частину MathML 2,0. У документації чітко
вказується, що саме доступно. Див. розділ
"Відомі питання по MathML".
Amaya був побудований як структурований редактор документів. Такий підхід дозволяє йому обробляти складні документи й структуровані об'єкти,
такі як таблиці, графіки або математичні вирази. При редагуванні в HTML й XHML режимах, Amaya працює з деревом документа, а не з його текстовим
уявленням, що створюється тільки в момент збереження документа, у тій синтаксичній структурі, що ви виберете (простий текст, HTML, XHML).
Amaya також дозволяє відкрити вихідний код документа (елемент меню
Views/Show source), а потім редагувати теги. Це робиться в окремому
документі. Amaya показує, яка частина вихідного документа бере участь у редагуванні синхронного документа й навпаки. Обидва - вихідний документ і
відформатований документ – можуть редагуватися. Зміни, зроблені в кожному із цих двох документів, відображаються в іншій за допомогою команди
File/Synchronize. Синхронізація також здійснюється автоматично, при перегляді змін.
За допомогою Amaya можна збільшити й зменшувати зображення, вікно за вікном. Таким чином, кожен документ у вікні зміненого маштабу буде
відображатися більше або менше свого нормального розміру залежно від коефіцієнта зміни маштаба. Цей коефіцієнт зміни маштаба діє на всі типи
відображеної інформації (шрифти, зображення й т.д.). Команди, які змінюють коефіцієнт зміни маштабу, знаходяться у меню Views.
Меню The Edit/Preferences/General дозволяє змінити тільки розмір шрифту. За умовчанням, коефіцієнт зміни маштабу шрифту дорівнює 100% (документи відображаються в реальному розмірі). Цей коефіцієнт зміни маштабу впливає тільки на розмір шрифту, але не на інші елементи
(зображення й т.д.)
Для того, щоб мати можливість вибирати шрифти, Amaya працює з файлом настроювання шрифтів (Font Configuration file за умовчанням цей
файл знаходиться в директорії
Amaya/config/:
- Файл
"fonts.gl.mac" використовується при роботі Amaya на платформі Mac OSX
- Файл
"fonts.gl" використовується при роботі Amaya під ОС Windows й Linux OpenGL
- Файл
"fonts.gl.win" використовується при роботі Amaya під ОС Windows
Додаткову інформацію про ці файли налаштування, див. на http://www.w3.org/Amaya/User/FontConfig.html
Версії Amaya WX
AmayaWX працює тільки з шрифтами TrueType. Дистрибутив Amaya поставляється з набором шрифтів Esstix (великий набір математичних символів)
і набором безкоштовних шрифтів. При запуску Amaya спочатку запитує попередньо встановлені системні шрифти й використовує свої власні шрифти,
якщо попередньо встановлених шрифтів немає.
На платформах Unix, AmayaWX використовує для необхідних шрифтів три конфігураційних файли: Amaya/config/fonts.gl,
Amaya/config/fonts.gl.rd, и
Amaya/config/fonts.gl.deb.
AmayaWX використовує один конфігураційний файл
Amaya/config/fonts.gl.win.
Версії Amaya GTK
Amaya GTK работает с X Font Server (Xft). Деякі системні дистрибутиви поставляються з попередньо встановленими шрифтами або пакетами шрифтів, що встановлюються автоматично. Деякі інші шрифти повинні встановлюватися вручну.
Якщо вам потрібно самим установити шрифти на платформі Linux, то вам належить:
- Розархівувати та / або скачати шрифти й установити їх в
/usr/local/share/fonts або
/usr/X11R6/lib/X11/fonts
- Установити їх за допомогою команди "
unzip esstix.zip". Рекомендується встановлювати їх у каталог
/usr/local/share/fonts/esstix
- Додати ці нові шрифти в конфігураційний файл Xft:
/etc/X11/XftConfig
...
dir "/usr/local/share/fonts/XXX"
- Додати цей новий каталог шрифтів у список каталогів праворуч
/etc/X11/fs/config
Ось приклад:
catalogue = /usr/local/share/fonts/truetype,
/usr/lib/X11/fonts/misc,
/usr/lib/X11/fonts/cyrillic,
/usr/lib/X11/fonts/75dpi/:unscaled,
/usr/lib/X11/fonts/100dpi/:unscaled,
/usr/X11R6/lib/X11/fonts/misc:unscaled,
/usr/lib/X11/fonts/URW,
/usr/lib/X11/fonts/Type1,
/usr/lib/X11/fonts/CID,
/usr/lib/X11/fonts/Speedo,
/usr/lib/X11/fonts/75dpi,
/usr/lib/X11/fonts/100dpi,
/usr/local/share/fonts/esstix,
/usr/local/share/fonts/japanese
- Потім створіть дескриптори файлу fonts.scale, fonts.dir й XftCache як показано нижче:
fonts.scale,
fonts.dir and XftCache як показано нижче:
cd /usr/local/share/fonts/XXX
ttmkfdir -o fonts.scale
mkfontdir
xftcache
- Перезавантажте або запустіть знову сервер шрифтів.
Шрифти Esstix
Шрифти Esstix доступні (ми надаємо файл esstix.tar.gz) по посиланню
ftp://ftp.elsevier.nl/pub/styles/esstix/esstix.zipesstix.tar.gz
.
- Скачати файл із шрифтами Esstix esstix.tar.gz
file
- Установити їх за допомогою команди "
unzip esstix.zip" або
"tar xzf esstix.tar.gz". Ми рекомендуємо встановлювати їх у каталог /usr/local/share/fonts/esstix
- Додати цей новий каталог шрифтів у файл конфігурації Xft:
/etc/X11/XftConfig
...
dir "/usr/local/share/fonts/esstix"
- Потім створити дескриптори файлу:
fonts.scale,
fonts.dir and XftCache в такий спосіб:
cd /usr/local/share/fonts/esstix
ttmkfdir -c -m20 -o fonts.scale
mkfontdir
xftcache
- Перезавантажити або запустити знову сервер шрифтів.
Версії Amaya Win32
Встановлення шрифтів Esstix на платформі Windows
- Скачати шрифти Esstix (ми надаємо файл ESSTIX.zip
file)
- розпакувати вміст цього файлу
- ККопіювати шрифти з каталогу ESSTIX у каталог C:\WINDOWS\Fonts.
Змініть розмір вашого вікна до необхідного вам розміру, а потім використайте меню
Edit/Preferences/Geometry, щоб зберегти поточну форму
відображуваних вікон. Ваші зміни збережуться при наступному оновленні Amaya.
Ви також можете встановити автоматичне збереження даних параметрів вікна при виході в меню
Edit/Preferences/General menu.
Редактор Amaya не може бути використаний для перевірки коректності HTML сторінок. Браузер приймає як коректні, так і некоректні документи
HTML і намагається динамічно виправити помилки. Наприклад, він дозволяє додати відсутні кінцеві теги й перемістити елементи на потрібні позиції.
При розборі XHTML документа Amaya перевіряє його на правильність структури й зупиняється, як тільки зустрічає помилку, в цьому випадку,
Amaya видає вікно попередження про те, що документ некоректний.
В обох випадках (HTML й XHTML документів), коли Amaya знаходить теги й атрибути, невідому або будь-яку іншу помилку, редактор створює
лог файл, який можна переглянути командою FileShow parsing errors.
Браузеру - редактору Amaya доводиться працювати з існуючими HTML сторінками, і далеко не всі з них відповідають стандарту HTML DTD
(Document Type Definition). При проектуванні Амайя, ми зіткнулися з важким вибором:
- У цьому випадку більшість користувачів будуть розчаровані неможливістю побачити більшість Web сторінок, які, проте, відображаються в інших web клієнтах.
- Приймати некоректно створені сторінки й дозволяти редактору Amaya виправляти найпоширеніші помилки.
Ми вибрали другий варіант і вирішили, що редактору Amaya варто намагатися виправляти помилки, але без втрати інформації. Якщо елемент не є
коректним у даному контексті, Amaya намагається змінити структуру в певному місці таким чином, щоб зробити даний елемент коректним, однак,
редактор не видаляє й не переміщає елемент в інше місце, що може змінити зміст документа.
Питання полягає в тому, що стандарт DTD визначає тільки структуру класу документа, але не його семантику. При роботі з некоректним документом, як правило, існує кілька способів перетворити його структуру й зробити його правильним, але будь-яке перетворення може мати різний вплив на семантику документа. Стандарт DTD не дозволяє вам вибирати правильні перетворення.
Інше важливе проектне рішення, що було реалізовано в Amaya, полягає в тім, що, навіть якщо редактор і приймає некоректні документи, то
структура й розмітка залишаються коректними. Очевидно, що тут розглядаються тільки елементи, які створені або змінені. Деякі некоректні частини вихідного документа можуть залишатися, при збереженні документа.
Наведені вище зауваження стосуються тільки HTML документів. До XHTML документів Amaya застосовує жорсткі вимоги, редактор зупиняє розбір документа при виявленні формальної помилки. Мотивація - допомогти XHTML розгортатися вірним способом. Документів по підтримці немає.
Назва документа, як і будь-який інший заголовний елемент, може редагуватися в структурі цього документа. Ви також можете використати діалог
XHTML/Change Title.
Якщо курсор знаходиться наприкінці елемента формату <pre> натисніть Enter і створіть новий рядок елемента <pre>. Щоб створити ще один елемент, наприклад, параграф після елемент <pre>, ви можете використати меню XHTML і вибрати тип елемента, що ви бажаєте створити.
Інший спосіб зробити теж саме: потрібно виділити весь елемент
<pre> із клавішею ESC (Linux) або клавішею F2 (Windows) і натиснути Enter. Таким чином, ви створите новий параграф після елемента
<pre>.
Також й у таблиці: виділіть всю таблицю й натисніть Enter, щоб створити новий параграф після таблиці, також можна вийти з таблиці, натиснувши Enter, коли курсор поза таблицею.
Фрейми створюють безліч проблем для моделі Інтернет, наприклад, стандартні URL адреси можуть лише вказувати на фрейм або набір фреймів.
Посилання та / або кнопка "Назад" можуть видавати невірні результати. Вони також є причиною неприємностей для людей з обмеженими
можливостями й роблять редагування більш складним. На жаль, фрейми не скасовані, і деякі люди продовжують ними користуватися. Ми не
рекомендуємо їхнє використання.
У зв'язку з нестачею ресурсів, ми не плануємо реалізацію даних функцій. Вони набагато більш важливі для браузера, ніж для редактора.
XHML документи повинні бути правильно сформовані, у чому немає необхідності у випадку з HTML документами. Як тільки синтаксичний аналізатор
XML Expat, що використовується редактором Amaya, виявляє помилку в коді XHTML, він видає попередження об повідомлення у файл "Parsing
Errors" і зупиняється аналіз документа.
Найпоширеніші помилки:
- Опис документа не погоджений: не розпізнається тип документа або простір імен.
- Відсутній закриваючий тег або початковий тег порожнього елемента не містить останнього символу "/".
- Значення атрибута не поміщено в лапки.
- Документ містить символи, які не відповідають набору символів (кодуванню) документа.
Ми рекомендуємо оголошувати набір символів своїх документів. Він може бути оголошений або в xml описі, і / або в
позначці елементу XHTML документів (див. приклад нижче).
<?xml version="1.0" encoding="iso-8859-1"?>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
....
</head>
Тому що набір символів, що використовується за умовчанням, відрізняється для HTML й XHTML документів, то часто трапляється,
що автори створюють XHTML документи із стандартним набором символом ISO-latin-1[10], які не містять інформації про набір
символів. У випадку якщо символ, проаналізований синтаксичним аналізатором XML, не відповідає певному символу в коді UTF-8
(це відбудеться, якщо документ йде в кодуванні ISO-latin-1 , але перевіряється як файл UTF 8), то документ вважається
некоректним: розбір припиняється й виводиться повідомлення про помилку
У даному конкретному випадку, Ви можете спробувати заново відкрити документ в іншому кодуванні, ISO-8859-1 або набором інших
символів через меню
File>Force a Character Coding.
Коли XHTML документ сформований неправильно, редактор Amaya пропонує прочитати його як простий HTML файл. After. Після
цього ви зможете знову зберегти його як XHTML файл за допомогою команди Save As.
Підтримка кодової таблиці Unicode ще не повністю реалізована. Залежно від наявних на вашому комп'ютері шрифтів, деякі символи
можуть відображатися, або не відображатися. Недоступні символи відображаються як невеликі квадратики.
Редактор Amaya підтримує каскадні таблиці стилів (CSS), однак реалізація даної функції ще не завершена. Багато видів
дешифраторів і властивості стилів уже доступні. Кожна версія додає нові функції CSS. Перевірте поточний статус впровадження CSS в останній версії.
Amaya підтримує віддалені публікації з використанням технології HTTP PUT. На сьогоднішній день Amaya не можете завантажувати
файли, використовуючи FTP. Якщо ви використовуєте сервер Apache, ви можете використати модуль mod_put для підтримки технології PUT.
модуль mod_put не працює із сервером Apache 2, тому вам доведеться встановити й активувати модуль WebDav:
Щоб запустити mod_dav, додайте у ваш файл httpd.conf наступне:
<Directory />
Dav On
....
</Directory>
Це активує провайдер файлової системи DAV, що реалізований модулем
mod_dav_fs.
Отже, цей модуль повинен бути скомпільований
на сервері або завантажений під час виконання програми за допомогою директиви
LoadModule
directive.
Крім того, розташування для бази даних DAV повинно бути зазначене в загальному розділі вашого файлу httpd.conf, з використанням
директиви DavLockDB
directive:
....
# це конфігурація, що ми намагаємося опублікувати на web сервері
# вам належить ретельно переконатися в тім, що ваш сервер захищений, перш ніж використати mod_dav.
<IfModule mod_dav_fs.c>
# Location of the WebDAV lock database.
DAVLockDB /var/lib/dav/lockdb
DAVMinTimeout 600
</IfModule>
....
Більше докладну інформацію шукайте в документації по серверу Apache
(/var/www/manual/mod/mod_dav.html.en)
Редактор Amaya надає функцію $Date.. При збереженні файлу Amaya вставляє поточну дату скрізь, де виявляє текст "date:" між
двома символами '$' або спеціальними ремарками. Пункт меню XHTML/Insert time stamp дозволяє генерувати цю дату на поточній
позиції в документі.
Формат з дати залежить від змінної конфігурації Amaya.
ISO_DATE=Yes (за умовчанням) створює "YYYY-MM-DD"
YYYY = рік як десяткове число, включаючи сторіччя.
MM = місяць як десяткове число (у діапазоні від 01 до 12).
DD = День місяця як десяткове число (у діапазоні від 01 до 31).
ISO_DATE=No генерує "DD-MM-YYYY"
DD = День місяця як десяткове число (у діапазоні від 01 до 31).
MM = місяць як десяткове число (у діапазоні від 01 до 12).
YYYY = рік як десяткове число, включаючи сторіччя.
Тим, хто бажає розширювати або змінити додаток Amaya, варто прочитати наступну документаціюю:
Ця помилка виникає, коли забувають створити об'єкт subtree до початку процесу конфігурування. Як пояснено на сторінці Autoconf page, вам потрібно створити спочатку subtree (obj або будь-яке інше ім'я) для коду об'єкта й запустити конфігурацію для створення Makefile(s):
cd Amaya
mkdir obj
cd obj
../configure
До компіляторів Thot потрібен процесор попередньої обробки cpp:
- Якщо ви використовуєте інструменти GNU, у процесі зміни параметрів варто посилатися на компілятор gcc з вірними
опціями. Ви можете перевірити, що файл Options параметр) містить наступне визначення:
CPP = gcc -E -x c
- В інших випадках ви повинні переконатися в наявності процесора попередньої обробки cpp
в PATH.
Останні версії Amaya цілком сумісні з GTK, однак, наприклад, для стандарту на графічний інтерфейс користувача Motif, вам необхідно
встановити деякі конкретні бібліотеки для можливості компіляції Амайя.
У зв'язку зі спільною поставкою з розповсюдженим сьогодні оточенням Gnome, ваш дистрибутив, безумовно, буде включати дані
бібліотеки:
| Назва бібліотеки |
Debian |
Mandrake, Redhat or Suse |
| libglib1.2 |
libglib1.2_1.2.x_i386.deb |
glib-1.2.x-1.i386.rpm |
| libgtk1.2 |
libgtk1.2_1.2.x-1_i386.deb |
gtk+-1.2.x-1.i386.rpm |
Якщо ви хочете переконатися в тім, що бібліотеки встановлені, виконайте наступні команди оболонки:
#locate libgtk
#locate libglib
Запустивши одного разу необхідні вам бібліотеки, вам буде потрібен розширений пакет, що містить заголовки й статичні бібліотеки.
| Назва бібліотеки |
Debian |
Mandrake, Redhat or Suse |
| libglib1.2-devel |
libglib1.2-devel.x_i386.deb |
glib-1.2-devel..x-1.i386.rpm |
| libglib1.2-devel |
libgtk1.2-devel.x_i386.deb |
gtk+-1.2-devel..x-1.i386.rpm |
Якщо ви хочете перевірити, чи він встановлений, спробуйте наступні команди оболонки:
#locate gtk.h
#locate glib.h
Не намагайтеся зібрати або запустити програму з версією GTK1,3, вона не буде працювати (поки ви не перенесете Amya на GTK 2.0).
Точно виконуйте інструкції HowTo щоб зібрати Amaya з конфігураційною опцією
--with-gtk.
Де можна отримати ці бібліотеки?
Деякі платформи можуть мати різні варіанти інструментів autoconf й libtool. Якщо ви отримуєте повідомлення типу:
libtool: версія ltconfig ' не відповідає версії version '1.3.4'
Fatal configuration error. See the libtool docs for more information.
Спробуйте виконати наступні команди в каталогах Amaya й
libwww:
aclocal \
&& libtoolize --force --copy \
&& automake --foreign --force-missing --add-missing --copy \
&& autoconf
Дякуємо Максиму Захарову за надану інформацію.
Імовірно, що версія оболонки, що виконує ваші команди, давно не оновлювалася. Спробуйте використати замість неї bash, за
допомогою запуску наступної команди в директорії компіляції:
make SHELL=/path/to/your/bash
Irиne Vatton
Date: 2007-09-11
employee drug testing |
marijuana drug test |
home drug test kits |
drug testing kits