EDDIE v2.0 - FICHIER D'AIDE
            
    Texteur Utf-8 basique qui évolue au fil des jours. Pour un
tour rapide d'Eddie, essayez les boutons ci-dessous dans l'ordre que vous voulez, en consultant les écrans du menu Aide au besoin. On peut utiliser le bouton Cherche ci-dessous pour trouver rapidement un mot clé. Par exemple, une recherche répétée sur « sauvegarde » ou sur « ctrl-s » affiche toute l'information sur les options de sauvegarde.

    Axé sur la rédaction de textes simples, notamment dans un cadre de recherche documentaire, Eddie émule les vingt fonctions les plus courantes des texteurs professionnels, mais pas nécessairement leurs fonctions complexes (mise en page, gestion des tableaux...). Par contre, il offre certaines fonctionnalités inédites comme un dialogue de recherche multioccurrence dans une ou plusieurs branches de l'arborescence des fichiers, complété par un dialogue de recherche et remplacement à jeu d'options très complet pour explorer ou modifier le fichier à l'écran. De plus, il comporte toutes sortes de raccourcis utiles, par exemple pour le changement de casse ou pour l'insertion de n'importe quel caractère Utf-8, ou pour celle de guillemets français en trois clics.
    
    Eddie ouvre et sauvegarde les fichiers codés en Utf-8 (notamment avec extension .txt, .html ou .edd) de toutes les langues ou combinaisons de celles-ci. De plus, il lit aussi correctement les fichiers Latin-1 (appelés également Western European ou Windows-1252) de la plupart des langues de l'Europe de l'Ouest.

N.B. : Les fichiers textes (.txt) peuvent être codés en divers formats, dont Latin-1 (par exemple, les anciens fichiers texte dans Windows). Toutefois, comme le format Utf-8, utilisé sous Linux, MacIntosh, OS X, et de plus en plus sous Windows, est devenu la norme, Eddie peut lire les fichiers Latin-1, mais il ne les sauvegarde qu'en Utf-8.

    Eddie peut interconvertir les formats .txt et .edd. Ce dernier format créé pour Eddie conserve les attributs gras, italique et souligné, ainsi que diverses fontes créées à la volée pour une partie ou l'ensemble du texte. De plus, on peut convertir les fichiers .edd au format .txt ou .html, et ces fichiers peuvent être ouverts dans d'autres applications (p. ex. Word, Open Office, les fureteurs Web). Le format .html sert donc de format passerelle pour convertir un fichier .edd en fichier .odt (commande
Fichier/Exporter... dans OpenOffice), ou en fichier .doc (Sauvegarder sous... dans Microsoft Word). Enfin, veuillez noter qu'Eddie ne prend pas en charge les codes html en mode lecture, mais il peut lire ces fichiers en mode texte en affichant ces codes.

    Pour convertir un fichier dans Eddie, utiliser le déroulant
Type de la boîte de requête Sauvegarder sous... (voir ci-dessous).

    Bref, Eddie ne prend en charge qu'un sous-ensemble des fonctions des texteurs professionnels, mais grâce à ses fonctionnalités inédites, ce qu'il fait, il le fait aussi bien ou mieux que ceux-ci.

    Les commentaires ou critiques des utilisateurs sont les bienvenus.

    
FONCTIONNALITÉS DES MENUS ET LEURS RACCOURCIS CLAVIER
    
    Toutes les commandes disponibles sont accessibles dans les menus
déroulants et les plus utiles, par des raccourcis clavier (voir le résumé à la fin
de ce texte), ou par des boutons sur barre en bas de la fenêtre.

    De plus, on peut accéder aux divers menus en appuyant sur
Alt ou en tapant leur raccourci Alt.
        
Menu Fichier : (Alt-f)

-
Nouvelle fenêtre :        Ouvre une nouvelle fenêtre vide. Ctrl-N

-
Ouvrir... : Ouvre un fichier à partir d'une boîte de dialogue. Ctrl-O

-
Sauvegarder :    Sauvegarde directement le texte de l'écran. Cette Ctrl-s
     commande    bascule l'indicateur de sauvegarde « ✰ - ★ »
    de la barre titre. De plus, comme
Sauvegarder sous..., cette
    commande crée automatiquement une copie de sécurité à
    extension « .bak », par ex. « examen.edd.bak ». Le fichier .bak
    existant, s'il y en a un, est effacé avant d'être remplacé. Un message
    d'avertissement apparaît si la taille du fichier initial est sensiblement
    supérieure à celle du fichier qui doit être sauvegardé. Un message
    d'erreur apparaît en cas d'erreur de sauvegarde. On peut alors
    tenter de défaire les modifications récentes (voir
Défaire ci-dessous).

-
Sauvegarder sous... :        Ouvre le dialogue de sauvegarde standard, Ctrl-S
    qui affiche la liste des fichiers ayant la même extension. Utiliser le
    déroulant
Type pour voir la liste des fichiers portant cette extension
    ou pour changer le format d'un fichier. Utiliser la boîte
Nom du fichier
    pour modifier le nom d'un fichier.

-
Fermer : Ferme un document et vide l'écran sans le fermer (Kill). Ctrl-K

-
Tout quitter : Ferme toutes les fenêtres et quitte le programme Ctrl-Q
    après avertissement. Un autre avertissement est émis si le texte
    a été modifié sans être sauvegardé.

-
Quitter : (Remplace Tout quitter sur les fenêtres secondaires).
    Comme ci-dessus, mais ferme la fenêtre sans prévenir, sauf si le
    texte modifié n'a pas été sauvegardé.
    
N.B. : On peut aussi utiliser la touche Esc pour fermer une fenêtre secondaire.
    
Menu Éditer : (Alt-d)

-
Chercher et remplacer... : Ouvre le dialogue du même nom Ctrl-f
(description détaillée dans
Aide Chercher et remplacer, menu Aide).
        Boîtes de requête :
     •
Chercher quoi... : Mot ou expression à chercher.
     •
Remplacer par... : Mot ou expression de remplacement, le cas échéant.
    Cases à cocher :
     •
Respecter la casse : Majuscules différentes des minuscules.
     •
Mots entiers : Affiche des mots complets seulement.
     •
Afficher tout : Affiche toutes les occurrences globalement.
     •
Expression régulière : Explications : bouton Aide Chercher ci-dessous.
    ¤ Bouton
Chercher : Lance la recherche (comme la touche Entrée) et
     met un mot ou une expression en surbrillance s'il est trouvé.
    ¤ Bouton
Précédent : Recherche l'occurrence précédente en remontant.    
    ¤ Bouton
Remplacer :        Remplace une occurrence à la fois.
    ¤ Bouton
Remplacer tout :     Remplace toutes les occurrences globalement
     de haut en bas, à partir du curseur.
    ¤ Bouton
Aide Chercher : Écran d'aide pour Chercher et Remplacer.
    ¤ Bouton
Quitter :    Ferme le dialogue (ou encore, taper Esc).        
    Pour des informations plus détaillées, consulter
Aide Chercher et remplacer
    dans le menu
Aide, également accessible avec le bouton Aide Chercher dans
    le dialogue
Chercher et remplacer.

-
Recherche multioccurrence... : Ouvre le dialogue du même nom Ctrl-m
    pour effectuer des recherches multioccurrences, multifichiers et
    multirépertoires, c.-à-d. à plusieurs résultats, trouvés dans plusieurs
    fichiers logés dans plusieurs répertoires. Les résultats de chaque
    recherche sont affichés au milieu d'une ligne de contexte sur une liste
    déroulante. Chacune de ces lignes, si elle est cliquée, affiche une
    occurrence dans une fenêtre plein texte à contexte intégral. Il faut
    plus ou moins de temps pour que la liste soit complète mais, comme
    elle alimentée en arrière-plan, on peut consulter les entrées visibles.
    
    
Boîtes de requête :
     •
Répertoire de départ : Tous les fichiers correspondant au masque
     (p. ex. *.txt) seront examinés.
     •
Masque du nom du fichier : Utilise des jokers (? et *, qui représentent
     respectivement un et plusieurs caractères). Ainsi, *2015.t??
     ouvre tous les fichiers dont le nom finit par '2015' et dont l'extension
     à trois caractères commence par un 't', p. ex. Bilan2015.txt.
     •
Codage (par défaut Utf-8) : On peut essayer d'autres codages,
     par exemple Latin-1, si des caractères bizarres sont affichés.
     Pour lire les fichiers Utf-8 et Latin-1, entrer « Utf-8+ ». Cette
     option est peu plus lente que si un seul codage est demandé.
     •
Mot(s) clé(s) recherché(s) : Mot ou expression recherché.
    Options des cases à cocher :
     •
Sous-répertoires inclus? : Recherche récursive dans toute
     l'arborescence des répertoires à partir du répertoire de départ.
     •
Mots entiers :    Majuscules différentes des minuscules.
     •
Respecte la casse : Affiche exclusivement des mots complets.     
    ¤ Bouton [
...] : Ouvre un dialogue pour sélectionner un répertoire.    
    ¤ Bouton
Chercher (ou touche Entrée) : Lance la recherche .
    
    
N.B. : Cet outil de recherche multioccurrence lit aussi (plus lentement) certains fichiers
    binaires, p.ex. des fichiers de texteurs professionnels (.odt, .doc), mais non les .pdf.
    N.B.: Examen de longs textes : il est conseillé de n'ouvrir qu'une fenêtre plein texte à
    la fois pour éviter un écran blanc, signe d'un fort ralentissement.
    
-
Examen de l'orthographe : Vérifie si chacun des mots d'un
    texte ou d'une sélection (en surbrillance) sont orthographiés
    correctement. Il faut corriger les erreurs manuellement, s'il y en a.
    Ne détecte pas les erreurs grammaticales. Pour enlever une ou
    plusieurs des marques rouges, répéter la commande sur un bloc
    surligné comportant le ou les mots corrigés. Ne reconnaît ni les
    noms propres, ni les mots composés (séparés par un trait d'union
    ou une apostrophe). Ceux-ci sont décomposés en mots simples avant
    d'être vérifiés. Le compte de mots de cette fonction ignore les chiffres
    et les caractères ou groupes de caractères non alphabétiques.

    
N.B. : On peut continuer à écrire un texte pendant la vérification, mais il faut éviter de
    le modifier amont, par exemple par des opérations de recherche et remplacement.


-
Aller à... : Dialogue qui permet de se déplacer dans le texte Ctrl-g
    jusqu'au numéro de paragraphe demandé, et qui affiche diverses
    statistiques comme le nombre de mots et la position du curseur
    en trois formats :
    a) paragraphe.caractère : numéro séquentiel du paragraphe et du
    caractère à la position du curseur;
    b) numéro de la ligne/nombre total de lignes et
    c) numéro du caractère/nombre total de caractères,
    utiles pour le débogage et pour la navigation dans les longs textes.    

    
N.B. : La notation a) ci-dessus (paragraphe.caractère) correspond à la notation
    ligne.colonne de l'interface Tkinter, selon laquelle nos « paragraphes » sont des
    lignes de diverses longueurs, les plus longues étant repliées autant de fois que
    nécessaire pour les afficher au complet dans une fenêtre. Ce mode de notation
    de la positon est plus pratique que notre « ligne », dont la longueur varie selon deux
    autres paramètres, la largeur de la fenêtre et la taille de la police de caractères.
    N.B. : Le temps de réponse peut être long pour les très grands textes.

-
Insérer un caractère... :    Boîte de requête qui saisit un symbole Alt-i
    de 1 à 3 caractères (p. ex. « ed » (espace dur) ou « gg »
    (guillemet français gauche) pour insérer divers caractères
    spéciaux (p. ex. œ) ou symboles graphiques (p. ex. °, ¼, €). Voir
    les explications dans la boîte de dialogue. Parce que l'expression
    insérée est copiée dans le presse-papier, on peut la recoller
    ailleurs à volonté, p. ex. ¹ pour une note en bas de page.

-
Joindre (insérer) un fichier... : Fusionne deux ou plus de deux Ctrl-J
    fichiers en insérant le contenu d'un nouveau fichier
avant le
    texte à l'écran, plutôt qu'à sa suite, afin de préserver le formatage
    des fichiers .edd. Il est donc recommandé de commencer par la fin.    

-
Sélectionner tout : Sélectionne tout le texte à l'écran Ctrl-a

-
Centrer :    Centre le(s) mot(s) devant le curseur, ou le curseur Ctrl-T
    d'une ligne vide, avec une limite de deux tabulations (la troisième
    déclenche le centrage de tout ce qui est devant sur la ligne).
    
N.B. : Centrer avant toute autre opération, par exemple avant de changer la
    casse ou le style. De plus, on ne doit pas centrer plus d'une ligne à la fois à cause
    de l'implémentation ligne à ligne du convertisseur edd -> html.
                 
-
Tabulations normales : Rétablit l'espacement normal des Ctrl-t
    tabulations à 1 cm, s'il a été changé, sans limite de nombre autre
    que la longueur de la ligne. Eddie choisit automatiquement cet
    espacement pour tous les formats, sauf pour certains fichiers .edd
    qui comportent un ou plusieurs titres centrés. Dans ce cas, la
    troisième tabulation commande la justification au centre.            

-
Sélection entre guillemets : Place automatiquement la sélection Alt-g
    entre guillemets français (avec espace insécable). On peut aussi
    entrer chacun des guillemets séparément avec la fonction
Insérer.

-
Inverser la casse : S'il n'y a pas de sélection, inverse la casse du Alt-c
    caractère devant le curseur (majuscules <-> minuscules); sinon,
    inverse la casse de toute la sélection. Si la casse de celle-ci est
    mixte, la sélection est convertie en majuscules. Parce que le texte
    original est copié dans le presse-papier, il peut être recollé ailleurs.
    
N.B. : Le cas échéant, changer la casse avant de changer la fonte.
                                    
- Sous-menu
Fonctions d'édition : Ctrl-x, Ctrl-c, Ctrl-v, Ctrl-z, Ctrl-y
Ctrl-X, Ctrl-C, Ctrl-V
    Ce sous-menu, qu'on peut détacher en cliquant sur la ligne de tirets,
    affiche des fonctions utiles pour l'édition :
Couper, Coller, Copier,
    
Défaire (Undo) et Refaire (Redo), avec leur raccourci clavier. Les trois
    premières commandes sont aussi accessibles sur la barre de boutons.
    Les commandes
Défaire (Ctrl-z) et Refaire (Ctrl-y) répondent aussi à
    un raccourci clavier moins connu qui permet des corrections rapides.

    
N.B. : Indice visuel utile : Contrairement à la fonction Copier habituelle, celle d'Eddie
    efface la sélection, confirmant ainsi que la sélection a été copiée dans le presse-papier.
        

Menu Polices et styles : (Alt-p) (voir aussi Aide Polices dans Aide)

-
Sélecteur de fontes... :     Boîte de requête qui saisit un ou plusieurs Ctrl-p
    des trois paramètres (police, taille et style) qui définissent une fonte.
    La fonte par défaut est verdana 11, normal.

    ¤ Bouton
Saisie : Saisit la fonte définie par les trois boîtes d'entrée.
    La touche donne le même résultat. Les valeurs par
    défaut sont utilisées s'il y a des cases vides.
    ¤ Bouton
Colle : Colle le contenu du presse-papier dans la boîte
    d'entrée
Police. Utiliser avec le bouton Copie du fichier Aide Polices
    (voir
Polices suggérées ci-dessous).
    ¤ Bouton
Polices suggérées : Affiche une liste non exclusive de
    polices testées avec succès sous Windows, ainsi que leur taille
    recommandée pour obtenir une hauteur qui équivaut à celle de la
    fonte par défaut, verdana 11, notamment pour    la conversion au
    format html. Pour copier-coller une police: sélectionner une police sur
    la liste cliquer sur le bouton
Copie en bas, puis sur le bouton Coller du
    sélecteur de fontes (ci-dessus). Voir également diverses informations
    générales sur les fontes au bas de la liste.
Ctrl-b, Ctrl-i, Ctrl-u
Ctrl-B, Ctrl-I, Ctrl-U
-
Styles... : Gras, Italiques et Souligné et leurs raccourcis.
    Utiliser ces commandes pour changer des styles simples sans changer
    la police par défaut. Pour changer celle-ci ou pour des styles composés
    (p. ex. bold italic), utiliser le menu
Polices et styles...
    
    
N.B. : Pour annuler les fontes et styles, couper et recoller sur place le texte marqué.

Menu Outils : (Alt-o)

    
Crypter/décrypter : Fonction protégée par mot de passe qui détecte
    automatiquement avant traitement si un fichier est chiffré ou non.
    L'algorithme fonctionne avec toutes les langues de l'Europe occidentale.
    Le résultat affiché à l'écran peut être sauvegardé comme un fichier
    ordinaire, et les fichiers .edd gardent leur formatage. Il est conseillé de
    modifier le nom des fichiers chiffrés en conséquence (p. ex. note_chf.txt).
    

    N.B. : Le cryptage et le décryptage des longs textes peuvent prendre quelques secondes.
        Veuillez patienter pendant qu'Eddie travaille : ses commandes sont inactives.

    
Menu Aide : (Alt-a)

-
Aide :     Ouvre le présent fichier d'aide dans une nouvelle fenêtre. Ctrl-H
-
Aide Chercher et Remplacer : Ouvre un fichier d'aide pour le dialogue
    du même nom.
-
Aide Polices : Fichier d'aide pour le sélecteur de fontes, aussi affiché
    par le bouton
Polices suggérées de ce dernier (voir ci-dessus).
-
À propos... : Nom de l'auteur et numéro de version du programme    

    
RACCOURCIS CLAVIER

- S.v.p.
respecter la casse : Sauf pour certaines commandes courantes
    comme Ctrl-b, Ctrl-i, Ctrl-u (Bold, Italic, Underline) et Ctrl-c, Ctrl-x, Ctrl-v
    (Copier, Couper, Coller), les majuscules sont différentes des minuscules.

- La touche ferme la dernière fenêtre ouverte, mais non la fenêtre
    principale, (Document 1), également reconnaissable par le bouton
    
Tout quitter dans le coin inférieur droit.

Raccourcis clavier utiles :

    Ctrl-a :        Sélectionner tout.
    Ctrl-b :        Met la sélection en caractères gras (Bold).
    Ctrl-c :        Copier la sélection (avec confirmation visuelle).
    Ctrl-f :        Ouvre le dialogue Recherche et Remplacement.
    Ctrl-g :        Affiche des statistiques et va à la ligne demandée (Go).
    Ctrl-H :        Affiche un écran d'aide (Help).
    Ctrl-i :        Met la sélection en italiques (Italic).
    Ctrl-J :        Joint (insère) un fichier au début du texte à l'écran.
    Ctrl-K :        Ferme le texte affiché et vide l'écran (Kill).
    Ctrl-N :        Ouvre une nouvelle fenêtre (New).
    Ctrl-O :        Ouvre le sélecteur de fichiers en mode lecture (Open),
    Ctrl-p :        Ouvre le lecteur/sélecteur de fontes (police, taille et style).
    Ctrl-s :        Sauvegarde directement le texte (Save).
    Ctrl-S :        Ouvre le sélecteur de fichiers en mode sauvegarde (Save as).
    Ctrl-t :        Règle l'espacement des tabulations à 1 cm (valeur par défaut).
    Ctrl-T :        Centre la ligne.
    Ctrl-u :        Souligne la sélection (Underline).
    Ctrl-v :        Colle le contenu du presse-papier.
    Ctrl-x :        Coupe la sélection.
    Ctrl-y :        Refaire (Redo).
    Ctrl-z :        Défaire (Undo).
    Alt-c :        Bascule la casse de la lettre suivante ou de la sélection.
    Alt-g :        Insère des guillemets français de part et d'autre de la sélection.
    Alt-i :        Insère des symboles ou caractères spéciaux.

Autres raccourcis Windows standard utiles pour l'édition de textes :

    Début (Home) :                    Curseur au début de la ligne.
    Fin (End)    :                Curseur à la fin de la ligne.
    Ctrl-Début (Home) :                    Curseur au début du texte.
    Ctrl-Fin (End):                    Curseur à la fin du texte.
    Ctrl -Flèche g/dr. :                    Parcourir un texte mot à mot.
    Maj-Ctrl-Fl. g/dr :                        Sélectionner un ou plusieurs mots.
    Ctrl- Fl. haut/bas :                    Passer d'un paragraphe à l'autre.
    Maj-Ctrl - Fl. h/bas :                    Sélectionner tout un paragraphe.

Raccourcis Emacs :

    Ctrl-k :    Efface la ligne devant le curseur.
    Ctrl-d :    Efface le caractère suivant.
    Ctrl-h :    Efface le caractère précédent.
    Ctrl-i : La commande « Efface le mot devant le curseur » est désactivée
         et met la sélection en  italiques.

    
CONFIGURATION

    Dans le fichier associé util.py, on peut changer les deux variables par
    défaut ci-dessous :
    
    DFONT = 'verdana', 11, 'normal'        # fonte par défaut
    prfx = "txt/"          # sous-répertoire des fichiers txt, edd, etc.

    
UTILISATION DE LA LIGNE DE COMMANDE            

    
Usage : Eddie02.py [[chemin]/nom_fichier] | [-h]] [-v]

    En mode ligne de commande, Eddie accepte un nom de fichier, p. ex.:
    eddie02.py documents/montexte.txt

    Sans arguments, Eddie ouvre l'écran principal vide (Document 1).

    Si le premier argument est '-h', Eddie affiche la ligne d'aide ci-dessus.
    
Sinon, le premier argument doit être le nom du fichier à ouvrir, avec son
    chemin en préfixe s'il n'est pas dans le même répertoire que l'exécutable.

    Si le deuxième argument est '-v', Eddie devient verbeux et affiche
    divers message de débogage.

                        ⮜ Fin du fichier ⮞