Obligement - L'Amiga au maximum

Mardi 21 novembre 2017 - 16:49  

Translate

En De Nl Nl
Es Pt It Nl


Rubriques

 · Accueil
 · A Propos
 · Articles
 · Galeries
 · Glossaire
 · Hit Parade
 · Liens
 · Liste jeux Amiga
 · Quizz
 · Téléchargements
 · Trucs et astuces


Articles

 · Actualité (récente)
 · Actualité (archive)
 · Comparatifs
 · Dossiers
 · Entrevues
 · Matériel (tests)
 · Matériel (bidouilles)
 · Points de vue
 · En pratique
 · Programmation
 · Reportages
 · Tests de jeux
 · Tests de logiciels
 · Tests de compilations
 · Articles divers

 · Articles in english
 · Articles in other languages


Twitter

Suivez-nous sur Twitter




Liens

 · Sites de téléchargements
 · Associations
 · Pages Personnelles
 · Moteurs de recherche
 · Pages de liens
 · Constructeurs matériels
 · Matériel
 · Autres sites de matériel
 · Réparateurs
 · Revendeurs
 · Presse et médias
 · Programmation
 · Développeurs logiciels
 · Logiciels
 · Développeurs de jeux
 · Jeux
 · Autres sites de jeux
 · Scène démo
 · Divers
 · Informatique générale


Jeux Amiga

0, A, B, C, D, E, F,
G, H, I, J, K, L, M,
N, O, P, Q, R, S, T,
U, V, W, X, Y, Z


Trucs et astuces

0, A, B, C, D, E, F,
G, H, I, J, K, L, M,
N, O, P, Q, R, S, T,
U, V, W, X, Y, Z


Glossaire

0, A, B, C, D, E, F,
G, H, I, J, K, L, M,
N, O, P, Q, R, S, T,
U, V, W, X, Y, Z


Partenaires

Annuaire Amiga

Amedia Computer

Relec

Hit Parade


Contact

David Brunet

Courriel

 


Programmation : AmigaGuide - les commandes
(Article écrit par Jérôme Chesnot et extrait de RAM - novembre 1995)


Note : cet article est (C) RAM 1995.

Qui ne connaît pas la bibliothèque AmigaGuide. Je veux des noms. Pour notre premier article, nous allons essayer de vous présenter cette puissante bibliothèque (disponible à partir du Workbench 2.1) de manière à ce que vous soyez capable de réaliser vous-même un guide sur la sexualité des gorets en Pyrénées.

Le concept est super simple, les commandes aussi, et l'on peut faire à peu près ce que l'on veut : le principe est de relier les paragraphes (appelé NODE) d'un texte ASCII par des boutons à l'aide de commandes et du caractère "@" (personnellement, j'appelle ça un arrobasque, je tiens ce nom de l'époque où je pianotais sur TRS80, aujourd'hui, on dit "at"). Les liens entre boutons et NODE peuvent se faire à l'intérieur du guide, mais aussi en externe. Cela peut-être un texte, une image, un son (via les datatypes).

Les commandes globales sont à placer au début du fichier, de manière à ce que par exemple le système reconnaisse un guide d'un simple texte ASCII et en formate l'intégralité suivant vos paramètres. Il existe ensuite les commandes de NODE (à placer après la déclaration du NODE "@NODE" et avant la fin "@ENDNODE") qui formatent uniquement le paragraphe et les commandes d'attributs qui sont propres à AmigaGuide. A noter que certaines fonctions ne sont accessibles qu'à partir de la version 40 de la bibliothèque (version 3.1 du Workbench). La fenêtre AmigaGuide possède six boutons, "Contenu", "Index", "Aide", "Retour", "Feuilleter <" et "Feuilleter >", qui servent à naviguer dans le guide.

Les commandes globales

Elles sont placées par ordre de facilité de lecture mais cela n'a aucune importance au niveau technique.

@COMMANDE paramètre :
Description.

@DATABASE nomduguide :
La première commande, identifie le fichier comme un document AmigaGuide.

@$VER: version :
Définie la version du guide au format AmigaDOS. Ce format est : NomduGuide v1.0 (mm/dd/yy). À utiliser avec la commande DOS "Version". "$VER:" doit être en majuscule.

@AUTHOR nom :
Définie l'auteur de la base (vous !).

@(C) copyright :
Définie un copyright au guide.

@REM ou @REMARK :
À utiliser comme commentaire qui ne sera pas affiché.

@FONT nom taille :
Définie la police de caractères à utiliser dans le guide.

@TAB nombre :
Définie la taille en espace d'un Tab. 8 par défaut (v40).

@HEIGHT lignes :
Définie le nombre de lignes maximum en hauteur.

@WIDTH caractères :
Définie le nombre de caractères maximum en largeur.

@HELP chemin/fichier :
Spécifie le guide accessible par le bouton "Aide" (S:Help.guide par défaut).

@INDEX node :
Spécifie le NODE accessible par le bouton "Index". Il existe dans le domaine public des utilitaires comme AGIndex qui permettent de générer automatiquement un index à partir de votre guide.

@MASTER chemin :
Spécifie le chemin d'accès du fichier AmigaGuide principal lors d'une dérivation.

@WORDWRAP :
Utilise le retour-chariot automatique pour tous les paragraphes.

@SMARTWRAP :
Plus efficace que WORDWRAP, les paragraphes doivent être séparés par deux retour-chariots (v40).

@ONOPEN :
Spécifie un script ARexx à exécuter lors de l'ouverture du guide. Si le script retourne une erreur, le document ne pourra pas s'ouvrir (v40).

@ONCLOSE :
Spécifie un script ARexx à exécuter lors de la fermeture du guide. Le retour du script n'est pas très important (v40).

@MACRO nom commandes :
Définie une macro pour le document. Une macro est constituée de commandes d'attribut et, pourquoi pas, d'autres macro. Exemple : @MACRO bold "@{b} $1 @{ub}" (v40).

La création d'un NODE est fort simple :

@NODE nom du node :
Définie le début du paragraphe Hypertexte.

@COMMANDE(S) :
Éventuellement des commandes de formatage propres au NODE.
Le texte du node. Pour les gorets, c'est ici que l'on explique.

@ENDNODE :
Définie la fin du paragraphe Hypertexte. Le node principal est défini comme ceci : @NODE Main (Accessible grâce au bouton "Contenu")

Les commandes de NODE

@COMMANDE paramètre :
Description.

@NODE NomDuNode TitreDeLaFenêtre :
Définie le début du NODE. Si aucun nom de titre de fenêtre n'est spécifié, le nom du NODE sera utilisé comme titre.

@TITLE :
Le titre de la fenêtre lorsque le NODE est sélectionné peut aussi être défini ici.

@ENDNODE :
Définie la fin du paragraphe Hypertexte.

@TOC chemin/nom :
Spécifie le NODE accessible par le bouton "Contenu".

@FONT nom taille :
Définie la police de caractères à utiliser dans le NODE.

@TAB nombre :
Définie la taille en espace d'un Tab pour ce NODE. 8 par défaut (v40).

@HELP chemin/fichier :
Spécifie le guide accessible par le bouton "Aide" (S:Help.guide par défaut).

@INDEX node :
Spécifie le NODE accessible par le bouton "Index".

@PREV :
Définie le NODE précédent accessible par le bouton "Feuilleter <".

@NEXT :
Définie le NODE suivant accessible par le bouton "Feuilleter >".
Ces deux commandes sont à utiliser si les NODES ne sont pas physiquement à côté.

@SMARTWRAP :
Identique à la commande globale, elle ne sera effective uniquement sur le NODE.

@ONOPEN :
Spécifie un script ARexx à exécuter lors de l'ouverture du NODE. Si le script retourne une erreur, le NODE ne pourra pas s'ouvrir (v40).

@ONCLOSE :
Spécifie un script ARexx à exécuter lors de la fermeture du NODE. Le retour du script n'est pas très important (v40).

@MACRO :
Identique à la commande globale.

Il peut arriver que vous ayez besoin du caractère "@" dans vos guides et cela pourrait être interprété comme une commande par AmigaGuide. Pour l'isoler, utilisez le caractère antislash "/". Exemple : le goret possède une queue en '/@'.

La création d'un bouton et d'un lien est à peine plus compliquée que celui d'un NODE :

@{" Nom du Bouton " LINK NomDuNODE Ligne}
@{" Nom du Bouton " LINK chemin/fichier/MAIN"}

Lors d'un lien externe, ne pas oublier le /MAIN final.

Les commandes d'attributs

Elles peuvent être placées n'importe où dans le texte. La plupart nécessitent le Workbench 3.0 minimum. Les attributs sont toujours entre deux accolades "{}": @{Étiquette COMMANDE}

LINK : Spécifie un lien Hypertexte normal.

RX script :
Exécute un script ARexx.

RXS commande :
Exécute une chaîne ARexx.

SYSTEM commande :
Exécute une commande AmigaDOS.

@{AMIGAGUIDE} :
Affiche le mot "Amigaguide(R)" en gras (v40).

@{BODY} :
Restaure le formatage normal du texte (v40).

@{B} :
Active l'option "Gras".

@{UB} :
Désactive l'option "Gras".

@{I} :
Active l'option "Italique".

@{UI} :
Désactive l'option "Italique".

@{U} :
Active l'option "Souligné".

@{UU} :
Désactive l'option "Souligné".

@{PLAIN} :
Désactive tous les attributs de style (gras, italique...) (v40).

@{JLEFT} :
Active la justification à gauche (v40).

@{JCENTER} :
Active la justification centrée (v40).

@{JRIGHT} :
Active la justification à droite (v40).

@{BG couleur} :
Change la couleur du fond. les options sont :
Text : même couleur que le texte (blanc sur blanc, c'est sympa ;-)).
Shine : plus clair.
Shadow : ombré.
Fill : couleur de remplissage.
FillText : couleur de remplissage du texte.
Background : couleur du fond.
Highlight : en surbrillance.

Voici un petit guide qui récapitule les commandes et la syntaxe

@DATABASE "La sexualité des Gorets en Pyrénées"
@$VER Goret.guide v1.0 (11/10/95)
@AUTHOR L'Homme qui a vu l'Ours
@FONT Helvetica.font 10
@INDEX NODE Index
@NODE MAIN "La sexualité des Gorets en Pyrénées"
@{" Intro " LINK Intro}
@{" Description " LINK Descript}
@{" Auteur " LINK Auteur}
@ENDNODE
@NODE Intro "Introduction"
@{b}@{u}Introduction@{uu}@{ub}
Ce guide traite de la sexualité des Gorets en Pyrénées.
@ENDNODE
@NODE Descript "Description"
@{" Trrruuuiiieee " LINK DH3:Images/Goret.GIF/MAIN}
@{" La musique " SYSTEM "C:OctaPlayer Mods:Mod.Peggy"}
@ENDNODE
@NODE Auteur "Auteur"
L'Homme qui a vu l'Ours
09 Massat
@ENDNODE
@NODE Index
@{" Auteur " LINK Auteur}
@{" Description " LINK Descript}
@{" Intro " LINK Intro}
@{" Trrruuuiiieee " LINK DH3:Images/Goret.GIF/MAIN}
@ENDNODE

Merci à Aric R. Caley pour son guide (!) sur AmigaGuide. J'aimerais bien une nouvelle version incluant la recherche, la possibilité d'inclure une image en fond, de mettre des brosses dans les boutons... (faut demander à Gilles(bert) Bourdin ;-))

Quelques logiciels utiles


[Retour en haut] / [Retour aux articles]