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 leer y editar un archivo 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 visor 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 descargarlos 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 ver archivos AmigaGuide utilizados 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 diversos tipos de datos que abren MultiView como herramienta predeterminada cuando cualquier archivo multimedia (incluidos los archivos AmigaGuide) se invoca haciendo clic con el mouse y se reconoce por el tipo de datos correspondiente existente.
Aunque el formato AmigaGuide se utiliza casi exclusivamente para documentar programas de Amiga, los visores están disponibles para varias otras plataformas:
Un documento 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 '@' (pronunciado 'arroba'). Para ser reconocido como un documento AmigaGuide, la primera línea debe incluir este texto:
@database Amigaguide.guide
Hay tres categorías de comandos: Global, Nodo y Atributos. Los comandos globales generalmente se especifican al principio del documento, antes de definir cualquier nodo, y se aplican a todos los nodos del documento. Técnicamente, pueden estar en cualquier lugar. Se pueden utilizar muchos comandos tanto globalmente como en nodos.
Los comandos de nodo se pueden utilizar dentro de un nodo (después de '@NODE' y antes de "@ENDNODE") y afectan sólo al nodo en el que se utilizan.
Los atributos se pueden especificar en cualquier lugar de una línea normal. Además del símbolo '@', los atributos siempre usan un par de llaves ('{' y '}') para encerrar el nombre del atributo y posiblemente argumentos adicionales.
Los comandos "ÍNDICE", "AYUDA", "SIGUIENTE", "ANTERIOR" y "TOC" y el enlace de hipertexto multiuso especifican otros nodos a los que saltar. Todos admiten el nombramiento de nodos dentro del documento actual, pero también admiten una ruta junto con ese nombre que permite ubicar el nodo en cualquier documento AmigaGuide.
Se mostrarán como botones cuadrados de texto simplemente en relieve en la página de MultiView.
Para acceder a un nodo en otro documento, simplemente es necesario colocar una ruta de archivo 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 compatible con los tipos de datos de Amiga : imágenes, animaciones, cualquier cosa. Utiliza el programa MultiView para manejarlo a través de su soporte interno para el tipo de datos estándar Amiga. El usuario aún debe dar 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".