AmigaGuide
AmigaGuide — очень простой язык разметки гипертекстовых документов, применяющийся для написания справочной (главным образом) документации в операционных системах, подобных AmigaOS (AmigaOS 4, AROS, MorphOS).
Документ AmigaGuide представляет собой обычный текстовый (ASCII) файл, размеченный «тегами»; для того, чтобы его редактировать, достаточно обычного текстового редактора.
AmigaGuide и MultiView
Для просмотра с использованием всех предоставляемых возможностей (форматирование, гиперссылки, запуск приложений AmigaOS и скриптов ARexx) используются приложения AmigaGuide, Multiview (при наличии соответствующего datatype), PowerGuide. В то же время, документ может быть просмотрен и как обычный текстовый файл.
В качестве стандартного языка разметки гипертекстовых документов в AmigaOS формат начал применяться, начиная с Workbench 2.x (см. [1]) в 1992 году, когда в поставку было включено приложение для просмотра AmigaGuide-документов. Пользователи более ранних версий могли (и могут сейчас) загрузить необходимое приложение с архива программ для Amiga — Aminet — по ссылке AmigaGuide 34. Начиная с AmigaOS 3.0, приложение AmigaGuide было заменено более полным и гибким MultiView.
Поддержка на других платформах
Хотя формат AmigaGuide и был разработан для Amiga и используется для документирования программ для AmigaOS-подобных систем, просмотреть документы можно на различных платформах:
- Java — JAGUaR
- DOS — AGView (недоступная ссылка)
- Microsoft Windows — AGWViewer, WinGuide (архив LHA), WinGuide (архив ZIP)
- GNU/Linux — AGReader
- Mac OS - Grotag
Синтаксис
Все команды AmigaGuide начинаются с символа «@» («собака»). Для распознавания по сигнатуре «@database» и обработки как документ AmigaGuide, первая строка файла должна содержать команду объявляющую документ:
@database Amigaguide.guide
Определено три вида команд: Глобальные, Узлы и Атрибуты
Есть три категории команд: Глобальные (Global), Узловые (Node) и Атрибутные (Attributes).
Глобальные команды обычно находятся в начале документа, перед определением каких-либо узлов, и действуют на все узлы документа. Технически они могут быть где угодно. Многие команды можно использовать как глобально, так и в узлах.
Узловые команды находятся в узлах (узел — область текста которая начинается с объявления командой @node и заканчивается командой @endnode) и действуют только в пределах своего узла.
Атрибутные команды могут указываться в любом месте. Помимо символа @, атрибуты всегда используют пару фигурных скобок ({ и }), в которые заключается имя атрибута и, возможно, дополнительные аргументы атрибута.
Основные команды
Команды @index, @help, @next, @prev, @toc и link (атрибут универсальной гипертекстовой ссылки) указывают переход к другим узлам. Все эти команды требуют единое именование для узлов по всему документу, но также позволяют включать имена узлов в путь (позволяет узлу находиться в любом документе AmigaGuide). На странице документа AmigaGuide открытого в приложении Multiview такие команды будут выглядеть как прямоугольники с эффектом тиснения обрамляющие текст ссылки.
Внешние ссылки
Чтобы получить доступ к узлу в другом документе AmigaGuide, необходимо просто указать путь к файлу где он описан перед именем узла. С этой точки зрения AmigaGuide — очень простой язык гипертекста.
Мультимедийные возможности
Начиная с AmigaOS 3.0 и выше, пользователь может перейти из документа AmigaGuide к любому файлу, поддерживаемому типами данных Amiga — это могут быть изображения, анимации, графика, видео, звук, любые типы данных. Приложение MultiView определяет сигнатуру файла и исходя из неё использует имеющиеся в операционной системе типы данных (datatypes) для представления (проигрывания, воспроизведения, демонстрации и т.д.) пользователю. Однако, пользователь всё равно должен указать имя «узла», даже если файл не является файлом AmigaGuide и не имеет «узлов». Для этого используется следующий синтаксис: "main": "name_of_picture.iff/main".
Ссылки
- Amigaguide (at Safalra’s Website) Общая и справочная информация об Amigaguide; конвертер Amigaguide в HTML с открытым исходный текстом; программа для проверки на безопасность; WinGuide
- Amigaguide manual (в формате Amigaguide)
- http://main.aminet.net/misc/ — каталог, откуда можно скачать WinGuide, AGReader, и другие программы просмотра AG.
- Comparing AmigaGuide and HTML (англ.)
Content Disclaimer
Informasi ini disarikan dari Wikipedia dan disajikan kembali untuk tujuan edukasi. Konten tersedia di bawah lisensi CC BY-SA 3.0. Kami tidak bertanggung jawab atas ketidakakuratan data yang bersumber dari kontribusi publik tersebut.
- The information displayed on this website is sourced in part or in whole from Wikipedia and has been adapted for the purpose of restating it. We strive to provide accurate and relevant information, however:
- There is no guarantee of absolute accuracy. Wikipedia is an open, collaborative project that can be edited by anyone, so information is subject to change.
- It is not intended to constitute professional advice. The content displayed is for informational and educational purposes only. For important decisions (e.g., medical, legal, or financial), please consult a professional.
- Content copyright. Wikipedia is licensed under the Creative Commons Attribution-ShareAlike License (CC BY-SA). This means that content may be reused with appropriate attribution and shared under a similar license.
- Responsible use. Any risk arising from the use of information from this website is entirely the responsibility of the user.