Editing AmigaGuide

{{Short description|Hypertext document file format used by Amiga computers}}
'''AmigaGuide''' is a [[hypertext]] [[document file format]] designed for the [[Amiga]]. It was developed in the early 1990s and released to the market in 1992. Files are stored in [[ASCII]] so it is possible to read and edit a file without the need for special software.

Since [[Workbench (AmigaOS)|Workbench 2.1]] an Amiga Guide system for O.S. inline help files and reading manuals with hypertext formatting elements was launched in AmigaOS and based on a viewer called simply "AmigaGuide" and it has been included as standard feature on the Amiga system. Users with earlier versions of Workbench could view the files by downloading the program and library '''AmigaGuide 34''' distributed with public domain collections of floppy disks (for example on [[Fred Fish]] collection) or it could be downloaded directly from [[Aminet]] software repository.<ref name = Aminet>{{Cite web| title = AGuide34 | url = http://aminet.net/search?query=aguide34 | publisher = Urban Müller and the Aminet team | author= Commodore |access-date=2021-09-16}}</ref> Starting from AmigaOS 3.0 the AmigaGuide tool was replaced with the more complete and flexible [[Amiga support and maintenance software#MultiView|MultiView]].

==AmigaGuide and MultiView==
AmigaGuide is the default tool for viewing AmigaGuide files used with AmigaOS 2.1, and is also a basic text viewer for ASCII documents. It can handle multiple files thanks to cross-linking tables called XREF.<ref name = AmigaGuide>{{Cite web| title = Guida Rapida Dell'AmigaDOS, AmigaGuide | url = http://www.amigamagazine.info/index.html#grados/amigaguide.html | publisher = Amiga Magazine Italia, Gruppo Editoriale Jackson | author = Romano Tenca | access-date=2015-04-21}}</ref>

MultiView is basically a void container and a natural GUI for the various datatypes that open MultiView as a default tool when any media file (including AmigaGuide files) are invoked by mouse clicking and recognized by the existing correspondent datatype.

==AmigaGuide readers on various platforms==
Although the AmigaGuide format is almost solely used for documenting Amiga programs, viewers are available for several other platforms:

*[[Java platform|Java]] - [https://web.archive.org/web/20070312040433/http://home1.swipnet.se/~w-10967/Projex/Jaguar/ JAGUaR]
*[[MS-DOS]] - [ftp://k332.feld.cvut.cz/pub/local/lemming/AGView/AGview.arj AGView]{{dead link|date=October 2016 |bot=InternetArchiveBot |fix-attempted=yes }}
*[[Microsoft Windows|Windows]] - [https://web.archive.org/web/20110824070632/http://www.stone-oakvalley-studios.com/index_software.php AGWViewer] [http://main.aminet.net/misc/emu/winguide.lha WinGuide (LHA archive)] [https://web.archive.org/web/20060505152701/http://www.safalra.com/hypertext/amigaguide/winguide.html WinGuide (ZIP archive)]
*[[Linux]] - [http://aminet.net/package/misc/unix/AGReader.tar.bz2 AGReader]
*[[Mac (computer)|Mac]] - [https://web.archive.org/web/20120304100446/http://www.downv.com/Mac/download-Grotag-10037583.htm Grotag] A little free Open Source viewer of AmigaGuide files on Macintosh computers.

==Syntax==
An AmigaGuide document is a simple [[ASCII]]-formatted document, so it can be edited by any normal [[text editor]] and viewed by any text reader software.

AmigaGuide commands all begin with the '@' (pronounced 'at') symbol. To be recognized as an AmigaGuide document, the first line should include this text:

<code>@database Amigaguide.guide</code>

There are three categories of commands: Global, Node, and Attributes. Global commands are usually specified at the beginning of the document, before any nodes are defined, and apply to all the nodes in the document. Technically, they can be anywhere. Many commands can be used both globally and in nodes.

Node commands are usable inside a node (after an '@NODE' and before an "@ENDNODE"), and affect only the node in which they are used.

Attributes may be specified anywhere in a normal line.  In addition to the '@' symbol, attributes always use a pair of braces ('{' and '}') to enclose the attribute name and possibly additional arguments.

===Main commands===
The commands "INDEX", "HELP", "NEXT", "PREV", and "TOC" and the all-purpose hypertext link specify other nodes to jump to.  They all support the naming of nodes within the current document, but they also all support a path along with that name which lets the node be located in any AmigaGuide document.

They will be shown as simply embossed text squared buttons in the page of MultiView.

===External links===
To access a node in another document, it is simply required to put an AmigaDOS file path before the node name. From this point of view, AmigaGuide is a very simple hypertext language.

===Multimedia===
Since [[AmigaOS versions#AmigaOS 3.0, 3.1|AmigaOS 3.0]] or above, the user can jump to any file that is supported by [[Amiga support and maintenance software#Datatypes|Amiga datatypes]] – pictures, animation, anything. It uses the MultiView program to handle it through its internal support for the datatype Amiga standard. The user must still give a "node" name, even though the file is not an AmigaGuide file and has no "nodes" – so the syntax is:

<code>"main": "name_of_picture.iff/main".</code>

==References==
<references/>

==External links==
*[http://www.taws.ch/WB.html TAWS] online viewer by drag'n'dropping an AmigaGuide file onto its window.
*[https://web.archive.org/web/20120324062611/http://www.reality-check-inc.com/aguide.htm AmigaGuide Tech Sheet] AmigaGuide overview by the inventor.
*[https://iamkate.com/code/amigaguide-reference/ AmigaGuide reference] AmigaGuide tags and commands explained, organised by introduction version; open source AmigaGuide to HTML converter, and security inspector
*[http://www.lysator.liu.se/amiga/code/guide/amigaguide.guide AmigaGuide manual] (in AmigaGuide format)
*[http://aminet.net/text/hyper/aguide34.lha AmigaGuide V34 distribution archive] (Aminet download for AmigaOS)
*[http://ale.emuunlim.com/guides/amigaguide-create.shtml How to create an AmigaGuide] (on EmuUnlimited site)
*[http://www.amigamagazine.info/index.html#grados/amigaguide.html AmigaGuide AmigaDOS command] in Guida rapida all'AmigaDOS from Amiga Magazine Italia, 1996 (In Italian Language), contents of the site preserving online all issues of this magazine.

{{AmigaOS}}
{{Document markup languages}}

[[Category:Computer file formats]]
[[Category:AmigaOS]]
[[Category:Hypertext]]
[[Category:MorphOS]]