@Cliva Guide @node main " CliVa option table " CliVa v2.0 Copyright 1991 1992 1993 Christian Warren Tous droits r ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @{" 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"} @{" 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 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Cliva est plac dans le Domaine Publique pour l'Amiga. Une contribution de 15$ est sugg 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 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 -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 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 plac 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 faut: priorit 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 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_ faut: "Workbench" fonction: Ouvre CliVa sur un cran en particulier. Le nom de l' 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 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 Ces boutons invisible seront plac s dans l'espace se trouvant au haut de la fen @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 faut: fonte par d faut du syst 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 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 @endnode @node COLOR_WINDOW " COLOR_WINDOW " Nom: COLOR_WINDOW format: -COLOR_WINDOW couleur_Lettre couleur_Fond 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 @endnode @node COLOR_BACKGROUND " COLOR_BACKGROUND " Nom: COLOR_BACKGROUND format: -COLOR_BACKGROUND couleur faut: couleur = 2 fonction: D finie la couleur utilis e pour le fond de la fen @endnode @node NB_GADGETS " NB_GADGETS " Nom: NB_GADGETS format: -NB_GADGETS nb_horizontal nb_vertical 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 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 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 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 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 @endnode @node COLOR_BORDER_GADGET " COLOR_BORDER_GADGET " Nom: COLOR_BORDER_GADGET format: -COLOR_BORDER_GADGET couleur_Haut couleur_Bas 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 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 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 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 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 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 finition des boutons. Si une configuration est plac but de la d finition des boutons, alors la ligne de configuration sera incluse dans la commande du bouton pr dent. - Vous pouvez placer des commentaires en placant un '#' au d but de la ligne en question. @endnode @node Def_Gadgets " Def_Gadgets " finition des Boutons ~~~~~~~~~~~~~~~~~~~~~~ Ces Arguments sont utilis s pour la d finition de bouton. Titre du Bouton = Chaine de caract crit dans le bouton. Le titre du bouton peut comporter des []. Ce qui inserera dans le titre la contenu de la variable . 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 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 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 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 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 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 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 d'une page, si la position est d ja au d but d'une page alors rien n'est fait. @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 [^], alors le contenu de la variable 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 \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 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 utilis , le r pertoire du fichier est ins . Cette particuliarit peut tre tr s pratique, comme le temoigne l'exemple ci-dessous. exemple: \vs[1]\f1[][Fichier cuter?] cd \dl => Le r pertoire courant est celui o \vu[1] => trouve le fichier tre ex @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 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 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 dans le script. Si vous placez un '@' dans la Question, une saut de ligne sera inser endroit. Ceci est vrai dans tout les arguments intitul '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 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 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 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 le r pertoire sera demand . Par la suite, la commande "NewShell r pertoire" sera ex 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 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 @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 \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 menter de 1. Plusieurs \pp peuvent se trouver dans une m me commande. exemple: =D "Pr 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 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 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 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 analys me si l'analyse de toute les commandes n'est pas encore complet . Une fois que l'ex cution du script a amorc , le reste des commandes seront analys 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 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 " - 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 - Modifie : Tout les lignes pourront tre modifi es avant d' 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 93 ------------ - Premi re version officiel. 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 mais tout autre contribution sera accept e. N'h sitez pas non plus 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 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 le Beta testeur officiel de CliVa et pour m'avoir 'forc rajouter un paquet de fonctions. Va-t'il faire les .guide!! @endnode