AmigaGuide es un formato de archivo de documento de hipertexto diseñado para Amiga . Los archivos se almacenan en ASCII, por lo que es posible leerlos y editarlos sin necesidad de software especial.
Desde Workbench 2.1 se lanzó en AmigaOS un sistema Amiga Guide para archivos de ayuda en línea del sistema operativo y manuales de lectura con elementos de formato de hipertexto, basado en un visualizador llamado simplemente "AmigaGuide" y que se ha incluido como característica estándar en el sistema Amiga. Los usuarios con versiones anteriores de Workbench podían ver los archivos descargando el programa y la biblioteca AmigaGuide 34 distribuidos con colecciones de disquetes de dominio público (por ejemplo, en la colección Fred Fish ) o podían descargarlo directamente desde el repositorio de software de Aminet . [1] A partir de AmigaOS 3.0, la herramienta AmigaGuide fue reemplazada por la más completa y flexible MultiView .
AmigaGuide es la herramienta predeterminada para visualizar archivos AmigaGuide que se utilizan con AmigaOS 2.1, y también es un visor de texto básico para documentos ASCII. Puede manejar múltiples archivos gracias a tablas de enlaces cruzados llamadas XREF. [2]
MultiView es básicamente un contenedor vacío y una GUI natural para los distintos tipos de datos que abren MultiView como herramienta predeterminada cuando se invoca cualquier archivo multimedia (incluidos los archivos de AmigaGuide) haciendo clic con el mouse y son reconocidos por el tipo de datos correspondiente existente.
Aunque el formato AmigaGuide se utiliza casi exclusivamente para documentar programas Amiga, hay visores disponibles para varias otras plataformas:
Un documento de AmigaGuide es un documento simple con formato ASCII , por lo que puede editarse con cualquier editor de texto normal y visualizarse con cualquier software de lectura de texto.
Todos los comandos de AmigaGuide comienzan con el símbolo '@' (se pronuncia 'arroba'). Para que se los reconozca como un documento de AmigaGuide, la primera línea debe incluir este texto:
@database Amigaguide.guide
Existen tres categorías de comandos: globales, de nodo y de atributos. Los comandos globales suelen especificarse al principio del documento, antes de definir los nodos, y se aplican a todos los nodos del documento. Técnicamente, pueden estar en cualquier lugar. Muchos comandos se pueden utilizar tanto de forma global como en los nodos.
Los comandos de nodo se pueden utilizar dentro de un nodo (después de un “@NODE” y antes de un “@ENDNODE”) y afectan solo al nodo en el que se utilizan.
Los atributos se pueden especificar en cualquier parte de una línea normal. Además del símbolo '@', los atributos siempre utilizan un par de llaves ('{' y '}') para encerrar el nombre del atributo y, posiblemente, argumentos adicionales.
Los comandos "INDEX", "HELP", "NEXT", "PREV" y "TOC" y el enlace de hipertexto multipropósito especifican otros nodos a los que saltar. Todos ellos admiten la denominación de nodos dentro del documento actual, pero también admiten una ruta junto con ese nombre que permite ubicar el nodo en cualquier documento de AmigaGuide.
Se mostrarán simplemente como botones cuadrados de texto en relieve en la página de MultiView.
Para acceder a un nodo de otro documento, simplemente es necesario colocar la ruta de un archivo de AmigaDOS antes del nombre del nodo. Desde este punto de vista, AmigaGuide es un lenguaje de hipertexto muy simple.
Desde AmigaOS 3.0 o superior, el usuario puede saltar a cualquier archivo que sea compatible con los tipos de datos de Amiga (imágenes, animaciones, etc.). Utiliza el programa MultiView para gestionarlo a través de su compatibilidad interna con el tipo de datos estándar de Amiga. El usuario debe proporcionar un nombre de "nodo", aunque el archivo no sea un archivo AmigaGuide y no tenga "nodos", por lo que la sintaxis es:
"main": "name_of_picture.iff/main".