Seitenstand 1.00 (2026-11-17), gilt für webMobaLedLib 3.87
Die webMobaLedLib lebt von der Mitarbeit vieler. Du kannst Fehler beheben, Funktionen ergänzen, Übersetzungen verbessern, Anleitungen schreiben oder neue Versionen testen. Diese Seite erklärt, wie du mithilfst, was du beachten musst, wie dir eine KI dabei helfen kann und wie deine Arbeit in das Programm kommt.
Du möchtest nur einen Fehler melden? Dann lies Fehler melden. Das ist die einfachste Form der Mitarbeit.
| Aufgabe | Was du brauchst |
|---|---|
| Neue Versionen testen | Nur die Betatest-Checkliste (install/BETATEST_Checkliste.md) und eine Lichtmaschine. Besonders gebraucht: Hardwaretests, Windows, macOS, Linux, Raspberry Pi, iPad. |
| Übersetzen | Die Datei csv/Web_Languages.csv enthält alle Texte in sieben Sprachen. Du kannst Texte prüfen und verbessern, ohne zu programmieren. |
| Wiki und Anleitungen | Ergänzungen und Korrekturen an den Wiki-Seiten. Schick Vorschläge als Issue. |
| Fehler beheben, Funktionen bauen | Python-Kenntnisse (oder eine KI, siehe unten) und ein GitHub-Konto. |
Beim Testen und Übersetzen kommst du ohne Programmierung aus. Schreibe deine Ergebnisse als Issue oder in das Forum.
python. Der Zweig main enthält den letzten Release; seine Nummer steht im Tag, zum Beispiel V3.5.0L3-3.85 (der Teil nach dem Bindestrich ist die webMobaLedLib-Version)._web, Hauptprogramm webmobaledlib.py). Die Fachlogik stammt aus dem Excel-Original (VBA), das nach Python übersetzt wurde (Ordner proggen, pattgen, mlpyproggen, ExcelAPI). Der Ordner headless ersetzt die Fenster der Tk-Oberfläche durch Code ohne Fenster.KI_prompt/KI_ENTWICKLUNG_Prompt.md im Repository beschreibt alle Ordner, bekannte Fallstricke, die Arbeitsregeln und die Tests ausführlich. Lies sie, bevor du größere Änderungen machst. Sie ist auch das Briefing für eine KI.HOC_intern.md (warum wurde was geändert) und install/ANLEITUNG_Installation.md. Beide liegen im Release-Paket.Vor dem Ändern
main), nicht auf einem alten Stand. Schreibe in den PR, auf welcher Version er beruht. Der Entwickler arbeitet oft schon an einer neueren Version; er führt deine Änderung dann mit seinem Stand zusammen.LANGUAGE_NAMES wurde überschrieben und hätte Sprachen zerstört).Im Code
python), Version, Datum, Autor, Lizenz (LGPL V2.1) und einer History of Change. Erhöhe die Version und ergänze eine Zeile in der History. Gibt es noch keinen Kopf, füge einen ein (Muster: eine beliebige Datei im Ordner _web).# v1.15. Gelöschte Zeilen bleiben als Kommentar stehen und bekommen ebenfalls die Version. So sieht man jede Änderung im Code, ohne Vergleichsprogramm.tr(„…“). Der deutsche Text ist der Schlüssel in csv/Web_Languages.csv. Trage neue Texte dort ein (sieben Spalten: Deutsch, Englisch, Niederländisch, Französisch, Italienisch, Spanisch, Dänisch). Fehlt eine Sprache, gilt Englisch. Schreibe nur die Sprachen, die du sicher kannst, und sag es im PR.start_windows.bat). Einstellungen gehören als Option in die Oberfläche (Programm Einstellungen).icons und icons_gross) gehören nicht in einen PR. Die Dateinamen müssen exakt wie in der Makrotabelle geschrieben sein.Testen
python -m py_compile datei.py für jede geänderte Datei.python webmobaledlib.py oder das Startskript für dein System) und die Seite, die du geändert hast, muss sich öffnen lassen.git clone https://github.com/<dein-Name>/WebMLL. (Oder bearbeite einzelne Dateien direkt im Browser mit dem Stiftsymbol; GitHub legt dann Fork und Branch für dich an.)git switch -c mein-thema. Der Name sagt, worum es geht, zum Beispiel fix-zeitangabe-komma.git add und git commit mit einer kurzen, klaren Beschreibung (was und warum). Dann git push -u origin mein-thema.main des Repositories haroldlinke/WebMLL ist, und fülle die Beschreibung aus (Vorlage unten).Vorlage für die Beschreibung des Pull Requests:
**Basis:** webMobaLedLib-Version, auf der die Änderung beruht (zum Beispiel 3.85) **Zugehöriger Issue:** #123 (falls vorhanden) **Was ändert der PR und warum?** (zwei bis fünf Sätze) **Geänderte Dateien:** - _web/web_xxx.py (Version 1.15): ... - csv/Web_Languages.csv: 3 neue Texte (Deutsch, Englisch) **Getestet:** - Windows 11, Chrome, Python 3.12: ... **Nicht geprüft:** - Hardware, macOS, Raspberry Pi **Text für die Release-Hinweise:** - Korrekturen: ...
Das Programm entwickelt sich laufend; der Entwickler arbeitet auf einem Entwicklungsstand, der meist mehrere Versionen vor dem letzten Release liegt. Dein PR beruht aber auf dem Release. Deshalb ist das Zusammenführen kein einfacher Klick auf Merge:
Dein Beitrag steht danach im Programmstand und in der Versionsgeschichte. Der Beitrag von moosbewohner (Doppelklick in der Spalte Typ) ist ein Beispiel dafür, wie das abläuft.
Du musst nicht alles selbst schreiben: Eine KI wie Claude kann Code lesen, ändern und prüfen. Sie ist aber nur so gut wie ihr Briefing: Eine neue Sitzung kennt weder das Projekt noch seine Regeln.
So gehst du vor:
webmobaledlib_Dateien_Stand_x.yz.zip bzw. den Ordner python) und die Dateien HOC_intern.md und KI_prompt/KI_ENTWICKLUNG_Prompt.md.Prompt für die KI (zum Kopieren):
# Auftrag
Du hilfst mir, einen Beitrag (Pull Request) für das Open-Source-Programm
webMobaLedLib zu schreiben. Antworte auf Deutsch, sachlich und knapp.
Behaupte nie, etwas sei geprüft, wenn du es nicht ausgeführt hast.
Nenne Unsicheres als unsicher. Stelle höchstens eine Rückfrage auf einmal.
## Das Projekt
webMobaLedLib ist die Web-Version des Programmgenerators der MobaLedLib
(LEDs, Servos und Sound für Modellbahnen). Man pflegt in einer Tabelle
Zeilen mit Makros, das Programm erzeugt daraus ein Programm für die
Lichtmaschine (ARDUINO Nano, ESP32 oder Raspberry Pico) und lädt es per USB
hoch. Die Oberfläche läuft im Browser (NiceGUI, Ordner _web). Die Fachlogik
stammt aus dem Excel-Original (VBA) und wurde nach Python übersetzt
(Ordner proggen, pattgen, mlpyproggen, ExcelAPI; headless ersetzt die
Tk-Fenster). Die Datei KI_prompt/KI_ENTWICKLUNG_Prompt.md im Anhang
beschreibt alle Ordner und Fallstricke ausführlich: Lies sie zuerst.
HOC_intern.md im Anhang erklärt, warum die letzten Änderungen gemacht wurden.
## Meine Aufgabe
(Hier beschreiben: was soll sich ändern, welcher Fehler tritt auf, welche
Meldung kommt, wie stelle ich ihn nach.)
## Vorgehen
1. Lies die betroffenen Dateien und finde die Ursache. Stelle sie nach,
wenn möglich. Keine Vermutung als Tatsache liefern.
2. Nenne mir kurz deinen Plan, bevor du änderst.
3. Mache kleine, gezielte Änderungen. Kein Umformatieren, keine
Umbenennungen nebenbei, keine neuen Fremdbibliotheken. Ein Thema pro
Pull Request. Prüfe, dass neue Namen nicht schon vergeben sind.
4. Regeln für geänderte Python-Dateien:
- Kopf mit Name, Path (relativ zu python), Version, Last Update,
Author, Licence LGPL V2.1 und History of Change. Version erhöhen,
History ergänzen. Fehlt der Kopf: einfügen.
- Jede geänderte Zeile bekommt die neue Version als Kommentar
(# v1.15). Zu löschende Zeilen bleiben als Kommentar stehen und
werden mit der Version markiert.
- Vorhandene Zeilenenden (CRLF oder LF) behalten.
5. Texte für Anwender sind deutsch und stehen in tr("..."). Der deutsche
Text ist der Schlüssel in csv/Web_Languages.csv (Trennzeichen ;,
Spalten: Deutsch, EN, NL, FR, IT, ES, DA). Neue Texte dort ergänzen.
Namen von Knöpfen, Reitern und Menüs exakt wie im Programm schreiben.
6. Anwender dürfen nie von Hand in wichtigen Dateien editieren müssen.
Einstellungen gehören als Option in die Oberfläche.
7. Prüfe mit python -m py_compile jede geänderte Datei, führe vorhandene
und neue Tests aus und prüfe den Start des Programms, soweit in deiner
Umgebung möglich. Nicht prüfbar sind Browser, Windows, macOS, Raspberry
Pi und Hardware: Schreibe das ausdrücklich in "Nicht geprüft".
## Ergebnis
Liefere (a) die geänderten Dateien, (b) eine kurze Liste Datei, Version,
Änderung, (c) eine Beschreibung für den Pull Request mit: Basisversion,
Was und warum, Getestet, Nicht geprüft, Text für die Release-Hinweise
(Neue Funktionen oder Korrekturen), ein Punkt für die Betatest-Checkliste.
Benenne eigene Fehler sofort und behebe sie.
Hinweis: Der Prompt ist eine Kurzfassung für Beitragende. Das ausführliche Briefing des Entwicklers liegt als KI_prompt/KI_ENTWICKLUNG_Prompt.md im Repository; es enthält außerdem die Arbeitsweise bei Release-Paketen. Die Regeln für Pakete und Releases brauchst du für einen Pull Request nicht.