@DATABASE "YamExpansion v2.guide"
@author "Diego 'dxo' de Felice"
@remark "$VER: YamExpansion v2.0 Guide (26. January 1999)"
@index MAIN

@node MAIN "Index"


                             @{b}- YAM-Expansion ver. 2.6 -@{ub}

                                   @{u}Version Française@{uu}

                         @{FG shine}(C) 1999 de Diego 'dx0' de Felice@{FG text}
                             @{FG text}<d.defelice@ba.nettuno.it>@{FG text}


          @{"Réclamations" link DISC}                - A LIRE EN PREMIER

          @{"Qu'est ce ?" link INFO}                 - Quelques informations sur ce
                                         programme

          @{"Installation" link INST}                - Comment installer ce programme


          @{"Utilisation" link HOWUSE}                 - Comment utiliser ce programme


   @{FG fill}MàJ@{FG text}    @{"Fenêtre principale" link MWIN}          - La fenêtre principale et ses boutons

   @{FG fill}MàJ@{FG text}    @{"Fenêtre des réglages" link CONFIG}        - Comment configurer ce programme

   @{FG fill}MàJ@{FG text}    @{"F.A.Q." link FAQ}                      - Les questions les plus fréquentes


   @{FG fill}MàJ@{FG text}    @{"Historique" link CHANGES}                  - Toutes les versions de YamExpansion

          @{"L'auteur" link AUTORE}                    - Qui est ce ?

          Rapport de Bug               - Si vous voulez m'aider à retirer tous
                                         les bugs écrire à @{"L'auteur" link AUTORE}

   @{FG fill}MàJ@{FG text}    @{"Remerciements" link THANKS}               - A lire ici :)

   @{FG fill}MàJ@{FG text}    @{"A FAIRE" link TODO}                     - J'y travail...


@endnode

@node TODO "A FAIRE"

    @{FG shine}- A FAIRE -@{FG text}

  Donnez moi les idées qui vous paraissent utiles :) Vous pouvez me joindre @{" à " link AUTORE}.

  Je les ajouterai dans la prochaine version:

   - un utilitaire de filtrage

   - des raccourcis clavier


@endnode

@node THANKS "Remerciements"

    @{FG shine}- Remerciements -@{FG text}


  Je veux remercier:

            Cavalleri "Shiva" Matteo    pour son aide, tests et soutien
         Francesco "Zokie" De Napoli    pour son aide, tests et soutien
                Simone "Wiz" Tellini    pour son aide, soutien et...
                                        buuurp :))
                    Zeljko Novitovic    pour le "temps de téléchargement",
                                        le code et ses idées
                      Michael Luense    Pour son catalogue en Allemand
                     Truls Osmundsen    Pour son catalogue en Norvégien
                                        (traducteur)
                   Veronica Oksholen    Pour son catalogue en Norvégien
                                        (Re lecture)
                      Paulo Marzucco    Pour son aide avec EGCS
                       Gilles Masson    Pour l'excellent NList.mcc
                       Stefan Stuntz    Pour Magic User Interface
               Troels Walsted Hansen    pour l'OpenURL.library
                    Marco Scharfchen    pour les MWB-Icons 
                                        supplémentaires et les idées
                 Arndt van der Molen    puor Automatic-download script, aide
                                        et soutien
               Detlef Wojtaszkiewicz    pour ses idées, Automatic-download
                                        script, rapports de bugs et tests
                    Syiad T. Al-Duri    pour ses idées
                        Mark Mackeen    pour ses rapports de bugs
                                Bubu    pour ses idées
                    Antonio De Cicco    pour ses rapports de bugs
                 Chapron Jean-Michel    pour le catalogue français
                                        et le guide
                Urban Dominik Müller    pour le système XPK
                     Jim Maciorowski    pour ses idées
                      Jurgen Urbanek    pour ses tests et ses rapports
                                        de bugs
                       Dennis Barret    pour ses rapports de bugs
                            Metalurg    pour ses idées
                         Tomasz Kepa    pour ses idées
                         Kovâc Péter    puor le catalogue hongrois
                          Triskelion    pour le catalogue spagnol et
                                        le guide
                 Roger Van Santvliet    pour ses rapports de bugs
                        Paul Brazier    pour ses rapports de bugs et idées
                     Ferry Schouters    pour ses rapports de bugs
                               Sodar    pour ses rapports de bugs
                     David Kiessling    pour ses rapports de bugs
                       Davide Zipeto    puor ses rapports de bugs
                     Philippe Bovier    puor ses rapports de bugs
                    Martin Tauchmann    pour ses rapports de bugs

            Tous les amis de #amigaita
                Tous les amis de AgiBa

     Tous les utilisateurs actuels de YamExpansion 
                                                (et également les futures :))


@endnode

@node CHANGES "Historique"

    @{FG shine}- Historique -@{FG text}


  @{b}ver. 2.6@{ub}  - added the support for DOpus Magellan II (the batch file can
              be shared between AmFTP and DOpus). However I think to have
              done a little mess with the AmFTP support :(

            - removed other small bugs


  @{b}ver. 2.5@{ub}  - ajouté la possibilité de choisir un champ "répondre à:" dans le FTP-email

            - corrigé le bug "dimagrone" :) (celui qui de temps en temps rend la
              fenêtre étroite et puis qui empêche d'en modifier la taille)

            - Je pense (=espère :) )avoir trouvé le problème, avec les petites
              flèches, qui produit de temps en temps un plantage du programme.
              Sur mon système le programme ne se plante plus)

            - résolu le problème avec la création de FTP-emails ( sur certains
              systèmes il y avait des crashs sérieux ou la création d'emails vides

            - retiré d'autres petits bugs

            - maintenant le programme est un peu plus rapide pour remplir
              les deux listes


  @{b}ver. 2.42@{ub} - changé légèrement la fenêtre des réglages pour quelle
              s'ouvre aussi avec des écrans en basse résolution

            - ajouté un script d'installation en allemand

            - corrigé un texte d'une bulle d'aide


  @{b}ver. 2.41@{ub} - corrigé un bug dans la création de FTP-mails


  @{b}ver. 2.4@{ub}  - ajouté le guide Espagnole ( merci à Triskelion)

            - ajouté le téléchargement automatique avec AmFTP

            - corrigé quelque bugs

            - plus de problèmes avec la commande rx (elle n'est plus utilisée)


  @{b}ver 2.3@{ub}   - maintenant vous pouvez sélectionner plusieurs 'récent'
              et charger toutes les archives en une fois ( merci à
              Marcel Beck pour les nouvelles commandes AREXX :)
 
            - ajouté le fichier amigaguide en français ( merci à Chapron
              Jean-Michel)

            - ajouté l'usage du style "wget -c -i liste.fichier"
              pour l'appel de wget

            - ajouté le catalogue hongrois ( merci à Kovàc Péter)

            - vous pouvez choisir l'origine des email 'récent' (ainsi
              si plus tard le serveur principal d'Aminet change vous
              pouvez adapter le programme à ce nouveau serveur)

            - ajouté le catalogue spagnol ( merci à Triskelion)

  @{b}ver 2.2@{ub}   - corriger un bug idiot dans la fenêtre réglages

            - ajouté de deux boutons pour charger le 'recent'
              précédent/suivant et un bouton pour charger le 'recent'
              sélectionné dans un répertoirede YAM.

            - ajouté le catalogue français ( merci à Jean-Michel
              Chapron)

            - peut utiliser les répertoires compressés par XPK

            - nouvelles options pour le générateur d'email FTP

            - corrigé quelques vilains bugs


  @{b}ver 2.1@{ub}   - ajouté le catalogue Norvégien (merci à Truls
              Osmundsenet Veronica Oksholen)

            - corrigé le catalogue Allemand (merci à Micharl Lunse)

            - changé de GUI, utilise maintenant NList.mcc (merci
              à Gilles Masson)

            - ajouté les icones MWB supplémentaires (merci à
              Marco Scharfchen)

            - envoyé les fichiers Html au butineur via
              l'OpenURL.library (merci à Troels Walsted Hansen)

            - corrigé "quelques"  bugs ;)

            - nouvelles fonctionnalités et options


  @{b}ver. 2.0@{ub}  - Yam 2.0 tant attendu est arrivé

            - Plus rapiiiiide :)

            - ajouté la création de Script WGet

            - supprimé la section de signature aléatoire

            - utilise la localisation

            - pour les fichiers Html, vous pouvez choisir entre
              des tableaux élaborés ou des tableaux plus simples
              (mais plus rapides)

            - nouvelle documentation


  @{b}ver. 1.9@{ub}  - ajouté une version en Italien de la doc

            - fait sauter le bug du générateur de fichier Html

            - ne laisse plus de cochonneries dans @{b}t:@{ub}

            - dans la section Ftp il est maintenant possible
              d'afficher le fichier 'batch' AmFtp ou de le supprimer

            - changé le style du guide

            - corrigé quelques bugs

            - maintenant vous pouvez télécharger les fichiers
              @{b}.readme@{ub} avec AmFtp ou FtpMail


  @{b}ver. 1.6@{ub}  - corrigé nombres de bugs :)

            - maintenant travail correctement avec MUIRexx @{FG text}3.0a@{FG text} 
              (ou semble travailler correctement :))


  @{b}ver. 1.4@{ub}  - corrigé le bug du script d'installation qui ne 
              copiait pas le fichier @{b}YamExpansion.yarexx@{ub} dans
              le répertoire @{b}Yam:rexx/@{ub}

            - ajouté une option pour désactiver le logo YamExpansion
              de la fenêtre principale

            - ajouté la possibilité d'entrer de nouvelles saisies
              dans le menu de configuration Url de FtpMail, Html
              et Url Aminet Ftp

            - vous ne pouvez lancer ce programme si YAM n'est pas
              chargé en mémoire

            - plus rapide qu'en ver. 1.0


  @{b}ver. 1.0@{ub}  - la première version


@endnode

@node INST "Installation"

    @{FG shine}- Installation -@{FG text}


  @{u}@{b}IMPORTANT@{ub}@{uu}: Si vous utilisez une version précédente de YamExpansion pas 
 panique. Il n'y aura pas d'inter-actions entre ces versions. Vous pouvez
 la garder, tester la nouvelle version et si vous préférez celle-ci alors
 supprimez l'ancienne version sans oubliez de retirer l'assignation
 @{b}yamexpansion:@{ub}.

  En premier double cliquez sur l'icone @{b}InstallEng@{ub} de ce répertoire. Suivez
 les instructions et vous aurez le programme installé dans son nouveau
 répertoire.

  Ensuite vous pouvez lancer le programme par un double clique sur l'icone 
 @{b}YAMExpansion@{ub} du répertoire @{b}yamexp:@{ub}. Mais si vous le voulez, vous pouvez 
 ajouter un item au menu  @{b}Scripts@{ub} de @{FG shine}Yam@{FG text} pour ceci :

  Dans @{FG shine}Yam@{FG text}, ouvrir @{b}Settings@{ub} - @{b}Configuration@{ub}, allez dans la section @{b}ARexx@{ub}
 où vous trouverez toutes les entrées du menu @{b}'Scripts' @{FG  shine}x@{FG text}@{ub}.

  Choisissez une entrée libre et saisissez comme nom @{i}YamExpansion@{ui}, comme
 type de script @{i}AmigaDOS@{ui} ( c'est le gadget cycle à droite du nom), et
 en-dessous comme script @{i}yamexp:yamexpansion@{ui}. Laissez @{i}Open console window@{ui}
 et @{i}Wait for termination@{ui} @{u}inactif@{uu}.


  Si toutes les entrées du menu @{b}'Scripts'@{ub} sont utilisées, alors la seule
 solution est de retirer un script que vous n'utilisez pas souvent pour
 y placer @{i}YamExpansion@{ui}.

  Vous pouvez aussi lancer automatiquement YamExpansion en ouvrant un
 fichier Aminet 'recent' pour cela :

  En ouvrant @{FG shine}Yam@{FG text}, @{b}Settings@{ub} - @{b}Configuration@{ub}, allez à la section @{b}ARexx@{ub}
 où vous trouverez l'entrée @{b}When reading a message@{ub} que vous selectionnerez.
 Maintenant activez le gadget cycle @{b}ARexx@{ub} et saisissez @{b}Rexx/AutoYamExp.rexx @{ub}
 comme @{b}Script@{ub}, laissez inactif l'@{b}Open console window@{ub} et l'option @{b}Wait for 
 termination@{ub}.

 C'est terminé, maintenant quand vous ouvrez votre email et que celui-ci est
 un fichier 'recent', alors YAM ouvrira YamExpansion automatiquement.


@endnode


@node AUTORE "L'auteur"

    @{FG shine}- L'auteur -@{FG text}


    @{FG shine}Nom:@{FG text}  @{b}Diego 'dx0' de Felice@{ub}

  @{FG shine}Email:@{FG text}  @{b}d.defelice@ba.nettuno.it@{ub}

    @{FG shine}Irc:@{FG text}  @{b}dx0@{ub} sur @{b}#amigaita@{ub}


@endnode

@node DISC "Réclamations"

    @{FG shine}- Réclamations -@{FG text}


  Je ne suis responsable d'aucune perte ou dégradation de données,
 programme, matériel qui pourrait provenir de la possession ou de
 l'usage de ce programme

  Ce programme est 'freeware' et je suis un pauvre étudiant, aussi je
 n'ai pas les moyens de me payer des testeurs.


 @{b}VOUS UTILISEZ CE PROGRAMME A VOS PROPRES RISQUES@{ub}

 Si vous voulez utiliser ce programme, alors vous devez respecter
 ce que je viens de dire !!!


@endnode

@node INFO "Qu'est ce ?"

    @{FG shine}- Introduction -@{FG text}


  @{b}YamExpansion@{ub} est un programme de traitement des email de la 'mailing
 list' @{b}Aminet@{ub}. Vous pouvez lire dans un GUI les fichiers téléchargés,
 choisir les fichiers qui vous intéressent puis écrire un mail-FTP, ou
 un script @{b}WGet@{ub}, ou un fichier 'batch' @{b}AmFtp@{ub}, ou un fichier HTML.

  Pensez que ce programme est @{b}freeware@{ub}. Aussi vous pouvez le copier et
 l'utiliser gratuitement. Vous ne pouvez diffusez ce programme que dans
 sa forme d'origine ( soit cette archive).


@endnode

@node CONFIG "Fenêtre Réglages"

    @{FG shine}- Fenêtre Réglages -@{FG text}



  Dans cette fenêtre vous pouvez régler certains paramètres du programme.
 Pour y accéder vous devez cliquer sur le bouton @{b}Réglages@{ub} de la
 @{"Fenêtre principale" link MWIN}.

  @{FG shine}@{b}Fichier HTML:@{ub}@{FG text}

     @{b}Url d'Aminet:@{ub} Ici vous pouvez saisir ou choisir l'URL complète d'Aminet
                  au format du butineur. Notez que vous devez aussi y
                  inclure le répertoire distant d'Aminet.

                    @{b}ex:@{ub} ftp://ftp.unina.it/pub/aminet/

     @{b}Sauver html dans le répertoire:@{ub} Ici vous pouvez choisir ou saisir le
                  répertoire ou vous voulez sauver tous les fichiers Html
                  créés par YamExpansion.

     @{b}Présentation élaborée :@{ub} Si vous activez cette option alors le fichier
                  Html généré aura des tableaux élaborés mais lents. Si
                  vous n'activez pas cette option les tableaux ressembleront
                  à un email normal, mais avec des liens sur les fichiers.

     @{b}Envoyer le fichier Html au butineur :@{ub} Envoie le fichier Html qui vient
                  d'être créé à votre butineur préféré en utilisant @{b}OpenURL
                  .library@{ub} (voir le programme de préférence de l'@{b}OpenURL.library@{ub}
                  pour y désigner votre butineur préféré).

     @{b}Afficher/activer le butineur :@{ub} Si le butineur est iconifié alors il sera
                  ouvert.

     @{b}Afficher le butineur au premier plan :@{ub} Passera la fenêtre du butineur
                  au premier plan.

     @{b}Ouvrir le fichier dans une nouvelle fenêtre :@{ub} Si il n'y a pas de fenêtre
                  libre, ouvre le fichier dans une nouvelle fenêtre.

    @{b} Démarrer le butineur si ce n'est déjà fait:@{ub} Si le butineur n'est pas
                  démarré, il sera lancé.


  @{FG shine}@{b}'batch' AmFTP:@{ub}@{FG text}

     @{b}Rep. Aminet:@{ub} Ici vous pouvez saisir le répertoire distant d'Aminet

                    @{b}ex:@{ub} /pub/aminet/

     @{b}Nom du fichier 'batch' :@{ub} Ici vous pouvez choisir ou saisir le nom du
                   fichier 'batch' à utiliser avec AmFtp

     @{b}Téléchargement des '.readme':@{ub} Si vous activez cette option alors
                   vous téléchargerez aussi le fichier 'readme' pour
                   chaque fichier que vous choisissez.

     @{b}Toujours ouvrir un 'requester' :@{ub} Si vous activez cette option alors
                   le programme ouvrira toujours un 'requester' et vous
                   demandera un nom de fichier quand vous cliquerez dans
                   @{b}Création d'un 'batch' AmFtp@{ub}

     @{b}Ajouter au fichier 'batch' existant :@{ub} Si vous activez cette option,
                   si un fichier 'batch' AmFtp existe déjà  alors
                   la nouvelle selection de fichiers sera ajoutée à ce 
                   fichier. Si le fichier n'existe pas il sera créé.

  @{b}Utiliser Miami:@{ub}  Cela sert à utiliser Miami comme pile TCP-IP pour le script ARexx de téléchargement
                   automatique. Si Miami n'est pas chargé en mémoire le script va le lancer automatiquement
                   puis se connectera (si ce n'est déjà fait), autrement le script se connectera seulement
                   (si ce n'est déjà fait).

 @{b}Que faire après:@{ub}  Ici vous pouvez choisir ce que vous voulez faire à la fin du téléchargement. Si vous
                   choisissez la dernière option ("Me laisser le choix bla bla bla") alors, avant le téléchargement,
                   une fenêtre s'ouvrira vous laissant les choix: Rester en ligne, Se déconnecter, Se
                   déconnecter et quitter Miami ou Annuler le téléchargement.

 @{b}Exécutable pour Miami:@{ub}  C'est le fichier exécutable pour Miami (Il est utilisé par le script ARexx pour
                    le lancer)

 @{b}Programme FTP à utiliser:@{ub}  Choisir le programme à utiliser\npour un téléchargement automatique

 @{b}exécutable pour AmFTP/DOpusII:@{ub}  C'est le fichier exécutable pour AmFTP/DOpusII (Il est utilisé par le script
                                 ARexx pour le lancer)

 @{b}URL pour le FTP d'Aminet:@{ub}  Ici vous pouvez entrer ou choisir l'URL complet d'Aminet au format FTP
                   Notez que le répertoire du distant est le même que dans "Rep. Aminet" ci-dessus.

                     @{b}ex:@{ub} ftp.unina.it

  @{b}Sauver les fichiers dans:@{ub}  Donner le répertoire où les fichiers seront téléchargés

  @{b}Que télécharger:@{ub}  Ici vous pouvez choisir ce que le script ARexx téléchargera automatiquement. Si
                   vous choisissez la dernière option ("Me laisser le choix bla bla bla") alors, avant le
                   téléchargement, une fenêtre s'ouvrira vous laissant le choix entre les 3 premières options
                   ou Annuler le téléchargement. Notez également que si vous ne sélectionnez aucun fichier
                   et choisissez l'une des deux premières options, le script va utiliser l'ancien fichier Batch
                   AmFTP pour le téléchargement. Si vous ne sélectionnez aucun fichier et qu'il n'y a pas de
                   fichier Batch, le script va s'exécuter mais ne téléchargera aucun fichier.


  @{FG shine}@{b}Script WGet:@{ub}@{FG text}

     @{b}Url d'Aminet:@{ub} Ici vous pouvez saisir ou choisir l'URL complète d'Aminet
                   au format du butineur. Notez que vous devez aussi y
                   inclure le répertoire distant d'Aminet.

                    @{b}ex:@{ub} ftp://ftp.unina.it/pub/aminet/

     @{b}Nom du fichier script:@{ub} Ici vous pouvez choisir ou saisir le nom du
                   fichier script WGet. Pour l'utiliser vous devez être
                   dans un shell: allez dans le répertoire où vous l'avez
                   sauvé et tapez son nom. Les fichiers seront téléchargés
                   dans ce répertoire.(Je vous suggeres de créer un
                   répertoire "Download" et d'y sauver les scripts et de
                   mettre l' executable WGet dans le répertoire C: ).

     @{b}Téléchargement des '.readme':@{ub} Si vous activez cette option alors
                   vous téléchargerez aussi le fichier 'readme' pour
                   chaque fichier que vous choisissez.

     @{b}Toujours ouvrir un 'requester':@{ub} Si vous activez cette option alors
                   le programme ouvrira toujours un 'requester' et vous
                   demandera un nom de fichier quand vous cliquerez dans
                   @{b}Création d'un script WGet@{ub}

     @{b}Ajouter au script existant :@{ub} Si vous activez cette option, si
                   un fichier script WGet existe déjà  alors la
                   nouvelle sélection de fichiers sera ajoutée à ce 
                   fichier. Si le fichier n'existe pas il sera créé.

    @{b}création du script:@{ub} Si vous choisissez cette option vous allez créer
                   un fichier avec la liste des archives @{b}et la liste des
                   fichiers@{ub}  un script avec l'unique ligne "wget -c -i
                   <listefichier>". toutes les archives seront ajoutées à
                   la liste des fichiers et vous pouvez choisir un nom pour
                   ce fichier, voir ci-dessous...

    @{b}Nom du fichier:@{ub} Ici vous pouvez entrer un nom pour la liste des fichiers
                   @{b}liste@{ub}

  @{FG shine}@{b}Ftp-EMail:@{ub}@{FG text}

     @{b}Adresse du serveur EMail-Ftp:@{ub} Ici vous pouvez choisir ou saisir
                   l'adresse du serveur EMail-Ftp que vous voulez utiliser

     @{b}Url d'Aminet:@{ub} Ici vous pouvez saisir ou choisir l'URL complète d'Aminet
                    au format du butineur. Notez que vous devez aussi y
                    inclure le répertoire distant d'Aminet.

                    @{b}ex:@{ub} ftp.unina.it

     @{b}Rep. Aminet:@{ub} Ici vous pouvez saisir le répertoire distant d'Aminet

                    @{b}ex:@{ub} /pub/aminet/

     @{b}Téléchargement des '.readme':@{ub} Si vous activez cette option alors
                   vous téléchargerez aussi le fichier 'readme' pour
                   chaque fichier que vous choisissez.

     @{b}Taille des pièces jointes :@{ub} Ici vous pouvez saisir la taille des pièces
                   jointes aux emails:

                   Certains serveurs n'acceptent pas @{b}size huge@{ub} (512 Koctets),
                   d'autres @{b}size num[K|M]@{ub} où @{b}num@{ub} est la valeur numérique de
                   la taille en @{b}K@{ub}ilo octets ou @{b}M@{ub}ega octets.

                   Notez que vous devez être sure que votre serveur accepte un
                   de ces réglages.

     @{b}Pièces jointes en :@{ub} Vous pouvez choisir comment les fichiers seront
                   joints à l'email: comme @{b}MIME@{ub} ou @{b}UUEncode@{ub}d.


@{b}Utiliser le champ:@{ub} choisissez cette option pour ajouter un champ "répondre à:"
   @{b}"répondre à :"@{ub}  à votre FTP-emails

     @{b}Adresse pour:@{ub} Ici vous pouvez saisir votre adresse email préférée pour "répondre à:"
   @{b}"répondre à :"@{ub}


  @{FG shine}@{b}Réglages divers :@{ub}@{FG text}

     @{b}Vitesse moyenne du Modem :@{ub} Ici vous pouvez saisir la vitesse moyenne
                   de votre connexion. YamExpansion utilisera cette vitesse
                   pour calculer le temps de téléchargement attendu qui est
                   affiché dans la fenêtre principale.

     @{b}Marquer 'recent comme lu en sortant :@{ub} L'email 'recent' sera indiqué comme
                   lu dans YAM en quittant YamExpansion

     @{b}Sortir après avoir activé un des quatre boutons 'Création':@{ub} Après avoir
                   cliqué sur un des quatre boutons "Création" (Création de
                   l'email Ftp, Création du 'batch' AmFtp, Création du script
                   WGet, Création de l'Html) Le programme va se terminer
                   tout seul.

     @{b}Les 'recents' sont dans des répertoires compressés par XPK :@{ub} Si vos
                   'recents' sont dans des répertoires compressés par XPK alors
                   vous devez activer cette option. Notez que le programme 
                   détectera automatiquement  si un email est compressé ou
                   non, J'ai ajouté cette option seulement pour accélérer le
                   programme pour ceux qui n'utilisent pas les répertoires
                   compressés par XPK

     @{b}Déplacer les 'recents' de la liste d'origine :@{ub} Si vous activez cette option,
                   quand vous ajouterez des items à la liste de sélection @{b}liste
                   des fichiers sélectionnés@{ub}, alors ces items seront retirés de
                   la liste d'origine @{b}liste des fichiers de l'email@{ub}

     Les boutons @{b}Utiliser@{ub}, @{b}Sauver@{ub} et @{b}Annuler@{ub} servent à ... utiliser,
                   sauver et annuler les réglages en cours :)

@endnode

@node HOWUSE "Utilisation"

  Pour utiliser @{b}YamExpansion@{ub}, commencez par l'@{"installation" link INST}
 du programme, ensuite vous pouvez enchaîner:


 @{FG shine}1.@{FG text} démarrez Yam2.0.

 @{FG shine}2.@{FG text} sélectionnez un où plusieurs emails 'recent'.

 @{FG shine}3.@{FG text} démarrez YamExpansion (vous pouvez le faire depuis un shell, depuis
    son icone, depuis les scripts du menu ou de façon automatique.
    Cela dépend comment vous avez @{"installé" link INST} le programme).

 @{FG shine}4.@{FG text} Lisez la rubrique @{"fenêtre principale" link MWIN} pour savoir comment
    utiliser les gadgets du programme.


  @{FG shine}@{b}IMPORTANT:@{ub}@{FG text} si vous utilisez le programme depuis un shell,  s'il vous
      plait utilisez le avec la commande @{b}run yamexpansion@{ub}, autrement
      il fonctionnera une fois et puis .. crash :(


@endnode



@node MWIN "Fenêtre principale"

    @{FG shine}- Fenêtre principale -@{FG text}


   Quand vous lancez @{b}YamExpansion@{ub}, La fenêtre principale va s'ouvrir.
  Comme vous pouvez le constater, cette fenêtre est constituée de
  plusieurs sections: en haut de la fenêtre vous pouvez lire le type de
  'recent' et sa date. Sur la même ligne vous pouvez voir trois boutons :
  deux flèches utilisées pour lire le 'recent' @{b}suivant @{ub}/@{b} précédent@{ub}
  (si vous êtes sur un 'recent' journalier, le suivant sera également
  un journalier, c'est le même principe pour un 'recent' hebdomadaire)
  et un bouton @{b}R@{ub} pour lire ceux qui sont choisis dans le répertoire de YAM
  (la même restriction que pour les boutons flèches s'applique ici).

   Juste en dessous, se trouve la @{b}Liste des Fichiers de l'email@{ub}. Si
  l'email est un email hebdomadaire, alors vous avez trois boutons à
  utiliser pour choisir une des trois sections d'un 'recent' hebdomadaire :
  @{b}Nouveaux fichiers de la semaine@{ub}, @{b}Les plus téléchargés@{ub} de la semaine
  et l'@{b}Aminet hit parade@{ub} des archives les plus demandées.

   Quand vous lancez @{b}YamExpansion@{ub} la liste contient toutes les archives de
  l'email. Dans cette liste vous pouvez choisir une ou plusieurs lignes
  et avec le bouton @{b}Ajout de fichier(s)@{ub} les ajouter à la seconde liste
  (voire plus bas). Vous pouvez aussi utiliser le mode 'drag&drop' dans
  dans cette liste à l'aide de la souris pour faire un tri (Pour le moment
  vous ne pouvez pas utiliser le mode 'drag&drop' vers la liste du bas,
  désolé :P) Si vous voulez ajouter tous les fichiers listés vous pouvez
  cliquer sur @{b}Ajout de tous les fichiers@{ub}.

   Sous les boutons 'ajout' vous trouvez deux compteurs: un donne le
  nombre de fichiers de la liste  et l'autre la taille totale des fichiers
  en Octets.


   Dans la deuxième partie de la Gui vous trouvez la @{b}Liste des fichiers
  sélectionnés @{ub}. Les fichiers inclus dans cette liste sont ceux que vous
  voulez télécharger depuis Aminet. Mais si vous voulez retirer un ou
  plusieurs fichiers vous pouvez le ou les sélectionner et cliquez sur
  le bouton @{b}Retirer le(s) fichier(s)@{ub} . Si vous cliquez sur @{b}Retirer tous
  les fichiers@{ub}, vous videz la liste. Comme pour la liste du haut, vous
  pouvez aussi utiliser à l'aide de la souris le mode 'drag&drop' avec
  un ou plusieurs fichiers pour les trier à votre convenance.

   Sous les boutons 'retirer' vous trouvez trois compteurs: le premier
  donne le nombre de fichiers dans la liste, le second donne la taille
  des fichiers en Octets et le troisième donne le temps estimé pour le
  téléchargement de ces fichiers (voir @{"réglages" link CONFIG} pour savoir comment
  est calculé ce temps)..

   Une fois que vous avez choisi les fichiers que vous voulez télécharger,
  vous pouvez choisir la façon de les télécharger : @{b}Création de l'email-Ftp@{ub}
  créera un email dans lequel il y a la liste des fichiers (Vous allez
  recevoir les fichiers dans un email, aussi soyez prudent), @{b}Création du
  'batch' AmfFtp@{ub} créera un fichier 'batch' à utiliser avec AmFtp, @{b}Création
  du script WGet@{ub} créera un script qui utilise le programme WGet (non fourni)
  pour télécharger les fichiers et finalement @{b}Création de l'Html@{ub} créera un
  fichier Html qui contient la liste des fichiers choisis avec pour chacun
  un lien pour le télécharger. Sur la droite des boutons  Création du 'batch'
  AmFtp et Création du script WGet il y a deux petits boutons pour éditer
  les fichiers 'batch' et script. Si vous voulez supprimer le fichier 'batch'
  AmFtp vous pouvez utiliser l'option @{b} Détruire le 'batch' Amftp@{ub} du menu
  @{b}Projet@{ub} ; pour supprimer le script WGet utilisez l'option @{b} Détruire le
  script WGet @{ub} du menu @{b}Projet@{ub}.
  Le bouton @{b}D@{ub} à droite de "Création du 'Batch' AmFTP" sert à la création du script ARexx qui
  téléchargera automatiquement les fichiers sélectionnés, le fichier Batch ou les deux.
  (Note: voir la partie @{"réglages" link CONFIG} pour plus de détails sur les noms des
  fichiers et des répertoires)

   Si l'email contient d'autres textes (souvent des informations sur les
  serveurs Aminet ou les CD Aminet) alors vous aurez une fenêtre texte ici.
  Pas de texte = Pas de fenêtre :)

   En bas de la GUI il y a une @{b}barre d'état@{ub} où vous pouvez lire quelques
  informations sur l'état actuel du programme. (ayez toujours un oeil dessus :)
  A sa droite vous trouvez le bouton réglages pour ouvrir la @{" Fenêtre réglages " link CONFIG}.

   @{b}S'il vous plait@{ub}, avant d'utiliser ce programme, prenez quelques minutes
  pour le configurer, cliquez simplement sur le bouton @{b}Réglages@{ub} (Plus d'info sur
  les réglages @{"ici" link CONFIG}).

@endnode


@node FAQ "F.A.Q."

  Les questions les plus fréquentes:

   @{FG shine}Q:@{FG text} Pourquoi YamExpansion n'est pas traduit dans ma langue ?

   @{FG shine}R:@{FG text} Si vous le désirez vous pouvez le faire vous même en éditant
      le fichier @{b}yamexpansion.ct@{ub} de cette archive et puis en me
      faisant parvenir ce fichier (si vous le voulez vous pouvez
      également traduire le fichier .guide ;)

   @{FG shine}Q:@{FG text} Qu'est ce que la Mailing Liste 'Recent' ?

   @{FG shine}R:@{FG text} C'est une mailing liste gratuite en lecture seule dans
      laquelle les emails sont formés de la liste des fichiers
      qui ont été téléchargés sur Aminet. Il y a deux mailing
      listes: une pour les téléchargements du jour (vous recevez
      un email tous les jours) et une pour les téléchargements
      de la semaine (vous recevez un email une fois par semaine
      ( le Samedi )).

      Vous pouvez vous abonner à cette mailing liste en envoyant
      un email à @{b}listproc@wugate.wustl.edu@{ub}

      avec @{b}SUBSCRIBE AMINET-DAILY <votre adresse email>@{ub} dans le
      contenu du message pour un abonnement journalier ou avec
      @{b}SUBSCRIBE AMINET-WEEKLY <votre adresse email>@{ub} dans le contenu
      du message pour un abonnement hebdomadaire.

   @{FG shine}Q:@{FG text} Qu'est ce que @{b}WGet@{ub} ?

   @{FG shine}R:@{FG text} WGet est un programme principalement utilisé pour télécharger
      des fichiers depuis WWW et pour créer des sites miroir de WWW.
      Mais WGet peut être très utile pour télécharger des fichiers
      depuis des serveurs ftp car il peut reprendre automatiquement
      des téléchargements interrompus (de même que des fichiers depuis
      WWW). Vous devez simplement écrire dans un shell: @{b}wget -c <url>@{ub}

   @{FG shine}Q:@{FG text} Où trouve-t-on WGet et comment l'installer ?

   @{FG shine}R:@{FG text} WGet est un programme gratuit du projet ADE (@{i}Amiga Developer
      Environment@{ui}). Vous pouvez le trouver sur le CD Geek Gadgets
      ou sur le site Geek Gadgets (ou un  miroir, je vous suggère
      le miroir ftp.unina.it). Pour installer WGet copiez l'exécutable
      WGet dans C: et si vous le voulez wget.guide dans un répertoire
      où vous rangez vos docs.

   @{FG shine}Q:@{FG text} Comment utiliser les fichiers 'batch' avec @{b}AmFtp@{ub} ?

   @{FG shine}R:@{FG text} lancez AmFtp, dans le menu @{b}Project@{ub} choisissez @{b}Batch Window@{ub}, dans
      le menu réglages choisissez @{b}Load & add batch window contents@{ub} et
      choisissez votre fichier 'batch'. Puis les fichiers vont apparaître
      dans @{b}Batch Window@{ub}, maintenant vous pouvez vous connecter à un
      serveur Aminet et quand vous êtes connecté cliquez le bouton
      @{b}Receive all@{ub} de la fenêtre Batch.

   @{FG shine}Q:@{FG text} Où trouve-t-on l'@{b}OpenURL.library@{ub} ?

   @{FG shine}R:@{FG text} Sur Aminet dans le répertoire /comm/www/  avec comme nom 
      openurl@{FG shine}xx@{FG text}.lha,ou @{FG shine}xx@{FG text} est le numéro de la version disponible
      (pour le moment c'est la 20)

   @{FG shine}Q:@{FG text} Puis je retirer l' assignation ?

   @{FG shine}R:@{FG text} Oui, depuis cette version c'est possible

   @{FG shine}Q:@{FG text} Le programme crash avec une  'Line 1111 Emulation error'

   @{FG shine}R:@{FG text} Vous utilisez une vieille version de SetPatch, téléchargez en
      une nouvelle depuis http://www.amiga.de (merci à Matteo Cavalleri
      pour avoir signalé ce "bug" :)))

   @{FG shine}Q:@{FG text} Quand je lance le programme, Il m'affiche @{i}"Ce n'est pas un email 'récent'"@{ui}
      mais je suis sure que l'email est un 'récent'... quid ? :)

   @{FG shine}R:@{FG text} c'est sûrement que le serveur de la mailing liste d' Aminet a changé.
      Pour adapter le programme vous ne pouvez pas changer le serveur depuis
      la fenêtre réglages car le programme ne démarre pas, mais
      vous pouvez modifier le fichier réglages:

       @{FG shine}1.@{FG text} ouvrir avec un éditeur de texte @{b}envarc:yamexpansion.prefs@{ub}

       @{FG shine}2.@{FG text} aller à la ligne @{b}34@{ub}

       @{FG shine}3.@{FG text} changer la ligne avec le nom complet du nouveau serveur. Pour
          connaître ce nom:

          @{FG shine}a.@{FG text} ouvrir Yam

          @{FG shine}b.@{FG text} placer le curseur sur un email 'récent'

          @{FG shine}c.@{FG text} ouvrir un shell

          @{FG shine}d.@{FG text} exécuter la commande: @{b}rx "options results;address YAM; MAILINFO
             STEM f.; say f.from"@{ub}

          @{FG shine}e.@{FG text} dans le shell va apparaître le nom complet de l'expéditeur,
             le copier dans l'éditeur de texte à la ligne 34

       @{FG shine}4.@{FG text} sauver le fichier

       @{FG shine}5.@{FG text} rebooter votre Amiga ou si vous préférez copiez le fichier
          envarc:yamexpansion.prefs dans env:

       @{FG shine}6.@{FG text} maintenant vous pouvez lancer YamExpansion :P


@endnode
