Text- und Code-Bearbeitung auf HP Prime.

PrimeEdit ist ein Text-/Code-Editor: Schreiben und
bearbeiten Sie einfache Textnotizen (.txt/.md),
MicroPython-Skripte (.py), JSON-Dateien (.json)
und echte HP-Prime-Katalogprogramme (.hppl) direkt
auf dem Taschenrechner. Zeilennummern,
Zeilenumbruch mit horizontalem Scrollen, Suchen &
Ersetzen, Rückgängig/Wiederholen, ein dunkles
Design mit VS-Code-artiger Syntaxhervorhebung für
.py/.hppl/.json, automatische Vervollständigung,
ein durchsuchbarer Befehlskatalog,
Operatoren-/Symbole-/Zeichentabellen-Panels, pro
Dateityp einstellbare Farben und Textauswahl mit
Kopieren/Ausschneiden/Einfügen machen es
praktisch, echten Code direkt auf dem Gerät zu
schreiben und zu korrigieren, nicht nur anzusehen.


PrimeEdit - Kurzanleitung (DE)
==============================

Ziel
- .txt/.md-Notizen, .py-Skripte, .json-Dateien und
  .hppl-Katalogprogramme auf der HP Prime
  bearbeiten, mit Zeilennummern, Suchen/Ersetzen,
  Rückgängig/Wiederholen, Syntaxhervorhebung,
  Vervollständigung und Touch-Unterstützung.

Start und Dateien
- Beim Start: zuerst erscheint ein 2 Sekunden
  langer Startbildschirm (App-Name, Version,
  Datum), dann öffnet die zuletzt bearbeitete
  Datei erneut, falls save_config_files.txt
  existiert, auch ein Katalogprogramm
  .hppl. Dieser Startbildschirm lässt sich nur
  durch direktes Bearbeiten von settings.json
  deaktivieren.
- Die App verhindert das automatische Abschalten
  des Taschenrechners (Leerlaufzeit verlängert)
  und deaktiviert das Abdunkeln des Bildschirms;
  beide werden beim Beenden (Esc)
  wiederhergestellt.
- Autosave ist standardmäßig aktiviert; speichert
  alle N Minuten (Standard 5, einstellbar über das
  Optionen-Panel oder ein Menü-Icon), aber nur,
  wenn der Puffer nicht gespeicherte Änderungen
  enthält: stilles Speichern, wenn die Datei
  bereits einen Namen hat, sonst wird gefragt.
- Icons für Neu
  (.txt/.json/.py/.hppl)/Öffnen/Speichern/Speichern
  unter. Speichern fragt nie nach einem
  Dateinamen, nur Speichern unter tut
  das. Speichern unter einem bereits vorhandenen
  Namen fragt zuerst, ob überschrieben werden
  soll.
- Speichern unter erlaubt die Wahl, unter welcher
  installierten App eine .txt/.md/.py/.json-Datei
  gespeichert wird (Standard: PrimeEdit selbst);
  ein Name, der auf .hppl endet, wird stattdessen
  als echtes Katalogprogramm über den
  Programs()-Mechanismus geschrieben. Ein eigenes
  Icon „Programm öffnen" erlaubt das direkte
  Öffnen und Bearbeiten eines bestehenden
  Katalogprogramms.

Navigation und Ansicht
- Cursor: Pfeiltasten, Pos1/Ende, Bild auf/ab. Ein
  Antippen an einer beliebigen Stelle im Text
  setzt den Cursor dorthin; Ziehen scrollt.
- Zeilen brechen bei 80 Spalten um, vorzugsweise
  nach einem Leerzeichen; darüber hinaus zeigt
  horizontales Scrollen (Wischen, oder
  automatisches Mitführen des Cursors beim Tippen)
  den Rest der Zeile. Gleiches Verhalten für jeden
  Dateityp.
- Die Spalte mit den Zeilennummern kann über das
  Optionen-Panel (siehe unten) ausgeblendet
  werden, um mehr Breite für den Umbruch zu
  gewinnen.
- Der Cursor blinkt gleichmäßig, damit man seine
  Position immer wiederfindet.

Text eingeben
- Zeichen werden über die physische
  ALPHA/Shift-Tastaturbelegung eingegeben, genau
  wie in den nativen Apps des Taschenrechners.
- ALPHA und Shift durchlaufen jeweils einen Zyklus
  aus -> einmal -> gesperrt: einmal antippen für
  ein einzelnes Zeichen, zweimal schnell antippen
  zum Sperren, ein drittes Mal antippen zum Lösen.

Suchen, Ersetzen, Gehe zu Zeile und
Rückgängig/Wiederholen
- Plot öffnet die Sucheingabe (oder findet die
  nächste Übereinstimmung, wenn bereits ein
  Suchbegriff gesetzt ist); View öffnet „Gehe zu
  Zeile"; Menu/Symb öffnen das Menü und die
  Farbpalette. Keine dieser Tasten ist eine
  Eingabetaste, sodass jede Taste der Tastatur für
  die Bearbeitung frei bleibt.
- Cas macht die letzte Änderung rückgängig, Num
  stellt sie wieder her (standardmäßig 32 Stufen,
  einstellbar über das Optionen-Panel) - dieselben
  Aktionen wie die Zeilen
  „Rückgängig"/„Wiederholen" im Optionen-Panel.

Dateitypen: .txt, .md, .py, .json und .hppl
- .txt/.md-Dateien werden standardmäßig in
  einfachem schwarzem Text auf weißem Grund
  angezeigt (helles Design);
  .py-/.hppl-/.json-Dateien wechseln standardmäßig
  zu einem dunklen Design (schwarzer Hintergrund,
  weißer Text) mit vollständiger
  Syntaxhervorhebung. Diese Farben sind
  vollständig anpassbar, siehe „Farbpanel" unten.
- Eine .hppl-Datei direkt aus dem Programmkatalog
  des Taschenrechners geöffnet? Sie wird mit
  derselben hervorgehobenen Ansicht dargestellt
  wie eine lokale .hppl-Datei und lädt sich beim
  nächsten Start automatisch erneut.

Farbpanel
- Ein eigenes Icon im Banner, direkt rechts neben
  dem Hamburger (zwei kleine Quadrate mit den
  aktuellen Text-/Hintergrundfarben), öffnet ein
  Panel mit 10 Einstellungen, verteilt auf mehrere
  Seiten: Hintergrund- und Textfarbe des Puffers,
  des Banners, der Statusleiste, der Panels und
  der Zeilennummern-Spalte.
- Jede Zeile öffnet erneut das Farbrad, um eine
  freie (RGB-)Farbe zu wählen. Alle 10 Farben
  werden für jeden Dateityp unabhängig eingestellt
  (.txt/.md teilen sich dieselbe Einstellung,
  .py/.hppl/.json haben jeweils ihre eigene) -
  beim Wechseln der Datei werden automatisch die
  passenden Farben des jeweiligen Typs angewendet.
- Pfeil hoch/runter navigieren über die Tastatur
  im Panel, Enter öffnet das Farbrad für die
  ausgewählte Zeile (oder wechselt bei
  „Weiter"/„Zurück" die Seite); ein Antippen
  außerhalb des Panels schließt es.

Syntaxhervorhebung
- .py-/.hppl-/.json-Code wird mit einer eigenen
  Bitmap-Schriftart fester Größe gezeichnet,
  sodass Schlüsselwörter, Strings, Kommentare und
  Zahlen jeweils ihre eigene Farbe erhalten, nach
  dem weithin bekannten "Dark+"-Schema von VS
  Code.

Automatische Vervollständigung
- Beim Eintippen eines Bezeichners in einer .py-
  oder .hppl-Datei öffnet sich automatisch ein
  Vorschlags-Popup, sobald 2 Zeichen eingegeben
  wurden - Schlüsselwörter,
  integrierte/Bibliotheksnamen und bereits an
  anderer Stelle in der Datei verwendete
  Bezeichner zählen alle mit.
- Pfeil hoch/runter bewegen die Auswahl innerhalb
  des Popups, ohne den Cursor im Text zu
  bewegen. Enter nach der Nutzung von Pfeil
  hoch/runter fügt den hervorgehobenen Vorschlag
  ein; Enter ohne vorheriges Durchblättern der
  Liste startet wie gewohnt einfach eine neue
  Zeile, sodass nie versehentlich ein
  Zeilenumbruch verloren geht.
- Ein Antippen eines Vorschlags übernimmt ihn
  direkt. Eine echte Funktion oder Methode wird
  mit bereits gesetzten Klammern eingefügt, Cursor
  dazwischen, bereit für Argumente; ein
  Schlüsselwort oder ein einfacher Bezeichner wird
  unverändert eingefügt.
- Die automatische Vervollständigung lässt sich
  über das Optionen-Panel abschalten, falls sie
  stört.
- Sie löst nie innerhalb eines Kommentars (# oder
  //) oder eines Python-"""-Blocks aus, auch wenn
  dieser sich über mehrere Zeilen erstreckt.

Befehlskatalog
- In einer .py- oder .hppl-Datei öffnet ein
  zweites Icon im oberen Banner (zeigt "py"/"ppl",
  rechts) einen vollständigen, durchsuchbaren
  Katalog: HPPL-Befehle nach Kategorie gruppiert
  (Grafik, Strings, Listen, Kontrollstrukturen und
  mehr), oder MicroPython nach Modul gruppiert,
  mit Klassen und ihren Methoden eine Ebene tiefer
  verschachtelt.
- Mit Weiter/Zurück blättern, ein Eintrag antippen
  fügt ihn am Cursor ein. Dies dient dazu, einen
  Befehl zu entdecken, dessen genauen Namen man
  nicht mehr weiß, als Alternative zur Eingabe
  eines Präfixes im Vervollständigungs-Popup.

Operatoren-, Symbole- und Zeichentabellen-Panels
- Shift+6 öffnet ein Raster mit
  Vergleichs-/Logikoperatoren (<= >= != AND OR
  NOT...), passend zur Sprache der geöffneten
  Datei; Shift+9 öffnet ein Raster mit Symbolen
  und griechischen Buchstaben (-> unendlich ° ' "
  & Å alpha beta gamma...). Beide sind in jedem
  Dateityp verfügbar, ein Eintrag antippen fügt
  ihn am Cursor ein.
- Shift+Vars (oder die Zeile „Zeichentabelle" im
  Optionen-Panel) öffnet einen Browser für gängige
  Unicode-Blöcke (Latein, Griechisch, Kyrillisch,
  Symbole...) mit Schnellzugriff auf Buchstaben
  mit Akzenten ganz oben in der Liste, um ein
  Zeichen einzufügen, das auf der physischen
  Tastatur fehlt.

Optionen-Panel
- Das Hamburger-Icon (drei Balken, oben links im
  Banner) oder die Apps-Taste antippen öffnet ein
  kompaktes Panel mit Einstellungen und Aktionen:
  - Zeilennummern: Spalte anzeigen oder
    ausblenden.
  - Automatische Vervollständigung:
    Vorschlags-Popup ein- oder ausschalten.
  - Speichern: Intervall des automatischen
    Speicherns, in Minuten.
  - Rückgängig/Wiederholen-Stufen: wie viele
    Stufen aufbewahrt werden (standardmäßig 32).
  - Auswahl: eine Textauswahl setzen oder
    aufheben, verankert an der aktuellen
    Cursorposition.
  - Kopieren / Ausschneiden / Einfügen, wirkt auf
    die aktuelle Auswahl und eine Zwischenablage
    im Speicher, die einen Dateiwechsel übersteht.
  - Rückgängig / Wiederholen: dieselben Aktionen
    wie die Tasten Cas/Num.
  - Zeichentabelle: öffnet das oben beschriebene
    Unicode-Zeichenpanel.
- Ein Antippen außerhalb des Panels schließt es.

Textauswahl
- Einmal über das Optionen-Panel gesetzt,
  erweitert jede Cursorbewegung - Pfeiltasten,
  Pos1/Ende, Seitensprünge oder ein Antippen an
  anderer Stelle im Text - die Auswahl,
  dargestellt als hervorgehobenes Band. Keine
  zusätzliche Tastenkombination ist nötig.
- Kopieren lässt die Auswahl nach dem Kopieren
  bestehen; Einfügen ersetzt eine aktive Auswahl
  durch den Inhalt der Zwischenablage, wie in den
  meisten Editoren üblich.

Tastenkürzel (HP-Prime-Tasten)
- Menu: Menü öffnen. Symb: Farbpalette. Plot:
  Suchen / nächstes Vorkommen. View: Gehe zu
  Zeile. Cas: Rückgängig. Num:
  Wiederholen. Shift+6: Operatoren. Shift+9:
  Symbole. Shift+Vars: Zeichentabelle. Apps:
  Optionen-Panel. Esc: schließt ein geöffnetes
  Popup/Panel, oder beendet die App, wenn nichts
  geöffnet ist (bietet vorher an zu speichern,
  falls es nicht gespeicherte Änderungen gibt).
