home *** CD-ROM | disk | FTP | other *** search
Text File | 1994-01-12 | 40.1 KB | 1,230 lines
@Cliva Guide @node main " CliVa option table " CliVa v2.0 Copyright © 1991 1992 1993 Christian Warren Tous droits réservés. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @{" Introduction " link "INTRODUCTION"} @{" OU et Comment " link "REJOINDRE"} @{" Histoire " link "HISTOIRE"} @{" Remerciements " link "REMERCIEMENTS"} @{" Définition du Menu " link "MENU"} ~~~~~~~~~~~~~~~~~~~~ @{" Touche de Fonction " link "SPECIAL"} @{" Notes " link Notes_Config} ~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~ Commandes pour configurer CliVa ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @{" POS_WINDOW " link "POS_WINDOW"} @{" ICON_WHEN_EXECUTE " link "ICON_WHEN_EXECUTE"} @{" DEF_ICON " link "DEF_ICON"} @{" COLOR_BORDER_GADGET " link "COLOR_BORDER_GADGET"} @{" SIZE_GADGET " link "SIZE_GADGET"} @{" COLOR_WINDOW " link "COLOR_WINDOW"} @{" PIXEL_BETWEEN_GADGET " link "PIXEL_BETWEEN_GADGET"} @{" COLOR_BACKGROUND " link "COLOR_BACKGROUND"} @{" PIXEL_FROM_BORDER " link "PIXEL_FROM_BORDER"} @{" COLOR_GADGET_DEF " link "COLOR_GADGET_DEF"} @{" NB_GADGETS " link "NB_GADGETS"} @{" ON_SCREEN " link "ON_SCREEN"} @{" WINDOW_TITLE " link "WINDOW_TITLE"} @{" NO_MENU " link "NO_MENU"} @{" TASK_PRIORITY " link "TASK_PRIORITY"} @{" GADGET_ICONIFIED " link "GADGET_ICONIFIED"} @{" DEF_WINDOW_EXECUTE " link "DEF_WINDOW_EXECUTE"} @{" FONT_STYLE " link "FONT_STYLE"} @{" ICONIFIED " link "ICONIFIED"} @{" FONT " link "FONT"} @{" NO_DRAG_BAR " link "NO_DRAG_BAR"} @{" UP_TO_DOWN " link "UP_TO_DOWN"} @{" SET_VAR " link "SET_VAR"} @{" Définition des Gadgets " link "Def_Gadgets"} ~~~~~~~~~~~~~~~~~~~~~~~~ @{" =S " link "=S"} @{" =] " link "=]"} @{" =[ " link "=["} @{" =E " link "=E"} @{" =P " link "=P"} @{" =D " link "=D"} @{" =D* " link "=D*"} @{" =[* " link "=[*"} @{" =L " link "=L"} @{" =M " link "=M"} @{" Définition des Commandes " link "Def_Commands"} ~~~~~~~~~~~~~~~~~~~~~~~~~~ Toutes les options commencent par un backslash ('\') et sont suivies d'arguments définies entre accolades ('[', ']'). @{" b " link "\b"} @{" o O " link "\oO"} @{" vm " link "\vm"} @{" pp " link "\pp"} @{" m " link "\m"} @{" d " link "\d"} @{" pa " link "\pa"} @{" vs " link "\vs"} @{" p " link "\p"} @{" M " link "\MM"} @{" dl " link "\dl"} @{" q " link "\q"} @{" vte " link "\vte"} @{" sa " link "\sa"} @{" ael " link "\ael"} @{" f1 " link "\f1"} @{" ql " link "\ql"} @{" vu " link "\vu"} @{" sA " link "\sAA"} @{" aes " link "\aes"} @{" fl " link "\fl"} @{" ivs " link "\ivs"} @{" I " link "\I"} @{" sm " link "\sm"} @{" des " link "\des"} @{" fm " link "\fm"} @{" ved " link "\ved"} @{" Q " link "\QQ"} @{" sM " link "\sMM"} @{" es " link "\es"} @{" g G " link "\gG"} @{" vnd " link "\vnd"} @{" np " link "\np"} @{" nd " link "\nd"} @{" nd " link "\nd"} @{" X " link "\X"} @{" vfe " link "\vfe"} @endnode @node INTRODUCTION "INTRODUCTION" CliVa v2.0 Copyright © 1991 1992 1993 Christian Warren Tous droits réservés. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Cliva est placé dans le Domaine Publique pour l'Amiga. Une contribution de 15$ est suggérée pour l'utiliser. Sentez vous libre de l'utiliser, mais A VOS PROPRES RISQUES, car je ne pourrais pas être tenu responsable pour des dommages que ce programme pourrait causer à votre système. Introduction ~~~~~~~~~~~~ CliVa permet de créer une interface entièrement configurable pour lancer tous programmes à partir de Boutons. Pour avoir une meilleur idée des possibilité de CliVa, je vous conseille de jeter un coup d'oeil au example fournis dans l'archive. Pour l'utiliser, il faut absolument que les libraries 'PowerPacker' (permet de dé-compresser les configs) et 'Req' soit présent dans votre répertoire 'libs:'. Ces dernière sont fournis dans l'archive, si vous executer le script 'Example' ils seront chargées en mémoire. Vous pourrez ensuite les installer sur votre système si vous le désirer. Exigence ~~~~~~~~ - CliVa doit pouvoir accéder aux librairies 'PowerPacker', 'Req' et 'DiskFont' dans le répertoire LIBS: - Les fichiers 'echo', 'execute', 'newshell' et 'mouse' doivent être accessible. - L'OS 2.0 N'EST PAS nécessaire à CliVa... Information sur l'exécutable CliVa ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - CliVa est 'pure', il peut donc être mis resident. SHELL usage: CliVa {-configuration} Autre.config {-configuration} WORKBENCH usage: -configuration ... Other.config ... argument: '-configuration' ==> CliVa fait comme si l'argument aurait été placé au début de la config. ex. CliVa "-TASK_PRIORITE 3" "-SET_VAR BLACK 0" 'Autre.config' ==> Config à charger. Par défaut, CliVa recherche le fichier 'CliVa.config' dans le répertoire courant puis le répertoire 'S:'. ex. CliVa AutreConfig.config @endnode @node TASK_PRIORITY " TASK_PRIORITY " Nom: TASK_PRIORITY format: -TASK_PRIORITY priorité défaut: priorité = 0 fonction: Définie la priorité de la tâche CliVa, doit être entre -19 et +19. @endnode @node DEF_WINDOW_EXECUTE " DEF_WINDOW_EXECUTE " Nom: DEF_WINDOW_EXECUTE format: -DEF_WINDOW_EXECUTE définition_du_Shell défaut: "CON:000/095/640/105/CliVa_Shell" fonction: Définie les informations sur le Shell qui sera ouvert lors de l'exécution de bouton nécessitant une fenêtre de sortie. @endnode @node ON_SCREEN " ON_SCREEN " Nom: ON_SCREEN format: -ON_SCREEN nom_écran défaut: "Workbench" fonction: Ouvre CliVa sur un écran en particulier. Le nom de l'écran fournit peut être définie que par les premières lettres du titre réel. Si l'écran n'est pas trouvé, alors CliVa ouvrira sur l'écran de défaut. Vous devez vous assurer de fermer CliVa avant que l'écran en question se referme sinon vous pourriez avoir a méditer sur votre erreur durant le rebootage de votre système... :-) ex. -ON_SCREEN CED -> Ouvre Cliva sur l'écran de Cygnus Ed @endnode @node ICONIFIED " ICONIFIED " Nom: ICONIFIED format: -ICONIFIED fonction: CliVa débutera sous forme d'iconne. @endnode @node ICON_WHEN_EXECUTE " ICON_WHEN_EXECUTE " Nom: ICON_WHEN_EXECUTE format: -ICON_WHEN_EXECUTE fonction: L'option 'AutoIconify' du menu sera selectionné. (voir plus loin pour la fonction d'AutoIconifie) @endnode @node WINDOW_TITLE " WINDOW_TITLE " Nom: WINDOW_TITLE format: -WINDOW_TITLE titre défaut: "CliVa 2.0 (c) 1991-1993 Christian Warren" fonction: Change le titre de la fenêtre. Si la configuration de CliVa comporte plus d'une page, la chaine " (Page xxx/max )" sera ajouté au titre. Si l'option NO_DRAG_BAR est utilisé, le titre sera affiché dans la bordure supérieur de l'écran. @endnode @node NO_DRAG_BAR " NO_DRAG_BAR " Nom: NO_DRAG_BAR format: -NO_DRAG_BAR fonction: La fenêtre ne comportera pas de DragBar visible. CliVa créera des boutons invisibles pour remplacer les boutons ainsi éliminés. Ces boutons invisible seront placés dans l'espace se trouvant au haut de la fenêtre. @endnode @node NO_MENU " NO_MENU " Nom: NO_MENU format: -NO_MENU fonction: N'attache pas les menus à la fenêtre. Vous devez vous assurez de définir au moins un bouton 'Quitter' si vous voulez que l'utilisateur puisse quitter CliVa... @endnode @node FONT " FONT " Nom: FONT format: -FONT fonte hauteur défaut: fonte par défaut du système. fonction: Définie la fonte utilisé et sa hauteur. ex. -FONT Diamond.font 14 @endnode @node POS_WINDOW " POS_WINDOW " Nom: POS_WINDOW format: -POS_WINDOW position_x position_y défaut: position_x = 0 position_y = 11 fonction: Définie la position du coin supérieur gauche de la fenêtre. Si la fenêtre dépasse la bordure de l'écran, la position sera ajusté pour que la fenêtre puisse être affiché. Par exemple, si vous definissez la position en X à 2000, alors la fenêtre de CliVa sera toujours collée sur la bordure droite de l'écran, et ce, quelque soit la largeur de la fenêtre. @endnode @node COLOR_WINDOW " COLOR_WINDOW " Nom: COLOR_WINDOW format: -COLOR_WINDOW couleur_Lettre couleur_Fond défaut: couleur_Lettre = 2 couleur_Fond = 1 fonction: Définie les couleurs utilisées pour la fenêtre. Ces couleurs sont utilisées, entre autres, pour les menus et la bordure de la fenêtre. @endnode @node COLOR_BACKGROUND " COLOR_BACKGROUND " Nom: COLOR_BACKGROUND format: -COLOR_BACKGROUND couleur défaut: couleur = 2 fonction: Définie la couleur utilisée pour le fond de la fenêtre. @endnode @node NB_GADGETS " NB_GADGETS " Nom: NB_GADGETS format: -NB_GADGETS nb_horizontal nb_vertical défaut: nb_horizontal = 5 nb_vertical = 4 fonction: Définie le nombre de bouton horizontale et verticale. @endnode @node UP_TO_DOWN " UP_TO_DOWN " Nom: UP_TO_DOWN format: -UP_TO_DOWN fonction: Les boutons seront numérotés de bas en haut, au lieu de gauche à droite. NORMAL UPDOWN 1 2 3 1 4 7 4 5 6 2 5 8 7 8 9 3 6 9 @endnode @node SIZE_GADGET " SIZE_GADGET " Nom: SIZE_GADGET format: -SIZE_GADGET largeur hauteur défaut: largeur = 112 hauteur = 13 fonction: Définie la largeur et la hauteur des boutons. @endnode @node PIXEL_BETWEEN_GADGET " PIXEL_BETWEEN_GADGET " Nom: PIXEL_BETWEEN_GADGET format: -PIXEL_BETWEEN_GADGET espace_x espace_y défaut: espace_x = 12 espace_y = 4 fonction: Définie l'espace, en pixels, entre les boutons. @endnode @node PIXEL_FROM_BORDER " PIXEL_FROM_BORDER " Nom: PIXEL_FROM_BORDER format: -PIXEL_FROM_BORDER gauche droite haut bas défaut: gauche = 16 droite = 16 haut = 5 bas = 5 fonction: Définie l'espace, en pixels, entre les boutons et la bordure de la fenêtre. @endnode @node COLOR_BORDER_GADGET " COLOR_BORDER_GADGET " Nom: COLOR_BORDER_GADGET format: -COLOR_BORDER_GADGET couleur_Haut couleur_Bas défaut: couleur_Haut = 1 couleur_Bas = 0 fonction: Définie les couleurs utilisées pour le contour des boutons. @endnode @node COLOR_GADGET_DEF " COLOR_GADGET_DEF " Nom: COLOR_GADGET_DEF format: -COLOR_GADGET_DEF couleur_lettre couleur_fond défaut: couleur_lettre = 1 couleur_fond = 2 fonction: Définie les couleurs par défaut pour les boutons. @endnode @node FONT_STYLE " FONT_STYLE " Nom: FONT_STYLE format: -FONT_STYLE style défaut: NORMAL fonction: Définie le style par défaut pour les boutons. Vous devez entrer un chiffre définissant le style de la fonte. NORMAL = 0 SOULIGNE = 1 GRAS = 2 ITALIQUE = 4 EXTENDED = 8 ex. GRAS + ITALIQUE -> 2 + 4 ==> -FONT_STYLE 6 @endnode @node GADGET_ICONIFIED " GADGET_ICONIFIED " Nom: GADGET_ICONIFIED format: -GADGET_ICONIFIED nom défaut: "CliVa" fonction: Définie ce qui sera écrit dans la fenêtre iconifié de CliVa. @endnode @node DEF_ICON " DEF_ICON " Nom: DEF_ICON format: -DEF_ICON position_x position_y largeur défaut: position_x = 0 position_y = 11 largeur = 100 fonction: Définie la position du coin supérieur gauche et la largeur de la fenêtre iconifié de CliVa. (Largueur minimum = 26) Les positions en X et Y sont régis par les mêmes remarques que POS_WINDOW. La hauteur de la fenêtre iconifié sera calculé en fonction de la hauteur des boutons. @endnode @node SET_VAR " SET_VAR " Nom: SET_VAR format: -SET_VAR nom valeur_numérique fonction: Définie une variable servant à faciliter la création des scripts. Vous pouvez définir autant de variable que vous voulez. Une fois définie, CliVa remplacera -nom- par la -valeur_numérique- lorsqu'une configuration demande un chiffre comme argument. Si un nom de variable est définie plus d'une fois, seul la première affectation sera utilisé. Les variables sont conseillées pour créer des scripts facilement modifiable. ex. -SET_VAR rouge 3 -SET_VAR bleu 2 -SET_VAR GRAS_SOULIGNER 3 -COLOR_GADGET_DEF rouge bleu -FONT_STYLE GRAS_SOULIGNER @endnode @node Notes_Config " Notes " Notes. - Les variables définies par SET_VAR peuvent être utilisé à tout les endroit où l'argument demandé est un chiffre. ex. -SET_VAR rouge 2 <= OK -SET_VAR Titre "CliVa 2.0" <= ERREUR -COLOR_BACKGROUND rouge <= OK -WINDOW_TITLE Titre <= ERREUR -WINDOW_TITLE rouge <= titre du window -> 'rouge' - Les arguments contenant des espaces doivent être encadrer de '"'. ex. -WINDOW_TITLE "CliVa 2.0" - Les configurations doivent ABSOLUMENT être placé avant la définition des boutons. Si une configuration est placé après le début de la définition des boutons, alors la ligne de configuration sera incluse dans la commande du bouton précédent. - Vous pouvez placer des commentaires en placant un '#' au début de la ligne en question. @endnode @node Def_Gadgets " Def_Gadgets " Définition des Boutons ~~~~~~~~~~~~~~~~~~~~~~ Ces Arguments sont utilisés pour la définition de bouton. Titre du Bouton = Chaine de caractère à être écrit dans le bouton. Le titre du bouton peut comporter des [<numéro>]. Ce qui inserera dans le titre la contenu de la variable <numéro>. Si la variable change de valeur, le titre du bouton reflétera ce changement. ex. variable 1 = "OS 2.0" titre = "Couleur [1]" Résultat -> "Couleur OS 2.0" couleur_lettre = Couleur utilisé pour les lettres du bouton. couleur_fond = Couleur pour le fond du bouton. style_fonte = Style de la fonte du bouton. (voir config. FONT_STYLE) @endnode @node =S " =S " ------------------------ 1. Commande de départ ------------------------- format: =S Commande [Commande ...] fonction: Définie les commandes qui seront exécuté lors du départ de CliVa. Aucun bouton ne sera créé. Ceci peut être pratique pour assigner des valeurs par défaut à certaine variable. exemple: =S \vs[1]Workbench \vs[2]df0: \vs[3]df1: =D "DiskCopy de [2] à [3]" DiskCopy \vu[2] TO \vu[3] @endnode @node =D " =D " ------------------------------ 2. Bouton ------------------------------- format: =D Titre [couleur_lettre] [couleur_fond] [style_fonte] Commande [Commande ...] fonction: Définie un bouton. Vous devez fournir le Titre, les autres informations sont facultative. exemple: =D "Avail" rouge bleu Avail\w @endnode @node =D* " =D* " ------------------------------- 3. Menu -------------------------------- format: =D* Titre [couleur_lettre] [couleur_fond] [style_fonte] fonction: Définie un 'Menu'. Ce genre de bouton ne pourra pas executer de commande. Ils peuvent servir a séparer les différentes parties de votre configuration. Ces boutons n'apparaitront pas surélevé à l'écran pour que l'ont puissent les distinguer. Vous devez fournir le Titre, les autres informations sont facultative. exemple: =D* "Utilité" blanc noir @endnode @node =[ " =[ " -------------------- 4. définition d'un bouton fixe -------------------- format: =[ position Titre [couleur_lettre] [couleur_fond] [style_fonte] Commande [Commande ...] fonction: Définie un bouton qui apparaitra sur chaque page, à partir de l'endroit où il est défini. Vous devez fournir la position où vous voulez que le bouton apparaisse. Un chiffre négatif place le bouton par rapport à la fin de la page au lieu du début. N'oubliez pas de tenir compte de l'option UP_TO_DOWN. Le nombre de bouton Fixe est limité à 29. Faite attention de ne pas définir des boutons fixe pour chaque position d'une fenêtre. Dans cette situation, CliVa se trouvera dans une boucle sans fin, il créera des zillions de boutons... exemple: Si NOMBRE_BOUTON_HORIZONTAL = 4 NOMBRE_BOUTON_VERTICAL = 3 Alors les boutons seront numeroté comme suit: 1 2 3 4 -12 -11 -10 -9 5 6 7 8 ou -8 -7 -6 -5 9 10 11 12 -4 -3 -2 -1 =[ 11 "Page suivante" noir rouge \np *** est équivalent à *** =[ -2 "Page suivante" noir rouge \np @endnode @node =[* " =[* " --------------------- 5. définition d'un Menu fixe --------------------- format: =[* position Titre [couleur_lettre] [couleur_fond] [style_fonte] fonction: Définie un Menu qui apparaitra sur chaque page, à partir de l'endroit où il est défini. Pour le reste, c'est identique à un bouton fixe. @endnode @node =] " =] " ------------- 6. destruction d'un bouton ou d'un Menu fixe ------------- format: =] position fonction: Détruit un bouton ou un Menu fixe. exemple: ... plusieurs page SANS le bouton Bidon ... =[* 2 "Bidon" ... plusieurs page AVEC le bouton Bidon ... =] 2 ... plusieurs page SANS le bouton Bidon ... @endnode @node =E " =E " ---------------------------- 7. Bouton Vide ---------------------------- format: =E fonction: Définie un bouton vide. Equivalent à la définition: =D* "" @endnode @node =L " =L " -------------- 8. Bouton Vide jusqu'à la prochaine ligne --------------- format: =L fonction: Place des boutons 'vides' tant que nous ne somme pas au début d'une ligne, si la position est déja au début d'une ligne alors rien n'est fait. @endnode @node =P " =P " -------------- 9. Bouton Vide jusqu'à la prochaine page ---------------- format: =P fonction: Place des boutons 'vides' tant que nous ne somme pas au début d'une page, si la position est déja au début d'une page alors rien n'est fait. @endnode @node =M " =M " --------- 10. Rajoute un APPMenu au menu Outils du Workbench ----------- format: =M Titre Commande [Commande ...] fonction: Définie un AppMenu. Vous devez absolument fournir le Titre. Il n'est pas possible d'utiliser des variables dans le titre... (ex. '=M "Voir [1]"' => Titre sera égal à "Voir [1]".) exemple: =M "Voir Texte" more \f1 @endnode @node Def_Commands " Def_Commands " Options disponible dans les commandes ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Tout les options commence par un backslash ('\') et sont suivie d'arguments définie entre accolade ('[', ']'). Si un argument est sous la forme [^<numéro>], alors le contenu de la variable <numéro> sera utilisé. ex. \vs[1]Vous avez sélectionné le fichier \f1! \pa[Information][^1][OK] Notes. - Lorsque l'argument d'une commande est 'Répertoire de départ', vous pouvez placez un [-] pour garder le répertoire déja en place. Cette fonction n'est utile que lorsque vous voulez fournir des valeurs aux autres arguments (ex. le Titre) sans pour autant définir un nouveau répertoire de départ. exemple. Copy \f1[dh0:][De quel fichier?] TO \f1[][Vers quel fichier?] => De cette façon, le répertoire de départ du deuxième \f1 sera le répertoire courant. Tandis que si vous remplacez le deuxième \f1 par '\f1[-][Vers quel fichier?]' alors son répertoire de départ sera le répertoire du fichier à copier. Ce qui est beaucoup plus pratique... - Lorsque l'argument d'une commande est 'Question', vous pouvez placer des '@' dans la Question, ce qui fera en sorte d'inserer des sauts de ligne à ces endroits. - Les variables utilisées dans cette partie de CliVa sont définie par un numéro de variable (1 à 15000) et par le contenu de la variable en question. Une fois définie, la variable peut être utilisé un peu partout. Par exemple, le contenu de la variable pourrait apparaitre dans un titre de bouton (voir Définition des Boutons). Il ne faut toute fois pas mélanger les variables utilisées par CliVa et les variables qui se trouve dans votre répertoire 'ENV:', pour utiliser les variables 'ENV:' il vous faut absolument utiliser les fonction \vfe et \vte. Ces dernière feront en sorte d'importer ou d'exporter le contenu d'une variable 'ENV:' dans une variable de CliVa. @endnode @node \b " \b " option: \b fonction: Effectue un backspace dans la commande. exemple: Copy df0: to df0:\b\b1: => Copy df0: to df1: @endnode @node \d " \d " option: \d[répertoire de départ][Titre de la fenêtre] Arg oblig.: Aucun. fonction: Ouvre un solliciteur de répertoire. exemple: cd \d[ram:][Quelle répertoire?] @endnode @node \dl " \dl " option: \dl fonction: Insère le dernier répertoire sélectionné. Si \f1 ou \fm a été utilisé, le répertoire du fichier est insèré. Cette particuliarité peut être très pratique, comme le temoigne l'exemple ci-dessous. exemple: \vs[1]\f1[][Fichier à exécuter?] cd \dl => Le répertoire courant est celui où se \vu[1] => trouve le fichier à être exécuté. @endnode @node \f1 " \f1 " option: \f1[répertoire de départ][Titre de la fenêtre][Motif] Arg oblig.: Aucun. fonction: Ouvre un solliciteur de fichier. Le fichier sélectionné sera inseré dans le script. exemple: Unwarp \f1[download:][Quel fichier warp?][*.wrp] @endnode @node \fl " \fl " option: \fl[extension] Arg oblig.: Aucun. fonction: Insère le dernier fichier sélectionné. Vous pouvez changer l'extension de ce fichier. exemple: shamsharp \f1 \fl[iff] ==> shamsharp "image.gif" "image.iff" @endnode @node \fm " \fm " option: \fm[répertoire de départ][Titre de la fenêtre][Motif][max] Arg oblig.: Aucun. fonction: Ouvre un solliciteur multiple de fichier. Vous pouvez lui donner un maximum de fichier sélectionnable. exemple: View80 \fm[texte:][Textes à lire?][*][10] @endnode @node \gG " \gG " option: \g et \G fonction: Par défaut, les fichiers et répertoires sont encadrés de guillemets. Ces options permettent de d'annuler ou de remettre cette option. \q -> Ne mets plus de guillemets. \Q -> Mets des guillemets. exemple: View80 \f \g\f \G\f => view80 "fichier1" fichier2 "fichier3" @endnode @node \oO " \oO " option: \o et \O fonction: Par défaut, les fichiers sont précédés de leur chemin (path). Ces options permettent de d'annuler ou de remettre cette option. \o -> Ne met pas de chemin. \O -> Met le chemin. exemple: Deksid \f1 => Deksid "dh0:rep/fichier" Deksid \o\f1 => Deksid "fichier" Deksid \O\f1 => Deksid "dh0:rep/fichier" @endnode @node \pa " \pa " option: \pa[Titre fenêtre][Question][Rép Gauche][Rép Milieu][Rép Droite] [Contenu Gauche][Contenu Milieu][Contenu Droite] Arg oblig.: Titre et Question. fonction: Ouvre un solliciteur. Si la réponse Gauche est choisi alors le Contenu Gauche sera inséré dans le script. Si vous placez un '@' dans la Question, une saut de ligne sera inseré à cet endroit. Ceci est vrai dans tout les arguments intitulés 'Question'. exemple: \pa[Info][Quelle lecteur de disque?][df0:][][df1:][df0:][][df1:] @endnode @node \q " \q " option: \q[contenu de défaut][Titre de la fenêtre] Arg oblig.: Contenu et Titre. fonction: Pose une question. exemple: Unwarp \f1 \q[df0:][Quelle lecteur de disque?] @endnode @node \ql " \ql " option: \ql fonction: Insère la dernière réponse à une question. exemple: cd \q[df0:][Quelle lecteur de disque?] Unwarp \f1 \ql @endnode @node \ivs " \ivs " option: \ivs[numéro de variable] Arg oblig.: Numéro de la variable. fonction: Si la variable N'EST PAS définie, le restant de la ligne en cours sera analysée. exemple: \ivs[1]\vs[1]\d[ram:][Ouvrir un Shell avec quelle répertoire?] NewShell \vu[1] => La première fois que ce bouton sera exécuté, le répertoire sera demandé. Par la suite, la commande "NewShell répertoire" sera exécuté sans que vous ayez à rentrer quoi que ce soit. @endnode @node \vc " \vc " option: \vc[numéro de variable] Arg oblig.: Aucun. fonction: Efface une ou toute les variables de CliVa. Si aucun argument n'est passé à cette fonction, toute les variables seront effacées. Prenez l'habitude de toujours effacer les variables locales à un seul bouton, car chaque variable nécessite de la mémoire. exemple: \vs[1]Vous avez sélectionné le fichier \f1 \pa[Info][^1] \vc[1] @endnode @node \ved " \ved " option: \ved[numéro de variable][contenu visé] Arg oblig.: Numéro de la variable et le contenu visé. fonction: Si la variable est définie et que son contenu EST EGAL au contenu visé, le restant de la ligne en cours sera analysée. (possibilité d'utiliser des patterns avec l'OS 2.0) exemple: \vs[1]\pa[Info][Question?][Choix a][Choix b][Choix c][a][b][c] \ved[1][a]Commande pour choix a. \ved[1][a]Autre commande pour choix a. \ved[1][b]Commande pour choix b. \ved[1][c]Commande pour choix c. @endnode @node \vnd " \vnd " option: \vnd[numéro de variable][contenu visé] Arg oblig.: Numéro de la variable et le contenu visé. fonction: Si la variable est définie et que son contenu N'EST PAS EGAL au contenu visé, le restant de la ligne en cours sera analysée. (possibilité d'utiliser des patterns avec l'OS 2.0) @endnode @node \vfe " \vfe " option: \vfe[numéro de variable CliVa][nom de la variable ENV:] Arg oblig.: Numéro de la variable et le nom de la variable ENV:. fonction: Importe le contenu de la variable 'ENV:' dans une variable 'CliVa'. Vous êtes obligez d'utiliser cette fonction si vous voulez, par exemple, modifier le contenu d'une variable 'ENV:'. A Noter: Le nom de la variable 'ENV:' peut contenir un chemin (ex. 'ram:env/Workbench') mais il ne faut pas qu'il y es des guillemets qui encadrent le nom de la variable. Voir exemple. exemple: \vs[1]\g\o\f1[ENV:][Modifier quelle variable ENV:?] \vfe[2][^1] \vm[2] \vte[2][^1] @endnode @node \vm " \vm " option: \vm[numéro de variable] Arg oblig.: Numérode la variable. fonction: Modifie le contenu d'une variable. Le titre de la fenêtre sera 'Modify variable', si ce titre ne vous convient pas, vous pouvez toujours utiliser l'option \q qui est plus général. \vm[1] === \vs[1]\q[^1][Autre Titre] exemple: \vs[1]\f1 => 'ram:env/Workbench' \vm[1] Deksid \vu[1]\vc[1] @endnode @node \vs " \vs " option: \vs[numéro de variable][Contenu] Arg oblig.: Numéro de la variable. fonction: Assigne un contenu à une variable. Si Contenu est fournis, alors Contenu sera assigné à la variable. Sinon le contenu assigné sera le résultat de l'analyse de la ligne sur lequel le \vs apparait. Le numéro de la variable doit être compris entre 1 et 15000. Si vous entrez un numéro hors de cette intervale, CliVa l'acceptera mais les résultats pourrait être surprenant. exemple: Vous avez choisit le fichier \f1.\vs[1] => Variable 1 = 'Vous avez choisit le fichier "fic".' \vs[1][Bidon1]\vs[2][Bidon2] => Variable 1 = 'Bidon1' et Variable 2 = 'Bidon2' @endnode @node \vte " \vte " option: \vte[numéro de variable CliVa][nom de la variable ENV:] Arg oblig.: Numéro de la variable et le nom de la variable ENV:. fonction: Exporte le contenu de la variable CliVa vers une variable ENV:. A Noter: Contrairement à \vfe, le nom de la variable ENV: ne peut pas contenir de chemin... exemple: \vfe[2][WorkBench] \vm[2] \vte[2][WorkBench] @endnode @node \vu " \vu " option: \vu[numéro de variable][contenu par défaut] Arg oblig.: Numéro de la variable. fonction: Insère dans le script le contenu de la variable. Si la variable n'est pas définie, le contenu par défaut sera utilisé. exemple: Format \vu[1][df0:] @endnode @node \I " \I " option: \I fonction: Après que le script de ce bouton est exécuter, CliVa s'iconifie. exemple: CliVa s:Autre.config\I @endnode @node \QQ " \Q " option: \Q fonction: Après que le script de ce bouton est exécuter, CliVa quitte. exemple: CliVa s:CliVa.config\Q ==> simule un RE-LOAD config. @endnode @node \np " \np " option: \np fonction: Après que le script de ce bouton est exécuter, le numéro de page sera incrémenter de 1. Plusieurs \np peuvent se trouver dans une même commande. exemple: =D "Prochaine Page" \np @endnode @node \pp " \pp " option: \pp fonction: Après que le script de ce bouton est exécuter, le numéro de page sera décrémenter de 1. Plusieurs \pp peuvent se trouver dans une même commande. exemple: =D "Précédente Page" \pp @endnode @node \p " \p " option: \p[numéro de page] Arg oblig.: Numéro de page. fonction: Après que le script de ce bouton est exécuter, le numéro de page sera changé pour le numéro de page fournis. exemple: =D "Allez à la page 3" \p[3] @endnode @node \sa " \sa " option: \sa fonction: DéSélectionne l'option AutoIconifie dans le menu. @endnode @node \sAA " \sA " option: \sA fonction: Sélectionne l'option AutoIconifie dans le menu. @endnode @node \sm " \sm " option: \sm fonction: DéSélectionne l'option Modify dans le menu. @endnode @node \sMM " \sM " option: \sM fonction: Sélectionne l'option Modify dans le menu. @endnode @node \m " \m " option: \m fonction: La ligne sur lequel \m se trouve pourra être modifié lorsque l'ont exécutera ce bouton. Voir l'option 'Modifie Commande'. exemple: cd dh0: ==> ne modifie pas Avail\m ==> modifie dir ==> ne modifie pas @endnode @node \MM " \M " option: \M fonction: A partir de la ligne sur lequel \M se trouve, tout les lignes pourront être modifié lorsque l'ont exécutera ce bouton. Voir l'option 'Modifie Commande'. exemple: cd dh0: ==> ne modifie pas Avail\M ==> modifie dir ==> modifie @endnode @node \ael " \ael " option: \ael[Titre fenêtre][Question][Rép Positive][Rép Negative] Arg oblig.: Titre fenêtre et Question. fonction: Si la réponse à la question est Positive, alors le reste de la ligne en cours sera analysé. Si vous placez un '@' dans la Question, une saut de ligne sera inseré à cet endroit. exemple: avail \eal[Question][Executer Deksid avant dir?][Oui][Non]Deksid dir @endnode @node \aes " \aes " option: \aes[Titre fenêtre][Question][Rép Positive][Rép Negative] Arg oblig.: Titre fenêtre et Question. fonction: Si la réponse à la question est Positive, alors le reste des commande pour ce bouton seront analysées. exemple: avail \aes[Question][Executer Deksid et dir?][Oui][Non]Deksid dir @endnode @node \des " \des " option: \des[Titre fenêtre][Question][Rép Positive][Rép Negative] Arg oblig.: Aucun fonction: Si la réponse à la question est Negative ou que le titre et la question ne sont pas fournis, alors le script ne sera pas executé. exemple: avail \des[Question][Executer Avail, Deksid et dir?][Oui][Non]Deksid dir @endnode @node \es " \es " option: \es fonction: Execute le contenu du script après que la ligne en cours es été analysé même si l'analyse de toute les commandes n'est pas encore completé. Une fois que l'exécution du script a été amorcé, le reste des commandes seront analysées. exemple: avail\es\w dir\es\w => ouvre 2 fenêtres de sortie, et execute simultanément avail et dir. @endnode @node \nd " \nd " option: \nd fonction: Par défaut, si l'option \w est utilisé, les commandes DOS suivantes seront ajoutés au script 'echo Press mouse button' et 'mouse'. Ce qui fera en sorte de bloquer la fenêtre de sortie tant que vous n'aurez pas cliqué sur un des boutons de la sortie. Avec \nd aucune de ces 2 commandes ne sera ajoutés. exemple: echo "lisez vite :)"\w\nd @endnode @node \w " \w " option: \w fonction: Signale que le script nécessite une fenêtre de sortie. En gros, la commande DOS executé sera 'NewShell "définition_du_Shell" from script' au lieu de 'Execute script' exemple: avail\w @endnode @node \X " \X " option: \X fonction: Execute immediatement la ligne sur lequel \X apparait. La ligne en question n'apparaitra dans le script final. L'analyse des commandes sera interrompu tant que l'exécution de la ligne ne sera pas completé. exemple: more texte\X \pa[Question][Le texte vous plait-il?][Oui][Peut-etre][Non] @endnode @node SPECIAL " SPECIAL " SPECIAL ~~~~~~~ - Lorsque vous cliquez sur un bouton, vous pouvez presser en même temps sur les touches de fonctions (Control, Alt, Amiga). Les variables suivantes seront alors initialisé: - variable numéro 15001 <- 'CONTROL' si la touche CONTROL est enfoncé. - variable numéro 15002 <- 'R-ALT' si la touche ALT-DROITE est enfoncé. - variable numéro 15003 <- 'L-ALT' si la touche ALT-GAUCHE est enfoncé. - variable numéro 15004 <- 'ALT' si une des touches ALT est enfoncé. - variable numéro 15005 <- 'R-AMIGA' si la touche ALT-AMIGA est enfoncé. - variable numéro 15006 <- 'L-AMIGA' si la touche ALT-AMIGA est enfoncé. - variable numéro 15007 <- 'AMIGA' si une des touches AMIGA est enfoncé. Exemple de bouton. =D "Avail" \ved[15001][CONTROL] Avail => si touche CONTROL enfoncé -> 'Avail' \vnd[15001][CONTROL] Avail flush => sinon 'Avail flush' @endnode @node MENU " MENU " MENU ~~~~ - AutoIconifie : Lorsque cette option est sélectionnée CliVa s'iconise automatiquement après chaque exécution d'un bouton comportant au moins une commande DOS. De cette manière, les boutons du genre 'Prochaine Page' pourront être exécuter sans que CliVa s'iconise sans arrêt... - Modifie : Tout les lignes pourront être modifiées avant d'être inseré dans le script. Si une des deux clés SHIFT est pressé lorsque vous cliquer sur un bouton, l'option 'Modifie' sera en fonction durant l'analyse des commandes. @endnode @node HISTOIRE " HISTOIRE " Histoire ~~~~~~~~ version 2.0: 30 mars 1993 ------------ Première version officiel. version 2.1: 10 octobre 1993 Grosseur: 19776 ------------ Ajout - Nouvelle option 'NO_HIDDEN_BUTTON' qui spécifie à CliVa de ne pas mettre de ScrollBar invisible à la fenêtre si l'option 'NO_DRAG_BAR' est utilisé. BUG Mineur - Quelque petit bugs sans trop d'importance de reparés. version 2.2: 3 novembre 1993 Grosseur: 20356 ------------ Ajout - Nouvelle option '=M nom' qui definie un element que CliVa rajoutera au menu 'Outils' du Workbench. (OS 2.0 seulement) Ajout - les patterns sont maintenant accepter pour les options '\ved' et '\vnd'. (ex. '\ved[1][*.c]CED \vu[1]' => si c'est une source, charge CygnusEd) (OS 2.0 seulement) BUG Mineur - CliVa avait parfois des problèmes à savoir la vrai grandeur de votre workbench. Reparé. BUG Mineur - L'option '\fl[new extension]' ne marchait pas si le flag 'no path' ('\o') était sélectionné. Reparé. version 2.3: 12 janvier 1994 Grosseur: 20352 ------------ Ajout - Les utilisateurs enregistrés recevront une clé qui modifira le texte affiché dans le 'About'... BUG Majeur - CliVa plantait lorsque les menus étaient utilisé et que CliVa devenait Iconifié. Reparé. A Faire ~~~~~~~ - Utiliser la ReqTools.library au lieu de la req.library. - Rajouter des 'shortcuts' au bouton. - Possibilité d'utiliser des noms pour les variables, au lieu de chiffres. - Faire une version plus spécifique à l'OS 2.0. @endnode @node REJOINDRE " REJOINDRE " Pour me rejoindre, et m'encourager: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ CLIVA est un produit Shareware, ce qui veut dire qu'il faut le payer si on l'utilise beaucoup. Une contribution de 15$ est recommandée, mais tout autre contribution sera acceptée. N'hésitez pas non plus à me laisser des messages sur les réseaux pour me donner vos commentaires sur CLIVA. Les groupes d'usagés Amiga et les collections de programmes Domaine Publiques, tels que Fred Fish, sont encouragés à mettre CLIVA dans leur collection. 1:167.151.0@fidonet Christian Warren 40:600/151.0@amiganet 101:166/106.0@francomedia Christian Warren 2201 Edouard-MontPetit #11 Montréal, Qué, CANADA H3T 1J3 @endnode @node REMERCIEMENTS " REMERCIEMENTS " Remerciements à ~~~~~~~~~~~~~~~ - C.W. Fox et Bruce Dawson: Pour leurs fantastiques librairies de File Requester et Color Requester. - Nico Francois: Pour ses merveilleuses librairies. (ReqTools et PowerPacker). - Denis Turcotte: Pour avoir traduit les docs, pour avoir été le Beta testeur officiel de CliVa et pour m'avoir 'forcé' à rajouter un paquet de fonctions. Va-t'il faire les .guide!! @endnode 
