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

CONTENU
---------------------------------------------------------------------
  LectureDys-arm64.dmg     Installateur pour Mac Apple Silicon
                            (M1, M2, M3, M4...)
  LectureDys-x86_64.dmg    Installateur pour Mac Intel
  README.txt                Ce document
  manuel_utilisation.txt    Guide d'utilisation du programme

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


QUEL FICHIER .DMG CHOISIR ?
---------------------------------------------------------------------
Menu Pomme > "A propos de ce Mac" :
  - "Puce Apple M1 / M2 / M3 / M4..." -> LectureDys-arm64.dmg
  - "Processeur ... Intel"            -> LectureDys-x86_64.dmg

En cas de doute, LectureDys-arm64.dmg convient a tous les Mac vendus
depuis fin 2020 ; LectureDys-x86_64.dmg est pour les Mac plus anciens
(processeur Intel).


CONFIGURATION REQUISE
---------------------------------------------------------------------
  - macOS recent (Ventura/Sonoma/Sequoia ou plus recent).


INSTALLATION
---------------------------------------------------------------------
1) Double-cliquer sur le fichier .dmg correspondant a votre Mac : une
   fenetre s'ouvre, montrant LectureDys.app.

2) Faire glisser LectureDys.app vers le dossier Applications
   (ouvrez un second Finder sur votre dossier Applications, ou
   utilisez l'icone "Applications" dans la barre laterale du Finder,
   puis glissez l'icone de l'application dedans).

3) Ejecter le disque "LectureDys" (icone d'ejection a cote de son
   nom dans la barre laterale du Finder), puis, si vous le
   souhaitez, supprimer le fichier .dmg telecharge.

Ne lancez pas l'application directement depuis la fenetre du .dmg
en usage courant : copiez-la d'abord dans Applications.


PREMIER LANCEMENT ET GATEKEEPER
---------------------------------------------------------------------
L'application n'est pas signee ni notarisee par Apple (pas
d'abonnement developpeur Apple pour ce projet associatif/
pedagogique). Au tout premier lancement, macOS affiche donc un
avertissement du type "LectureDys ne peut pas etre ouvert car
Apple ne peut pas verifier qu'il ne contient pas de logiciel
malveillant" et empeche l'ouverture par un simple double-clic.

Pour l'autoriser (une seule fois) :

  Option A - via le Finder :
    1) Dans Applications, faire un clic droit (ou Ctrl-clic) sur
       LectureDys.app.
    2) Choisir "Ouvrir".
    3) Confirmer en cliquant a nouveau sur "Ouvrir" dans la boite de
       dialogue. Les lancements suivants se feront normalement par
       simple double-clic.

  Option B - via les Reglages Systeme :
    1) Essayer d'ouvrir l'application normalement (elle sera
       bloquee).
    2) Aller dans Reglages Systeme > Confidentialite et securite.
    3) Une mention concernant LectureDys apparait en bas de la page,
       avec un bouton "Ouvrir quand meme". Cliquer dessus puis
       confirmer.

  Option C - via le Terminal (utilisateurs a l'aise avec la ligne de
  commande) :
       xattr -cr /Applications/LectureDys.app


DESINSTALLATION
---------------------------------------------------------------------
  - Faire glisser LectureDys.app (dans Applications) vers la
    Corbeille.
  - Pour repartir de zero (langue choisie, etc.) : supprimer aussi
    le dossier ~/.config/lecture_dys/.


PROBLEMES CONNUS / DEPANNAGE
---------------------------------------------------------------------
  - "LectureDys est endommagee et ne peut pas etre ouverte" :
      ce message (different de l'avertissement Gatekeeper normal
      decrit ci-dessus) apparait parfois quand macOS a mis en
      quarantaine l'application apres un telechargement via
      navigateur. Solution : ouvrir le Terminal et lancer
          xattr -cr /Applications/LectureDys.app
      puis relancer l'application.

  - L'application se lance mais rien ne s'affiche, ou plante
    immediatement :
      vous avez probablement installe le .dmg pour la mauvaise
      architecture (Intel sur un Mac Apple Silicon, ou inversement).
      Verifiez via le menu Pomme > "A propos de ce Mac" et
      reinstallez avec le bon fichier .dmg (voir "Quel fichier .dmg
      choisir ?" ci-dessus).

  - Le fichier texte s'affiche avec des caracteres bizarres :
      voir la section "Depannage" de manuel_utilisation.txt.


COMPILER DEPUIS LES SOURCES
---------------------------------------------------------------------
Le code source complet (lecture_dys.py) et le script de
construction (build_macos.sh) sont disponibles dans le depot du
projet. GTK4/PyGObject necessitent Homebrew sous macOS (aucune roue
PyPI officielle pour PyGObject) : voir les commentaires en tete de
build_macos.sh pour la procedure complete. Le script doit etre
execute une fois sur un Mac Apple Silicon et une fois sur un Mac
Intel pour produire les deux .dmg (ou, sur un Mac Apple Silicon,
une seconde fois via Rosetta 2 avec une installation Homebrew Intel
sous /usr/local).


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

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