AmigaGuide

AmigaGuide — это формат файла гипертекстового документа , разработанный для Amiga . Он был разработан в начале 1990-х и выпущен на рынок в 1992 году. Файлы хранятся в ASCII, поэтому их можно читать и редактировать без необходимости использования специального программного обеспечения.

Начиная с Workbench 2.1 в AmigaOS была запущена система Amiga Guide для встроенных файлов справки ОС и чтения руководств с элементами форматирования гипертекста, основанная на просмотрщике, называемом просто "AmigaGuide", и она была включена в качестве стандартной функции в систему Amiga. Пользователи более ранних версий Workbench могли просматривать файлы, загрузив программу и библиотеку AmigaGuide 34, распространяемую с коллекциями общедоступных дискет (например, в коллекции Fred Fish ), или ее можно было загрузить напрямую из репозитория программного обеспечения Aminet . ^[1] Начиная с AmigaOS 3.0 инструмент AmigaGuide был заменен на более полный и гибкий MultiView .

AmigaGuide — это инструмент по умолчанию для просмотра файлов AmigaGuide, используемых с AmigaOS 2.1, а также базовый просмотрщик текста для документов ASCII. Он может обрабатывать несколько файлов благодаря перекрестным ссылкам таблиц, называемых XREF. ^[2]

MultiView по сути является пустым контейнером и естественным графическим интерфейсом для различных типов данных, которые открывают MultiView как инструмент по умолчанию, когда любой медиафайл (включая файлы AmigaGuide) вызывается щелчком мыши и распознается соответствующим существующим типом данных.

Хотя формат AmigaGuide используется практически исключительно для документирования программ Amiga, доступны просмотрщики для нескольких других платформ:

• Ява - ЯГУАР
• DOS - AGView ^{[ постоянная мертвая ссылка ‍ ]}
• Windows - AGWViewer WinGuide (архив LHA) WinGuide (архив ZIP)
• Linux - AGReader
• Macintosh - Grotag Небольшой бесплатный просмотрщик файлов AmigaGuide с открытым исходным кодом на компьютерах Macintosh.

Документ AmigaGuide представляет собой простой документ в формате ASCII , поэтому его можно редактировать любым обычным текстовым редактором и просматривать с помощью любой программы для чтения текста.

Все команды AmigaGuide начинаются с символа '@' (произносится как 'at'). Чтобы быть распознанным как документ AmigaGuide, первая строка должна содержать этот текст:

@database Amigaguide.guide

Существует три категории команд: Global, Node и Attributes. Глобальные команды обычно указываются в начале документа, до определения узлов, и применяются ко всем узлам в документе. Технически они могут быть где угодно. Многие команды можно использовать как глобально, так и в узлах.

Команды узла можно использовать внутри узла (после «@NODE» и перед «@ENDNODE»), и они влияют только на тот узел, в котором они используются.

Атрибуты могут быть указаны в любом месте обычной строки. Помимо символа '@', атрибуты всегда используют пару фигурных скобок ('{' и '}'), чтобы заключить в них имя атрибута и, возможно, дополнительные аргументы.

Команды "INDEX", "HELP", "NEXT", "PREV" и "TOC", а также универсальная гипертекстовая ссылка указывают другие узлы для перехода. Все они поддерживают именование узлов в текущем документе, но также поддерживают путь вместе с этим именем, что позволяет узлу быть найденным в любом документе AmigaGuide.

Они будут отображаться как простые квадратные кнопки с рельефным текстом на странице MultiView.

Чтобы получить доступ к узлу в другом документе, нужно просто указать путь к файлу AmigaDOS перед именем узла. С этой точки зрения AmigaGuide — очень простой гипертекстовый язык.

Начиная с AmigaOS 3.0 или выше, пользователь может перейти к любому файлу, поддерживаемому типами данных Amiga – изображениями, анимацией, чем угодно. Он использует программу MultiView для обработки этого через свою внутреннюю поддержку стандарта типов данных Amiga. Пользователь все равно должен указать имя «узла», даже если файл не является файлом AmigaGuide и не имеет «узлов» – поэтому синтаксис следующий:

"main": "name_of_picture.iff/main".

• Онлайн-просмотрщик TAWS путем перетаскивания файла AmigaGuide в его окно.
• Технический лист AmigaGuide Обзор AmigaGuide от изобретателя.
• Справочник AmigaGuide. Объяснение тегов и команд AmigaGuide, организованное по вводным версиям; конвертер AmigaGuide с открытым исходным кодом в HTML и инспектор безопасности.
• Руководство AmigaGuide (в формате AmigaGuide)
• Архив дистрибутива AmigaGuide V34 (загрузка Aminet для AmigaOS)
• Как создать AmigaGuide (на сайте EmuUnlimited)
• AmigaGuide — команда AmigaDOS в быстром руководстве по AmigaDOS из журнала Amiga Magazine Italia, 1996 (на итальянском языке), содержимое сайта, сохраняющее онлайн все выпуски этого журнала.