Add Gitea workflow for cross-platform standalone builds

.gitea/workflows/build-standalone-release.yml

@@ -0,0 +1,65 @@
+name: Build Standalone Releases
+
+on:
+  workflow_dispatch:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: linux
+            runs-on: ubuntu-latest
+            shell: bash
+            build_cmd: |
+              chmod +x build/build_linux.sh build/package_linux.sh
+              ./build/build_linux.sh
+              ./build/package_linux.sh
+            artifact_glob: release/PDFtoICS-linux-v*.tar.gz
+
+          - os: macos
+            runs-on: macos-latest
+            shell: bash
+            build_cmd: |
+              chmod +x build/build_macos.sh build/package_macos.sh
+              ./build/build_macos.sh
+              ./build/package_macos.sh
+            artifact_glob: release/PDFtoICS-macos-v*.zip
+
+          - os: windows
+            runs-on: windows-latest
+            shell: pwsh
+            build_cmd: |
+              cmd /c build\build_windows.cmd
+              cmd /c build\package_windows.cmd
+            artifact_glob: release/PDFtoICS-windows-v*.zip
+
+    runs-on: ${{ matrix.runs-on }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Create venv
+        shell: ${{ matrix.shell }}
+        run: |
+          python -m venv .venv
+
+      - name: Build + Package
+        shell: ${{ matrix.shell }}
+        run: ${{ matrix.build_cmd }}
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.os }}-release
+          path: ${{ matrix.artifact_glob }}

BUILD_STANDALONE.md

@@ -54,6 +54,11 @@ git push origin main
 git push origin vx.y.z
 ```
 
+Optional per CI:
+- Workflow: `.gitea/workflows/build-standalone-release.yml`
+- Trigger: Tag-Push `v*`
+- Ergebnis: Plattform-Artefakte als CI-Artefakte
+
 ---
 
 ## Linux

README.md

@@ -1,153 +1,114 @@
 # PDF zu ICS Konverter - Dienstplan Importer
 
-Dieses Tool extrahiert Kalenderdaten aus Dienstplan-PDFs und konvertiert sie in das iCalendar-Format (ICS), das von den meisten Kalenderanwendungen importiert werden kann.
+Dieses Tool extrahiert Kalenderdaten aus Dienstplan-PDFs und konvertiert sie in das iCalendar-Format (ICS), das in gängigen Kalender-Apps importiert werden kann.
 
-## 🎯 Zwei Versionen verfügbar
+## 🎯 Varianten
 
-### 1. **GUI-Version** (Grafische Oberfläche) - Empfohlen!
+### 1) GUI (empfohlen)
-Benutzerfreundliche grafische Oberfläche mit Drag & Drop Support.
+Native Oberfläche mit wxPython:
 
 ```bash
 ./start_gui.sh
 ```
 
-**Features:**
+**Highlights:**
-- ✨ Drag & Drop für PDF-Dateien
+- Drag & Drop für PDFs
-- 📋 Mehrere PDFs gleichzeitig verarbeiten
+- Mehrere PDFs gleichzeitig
-- 📁 Ausgabe-Verzeichnis frei wählbar
+- Frei wählbares Ausgabe-Verzeichnis
-- 📊 Live-Log und Fortschrittsanzeige
+- Live-Log mit Fortschritt
-- 💾 Merkt sich letzte Verzeichnisse
+- Optionale Filter:
+  - Ruhetage ausschließen
+  - Urlaub (060/0060) ausschließen
 
-**Voraussetzung:** wxPython muss installiert sein (wird automatisch versucht; siehe [WXPYTHON_README.md](WXPYTHON_README.md))
+### 2) CLI
-
+Interaktives Textmenü:
-### 2. **CLI-Version** (Kommandozeile)
-Textbasiertes Menü für die Kommandozeile.
 
 ```bash
 ./start.sh
 ```
 
-**Features:**
+---
-- ⚡ Funktioniert überall ohne zusätzliche Abhängigkeiten
-- 🔄 Automatische Verarbeitung aller PDFs im Verzeichnis
-- 📝 Textbasiertes interaktives Menü
 
-## Features
+## ⚡ Schnellstart (60 Sekunden)
 
-✅ Extrahiert Dienstplan-Informationen aus PDFs
+1. GUI starten (`./start_gui.sh` oder `start_gui.cmd` unter Windows)
-✅ Erkennt Schicht-Zeitangaben (z.B. 04:51-15:46)
+2. PDF-Dateien hinzufügen
-✅ Handhabt Nachtschichten korrekt (über Mitternacht hinaus)
+3. Optional Filter aktivieren
-✅ Erstellt Standard-konforme ICS-Dateien
+4. Auf **"ICS Datei erstellen"** klicken
-✅ Unterstützt mehrere PDFs gleichzeitig
-✅ GUI mit Drag & Drop (optional)
-✅ CLI-Menü für schnelle Nutzung
 
-## Installation
+---
-### Windows (Empfohlen)
 
-1. Installieren Sie **Python 3.10+** und aktivieren Sie bei der Installation die Option **"Add Python to PATH"**.
+## 🧩 Installation nach Betriebssystem
-2. Öffnen Sie den Projektordner.
-3. Starten Sie die GUI per Doppelklick auf `start_gui.cmd`.
 
-Beim ersten Start wird automatisch eine virtuelle Umgebung (`.venv`) erstellt und alle benötigten Pakete installiert.
+### Linux (Ubuntu/Debian/Mint)
 
-**Alternative (CLI):** Doppelklick auf `start.cmd`.
-
-**Falls Python nicht gefunden wird (CMD im Projektordner):**
-
-```bat
-py -3 -m venv .venv --upgrade-deps
-.\.venv\Scripts\python.exe gui_wxpython.py
-```
-
-### Schnellstart (Empfohlen)
-
-**Für GUI-Version:**
 ```bash
 ./start_gui.sh
 ```
-Siehe [WXPYTHON_README.md](WXPYTHON_README.md) für wxPython-Hinweise.
 
-**Für CLI-Version:**
+Beim ersten Start wird automatisch `.venv` erstellt und alles installiert.
+
+Wenn `wxPython` nicht installiert werden kann, helfen häufig:
+
 ```bash
-./start.sh
+sudo apt-get update
+sudo apt-get install -y build-essential python3-dev libgtk-3-dev libglib2.0-dev libjpeg-dev libtiff-dev libpng-dev
 ```
 
-### GUI-Version (Empfohlen)
+Für systemweite Installation mit Menüeintrag siehe [INSTALL.md](INSTALL.md).
+
+### macOS
 
-1. Starten Sie die GUI:
 ```bash
 ./start_gui.sh
 ```
-2. Fügen Sie PDF-Dateien hinzu (Button oder Drag & Drop).
-3. Optional: Aktivieren Sie Filter wie „Ruhetage ausschließen“ und „Urlaub ausschließen (060, 0060)“.
-4. Klicken Sie auf „📄 ICS Datei erstellen“.
 
-Die GUI merkt sich Ihre letzten Verzeichnisse und Exportoptionen.
+Beim ersten Start wird `.venv` erstellt und die Abhängigkeiten werden installiert.
 
-### CLI-Version
+### Windows
 
-Starten Sie das interaktive Menü:
+1. Python 3.10+ installieren (Option **Add Python to PATH** aktivieren)
+2. `start_gui.cmd` per Doppelklick starten
 
-```bash
+Beim ersten Start wird `.venv` automatisch eingerichtet.
-./start.sh
-```
 
-Beide Skripte erstellen automatisch eine Python Virtual Environment und installieren alle benötigten Abhängigkeiten.
+---
 
-### Manuelle Installation
+## 🧱 Standalone-Apps (ohne Python beim Endnutzer)
 
+Für Build/Packaging auf Linux, macOS und Windows:
 
-Die erforderlichen Dependencies sind bereits installiert. Falls Sie das Projekt neu einrichten:
+- [BUILD_STANDALONE.md](BUILD_STANDALONE.md)
 
-```bash
+Dort enthalten:
-python3 -m venv .venv
+- Build-Skripte pro OS
-source .venv/bin/activate
+- Packaging-Skripte für Release-Artefakte
-pip install pdfplumber icalendar pypdf2 pytz packaging
+- empfohlene Release-Reihenfolge
-```
 
-## Verwendung
+---
 
-### Schnellstart (CLI)
+## 🖥️ CLI-Nutzung
 
-1. Kopieren Sie Ihre Dienstplan-PDF-Dateien in ein Verzeichnis
+### Beispiele
-2. Führen Sie das Skript aus:
-
-```bash
-python3 pdf_to_ics.py
-```
-
-Das Tool findet automatisch alle `.pdf` Dateien im aktuellen Verzeichnis und erstellt entsprechende `.ics` Dateien.
-
-### Kommandozeilen-Optionen
 
 ```bash
 # Alle PDFs im aktuellen Verzeichnis konvertieren
 python3 pdf_to_ics.py
 
-# PDFs aus einem bestimmten Verzeichnis konvertieren
+# Input/Output-Verzeichnis setzen
-python3 pdf_to_ics.py --input ./pdfs
-
-# PDFs in anderes Verzeichnis speichern
 python3 pdf_to_ics.py --input ./pdfs --output ./ics_dateien
 
 # Ruhetage ausschließen
 python3 pdf_to_ics.py --exclude-rest
 
-# Urlaub (060) ausschließen
+# Urlaub (060/0060) ausschließen
 python3 pdf_to_ics.py --exclude-vacation
 
-# Einzelne PDF-Datei konvertieren
+# Einzelne PDF-Datei
 python3 pdf_to_ics.py /pfad/zur/datei.pdf
-
-# Mit detaillierter Ausgabe
-python3 pdf_to_ics.py --input ./pdfs -v
-
-# Hilfe anzeigen
-python3 pdf_to_ics.py --help
 ```
 
-**Verfügbare Optionen:**
+### Optionen
 
 | Option | Kurzform | Beschreibung |
 |--------|----------|-------------|
@@ -155,106 +116,43 @@ python3 pdf_to_ics.py --help
 | `--output DIR` | `-o` | Ausgabe-Verzeichnis für ICS-Dateien (Standard: Eingabe-Verzeichnis) |
 | `--exclude-rest` | `-e` | Ruhetage ausschließen (Ruhe, R56, R36, vRWF48, RWE, vR48) |
 | `--exclude-vacation` | `-u` | Urlaub ausschließen (060, 0060) |
-| `--verbose` | `-v` | Detaillierte Ausgabe anzeigen |
+| `--verbose` | `-v` | Detaillierte Ausgabe |
 | `--help` | `-h` | Hilfe anzeigen |
 
-### Erweiterte Nutzung
+---
 
-Sie können auch direkt mit dem Python-Modul arbeiten:
+## 📅 ICS-Import
 
-```python
+Die erzeugten `.ics`-Dateien lassen sich u. a. in folgende Kalender importieren:
-from pdf_to_ics import extract_dienstplan_data, create_ics_from_dienstplan
+- Outlook
+- Google Kalender
+- Apple Kalender
+- Thunderbird
+- LibreOffice
+- Android-Kalender-Apps
 
-# PDF verarbeiten
+---
-dienstplan = extract_dienstplan_data('meine_pdf.pdf')
 
-# ICS erstellen
+## 🛠️ Fehlerbehebung
-create_ics_from_dienstplan(dienstplan, 'mein_kalender.ics')
+
+- **Keine Events gefunden:** PDF-Layout prüfen
+- **GUI startet nicht:** `.venv` löschen und neu starten
+  ```bash
+  rm -rf .venv
+  ./start_gui.sh
   ```
-
+- **Zeitzone ändern:** in `pdf_to_ics.py` den Wert `Europe/Berlin` anpassen
-## Dateiformat
-
-### ICS-Datei importieren
-
-Die erstellte `.ics` Datei kann in folgende Kalenderanwendungen importiert werden:
-
-- **Outlook**: Datei → Öffnen und exportieren → Importieren
-- **Google Kalender**: Einstellungen → Kalender importieren
-- **iCal/macOS**: Doppelklick auf die .ics Datei
-- **Thunderbird**: Kalender → Kalender importieren
-- **Android**: Mit einer Kalender-App öffnen
-- **LibreOffice**: Datei → Öffnen
-
-## Struktur der extrahierten Daten
-
-Das Tool extrahiert folgende Informationen aus der PDF:
-
-- **Name und Personalnummer**: Des Mitarbeiters
-- **Betriebshof**: Standort
-- **Sollarbeitszeit**: Gewünschte Arbeitszeit pro Monat
-- **Events**: Einzelne Schichten mit:
-  - Datum
-  - Dienstart (z.B. "36234", "Ruhe", "Dispo")
-  - Zeitangabe (falls vorhanden)
-
-## Output
-
-Für jede verarbeitete PDF wird eine entsprechende ICS-Datei erstellt:
-
-```
-2026-02-23 DB Köhler00100718_März2026.pdf  →  2026-02-23 DB Köhler00100718_März2026.ics
-```
-
-Die ICS-Datei enthält ein Event für jeden Arbeitstag mit:
-- **Titel**: Name - Dienstart
-- **Beschreibung**: Dienstart und Betriebshof
-- **Zeit**: Mit aktueller Zeitzone (Europe/Berlin)
-
-## Fehlerbehebung
-
-### Keine Events gefunden?
-- Stellen Sie sicher, dass die PDF das erwartete Tabellenformat hat
-- Überprüfen Sie die Dateiname und die PDF-Struktur
-
-### Zeitzone falsch?
-- Die aktuelle Einstellung ist Europe/Berlin
-- Zum Ändern: Bearbeiten Sie die Zeile in `pdf_to_ics.py`:
-  ```python
-  tz = pytz.timezone('Europe/Berlin')  # Ändern SIe diesen Wert
-  ```
-
-## Technische Details
-
-### Projektstruktur
-
-```
-ICS-Import/
-├── pdf_to_ics.py          # Core-Konvertierungslogik
-├── gui_wxpython.py        # GUI-Version (wxPython)
-├── menu.py                # CLI-Menü
-├── start_gui.sh/cmd       # GUI-Startskripte
-├── start.sh/cmd           # CLI-Startskripte
-├── README.md              # Diese Datei
-└── WXPYTHON_README.md     # GUI-spezifische Dokumentation
-```
-
-### Technische Spezifikationen
-
-- **Abhängigkeiten**: pdfplumber, icalendar, pytz, pypdf2, packaging
-- **Optional für GUI**: wxPython (native Oberfläche)
-- **Python-Version**: 3.6+
-- **Format**: iCalendar 2.0 (RFC 5545)
-- **Konfiguration**: `~/.pdf_to_ics_config.json` (GUI-Einstellungen)
-
-## Lizenz
-
-Dieses Tool ist zur privaten Verwendung gedacht.
 
 ---
 
 ## 📚 Weitere Dokumentation
 
-- **[WXPYTHON_README.md](WXPYTHON_README.md)** - Ausführliche GUI-Dokumentation und wxPython-Hinweise
+- [INSTALL.md](INSTALL.md) - Linux-Installation mit Menüeintrag
-- **[BUILD_STANDALONE.md](BUILD_STANDALONE.md)** - Standalone-Builds für Linux, macOS und Windows
+- [WXPYTHON_README.md](WXPYTHON_README.md) - wxPython-spezifische Hinweise
-- **[QUICKSTART.md](QUICKSTART.md)** - Schnellanleitung für den Import in verschiedene Kalender
+- [BUILD_STANDALONE.md](BUILD_STANDALONE.md) - Standalone-Builds/Packaging
-- **[ZUSAMMENFASSUNG.md](ZUSAMMENFASSUNG.md)** - Projekt-Übersicht und technische Details
+- [QUICKSTART.md](QUICKSTART.md) - Kurzanleitung Kalender-Import
+- [ZUSAMMENFASSUNG.md](ZUSAMMENFASSUNG.md) - Projekt- und Changelog-Übersicht
+
+## Lizenz
+
+Dieses Tool ist zur privaten Verwendung gedacht.

ZUSAMMENFASSUNG.md

@@ -164,6 +164,13 @@ Jedes Event in der ICS-Datei:
 
 ## 📝 Changelog (März 2026)
 
+### v1.2.2
+
+- README grundlegend strukturiert und bereinigt
+- Installationshinweise nach Betriebssystem ergänzt (Linux, macOS, Windows)
+- Standalone-Hinweise im README klar hervorgehoben
+- Schnellstart und Troubleshooting kompakter und ohne Redundanzen
+
 ### v1.2.1
 
 - Standalone-Build-Workflow mit PyInstaller ergänzt (`build/build_*.{sh,cmd}`)

version.txt

@@ -1 +1 @@
-1.2.1
+1.2.2