Als ich das Programm SUPERHIRN für den HP-67 hier publizierte, entwickelte ich auch ein kleines Tool, um Programme für diesen Taschenrechner schön zu dokumentieren. Leider habe ich es bis heute verpasst, dieses Tool zu veröffentlichen. Also hole ich das heute nach.
Kurzanleitung
Das Dokumentationstool findet man hier.
Zu Beginn ist die Programmseite leer. Man klickt nun in die INPUT Kolonne des ersten Programmschritts und gibt die Tastencodes des ersten Programmschritts ein, z.B. 3301 for STO1 oder 312511 für LBLA. Dann drückt man die CURSOR DOWN Taste, um zum nächsten Programmschritt zu gelangen, oder TAB, um auf die Kommentarkolonne des ersten Programmschritts zu springen. Das macht man so lange, bis das ganze Programm eingetippt ist.
Falls man irgendwo einen Fehler gemacht hat, kann man den Tastencode nachträglich ändern. Allerdings muss dazu der aktuelle Programmschritt abgeschlossen sein. Solange ein roter Rand um die Eingabezeile erscheint, kann man nicht auf andere Programmschritte wechseln. Programmschritte lassen sich auch nicht löschen. Zugegeben, nicht sehr komfortabel, aber ich habe das auch nur als Hilfsmittel für mich selber geschrieben. Notfalls (also Workaround) kann man das Programm als JSON herunterladen und diese Datei editieren.
Auf der rechten Seite findet man vier Knöpfe für weitere Funktionen:
- Upload: Damit lässt sich ein Programm im JSON Format hochladen.
- Download: Speichert ein Programm im JSON Format lokal in einer Datei.
- Drucken: Exportiert ein Programm in eine PDF-Datei. Den Programmtitel kann man eingeben. Das ist die eigentliche Hauptfunktion dieses Tools, das ein schönes Programmlisting erzeugt.
- Löschen: Löscht das aktuelle Programm ohne Nachfragen. Also Vorsicht.
Viel mehr ist zu diesem Tool nicht zu sagen. Vielleicht inspiriert es den einen oder anderen Leser, sein bestes HP-67 Programm so zu dokumentieren und der Nachwelt zu erhalten. Das würde mich natürlich freuen!
Die vier Knöpfe findet man aktuell auf der linken (nicht rechten) Seite… 😉
Gibt es eine Möglichkeit, das Tool selbst zu erweitern? Mein HP-67-Simulator für iOS verwendet viele weitere Tastenkombinationen. Es wäre toll, könnte man auch diese Programme auf hübsche Art dokumentieren. Die maximale Schrittzahl müsste auf 999 erhöht werden.
Danke für den Hinweis, das werde ich noch korrigieren. War wohl nicht ganz bei der Sache 😉
Ja, das Tool lässt sich prinzipiell erweitern und auch die Schrittzahl kann angepasst werden.
Ich habe das Tool allerdings nur auf die Schnelle hingehackt und hatte dabei keinen Anspruch, das Programm gut erweiterbar zu machen. Ich kontaktiere Sie per E-Mail.