Linux-Installation mit Desktop-Integration hinzugefügt
- install.sh: Automatisches Installations-Script • Prüft und installiert Tkinter automatisch • Erstellt Virtual Environment • Desktop-Verknüpfung im Anwendungsmenü • Launcher-Command: pdf-to-ics - uninstall.sh: Saubere Deinstallation • Entfernt alle Dateien • Optional: Benutzer-Konfiguration behalten - INSTALL.md: Technische Installations-Dokumentation - WEITERGABE.md: Benutzerfreundliche Schnellstart-Anleitung Die Anwendung kann jetzt als fertiges Paket weitergegeben werden!
This commit is contained in:
159
INSTALL.md
Normal file
159
INSTALL.md
Normal file
@@ -0,0 +1,159 @@
|
||||
# 📦 Installation - PDF zu ICS Konverter
|
||||
|
||||
Eine einfache Installation für Linux-Systeme, die die Anwendung in Ihr Anwendungsmenü integriert.
|
||||
|
||||
## 🚀 Schnell-Installation
|
||||
|
||||
```bash
|
||||
chmod +x install.sh
|
||||
./install.sh
|
||||
```
|
||||
|
||||
Das war's! Die Anwendung erscheint nun in Ihrem Anwendungsmenü unter "PDF zu ICS Konverter".
|
||||
|
||||
## 📋 Was macht das Installations-Script?
|
||||
|
||||
1. ✅ **Prüft Python-Installation** (Python 3.6+)
|
||||
2. ✅ **Installiert Tkinter** falls nötig (mit sudo-Berechtigung)
|
||||
3. ✅ **Erstellt Installationsverzeichnis** in `~/.local/share/pdf-to-ics`
|
||||
4. ✅ **Kopiert alle Dateien** ins Installationsverzeichnis
|
||||
5. ✅ **Erstellt Python Virtual Environment** mit allen Abhängigkeiten
|
||||
6. ✅ **Erstellt Desktop-Verknüpfung** für das Anwendungsmenü
|
||||
7. ✅ **Erstellt Launcher-Script** in `~/.local/bin/pdf-to-ics`
|
||||
|
||||
## 🎯 Nach der Installation
|
||||
|
||||
Die Anwendung starten Sie auf drei Arten:
|
||||
|
||||
### 1. Über das Anwendungsmenü (Empfohlen)
|
||||
- Öffnen Sie Ihr Anwendungsmenü (z.B. GNOME Activities, KDE Application Launcher)
|
||||
- Suchen Sie nach "PDF zu ICS"
|
||||
- Klicken Sie auf das Icon
|
||||
|
||||
### 2. Über die Kommandozeile
|
||||
```bash
|
||||
pdf-to-ics
|
||||
```
|
||||
|
||||
### 3. Über den vollständigen Pfad
|
||||
```bash
|
||||
~/.local/bin/pdf-to-ics
|
||||
```
|
||||
|
||||
## 🔧 Systemanforderungen
|
||||
|
||||
### Unterstützte Distributionen:
|
||||
- ✅ Ubuntu / Debian (automatische Tkinter-Installation)
|
||||
- ✅ Fedora / RHEL (automatische Tkinter-Installation)
|
||||
- ✅ Arch Linux (automatische Tkinter-Installation)
|
||||
- ✅ Andere Distributionen (manuelle Tkinter-Installation erforderlich)
|
||||
|
||||
### Voraussetzungen:
|
||||
- Python 3.6 oder höher
|
||||
- `sudo`-Berechtigung (für Tkinter-Installation)
|
||||
- Etwa 50 MB Festplattenspeicher
|
||||
|
||||
## 📁 Installations-Pfade
|
||||
|
||||
```
|
||||
~/.local/share/pdf-to-ics/ # Hauptinstallation
|
||||
~/.local/bin/pdf-to-ics # Launcher-Script
|
||||
~/.local/share/applications/ # Desktop-Verknüpfung
|
||||
~/.pdf_to_ics_config.json # Benutzer-Einstellungen
|
||||
```
|
||||
|
||||
## 🗑️ Deinstallation
|
||||
|
||||
```bash
|
||||
~/.local/share/pdf-to-ics/uninstall.sh
|
||||
```
|
||||
|
||||
Das Deinstallations-Script entfernt:
|
||||
- ✅ Installationsverzeichnis
|
||||
- ✅ Desktop-Verknüpfung
|
||||
- ✅ Launcher-Script
|
||||
- ⚠️ Konfigurationsdatei (optional)
|
||||
|
||||
## ⚠️ Fehlerbehebung
|
||||
|
||||
### "Tkinter ist nicht installiert"
|
||||
|
||||
**Ubuntu/Debian:**
|
||||
```bash
|
||||
sudo apt-get install python3-tk
|
||||
```
|
||||
|
||||
**Fedora:**
|
||||
```bash
|
||||
sudo dnf install python3-tkinter
|
||||
```
|
||||
|
||||
**Arch Linux:**
|
||||
```bash
|
||||
sudo pacman -S tk
|
||||
```
|
||||
|
||||
### "pdf-to-ics: Befehl nicht gefunden"
|
||||
|
||||
Ihr `~/.local/bin` ist nicht im PATH. Fügen Sie zu `~/.bashrc` hinzu:
|
||||
|
||||
```bash
|
||||
export PATH="$HOME/.local/bin:$PATH"
|
||||
```
|
||||
|
||||
Dann Terminal neu laden:
|
||||
```bash
|
||||
source ~/.bashrc
|
||||
```
|
||||
|
||||
### Anwendung erscheint nicht im Menü
|
||||
|
||||
Aktualisieren Sie die Desktop-Datenbank:
|
||||
```bash
|
||||
update-desktop-database ~/.local/share/applications
|
||||
```
|
||||
|
||||
Oder melden Sie sich ab und wieder an.
|
||||
|
||||
## 🔄 Update
|
||||
|
||||
Um auf eine neue Version zu aktualisieren:
|
||||
|
||||
```bash
|
||||
# 1. Deinstallieren
|
||||
~/.local/share/pdf-to-ics/uninstall.sh
|
||||
|
||||
# 2. Neue Version herunterladen
|
||||
cd /pfad/zur/neuen/version
|
||||
|
||||
# 3. Neu installieren
|
||||
./install.sh
|
||||
```
|
||||
|
||||
## 💡 Entwickler-Modus
|
||||
|
||||
Wenn Sie an der Anwendung entwickeln möchten, nutzen Sie stattdessen:
|
||||
|
||||
```bash
|
||||
./start_gui.sh # Startet aus dem aktuellen Verzeichnis
|
||||
```
|
||||
|
||||
Die Installation ist nur für End-Benutzer gedacht.
|
||||
|
||||
## 🐧 Andere Betriebssysteme
|
||||
|
||||
- **Windows:** Nutzen Sie `start_gui.cmd` (keine Installation nötig)
|
||||
- **macOS:** Nutzen Sie `start_gui.sh` (keine Installation nötig)
|
||||
|
||||
## 📞 Support
|
||||
|
||||
Bei Problemen während der Installation:
|
||||
|
||||
1. Prüfen Sie die Systemanforderungen
|
||||
2. Lesen Sie die Fehlermeldungen sorgfältig
|
||||
3. Konsultieren Sie die README.md
|
||||
4. Öffnen Sie ein Issue im Repository
|
||||
|
||||
---
|
||||
|
||||
**Installation erfolgreich?** Viel Spaß beim Konvertieren Ihrer Dienstpläne! 📅✨
|
||||
Reference in New Issue
Block a user