Tekst- en codebewerking op HP Prime.

PrimeEdit is een tekst-/code-editor: schrijf en
bewerk gewone tekstnotities (.txt/.md),
MicroPython-scripts (.py), JSON-bestanden (.json)
en echte HP Prime-catalogusprogramma's (.hppl)
rechtstreeks op de rekenmachine. Regelnummers,
regelterugloop met horizontaal scrollen, zoeken &
vervangen, ongedaan maken/opnieuw, een donker
thema met VS Code-achtige syntaxismarkering voor
.py/.hppl/.json, automatisch aanvullen, een
doorzoekbare opdrachtcatalogus,
operatoren-/symbolen-/tekentabelpanelen, per
bestandstype instelbare kleuren, en tekstselectie
met kopiëren/knippen/plakken maken het praktisch
om echte code direct op het toestel te schrijven
en te corrigeren, niet alleen te bekijken.


PrimeEdit - Snelle handleiding (NL)
====================================

Doel
- .txt/.md-notities, .py-scripts, .json-bestanden
  en .hppl-catalogusprogramma's bewerken op de HP
  Prime, met regelnummers, zoeken/vervangen,
  ongedaan maken/opnieuw, syntaxismarkering,
  automatisch aanvullen en aanraakondersteuning.

Starten en bestanden
- Bij het opstarten: eerst verschijnt een
  opstartscherm van 2 seconden (app-naam, versie,
  datum), daarna heropent het laatst bewerkte
  bestand als save_config_files.txt bestaat, ook
  een catalogusprogramma .hppl. Dit opstartscherm
  kan alleen worden uitgeschakeld door
  settings.json rechtstreeks te bewerken.
- De app voorkomt automatisch uitschakelen van de
  rekenmachine (wachttijd verlengd) en schakelt
  schermdimming uit; beide worden hersteld bij
  afsluiten (Esc).
- Automatisch opslaan is standaard ingeschakeld;
  slaat elke N minuten op (standaard 5, instelbaar
  vanuit het optiespaneel of een menu-icoon), maar
  alleen als de buffer niet-opgeslagen wijzigingen
  bevat: stilzwijgend opslaan als het bestand al
  een naam heeft, anders wordt erom gevraagd.
- Iconen voor Nieuw
  (.txt/.json/.py/.hppl)/Openen/Opslaan/Opslaan
  als. Opslaan vraagt nooit om een bestandsnaam,
  alleen Opslaan als doet dat. Opslaan onder een
  naam die al bestaat vraagt eerst om bevestiging
  om te overschrijven.
- Met Opslaan als kun je kiezen onder welke
  geïnstalleerde app een
  .txt/.md/.py/.json-bestand wordt opgeslagen
  (standaard: PrimeEdit zelf); een naam die
  eindigt op .hppl wordt in plaats daarvan
  geschreven als een echt catalogusprogramma via
  het Programs()-mechanisme. Een speciaal icoon
  "programma openen" laat je een bestaand
  catalogusprogramma direct openen en bewerken.

Navigatie en weergave
- Cursor: pijltjestoetsen, Home/End, pagina
  op/neer. Tik ergens in de tekst om de cursor
  daar te plaatsen; sleep om te scrollen.
- Regels vouwen om bij 80 kolommen, bij voorkeur
  na een spatie; daarna toont horizontaal scrollen
  (slepen, of de cursor die automatisch meebeweegt
  tijdens het typen) de rest van de
  regel. Hetzelfde gedrag voor elk bestandstype.
- De kolom met regelnummers kan worden verborgen
  via het optiespaneel (zie hieronder) om meer
  breedte te winnen voor de terugloop.
- De cursor knippert gelijkmatig, zodat je je
  positie altijd terugvindt.

Tekst typen
- Tekens worden getypt via de fysieke
  ALPHA/Shift-toetsenbordindeling, precies zoals
  in de native apps van de rekenmachine.
- ALPHA en Shift doorlopen elk een cyclus uit ->
  eenmaal -> vergrendeld: eenmaal tikken voor een
  enkel teken, tweemaal snel tikken om te
  vergrendelen, een derde keer tikken om los te
  laten.

Zoeken, vervangen, ga naar regel, en ongedaan
maken/opnieuw
- Plot opent het zoekvenster (of vindt de volgende
  overeenkomst als er al een zoekterm is
  ingesteld); View opent "ga naar regel";
  Menu/Symb openen het menu en het
  kleurenpalet. Geen van deze toetsen is een
  typtoets, zodat elke toets van het toetsenbord
  vrij blijft voor bewerking.
- Cas maakt de laatste wijziging ongedaan, Num
  voert deze opnieuw uit (standaard 32 niveaus,
  instelbaar vanuit het optiespaneel) - dezelfde
  acties als de regels "Ongedaan maken"/"Opnieuw"
  in het optiespaneel.

Bestandstypen: .txt, .md, .py, .json en .hppl
- .txt/.md-bestanden worden standaard weergegeven
  in gewone zwarte tekst op wit (licht thema);
  .py-/.hppl-/.json-bestanden schakelen standaard
  over naar een donker thema (zwarte achtergrond,
  witte tekst) met volledige
  syntaxismarkering. Deze kleuren zijn volledig
  aanpasbaar, zie "Kleurenpaneel" hieronder.
- Een .hppl-bestand rechtstreeks vanuit de
  programmacatalogus van de rekenmachine geopend?
  Het wordt weergegeven met dezelfde gemarkeerde
  weergave als een lokaal .hppl-bestand, en wordt
  bij de volgende start automatisch opnieuw
  geladen.

Kleurenpaneel
- Een apart icoon in de banner, direct rechts van
  het hamburgermenu (twee kleine vierkantjes met
  de huidige tekst-/achtergrondkleuren), opent een
  paneel met 10 instellingen, verdeeld over
  meerdere pagina's: achtergrond- en tekstkleur
  van de buffer, de banner, de statusbalk, de
  panelen en de regelnummerkolom.
- Elke regel opent opnieuw het kleurenwiel om een
  vrije (RGB-)kleur te kiezen. Alle 10 kleuren
  worden onafhankelijk ingesteld voor elk
  bestandstype (.txt/.md delen dezelfde
  instelling, .py/.hppl/.json hebben elk hun
  eigen) - van bestand wisselen past automatisch
  de kleuren van het bijbehorende type toe.
- Pijl omhoog/omlaag navigeren via het toetsenbord
  door het paneel, Enter opent het kleurenwiel
  voor de geselecteerde regel (of gaat naar de
  volgende/vorige pagina bij "Volgende"/"Terug");
  tikken buiten het paneel sluit het.

Syntaxismarkering
- .py-/.hppl-/.json-code wordt getekend met een
  speciaal bitmaplettertype van vaste grootte,
  zodat sleutelwoorden, strings, commentaar en
  getallen elk hun eigen kleur krijgen, volgens
  het alom bekende "Dark+"-schema van VS Code.

Automatisch aanvullen
- Bij het typen van een identifier in een .py- of
  .hppl-bestand opent automatisch een
  suggestievenster zodra 2 tekens zijn getypt -
  sleutelwoorden, ingebouwde/bibliotheeknamen, en
  identifiers die al elders in het bestand zijn
  gebruikt tellen allemaal mee.
- Pijl omhoog/omlaag verplaatsen de selectie
  binnen het venster zonder ooit de cursor in de
  tekst te verplaatsen. Enter na het gebruik van
  pijl omhoog/omlaag voegt de gemarkeerde
  suggestie in; Enter zonder eerst door de lijst
  te hebben gebladerd start gewoon een nieuwe
  regel zoals gebruikelijk, zodat je nooit per
  ongeluk een regeleinde verliest.
- Tikken op een suggestie accepteert deze
  direct. Een echte functie of methode wordt
  ingevoegd met de haakjes al op hun plaats,
  cursor ertussenin, klaar voor argumenten; een
  sleutelwoord of een gewone identifier wordt
  ongewijzigd ingevoegd.
- Automatisch aanvullen kan worden uitgeschakeld
  via het optiespaneel als het afleidt.
- Het wordt nooit geactiveerd binnen een
  commentaar (# of //) of een Python """-blok,
  zelfs niet als dat over meerdere regels loopt.

Opdrachtcatalogus
- In een .py- of .hppl-bestand opent een tweede
  icoon in de bovenste banner ("py"/"ppl", rechts)
  een volledige, doorzoekbare catalogus:
  HPPL-opdrachten gegroepeerd per categorie
  (grafisch, strings, lijsten, controlestructuren,
  en meer), of MicroPython gegroepeerd per module,
  met klassen en hun methoden een niveau dieper
  genest.
- Blader met Volgende/Terug, tik op een item om
  het bij de cursor in te voegen. Dit is bedoeld
  om een opdracht te ontdekken waarvan je de
  exacte naam niet meer weet, als alternatief voor
  het typen van een voorvoegsel in het
  aanvulvenster.

Operatoren-, symbolen- en tekentabelpanelen
- Shift+6 opent een raster met
  vergelijkings-/logische operatoren (<= >= != AND
  OR NOT...), passend bij de taal van het geopende
  bestand; Shift+9 opent een raster met symbolen
  en Griekse letters (-> oneindig ° ' " & Å alfa
  beta gamma...). Beide zijn beschikbaar in elk
  bestandstype, tik op een item om het bij de
  cursor in te voegen.
- Shift+Vars (of de regel "Tekentabel" in het
  optiespaneel) opent een browser voor gangbare
  Unicode-blokken (Latijn, Grieks, Cyrillisch,
  symbolen...) met snelle toegang tot letters met
  accenten bovenaan de lijst, om een teken in te
  voegen dat op het fysieke toetsenbord ontbreekt.

Optiespaneel
- Tik op het hamburger-icoon (drie balken,
  linksboven in de banner) of de Apps-toets om een
  compact paneel met instellingen en acties te
  openen:
  - Regelnummers: kolom tonen of verbergen.
  - Automatisch aanvullen: suggestievenster in- of
    uitschakelen.
  - Opslaan: interval van automatisch opslaan, in
    minuten.
  - Ongedaan maken/opnieuw niveaus: hoeveel
    niveaus worden bewaard (standaard 32).
  - Selectie: een tekstselectie zetten of
    opheffen, verankerd op de huidige
    cursorpositie.
  - Kopiëren / Knippen / Plakken, werkend op de
    huidige selectie en een klembord in het
    geheugen dat het wisselen van bestand
    overleeft.
  - Ongedaan maken / Opnieuw: dezelfde acties als
    de toetsen Cas/Num.
  - Tekentabel: opent het hierboven beschreven
    Unicode-tekenpaneel.
- Tikken buiten het paneel sluit het.

Tekstselectie
- Eenmaal gezet via het optiespaneel, breidt elke
  cursorbeweging - pijltjestoetsen, Home/End,
  paginasprongen, of een tik elders in de tekst -
  de selectie uit, weergegeven als een gemarkeerde
  band. Er is geen extra toetsencombinatie nodig.
- Kopiëren laat de selectie na het kopiëren
  bestaan; Plakken vervangt een actieve selectie
  door de inhoud van het klembord, zoals in de
  meeste editors.

Sneltoetsen (HP Prime-toetsen)
- Menu: menu openen. Symb: kleurenpalet. Plot:
  zoeken / volgende overeenkomst. View: ga naar
  regel. Cas: ongedaan maken. Num:
  opnieuw. Shift+6: operatoren. Shift+9:
  symbolen. Shift+Vars: tekentabel. Apps:
  optiespaneel. Esc: sluit een geopend
  venster/paneel, of sluit de app af als niets
  geopend is (biedt eerst aan om op te slaan als
  er niet-opgeslagen wijzigingen zijn).
