Edition de texte et de code sur HP Prime.

PrimeEdit est un editeur de texte/code : ecrivez
et modifiez des notes en texte brut (.txt/.md),
des scripts MicroPython (.py), des fichiers JSON
(.json) et de vrais programmes du catalogue HP
Prime (.hppl) directement sur la
calculatrice. Numeros de ligne, retour a la ligne
avec defilement horizontal, recherche &
remplacement, annuler/refaire, theme sombre avec
coloration syntaxique façon VS Code pour
.py/.hppl/.json, completion automatique, catalogue
de commandes parcourable, panneaux
d'operateurs/symboles/table de caracteres,
couleurs personnalisables par type de fichier, et
selection de texte avec copier/couper/coller
permettent d'ecrire et de corriger du vrai code
sur l'appareil, pas seulement de le consulter.


PrimeEdit - Tutoriel rapide (FR)
=================================

But
- Editer des notes .txt/.md, des scripts .py, des
  fichiers .json et des programmes .hppl du
  catalogue sur HP Prime, avec numeros de ligne,
  recherche/remplacement, annuler/refaire,
  coloration syntaxique, completion et support
  tactile.

Demarrage et fichiers
- Au lancement : un ecran de demarrage de 2
  secondes s'affiche d'abord (nom de l'app,
  version, date), puis reouvre le dernier fichier
  si save_config_files.txt existe, y compris un
  programme .hppl du catalogue. Cet ecran ne peut
  etre desactive qu'en modifiant directement
  settings.json.
- L'application bloque l'extinction automatique de
  la calculatrice (delai d'inactivite allonge) et
  desactive l'assombrissement de l'ecran ; les
  deux sont restaures a la sortie (Esc).
- Sauvegarde automatique activee par defaut ; se
  declenche toutes les N minutes (5 par defaut,
  reglable depuis le panneau d'options ou une
  icone du menu), mais seulement si le buffer
  contient des modifications non sauvegardees :
  sauvegarde silencieuse si le fichier a deja un
  nom, sinon propose d'enregistrer.
- Icones Nouveau
  (.txt/.json/.py/.hppl)/Ouvrir/Enregistrer/Enregistrer
  sous. Enregistrer ne demande jamais de nom de
  fichier, seul Enregistrer sous le
  fait. Enregistrer sous un nom deja existant
  demande confirmation avant d'ecraser.
- Enregistrer sous permet de choisir sous quelle
  application installee un fichier
  .txt/.md/.py/.json est sauvegarde (par defaut :
  PrimeEdit lui-meme) ; un nom se terminant par
  .hppl est a la place ecrit comme un vrai
  programme du catalogue via le mecanisme
  Programs(). Une icone dediee « ouvrir un
  programme » permet d'ouvrir et de modifier
  directement un programme du catalogue existant.

Navigation et vue
- Curseur : fleches, Origine/Fin, page
  precedente/suivante. Taper n'importe ou dans le
  texte y place le curseur ; glisser fait defiler.
- Les lignes se replient a 80 colonnes, de
  preference apres un espace ; au-dela, un
  defilement horizontal (glisser tactile, ou suivi
  automatique du curseur en tapant) laisse voir le
  reste de la ligne. Meme comportement pour tous
  les types de fichier.
- La gouttiere des numeros de ligne peut etre
  masquee depuis le panneau d'options (voir plus
  bas) pour gagner de la largeur de repli.
- Le curseur clignote regulierement pour toujours
  retrouver sa position.

Saisie de texte
- Les caracteres se tapent via la disposition
  physique du clavier ALPHA/Shift, exactement
  comme dans les applications natives de la
  calculatrice.
- ALPHA et Shift suivent chacun un cycle eteint ->
  une fois -> verrouille : un appui pour un seul
  caractere, deux appuis rapides pour verrouiller,
  un troisieme appui pour relacher.

Recherche, remplacement, aller a la ligne et
annuler/refaire
- Plot ouvre l'invite de recherche (ou trouve
  l'occurrence suivante si un terme est deja
  defini) ; View ouvre « aller a la ligne » ;
  Menu/Symb ouvrent le menu et la palette de
  couleurs. Aucune de ces touches n'est une touche
  de saisie, donc toutes les touches du clavier
  restent libres pour l'edition.
- Cas annule la derniere modification, Num la
  retablit (32 niveaux par defaut, reglable depuis
  le panneau d'options) - memes actions que les
  lignes « Annuler »/« Refaire » du panneau
  d'options.

Types de fichiers : .txt, .md, .py, .json et .hppl
- Les fichiers .txt/.md s'affichent par defaut en
  texte noir sur fond blanc (theme clair) ; les
  fichiers .py/.hppl/.json passent par defaut en
  theme sombre (fond noir, texte blanc) avec
  coloration syntaxique complete. Ces couleurs
  sont entierement personnalisables, voir «
  Panneau de couleurs » plus bas.
- Ouvert un fichier .hppl directement depuis le
  catalogue de programmes de la calculatrice ? Il
  s'affiche avec la meme vue coloree qu'un fichier
  .hppl local, et se recharge automatiquement au
  prochain demarrage.

Panneau de couleurs
- Une icone dediee dans le bandeau, juste a droite
  du hamburger (deux petits carres montrant les
  couleurs actuelles de texte/fond), ouvre un
  panneau regroupant 10 reglages, repartis sur
  plusieurs pages : couleur de fond et de texte du
  buffer, du bandeau, de la barre de statut, des
  panneaux et de la gouttiere de numeros de ligne.
- Chaque ligne rouvre la palette circulaire pour
  choisir une couleur libre (RVB). Les 10 couleurs
  sont reglees independamment pour chacun des
  types de fichier (.txt/.md partagent le meme
  reglage, .py/.hppl/.json chacun le leur) -
  changer de fichier applique automatiquement les
  couleurs du type correspondant.
- Haut/Bas naviguent dans le panneau au clavier,
  Entree ouvre la palette sur la ligne
  selectionnee (ou change de page sur les lignes «
  Retour »/« Suivant ») ; taper en dehors du
  panneau le ferme.

Coloration syntaxique
- Le code .py/.hppl/.json est dessine avec une
  police bitmap dediee de taille fixe, si bien que
  mots-cles, chaines, commentaires et nombres ont
  chacun leur propre couleur, selon le schema tres
  reconnu "Dark+" de VS Code.

Completion automatique
- En tapant un identifiant dans un fichier .py ou
  .hppl, une popup de suggestions s'ouvre
  automatiquement des 2 caracteres tapes -
  mots-cles, noms de bibliotheque/API integree, et
  identifiants deja utilises ailleurs dans le
  fichier comptent tous.
- Haut/Bas deplacent la selection dans la popup
  sans jamais deplacer le curseur dans le
  texte. Appuyer sur Entree apres avoir utilise
  Haut/Bas insere la suggestion en surbrillance ;
  appuyer sur Entree sans avoir parcouru la liste
  insere simplement une nouvelle ligne comme
  d'habitude, pour ne jamais perdre un retour a la
  ligne par accident.
- Taper une suggestion l'accepte directement. Une
  vraie fonction ou methode s'insere avec ses
  parentheses deja en place, curseur atterrissant
  entre les deux, prete pour les arguments ; un
  mot-cle ou un simple identifiant s'insere tel
  quel.
- La completion automatique peut etre desactivee
  depuis le panneau d'options si elle derange.
- Elle ne se declenche jamais a l'interieur d'un
  commentaire (# ou //) ni d'un bloc """ Python,
  meme etale sur plusieurs lignes.

Catalogue de commandes
- Dans un fichier .py ou .hppl, une seconde icone
  dans le bandeau superieur (affichant "py"/"ppl",
  a droite) ouvre un catalogue complet et
  parcourable : commandes HPPL groupees par
  categorie (graphique, chaines, listes,
  structures de controle, et plus), ou MicroPython
  groupe par module, avec les classes et leurs
  methodes imbriquees un niveau plus bas.
- Parcourir avec Suivant/Retour, taper une entree
  l'insere au curseur. Ceci est pense pour
  decouvrir une commande dont on ne se souvient
  pas du nom exact, en alternative a la saisie
  d'un prefixe dans la popup de completion.

Panneaux d'operateurs, de symboles et de table de
caracteres
- Shift+6 ouvre une grille d'operateurs de
  comparaison/logiques (<= >= != AND OR NOT...)
  adaptee au langage du fichier ouvert ; Shift+9
  ouvre une grille de symboles et lettres grecques
  (-> infini ° ' " & Å alpha beta gamma...). Les
  deux sont accessibles dans tous les types de
  fichier, taper une entree l'insere au curseur.
- Shift+Vars (ou la ligne « Table de caracteres »
  du panneau d'options) ouvre un navigateur de
  blocs Unicode (latin, grec, cyrillique,
  symboles...) avec un acces rapide aux lettres
  accentuees francaises en tete de liste, pour
  inserer un caractere absent du clavier physique.

Panneau d'options
- Taper l'icone hamburger (trois barres, en haut a
  gauche du bandeau) ou la touche Apps ouvre un
  panneau compact de reglages et d'actions :
  - Numeros de ligne : afficher ou masquer la
    gouttiere.
  - Completion automatique : activer ou desactiver
    la popup de suggestions.
  - Sauvegarde : intervalle de la sauvegarde
    automatique, en minutes.
  - Annuler/Refaire : nombre de niveaux conserves
    (32 par defaut).
  - Selection : armer ou desarmer une selection de
    texte ancree a la position actuelle du
    curseur.
  - Copier / Couper / Coller, agissant sur la
    selection courante et un presse-papiers en
    memoire qui survit au changement de fichier.
  - Annuler / Refaire : memes actions que les
    touches Cas/Num.
  - Table de caracteres : ouvre le panneau de
    caracteres Unicode decrit plus haut.
- Taper en dehors du panneau le ferme.

Selection de texte
- Une fois armee depuis le panneau d'options, tout
  deplacement du curseur - fleches, Origine/Fin,
  sauts de page, ou un tap ailleurs dans le texte
  - etend la selection, affichee comme une bande
  en surbrillance. Aucune combinaison de touches
  supplementaire n'est necessaire.
- Copier laisse la selection en place apres la
  copie ; Coller remplace une selection active par
  le contenu du presse-papiers, comme dans la
  plupart des editeurs.

Raccourcis (touches HP Prime)
- Menu : ouvrir le menu. Symb : palette de
  couleurs. Plot : rechercher / occurrence
  suivante. View : aller a la ligne. Cas :
  annuler. Num : refaire. Shift+6 :
  operateurs. Shift+9 : symboles. Shift+Vars :
  table de caracteres. Apps : panneau
  d'options. Esc : ferme une popup/un panneau
  ouvert, ou quitte l'application si rien n'est
  ouvert (propose d'enregistrer d'abord s'il y a
  des modifications non sauvegardees).
