=====================================================================
  LECTURE FACON DYSLEXIE - README (Linux)
  Projet Ector
=====================================================================

CONTENU
---------------------------------------------------------------------
  lecture_dys-x86_64.AppImage   Application autonome (tout-en-un)
  README.txt                    Ce document
  manuel_utilisation.txt        Guide d'utilisation du programme

L'AppImage embarque Python, GTK4/PyGObject et toutes les ressources
necessaires (traductions, logo, icone) : aucune installation de
dependance n'est requise.


CONFIGURATION REQUISE
---------------------------------------------------------------------
  - Linux 64 bits (x86_64) avec un environnement graphique
    (X11 ou Wayland) ; glibc recente (distributions courantes de ces
    dernieres annees : Ubuntu, Debian, Fedora, Mint, etc.).
  - Ne fonctionne pas dans un terminal sans interface graphique
    (SSH sans redirection X, console texte...).


INSTALLATION ET LANCEMENT
---------------------------------------------------------------------
1) Copier lecture_dys-x86_64.AppImage a l'emplacement de votre choix
   (ex. ~/Applications/ ou ~/bin/).

2) Le rendre executable :
       chmod +x lecture_dys-x86_64.AppImage

3) Le lancer :
       ./lecture_dys-x86_64.AppImage
   ou double-clic dans le gestionnaire de fichiers (Nautilus,
   Dolphin, Nemo...). Sur certaines distributions, un double-clic
   sur un fichier .AppImage propose "Executer" ou "Executer dans un
   terminal" au lieu de lancer directement : c'est normal, choisir
   "Executer".


AJOUTER UN RACCOURCI DANS LE MENU DES APPLICATIONS (facultatif)
---------------------------------------------------------------------
1) Copier l'icone lecture_dys.svg (ou icon_256.png) dans
       ~/.local/share/icons/

2) Creer le fichier ~/.local/share/applications/lecture_dys.desktop
   avec ce contenu (adapter le chemin "Exec" a l'emplacement reel de
   l'AppImage) :

       [Desktop Entry]
       Type=Application
       Name=Lecture facon dyslexie
       Comment=Simule une lecture avec lettres en miroir et grossissement aleatoires
       Exec=/chemin/vers/lecture_dys-x86_64.AppImage
       Icon=/home/VOTRE_UTILISATEUR/.local/share/icons/lecture_dys.svg
       Terminal=false
       Categories=Education;Utility;
       StartupWMClass=fr.ector.lecturedys

3) Le raccourci apparait dans le menu des applications (parfois
   apres deconnexion/reconnexion, ou "update-desktop-database
   ~/.local/share/applications" sur certaines distributions).


DESINSTALLATION
---------------------------------------------------------------------
  - Supprimer le fichier lecture_dys-x86_64.AppImage.
  - Si un raccourci de menu a ete cree : supprimer
    ~/.local/share/applications/lecture_dys.desktop et l'icone
    copiee dans ~/.local/share/icons/.
  - Pour repartir de zero (langue choisie, etc.) : supprimer
    ~/.config/lecture_dys/.


PROBLEMES CONNUS / DEPANNAGE
---------------------------------------------------------------------
  - "dlopen(): error loading libfuse.so.2" ou l'AppImage ne se lance
    pas du tout :
      certaines distributions recentes (notamment via Wayland/
      conteneurs, ou des distributions n'ayant pas FUSE par defaut)
      n'ont plus la bibliotheque FUSE necessaire au format AppImage.
      Deux solutions :
        a) installer FUSE :
             Debian/Ubuntu : sudo apt install libfuse2
             Fedora        : sudo dnf install fuse-libs
        b) ou extraire et lancer sans FUSE :
             ./lecture_dys-x86_64.AppImage --appimage-extract-and-run

  - "Permission denied" au lancement :
      le fichier n'a pas les droits d'execution, voir chmod +x
      ci-dessus.

  - Rien ne s'affiche / erreur liee a GTK ou a l'affichage :
      verifier que vous etes bien dans une session graphique (pas
      un simple terminal SSH), et que les pilotes graphiques de la
      machine sont a jour.

  - Icone generique / pas d'icone dans le menu :
      verifier le chemin "Icon=" du fichier .desktop cree (voir
      ci-dessus), et que le fichier d'icone existe bien a cet
      emplacement.


COMPILER DEPUIS LES SOURCES
---------------------------------------------------------------------
Le code source complet (lecture_dys.py) et le script de
construction de l'AppImage (build_appimage.sh) sont disponibles dans
le depot du projet. Voir les commentaires en tete de
build_appimage.sh pour les prerequis (paquets systeme python3-gi,
python3-gi-cairo, gir1.2-gtk-4.0).


VOIR AUSSI
---------------------------------------------------------------------
  manuel_utilisation.txt : guide complet des fonctionnalites du
  programme (barre d'outils, curseur de frequence, menu de langue,
  conseils d'utilisation pedagogique...).

=====================================================================
