Compare commits
5 Commits
v1.2.0
...
e7c62c2628
| Author | SHA1 | Date | |
|---|---|---|---|
| e7c62c2628 | |||
| 17b2e7ed59 | |||
| 54516a315a | |||
| 1bb8820cf1 | |||
| 95c461eca4 |
65
.gitea/workflows/build-standalone-release.yml
Normal file
65
.gitea/workflows/build-standalone-release.yml
Normal file
@@ -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 }}
|
||||||
6
.gitignore
vendored
6
.gitignore
vendored
@@ -3,3 +3,9 @@
|
|||||||
.venv/
|
.venv/
|
||||||
__pycache__/
|
__pycache__/
|
||||||
.pdf_to_ics_config.json
|
.pdf_to_ics_config.json
|
||||||
|
|
||||||
|
# Build artifacts
|
||||||
|
dist/
|
||||||
|
release/
|
||||||
|
*.spec
|
||||||
|
build/PDFtoICS/
|
||||||
|
|||||||
152
BUILD_STANDALONE.md
Normal file
152
BUILD_STANDALONE.md
Normal file
@@ -0,0 +1,152 @@
|
|||||||
|
# Standalone Builds (Linux, macOS, Windows)
|
||||||
|
|
||||||
|
Diese Anleitung erstellt eigenständige Anwendungen mit **PyInstaller** auf dem jeweiligen Zielbetriebssystem.
|
||||||
|
|
||||||
|
## Wichtig
|
||||||
|
|
||||||
|
- Builds müssen **nativ pro OS** erstellt werden (kein Cross-Compile mit diesen Skripten).
|
||||||
|
- Verwenden Sie eine aktive und funktionierende `.venv` im Projektordner.
|
||||||
|
- Die GUI wird aus `gui_wxpython.py` gebaut.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Release auf einen Blick
|
||||||
|
|
||||||
|
### Linux
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./build/build_linux.sh
|
||||||
|
./build/package_linux.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
### macOS
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./build/build_macos.sh
|
||||||
|
./build/package_macos.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
### Windows
|
||||||
|
|
||||||
|
```cmd
|
||||||
|
build\build_windows.cmd
|
||||||
|
build\package_windows.cmd
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Empfohlene Release-Reihenfolge
|
||||||
|
|
||||||
|
1. Version erhöhen (z. B. `version.txt` und Changelog)
|
||||||
|
2. Pro Zielplattform Build + Packaging ausführen
|
||||||
|
3. Artefakte im `release/`-Ordner prüfen
|
||||||
|
4. Git-Commit erstellen und Tag setzen (z. B. `v1.2.0`)
|
||||||
|
5. Tag und Branch pushen
|
||||||
|
6. Release-Artefakte auf der Release-Seite hochladen
|
||||||
|
|
||||||
|
Beispiel Git-Workflow:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git add -A
|
||||||
|
git commit -m "Release x.y.z"
|
||||||
|
git tag -a vx.y.z -m "vx.y.z"
|
||||||
|
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
|
||||||
|
|
||||||
|
```bash
|
||||||
|
chmod +x build/build_linux.sh
|
||||||
|
./build/build_linux.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
Ergebnis:
|
||||||
|
- `dist/PDFtoICS/` (Ordner mit ausführbarer Datei)
|
||||||
|
|
||||||
|
Optional als Release-Archiv (`.tar.gz`) verpacken:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
chmod +x build/package_linux.sh
|
||||||
|
./build/package_linux.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
Ergebnis:
|
||||||
|
- `release/PDFtoICS-linux-v<VERSION>.tar.gz`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## macOS
|
||||||
|
|
||||||
|
```bash
|
||||||
|
chmod +x build/build_macos.sh
|
||||||
|
./build/build_macos.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
Ergebnis:
|
||||||
|
- `dist/PDFtoICS.app`
|
||||||
|
|
||||||
|
Hinweis:
|
||||||
|
- Für öffentliche Verteilung ist Code-Signing/Notarisierung empfohlen.
|
||||||
|
|
||||||
|
Optional als Release-Archiv (`.zip`) verpacken:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
chmod +x build/package_macos.sh
|
||||||
|
./build/package_macos.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
Ergebnis:
|
||||||
|
- `release/PDFtoICS-macos-v<VERSION>.zip`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Windows
|
||||||
|
|
||||||
|
Starten Sie unter Windows:
|
||||||
|
|
||||||
|
```cmd
|
||||||
|
build\build_windows.cmd
|
||||||
|
```
|
||||||
|
|
||||||
|
Ergebnis:
|
||||||
|
- `dist\PDFtoICS\PDFtoICS.exe`
|
||||||
|
|
||||||
|
Hinweis:
|
||||||
|
- Für weniger SmartScreen-Warnungen ist Signierung empfohlen.
|
||||||
|
|
||||||
|
Optional als Release-Archiv (`.zip`) verpacken:
|
||||||
|
|
||||||
|
```cmd
|
||||||
|
build\package_windows.cmd
|
||||||
|
```
|
||||||
|
|
||||||
|
Ergebnis:
|
||||||
|
- `release\PDFtoICS-windows-v<VERSION>.zip`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Clean Build
|
||||||
|
|
||||||
|
PyInstaller erstellt `build/` und `dist/` sowie eine `.spec` Datei im Projektverzeichnis.
|
||||||
|
|
||||||
|
Optionales Aufräumen:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
rm -rf build dist *.spec
|
||||||
|
```
|
||||||
|
|
||||||
|
Unter Windows:
|
||||||
|
|
||||||
|
```cmd
|
||||||
|
rmdir /s /q build
|
||||||
|
rmdir /s /q dist
|
||||||
|
del /q *.spec
|
||||||
|
```
|
||||||
267
README.md
267
README.md
@@ -1,153 +1,114 @@
|
|||||||
# PDF zu ICS Konverter - Dienstplan Importer
|
# 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
|
```bash
|
||||||
./start_gui.sh
|
./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
|
```bash
|
||||||
./start.sh
|
./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
|
```bash
|
||||||
./start_gui.sh
|
./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.
|
||||||
```bash
|
|
||||||
./start.sh
|
|
||||||
```
|
|
||||||
|
|
||||||
### GUI-Version (Empfohlen)
|
Wenn `wxPython` nicht installiert werden kann, helfen häufig:
|
||||||
|
|
||||||
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.
|
|
||||||
|
|
||||||
### CLI-Version
|
|
||||||
|
|
||||||
Starten Sie das interaktive Menü:
|
|
||||||
|
|
||||||
```bash
|
```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
|
||||||
```
|
```
|
||||||
|
|
||||||
Beide Skripte erstellen automatisch eine Python Virtual Environment und installieren alle benötigten Abhängigkeiten.
|
Für systemweite Installation mit Menüeintrag siehe [INSTALL.md](INSTALL.md).
|
||||||
|
|
||||||
### Manuelle Installation
|
### macOS
|
||||||
|
|
||||||
|
|
||||||
Die erforderlichen Dependencies sind bereits installiert. Falls Sie das Projekt neu einrichten:
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
python3 -m venv .venv
|
./start_gui.sh
|
||||||
source .venv/bin/activate
|
|
||||||
pip install pdfplumber icalendar pypdf2 pytz packaging
|
|
||||||
```
|
```
|
||||||
|
|
||||||
## Verwendung
|
Beim ersten Start wird `.venv` erstellt und die Abhängigkeiten werden installiert.
|
||||||
|
|
||||||
### Schnellstart (CLI)
|
### Windows
|
||||||
|
|
||||||
1. Kopieren Sie Ihre Dienstplan-PDF-Dateien in ein Verzeichnis
|
1. Python 3.10+ installieren (Option **Add Python to PATH** aktivieren)
|
||||||
2. Führen Sie das Skript aus:
|
2. `start_gui.cmd` per Doppelklick starten
|
||||||
|
|
||||||
```bash
|
Beim ersten Start wird `.venv` automatisch eingerichtet.
|
||||||
python3 pdf_to_ics.py
|
|
||||||
```
|
|
||||||
|
|
||||||
Das Tool findet automatisch alle `.pdf` Dateien im aktuellen Verzeichnis und erstellt entsprechende `.ics` Dateien.
|
---
|
||||||
|
|
||||||
### Kommandozeilen-Optionen
|
## 🧱 Standalone-Apps (ohne Python beim Endnutzer)
|
||||||
|
|
||||||
|
Für Build/Packaging auf Linux, macOS und Windows:
|
||||||
|
|
||||||
|
- [BUILD_STANDALONE.md](BUILD_STANDALONE.md)
|
||||||
|
|
||||||
|
Dort enthalten:
|
||||||
|
- Build-Skripte pro OS
|
||||||
|
- Packaging-Skripte für Release-Artefakte
|
||||||
|
- empfohlene Release-Reihenfolge
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🖥️ CLI-Nutzung
|
||||||
|
|
||||||
|
### Beispiele
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Alle PDFs im aktuellen Verzeichnis konvertieren
|
# Alle PDFs im aktuellen Verzeichnis konvertieren
|
||||||
python3 pdf_to_ics.py
|
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
|
python3 pdf_to_ics.py --input ./pdfs --output ./ics_dateien
|
||||||
|
|
||||||
# Ruhetage ausschließen
|
# Ruhetage ausschließen
|
||||||
python3 pdf_to_ics.py --exclude-rest
|
python3 pdf_to_ics.py --exclude-rest
|
||||||
|
|
||||||
# Urlaub (060) ausschließen
|
# Urlaub (060/0060) ausschließen
|
||||||
python3 pdf_to_ics.py --exclude-vacation
|
python3 pdf_to_ics.py --exclude-vacation
|
||||||
|
|
||||||
# Einzelne PDF-Datei konvertieren
|
# Einzelne PDF-Datei
|
||||||
python3 pdf_to_ics.py /pfad/zur/datei.pdf
|
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 |
|
| Option | Kurzform | Beschreibung |
|
||||||
|--------|----------|-------------|
|
|--------|----------|-------------|
|
||||||
@@ -155,105 +116,43 @@ python3 pdf_to_ics.py --help
|
|||||||
| `--output DIR` | `-o` | Ausgabe-Verzeichnis für ICS-Dateien (Standard: Eingabe-Verzeichnis) |
|
| `--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-rest` | `-e` | Ruhetage ausschließen (Ruhe, R56, R36, vRWF48, RWE, vR48) |
|
||||||
| `--exclude-vacation` | `-u` | Urlaub ausschließen (060, 0060) |
|
| `--exclude-vacation` | `-u` | Urlaub ausschließen (060, 0060) |
|
||||||
| `--verbose` | `-v` | Detaillierte Ausgabe anzeigen |
|
| `--verbose` | `-v` | Detaillierte Ausgabe |
|
||||||
| `--help` | `-h` | Hilfe anzeigen |
|
| `--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')
|
|
||||||
```
|
|
||||||
|
|
||||||
## Dateiformat
|
- **Keine Events gefunden:** PDF-Layout prüfen
|
||||||
|
- **GUI startet nicht:** `.venv` löschen und neu starten
|
||||||
### ICS-Datei importieren
|
```bash
|
||||||
|
rm -rf .venv
|
||||||
Die erstellte `.ics` Datei kann in folgende Kalenderanwendungen importiert werden:
|
./start_gui.sh
|
||||||
|
|
||||||
- **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
|
|
||||||
```
|
```
|
||||||
|
- **Zeitzone ändern:** in `pdf_to_ics.py` den Wert `Europe/Berlin` anpassen
|
||||||
## 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
|
## 📚 Weitere Dokumentation
|
||||||
|
|
||||||
- **[WXPYTHON_README.md](WXPYTHON_README.md)** - Ausführliche GUI-Dokumentation und wxPython-Hinweise
|
- [INSTALL.md](INSTALL.md) - Linux-Installation mit Menüeintrag
|
||||||
- **[QUICKSTART.md](QUICKSTART.md)** - Schnellanleitung für den Import in verschiedene Kalender
|
- [WXPYTHON_README.md](WXPYTHON_README.md) - wxPython-spezifische Hinweise
|
||||||
- **[ZUSAMMENFASSUNG.md](ZUSAMMENFASSUNG.md)** - Projekt-Übersicht und technische Details
|
- [BUILD_STANDALONE.md](BUILD_STANDALONE.md) - Standalone-Builds/Packaging
|
||||||
|
- [QUICKSTART.md](QUICKSTART.md) - Kurzanleitung Kalender-Import
|
||||||
|
- [ZUSAMMENFASSUNG.md](ZUSAMMENFASSUNG.md) - Projekt- und Changelog-Übersicht
|
||||||
|
|
||||||
|
## Lizenz
|
||||||
|
|
||||||
|
Dieses Tool ist zur privaten Verwendung gedacht.
|
||||||
|
|||||||
@@ -164,6 +164,23 @@ Jedes Event in der ICS-Datei:
|
|||||||
|
|
||||||
## 📝 Changelog (März 2026)
|
## 📝 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}`)
|
||||||
|
- Packaging-Skripte für Release-Artefakte ergänzt:
|
||||||
|
- Linux: `.tar.gz`
|
||||||
|
- macOS: `.zip`
|
||||||
|
- Windows: `.zip`
|
||||||
|
- Neue Build-Dokumentation `BUILD_STANDALONE.md`
|
||||||
|
- `.gitignore` um Build-Artefakte erweitert (`dist/`, `release/`, `*.spec`, `build/PDFtoICS/`)
|
||||||
|
|
||||||
### v1.2.0
|
### v1.2.0
|
||||||
|
|
||||||
- GUI-Technik vollständig auf **wxPython** umgestellt
|
- GUI-Technik vollständig auf **wxPython** umgestellt
|
||||||
|
|||||||
27
build/build_linux.sh
Executable file
27
build/build_linux.sh
Executable file
@@ -0,0 +1,27 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||||
|
cd "$ROOT_DIR"
|
||||||
|
|
||||||
|
PYTHON_BIN="${PYTHON_BIN:-.venv/bin/python}"
|
||||||
|
|
||||||
|
if [ ! -x "$PYTHON_BIN" ]; then
|
||||||
|
echo "❌ Python nicht gefunden: $PYTHON_BIN"
|
||||||
|
echo "💡 Erwartet wird eine Virtual Environment unter .venv"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo "🐧 Erstelle Linux-Standalone mit PyInstaller..."
|
||||||
|
"$PYTHON_BIN" -m pip install --upgrade pip pyinstaller
|
||||||
|
|
||||||
|
"$PYTHON_BIN" -m PyInstaller \
|
||||||
|
--noconfirm \
|
||||||
|
--clean \
|
||||||
|
--name "PDFtoICS" \
|
||||||
|
--windowed \
|
||||||
|
--add-data "version.txt:." \
|
||||||
|
gui_wxpython.py
|
||||||
|
|
||||||
|
echo "✅ Fertig: dist/PDFtoICS"
|
||||||
27
build/build_macos.sh
Normal file
27
build/build_macos.sh
Normal file
@@ -0,0 +1,27 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||||
|
cd "$ROOT_DIR"
|
||||||
|
|
||||||
|
PYTHON_BIN="${PYTHON_BIN:-.venv/bin/python}"
|
||||||
|
|
||||||
|
if [ ! -x "$PYTHON_BIN" ]; then
|
||||||
|
echo "❌ Python nicht gefunden: $PYTHON_BIN"
|
||||||
|
echo "💡 Erwartet wird eine Virtual Environment unter .venv"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo "🍎 Erstelle macOS-Standalone mit PyInstaller..."
|
||||||
|
"$PYTHON_BIN" -m pip install --upgrade pip pyinstaller
|
||||||
|
|
||||||
|
"$PYTHON_BIN" -m PyInstaller \
|
||||||
|
--noconfirm \
|
||||||
|
--clean \
|
||||||
|
--name "PDFtoICS" \
|
||||||
|
--windowed \
|
||||||
|
--add-data "version.txt:." \
|
||||||
|
gui_wxpython.py
|
||||||
|
|
||||||
|
echo "✅ Fertig: dist/PDFtoICS.app"
|
||||||
24
build/build_windows.cmd
Normal file
24
build/build_windows.cmd
Normal file
@@ -0,0 +1,24 @@
|
|||||||
|
@echo off
|
||||||
|
setlocal
|
||||||
|
|
||||||
|
cd /d "%~dp0\.."
|
||||||
|
|
||||||
|
set "PYTHON_BIN=.venv\Scripts\python.exe"
|
||||||
|
if not exist "%PYTHON_BIN%" (
|
||||||
|
echo ❌ Python nicht gefunden: %PYTHON_BIN%
|
||||||
|
echo 💡 Erwartet wird eine Virtual Environment unter .venv
|
||||||
|
exit /b 1
|
||||||
|
)
|
||||||
|
|
||||||
|
echo 🪟 Erstelle Windows-Standalone mit PyInstaller...
|
||||||
|
"%PYTHON_BIN%" -m pip install --upgrade pip pyinstaller
|
||||||
|
|
||||||
|
"%PYTHON_BIN%" -m PyInstaller ^
|
||||||
|
--noconfirm ^
|
||||||
|
--clean ^
|
||||||
|
--name "PDFtoICS" ^
|
||||||
|
--windowed ^
|
||||||
|
--add-data "version.txt;." ^
|
||||||
|
gui_wxpython.py
|
||||||
|
|
||||||
|
echo ✅ Fertig: dist\PDFtoICS\PDFtoICS.exe
|
||||||
24
build/package_linux.sh
Executable file
24
build/package_linux.sh
Executable file
@@ -0,0 +1,24 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||||
|
cd "$ROOT_DIR"
|
||||||
|
|
||||||
|
APP_DIR="dist/PDFtoICS"
|
||||||
|
VERSION="$(tr -d '[:space:]' < version.txt)"
|
||||||
|
OUT_DIR="release"
|
||||||
|
ARCHIVE_NAME="PDFtoICS-linux-v${VERSION}.tar.gz"
|
||||||
|
|
||||||
|
if [ ! -d "$APP_DIR" ]; then
|
||||||
|
echo "❌ Build-Ordner nicht gefunden: $APP_DIR"
|
||||||
|
echo "💡 Bitte zuerst ausführen: ./build/build_linux.sh"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
mkdir -p "$OUT_DIR"
|
||||||
|
|
||||||
|
echo "📦 Erstelle Archiv: $OUT_DIR/$ARCHIVE_NAME"
|
||||||
|
tar -czf "$OUT_DIR/$ARCHIVE_NAME" -C dist PDFtoICS
|
||||||
|
|
||||||
|
echo "✅ Fertig: $OUT_DIR/$ARCHIVE_NAME"
|
||||||
25
build/package_macos.sh
Normal file
25
build/package_macos.sh
Normal file
@@ -0,0 +1,25 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||||
|
cd "$ROOT_DIR"
|
||||||
|
|
||||||
|
APP_BUNDLE="dist/PDFtoICS.app"
|
||||||
|
VERSION="$(tr -d '[:space:]' < version.txt)"
|
||||||
|
OUT_DIR="release"
|
||||||
|
ARCHIVE_NAME="PDFtoICS-macos-v${VERSION}.zip"
|
||||||
|
|
||||||
|
if [ ! -d "$APP_BUNDLE" ]; then
|
||||||
|
echo "❌ App-Bundle nicht gefunden: $APP_BUNDLE"
|
||||||
|
echo "💡 Bitte zuerst ausführen: ./build/build_macos.sh"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
mkdir -p "$OUT_DIR"
|
||||||
|
|
||||||
|
echo "📦 Erstelle Archiv: $OUT_DIR/$ARCHIVE_NAME"
|
||||||
|
rm -f "$OUT_DIR/$ARCHIVE_NAME"
|
||||||
|
(cd dist && zip -r "../$OUT_DIR/$ARCHIVE_NAME" "PDFtoICS.app" >/dev/null)
|
||||||
|
|
||||||
|
echo "✅ Fertig: $OUT_DIR/$ARCHIVE_NAME"
|
||||||
27
build/package_windows.cmd
Normal file
27
build/package_windows.cmd
Normal file
@@ -0,0 +1,27 @@
|
|||||||
|
@echo off
|
||||||
|
setlocal
|
||||||
|
|
||||||
|
cd /d "%~dp0\.."
|
||||||
|
|
||||||
|
set /p VERSION=<version.txt
|
||||||
|
set "VERSION=%VERSION: =%"
|
||||||
|
|
||||||
|
if not exist "dist\PDFtoICS\PDFtoICS.exe" (
|
||||||
|
echo ❌ Build-Ausgabe nicht gefunden: dist\PDFtoICS\PDFtoICS.exe
|
||||||
|
echo 💡 Bitte zuerst ausfuehren: build\build_windows.cmd
|
||||||
|
exit /b 1
|
||||||
|
)
|
||||||
|
|
||||||
|
if not exist "release" mkdir release
|
||||||
|
|
||||||
|
set "ARCHIVE=release\PDFtoICS-windows-v%VERSION%.zip"
|
||||||
|
if exist "%ARCHIVE%" del /q "%ARCHIVE%"
|
||||||
|
|
||||||
|
echo 📦 Erstelle Archiv: %ARCHIVE%
|
||||||
|
powershell -NoProfile -Command "Compress-Archive -Path 'dist\PDFtoICS\*' -DestinationPath '%ARCHIVE%'"
|
||||||
|
if errorlevel 1 (
|
||||||
|
echo ❌ Konnte Archiv nicht erstellen
|
||||||
|
exit /b 1
|
||||||
|
)
|
||||||
|
|
||||||
|
echo ✅ Fertig: %ARCHIVE%
|
||||||
@@ -1 +1 @@
|
|||||||
1.2.0
|
1.2.2
|
||||||
|
|||||||
Reference in New Issue
Block a user