W3C Amaya Using

Amaya Аб Amaya

INSTALL Спампаваць Amaya

Mail Мэйл лісты

Documentation Дакументацыя

People Распрацоўнікі праекту

Дадзены дакумент з'яўляецца перакладам артыкула "Amaya Frequently Asked Questions".
Арыгінальная версія якога існуе толькі на сайце W3C http://www.w3.org/Amaya/User/FAQ.html
Дадзены пераклад не з'яўляецца афіцыйным дакументам W3C.
Усе Аўтарскія Правы Належаць W3C.
Дадзены дакумент можа ўтрымоўваць памылкі перакладу і памылкі друку.

Documentation Amaya - часта зададзеныя пытанні

I. Агульныя пытанні

  1. Amaya - гэта рэдактар або браўзэр?
  2. Дзе можна знайсці Amaya?
  3. Ці даступны прадукт Amaya для MacOS?
  4. Ці можна знайсці Amaya на CD-ROM?
  5. Ці можна ўносіць у Amaya некаторыя змены?
  6. Чаму рэдактар Amaya напісаны на мове C?
  7. Ці адпавядае Amaya патрабаванням Y2K?
  8. Ці можна змяніць мову дыялогу?
  9. Што азначае слова "Amaya"?

II. Выкарыстанне Amaya

  1. Amaya не запускаецца. Што можна зрабіць?
  2. AmayaWX не запускаецца або запускаецца вельмі павольна.
  3. Ці падтрымлівае Amaya MathML?
  4. Ці можна рэдагаваць тэгі?
  5. Шрыфты занадта малыя. Што можна зрабіць?
  6. Як змяніць шрыфты?
  7. Ці можна атрымаць шрыфты Amaya?
  8. Як змяніць памер акна, усталяваны па змаўчанні?
  9. Ці можна ўбачыць спіс памылак, выяўленых Amaya?
  10. Які чыннік адсутнасці цвёрдых патрабаванняў да прытрымлівання структуры?
  11. Як мага абнавіць назоў дакумента?
  12. Як выйсці з <pre> або табліцы?
  13. Чаму Amaya не падтрымлівае фрэймы?
  14. Ці падтрымлівае Amaya JavaScript і аніміраваныя малюнкі?
  15. Amaya не распазнае XHTML, MathML, або SVG дакументы!
  16. Ці падтрымлівае Amaya не лацінскія знакі?
  17. Ці можна выкарыстаць CSS стылі?
  18. Як мага выдалена публікаваць дакументы?
  19. Як кантраляваць фармат даты?

III. Кампіляцыя Amaya

  1. Дзе можна атрымаць дакументацыю для распрацоўнікаў?
  2. Паведамленне аб адсутных файлах
  3. Збой пры кампіляцыі схемы HTML
  4. Што трэба для кампіляцыі з GTK?
  5. Праблемы з ltconfig (або libtool)
  6. Паведамленне пры тэставанні "тэст: патрабуецца пераменная"


I.1. Is Amaya - гэта рэдактар або браўзэр?

Amaya з'яўляецца галоўнай выявай прыладай для аўтарскага стварэння дакументаў з функцыямі прагляду. Кіраванне спасылкамі і магчымасць выдаленай публікацыі з'яўляюцца асноўнымі функцыямі гіпертэкставага рэдактара, і гэтыя функцыі патрабуюць поўнай інтэграцыі функцый рэдагавання і прагляду.


I.2. Дзе можна знайсці Amaya?

Вы можаце спампаваць дыстрыбутыў Amaya у розных фарматах, і для гэтага вы можаце выкарыстаць альбо ftp, альбо http:


I.3. Ці даступны прадукт Amaya для MacOS?

Так, пакеты dmg даступны:

Гл. старонку http://www.w3.org/Amaya/User/BinDist.html


I.4. Ці можна знайсці Amaya на CD-ROM?

Так, і Вы можаце заплаціць за яе, пры ўмове, што аўтарскае права захоўваецца.


I.5. Ці можна ўносіць у Amaya некаторыя змены?

Так, мы заклікаем людзей да правядзення тэстаў з прадуктам Amaya і яго паляпшэнню. Ён нават можа быць скарыстаны ў камерцыйных праграмах. Калі вы ўносіце паляпшэнні ў дадзены прадукт, мы рэкамендуем Вам звярнуцца да нас. Вы не можаце ўносіць змены і пры гэтым працягваць зваць прадукт той жа гандлёвай мазлівай або скажаць інфармацыі аб паходжанні прадукта і яго магчымасцях, і адказнасці, звязанай з выкарыстаннем прадукта. Вы можаце рабіць абгрунтаваныя сцвярджэнні, напрыклад, што ён заснаваны на кодзе Amaya, або што ён адпавядае Рэкамендуемай Спецыфікацыі W3C.


I.6.Чаму рэдактар Amaya напісаны на мове C?

Мова C мае шэраг пераваг, якія выдатна адпавядаюць нашым мэтам. Гэта вельмі кампактная і эфектыўная мова. Amaya таксама заснаваная на ўжо наяўнай бібліятэцы рэдагавання Thotlib, якая таксама напісаная ў C. Цалкам лагічна працягваць развіваць код Amaya на мове C.

Значная частка карыстацкага інтэрфейсу зараз напісана на C++.


I.7. Ці адпавядае Amaya патрабаванням Y2K?

Так, Amaya задавальняе патрабаванням Y2K.


1.8. Ці можна змяніць мову дыялогу?

Па змаўчанні 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.


1.9. Што азначае слова "Amaya"?

Спачатку прадукт зваўся Tamaya. Дрэва пад такім назовам расло ў офісе распрацоўнікаў; яно жа намалявана па гэтай дзень на лагатыпе рэдактара. Але потым апынулася, што "Tamaya" - гандлёвы знак нейкай французскай кампаніі. Таму рэдактар быў пераназваны ў Amaya.


II.1. Amaya не запускаецца. Што можна зрабіць?

Асноўны чыннік складаецца ў тым, што Amaya не можа стварыць сваю часовую працоўную дырэкторыю.

У табліцы, прыведзенай ніжэй, паказана размяшчэнне дадзенага каталога па змаўчанні пры выкарыстанні розных платформ:

Платформа

каталог Amaya

Unix and Mac OSX

$HOME/.amaya

Windows 95/ Windows 98

AMAYA-INSTALL-DIR\users\username or, if the user didn't login to Windows, AMAYA-INSTALL-DIR\users\default

Windows NT/XP

$HOMEDRIVE:\$HOMEPATH\amaya
by default 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

  1. У выпадку памылкі GDK, вы можаце паспрабаваць выканаць каманду "xset fp" а затым паспрабуйце запусціць amaya.
  2. # Калі ўсё неабходныя для выконваемага файла дынамічныя бібліятэкі прысутнічаюць, можна запусціць amaya праз strace, каб пазнаць, у чым менавіта памылка
    strace /usr/share/Amaya-R.V/wx/bin/amaya


II.2. AmayaWX не запускаецца або запускаецца вельмі павольна.

Amaya WX выкарыстоўвае бібліятэку стандартызаваных падпраграм і функцый OpenGL для візуалізацыі старонак, што дазваляе лепш здзяйсняць падтрымку SVG і анімацыі. Недахопам з'яўляецца тое, што Amaya моцна залежыць ад драйвераў відэа карты, калі драйвер з памылкамі, ёсць верагоднасць некарэктнай працы Amaya.

На платформах Unix Amaya ідзе з бібліятэкай Mesa для рэалізацыі базавых элементаў бібліятэкі OpenGL. Mesa - праграмная рэалізацыя OpenGL, такім чынам, пры працы з платформай Unix, Amaya не залежыць ад драйвераў відэакарты. Калі Amaya не запускаецца або запускаецца вельмі павольна на платформах Unix, праблема ў чымсьці сябрам.

На платформах Windows, Amaya выкарыстае апаратную рэалізацыю OpenGL, таму Amaya вельмі залежыць ад драйвераў відэа карты. Калі прыкладанне не запускаецца або запускаецца вельмі павольна, мы рэкамендуем карыстачам праверыць:

  1. Абнаўленне драйвераў іх відэакарты, калі такое ёсць у наяўнасці. Гэтае абнаўленне можна знайсці альбо на сайце MicroSoft (гл. падзел "драйверы") або на сайце вытворцы відэакарты.
  2. Windows версія мае патч, які вырашае гэту праблему wxWidgets/src/msw/glcanvas.cpp


II.3. Ці падтрымлівае Amaya MathML?

Так, але ў цяперашні час рэалізацыя MathML 2,0 у Amaya яшчэ не канчатковая. Прыкладанне не рэалізоўвае асноўную частку MathML 2,0. У дакументацыі выразна паказваецца, што менавіта даступна. Гл. падзел "Вядомыя пытанні па MathML".


II.4. Ці можна рэдагаваць тэгі?

Amaya быў пабудаваны як структураваны рэдактар дакументаў. Такі падыход дазваляе яму апрацоўваць складаныя дакументы і структураваныя аб'екты, такія як табліцы, графікі або матэматычныя выразы. Пры рэдагаванні ў HTML і XHML рэжымах, Amaya працуе з дрэвам дакумента, а не з яго тэкставым паданнем, якое ствараецца толькі ў момант захавання дакумента, у той сінтаксічнай структуры, якую вы вылучыце (прастой тэкст, HTML, XHML).

Amaya таксама дазваляе адкрыць зыходны код дакумента (элемент меню Views/Show source) , а затым рэдагаваць тэгі. Гэта робіцца ў асобным, але сінхранізаваным дакуменце. Amaya паказвае, якая частка зыходнага дакумента ўдзельнічае ў рэдагаванні сінхроннага дакумента і наадварот. Абодва - зыходны дакумент і адфарматаваны дакумент - могуць рэдагавацца. Змены, зробленыя ў любым з гэтых двух дакументаў, адлюстроўваюцца ў іншы пасродкам каманды File/Synchronize. Сінхранізацыя таксама здзяйсняецца аўтаматычна, пры праглядзе змен.


II.5. Шрыфты занадта малыя. Што можна зрабіць?

Пры дапамозе Amaya можна павялічыць і памяншаць малюнак, акно за акном. Такім чынам, кожны дакумент у акне змененага маштабу будзе адлюстроўвацца больш або менш свайго нармалёвага памеру ў залежнасці ад каэфіцыента змены маштабу. Гэты каэфіцыента змены маштабу дзейнічае на ўсе тыпы якая адлюстроўваецца інфармацыі (шрыфты, малюнкі і т.д.). Каманды, якія змяняюць каэфіцыент змены маштабу, знаходзяцца ў меню Views.

Меню Edit/Preferences/General Edit/Preferences/General Edit/Preferences/General дазваляе змяніць толькі памер шрыфта. Па змаўчанні, каэфіцыент змены маштаба шрыфта роўны 100% (дакументы адлюстроўваюцца ў праўдзівым памеры). Гэты каэфіцыент змены маштаба ўплывае толькі на памер шрыфта, але не на іншыя элементы (малюнкі і г.д.).


II.6. Як змяніць шрыфты?

Для таго, каб мець магчымасць выбіраць шрыфты, Amaya працуе з файлам налады шрыфтоў (Font Configuration file). Па змаўчанні гэты файл знаходзіцца ў дырэкторыі Amaya/config/:

Дадатковую інфармацыю аб гэтых файлах налады, гл. http://www.w3.org/Amaya/User/FontConfig.html


II.7. Ці можна атрымаць шрыфты Amaya?

Версіі Amaya WX

AmayaWX працуе толькі з шрыфтамі TrueType. дыстрыбутыў Amaya пастаўляецца з наборам шрыфтоў Esstix (вялікі набор матэматычных знакаў) і наборам бясплатных шрыфтоў TrueType. Пры запуску Amaya спачатку запытвае папярэдне ўсталяваныя сістэмныя шрыфты і выкарыстае свае ўласныя шрыфты, калі папярэдне ўсталяваных шрыфтоў няма.

На платформах Unix, AmayaWX выкарыстае для патрабаваных шрыфтоў тры канфігурацыйных файла:Amaya/config/fonts.gl, then Amaya/config/fonts.gl.rd, then Amaya/config/fonts.gl.deb.

Пад Windows, AmayaWX выкарыстоўвае адзін канфігурацыйны файл Amaya/config/fonts.gl.win.

Версіі Amaya GTK

Amaya GTK працуе з X Font Server (Xft). Некаторыя сістэмныя дыстрыбутывы пастаўляюцца з папярэдне ўсталяванымі шрыфтамі або пакетамі шрыфтоў, якія ўсталёўваюцца аўтаматычна. Некаторыя іншыя шрыфты павінны ўсталёўвацца ўручную.

Калі вам патрабуецца самім усталяваць шрыфты на платформе Linux, то вам варта:

  1. Разархіваваць і / або спампаваць шрыфты і ўсталяваць іх у /usr/local/share/fonts ці /usr/X11R6/lib/X11/fonts
  2. Усталяваць іх з дапамогай каманды "unzip esstix.zip". Рэкамендуецца ўсталёўваць іх у каталог /usr/local/share/fonts/esstix
  3. Дадаць гэтыя новыя шрыфты ў канфігурацыйны файл: /etc/X11/XftConfig
    ...
    dir "/usr/local/share/fonts/XXX" 
  4. Дадаць гэты новы каталог шрыфтоў у спіс каталогаў справа catalogue list of /etc/X11/fs/config

    This is an example:

    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
        
  5. Затым стварыць дэскрыптары файла: fonts.scale, fonts.dir і XftCache як паказана ніжэй::
    cd /usr/local/share/fonts/XXX
    ttmkfdir -o fonts.scale
    mkfontdir
    xftcache
        
  6. Перазагрузіць або перазапусціць сервер шрыфтоў.

Шрыфты Esstix

Шрыфты Esstix даступныя (мы падаем файл esstix.tar.gz file) па спасылцы ftp://ftp.elsevier.nl/pub/styles/esstix/esstix.zipesstix.tar.gz .

  1. Спампаваць файл з шрыфтамі Esstix esstix.tar.gz
  2. Усталяваць іх пры дапамозе каманды "unzip esstix.zip" ці "tar xzf esstix.tar.gz". Мы рэкамендуем усталёўваць іх у каталог /usr/local/share/fonts/esstix
  3. Дадаць гэты новы каталог шрыфтоў у файл канфігурацыі: /etc/X11/XftConfig
    ...
    dir "/usr/local/share/fonts/esstix" 
  4. Затым стварыць дэскрыптары файла: fonts.scale, fonts.dir and XftCache наступным чынам:
    cd /usr/local/share/fonts/esstix
    ttmkfdir -c -m20 -o fonts.scale
    mkfontdir
    xftcache
        
  5. Перазагрузіць або перазапусціць сервер шрыфтоў.

Версіі Amaya Win32

Усталёўка шрыфтоў Esstix на платформе Windows

  1. Запампаваць шрыфты Esstix (мы падаем файл ESSTIX.zip)
  2. Разархіваваць змесціва гэтага файла
  3. Капіяваць шрыфты з каталога ESSTIX у каталог C:\WINDOWS\Fonts.


II.8. Як змяніць памер акна, усталяваны па змаўчанні?

Змяніце памер вашага акна да патрабаванага вам памеру, а затым выкарыстайце меню Edit/Preferences/Geometr каб захаваць бягучую форму якія адлюстроўваюцца вокнаў. Вашы змены захаваюцца пры наступным абнаўленні Amaya.

Вы таксама можаце ўсталяваць аўтаматычнае захаванне дадзеных параметраў акна пры выхадзе ў меню Edit/Preferences/General menu.


II.9. Ці можна ўбачыць спіс памылак, выяўленых Amaya?

Рэдактар Amaya не можа быць скарыстаны для праверкі карэктнасці HTML старонак. Браўзэр прымае як карэктныя, так і некарэктныя дакументы HTML і спрабуе дынамічна выправіць памылкі. Напрыклад, ён дазваляе дадаць якія адсутнічаюць канчатковыя тэгі і перамясціць элементы на патрэбныя пазіцыі.

Пры разборы XHTML дакумента Amaya правярае яго на правільнасць структуры і спыняецца, як толькі сустракае памылку. У гэтым выпадку, Amaya выдае акно папярэджання аб тым, што дакумент некарэктны.

У абодвух выпадках (HTML і XHTML дакументаў), калі Amaya знаходзіць тэгі і атрыбуты, невядомую або любую іншую памылку, рэдактар стварае лог файл, які можна праглядзець камандай FileShow parsing errors.


II.10. Які чыннік адсутнасці цвёрдых патрабаванняў да прытрымлівання структуры?

Браўзэру - рэдактару Amaya прыходзіцца працаваць з наяўнымі HTML старонкамі, і вельмі нешматлікія з іх адпавядаюць стандарту HTML DTD (Document Type Definition). Пры праектаванні Amaya, мы сапхнуліся з цяжкім выбарам:

  1. Усталяваць цвёрдыя рамкі і адпрэчваць усе неадпавядалыя старонкі. У гэтым выпадку большасць карыстачоў будуць расчараваны немагчымасцю ўбачыць большасць Web старонак, якія, тым не менш, адлюстроўваюцца ў іншых web кліенты;
  2. Прымаць некарэктна створаныя старонкі і дазваляць рэдактару Amaya выпраўляць найболей распаўсюджаныя памылкі.

Мы вылучылі другі варыянт і вырашылі, што рэдактару Amaya варта спрабаваць выпраўляць памылкі, але без страты інфармацыі. Калі элемент не з'яўляецца карэктным у дадзеным кантэксце, Amaya спрабуе змяніць структуру ў вызначаным месцы такім чынам, каб зрабіць дадзены элемент карэктным, аднак, рэдактар не выдаляе і не перамяшчае элемент у іншае месца, што можа змяніць утрыманне дакумента.

Пытанне складаецца ў тым, што стандарт DTD вызначае толькі структуру класа дакумента, але не яго семантыку. Пры працы з некарэктным дакументам, як правіла, існуе некалькі спосабаў пераўтварыць яго структуру і зрабіць яго правільным, але любое ператварэнне можа мець рознае ўздзеянне на семантыку дакумента. Стандарт DTD не дазваляе вам выбіраць правільныя ператварэнні.

Іншае важнае праектнае рашэнне, якое было рэалізавана ў Amaya, складаецца ў тым, што, нават калі рэдактар і прымае некарэктныя дакументы, то структура і разметка застаюцца карэктнымі. Відавочна, што тут разглядаюцца толькі элементы, створаныя або змененыя рэдактарам Amaya. Некаторыя некарэктныя часткі зыходнага дакумента могуць заставацца, пры захаванні дакумента.

Прыведзеныя вышэй заўвагі дастасавальныя толькі для HTML дакументаў. Да XHTML дакументам Amaya ужывае цвёрдыя патрабаванні, рэдактар спыняе разбор дакумента пры выяўленні фармальнай памылкі. Матывацыя - дапамагчы XHTML разгортвацца дакладным спосабам. Дакументаў па падтрымцы няма.


II.11. Як мага абнавіць назоў дакумента?

Назоў дакумента, як і любы іншы загалоўкавы элемент, можа рэдагавацца ў структуры гэтага дакумента. Вы таксама можаце выкарыстаць дыялог XHTML/Change Title.


II.12. Як выйсці з <pre> або табліцы?

Калі курсор знаходзіцца ў канцы элемента фармату <pre>націсніце Enter і стварыце новы радок элемента <pre>. Каб стварыць яшчэ адзін элемент, напрыклад, параграф пасля элемента <pre>, вы можаце выкарыстаць меню XHTML і вылучыць тып элемента, які вы жадаеце стварыць.

Іншы спосаб зрабіць тое ж самае: трэба вылучыць увесь элемент <pre> з клавішай ESC (Linux) або клавішай F2 (Windows) і націснуць Enter. Такім чынам, вы створыце новы параграф пасля элемента <pre>.

Таксама і ў табліцы: вылучыце ўсю табліцу і націсніце Enter, каб стварыць новы параграф пасля табліцы. Таксама можна выйсці з табліцы, націснуўшы Enter, калі курсор па-за табліцай.


II.13. Чаму Amaya не падтрымлівае фрэймы?

Фрэймы ствараюць мноства праблем для мадэлі Інтэрнэт, напрыклад, стандартныя URL адрасы могуць толькі паказваць на фрэйм або набор фрэймаў. Спасылкі і / або кнопка "Назад" могуць выдаваць няслушныя вынікі. Яны таксама з'яўляюцца чыннікам непрыемнасцяў для людзей з абмежаванымі магчымасцямі і робяць рэдагаванне больш складаныя. Нажаль, фрэймы не скасаваныя, і некаторыя людзі працягваюць імі карыстацца. Мы не рэкамендуемы іх выкарыстанне.


II.14. Ці падтрымлівае Amaya JavaScript і аніміраваныя малюнкі?

У сувязі з недахопам рэсурсаў, мы не планаваны рэалізацыю дадзеных функцый. Яны значна больш важныя для браўзэра, чым для рэдактара.


II.15. Amaya не распазнае XHTML, MathML, або SVG дакументы!

XHTML з'яўляецца ператварэннем HTML 4, 0 у XML1.0. XHML дакументы павінны быць правільна сфармаваныя, у чым няма неабходнасці ў выпадку з HTML дакументамі. Як толькі сінтаксічны аналізатар XML Expat, выкарыстоўваны рэдактарам Amaya, выяўляе памылку ў кодзе XHTML, ён выдае папярэджанне аб паведамленні ў файл "Parsing Errors" і спыняецца аналіз дакумента.

Найболей распаўсюджаныя памылкі:

Бо набор знакаў, выкарыстоўваны па змаўчанні, адрозніваецца для HTML і XHTML дакументаў, то часта здараецца, што аўтары ствараюць XHTML дакументы са стандартным наборам знакам ISO-latin-1, якія не ўтрымоўваюць інфармацыі аб наборы знакаў. У выпадку калі знак, прааналізаваны сінтаксічным аналізатарам XML, не адпавядае вызначанаму знаку ў кодзе UTF-8 (гэта адбудзецца, калі дакумент ідзе ў кадыроўцы ISO-latin-1 , але правяраецца як файл UTF 8), то дакумент лічыцца некарэктным: разбор спыняецца і выводзіцца паведамленне аб памылцы.

У дадзеным пэўным выпадку, Вы можаце паспрабаваць зноўку адкрыць дакумент у іншай кадыроўцы, ISO-8859-1 або наборам іншых знакаў праз меню File>Force a Character Coding.

Калі XHTML дакумент сфармаваны няправільна, рэдактар Amaya прапаноўвае прачытаць яго як прастой HTML файл. Пасля гэтага вы зможаце зноў захаваць яго як XHTML файл пры дапамозе каманды Save As.


II.16. Ці падтрымлівае Amaya не лацінскія знакі?

Падтрымка кодавай табліцы Unicode яшчэ не рэалізаваная цалкам. У залежнасці ад наяўных на вашым кампутары шрыфтоў, некаторыя знакі могуць адлюстроўвацца, альбо не адлюстроўвацца. Недаступныя знакі адлюстроўваюцца як невялікія квадрацікі.


II.17. Ці можна выкарыстаць CSS стылі?

Рэдактар Amaya падтрымлівае каскадныя табліцы стыляў (CSS), аднак рэалізацыя дадзенай функцыі яшчэ не завершаная. Шматлікія выгляды дэшыфратараў і ўласцівасці стыляў ужо даступныя. Кожная версія дадае новыя функцыі CSS. Праверце бягучы статут укаранення CSS у апошняй версіі.


II.18. Як мага выдалена публікаваць дакументы?

Amaya падтрымлівае выдаленыя публікацыі з выкарыстаннем тэхналогіі HTTP PUT. На сённяшні дзень Amaya не можаце загружаць файлы, выкарыстаючы FTP. Калі вы выкарыстаеце сервер Apache вы можаце выкарыстаць модуль mod_put module для падтрымкі тэхналогіі PUT.

модуль mod_put не працуе з серверам Apache 2, таму вам прыйдзецца ўсталяваць і актываваць модуль WebDav

Каб запусціць mod_dav, дадайце ў ваш файл httpd.conf наступнае:

<Directory />
    Dav On
 ....
</Directory>

Гэта актывуе правайдэр файлавай сістэмы DAV, які рэалізаваны модулем mod_dav_fs. Такім чынам, гэты модуль павінен быць скампіляваны на серверы або загружаны падчас выканання праграмы з дапамогай дырэктывы LoadModule.

Акрамя таго, размяшчэнне для базы дадзеных DAV павінна быць паказана ўвогуле падзеле вашага файла httpd.conf з выкарыстаннем дырэктывы DavLockDB:

....
# гэта канфігурацыя, якую мы спрабуем апублікаваць на 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)


II.19. Як кантраляваць фармат даты?

Рэдактар 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 = год як дзесятковы лік, уключаючы стагоддзе.

III.1. Дзе можна атрымаць дакументацыю для распрацоўнікаў?

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


III.2. Паведамленне аб адсутных файлах

Гэтая памылка ўзнікае, калі забываюць стварыць аб'ект subtree да пачатку працэсу канфігуравання. Як растлумачана на старонцы Autoconf page Autoconf page, вам неабходна стварыць спачатку subtree obj (або любое іншае імя) для кода аб'екта і запусціць канфігурацыю для стварэння Makefile(s):

cd Amaya
mkdir obj 
cd obj
 ../configure


III.3. Збой пры кампіляцыі схемы HTML

Кампілятарам Thot патрабуецца працэсар папярэдняй апрацоўкі cpp:


III.4. Што трэба для кампіляцыі з GTK?

Апошнія версіі Amaya цалкам спалучаюцца з GTK, аднак, напрыклад, для стандарту на графічны інтэрфейс карыстача Motif, вам неабходна ўсталяваць некаторыя пэўныя бібліятэкі для магчымасці кампіляцыі Amaya.

У сувязі з сумеснай пастаўкай з якое распаўсюджваецца сёння асяроддзем 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.

Дзе можна атрымаць гэтыя бібліятэкі?


III.5. Праблемы з ltconfig (або libtool)

Некаторыя платформы могуць мець розныя варыянты прылад autoconf і libtool. Калі вы атрымоўваеце паведамленне тыпу:

libtool: ltconfig version '' does not match ltmain.sh version '1.3.4'
Fatal configuration error.  See the libtool docs for more information.

Паспрабуйце выканаць наступныя каманды ў каталогах Amaya і libwww directory:

aclocal \
&& libtoolize --force --copy \
&& automake --foreign --force-missing --add-missing --copy \
&& autoconf

Дзякуем Максіма Захарава за прадстаўленую інфармацыю.


III.6. Паведамленне пры тэставанні "тэст: патрабуецца пераменная"

Верагодна, што версія абалонкі, выконваючая вашы каманды, даўно не абнаўлялася. Паспрабуйце выкарыстаць замест яе bash, пасродкам запуску наступнай каманды ў дырэкторыі кампіляцыі:

      make SHELL=/path/to/your/bash

Valid HTML 4.0! W3C-Amaya

Ir?ne Vatton
Date: 2008-09-15

Copyright © 1994-2008 INRIA and W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C liability, trademark, document use and software licensing rules apply. Your interactions with this site are in accordance with our public and Member privacy statements.