Articulo de referencia

Guía de Amiga

AmigaGuide es un formato de archivo de documentos de hipertexto diseñado para Amiga . Fue desarrollado a principios de la década de 1990 y lanzado al mercado en 1992. Los archiv...

AmigaGuide es un formato de archivo de documentos de hipertexto diseñado para Amiga . Fue desarrollado a principios de la década de 1990 y lanzado al mercado en 1992. 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 visor llamado simplemente "AmigaGuide", que se incluyó 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 del repositorio de software Aminet . [ 1 ] A partir de AmigaOS 3.0, la herramienta AmigaGuide fue reemplazada por MultiView , más completa y flexible .

AmigaGuide y MultiView

AmigaGuide es la herramienta predeterminada para visualizar archivos AmigaGuide utilizados con AmigaOS 2.1, y también es un visor de texto básico para documentos ASCII. Puede manejar varios archivos gracias a tablas de enlaces cruzados llamadas XREF. [ 2 ]

MultiView es básicamente un contenedor vacío y una interfaz gráfica de usuario 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 ratón y es reconocido por el tipo de datos correspondiente existente.

Lectores de AmigaGuide en diversas plataformas

Aunque el formato AmigaGuide se utiliza casi exclusivamente para documentar programas de Amiga, existen visores disponibles para varias otras plataformas:

  • Java - JAGUaR
  • MS-DOS - AGView
  • Windows - AGWViewer WinGuide (archivo LHA) WinGuide (archivo ZIP)
  • Linux - AGReader
  • Mac - Grotag Un pequeño visor gratuito de código abierto para archivos AmigaGuide en ordenadores Macintosh.

Sintaxis

Un documento de AmigaGuide es un documento sencillo con formato ASCII , por lo que puede editarse con cualquier editor de texto normal y visualizarse con cualquier programa lector de texto.

Todos los comandos de AmigaGuide comienzan con el símbolo '@' (que se pronuncia 'at'). Para que se 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 cualquier nodo, y se aplican a todos los nodos del documento. Técnicamente, pueden ubicarse en cualquier lugar. Muchos comandos pueden utilizarse tanto de forma global como en nodos.

Los comandos de nodo se pueden usar dentro de un nodo (después de un '@NODE' y antes de un "@ENDNODE"), y solo afectan al nodo en el que se utilizan.

Los atributos pueden especificarse en cualquier parte 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.

Comandos principales

Los comandos "INDEX", "HELP", "NEXT", "PREV" y "TOC", así como el enlace de hipertexto de uso general, permiten especificar otros nodos a los que saltar. Todos ellos admiten la asignación de nombres a los nodos dentro del documento actual, pero también admiten una ruta junto con ese nombre, lo que permite localizar el nodo en cualquier documento de AmigaGuide.

En la página de MultiView, se mostrarán como simples botones cuadrados con texto en relieve.

Para acceder a un nodo en otro documento, basta con anteponer la ruta de un archivo AmigaDOS al nombre del nodo. Desde este punto de vista, AmigaGuide es un lenguaje de hipertexto muy sencillo.

Multimedia

Desde AmigaOS 3.0 o superior, el usuario puede acceder a cualquier archivo compatible con los tipos de datos de Amiga : imágenes, animaciones, etc. Utiliza el programa MultiView para gestionarlo mediante su compatibilidad interna con el estándar de tipos de datos de Amiga. El usuario debe especificar un nombre de "nodo", aunque el archivo no sea un archivo de AmigaGuide y no tenga "nodos"; por lo tanto, la sintaxis es:

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

Referencias

  1. Comodoro. "AGuide34" . Urban Müller y el equipo de Aminet . Consultado el 16 de septiembre de 2021 .
  2. Romano Tenca. «Guida Rápida Dell'AmigaDOS, AmigaGuide» . Revista Amiga Italia, Gruppo Editoriale Jackson . Consultado el 21 de abril de 2015 .
  • Puede acceder al visor en línea de TAWS arrastrando y soltando un archivo de AmigaGuide en su ventana.
  • Hoja técnica de AmigaGuide. Descripción general de AmigaGuide por el inventor.
  • Referencia de AmigaGuide: Explicación de las etiquetas y comandos de AmigaGuide, organizados por versión de introducción; convertidor de código abierto de AmigaGuide a HTML e inspector de seguridad.
  • Manual de AmigaGuide (en formato AmigaGuide)
  • Archivo de distribución de AmigaGuide V34 (descarga de Aminet para AmigaOS)
  • Cómo crear una AmigaGuide (en el sitio web de EmuUnlimited)
  • AmigaGuide Comando AmigaDOS en Guida rapida all'AmigaDOS de Amiga Magazine Italia, 1996 (en idioma italiano), contenidos del sitio que conservan en línea todos los números de esta revista.