git_issue_importer/README.WIN.md
2025-03-10 18:06:17 +01:00

82 lines
No EOL
3.3 KiB
Markdown

# Einrichtung einer geplanten Aufgabe in Windows für automatische Updates
Um das Forgejo-to-Markdown Update-Skript regelmäßig automatisch auszuführen, kannst du den Windows Task Scheduler (Aufgabenplanung) verwenden. Hier ist eine Schritt-für-Schritt-Anleitung:
## Vorbereitung
1. Speichere die beiden Skripte in einem Ordner deiner Wahl:
- `forgejo_exporter.py` (Python-Skript)
- `update_forgejo.bat` (Batch-Skript)
- `.env`
2. Stelle sicher, dass Python installiert ist und der `python`-Befehl im Pfad verfügbar ist
## Erstellen einer geplanten Aufgabe
1. Öffne die **Aufgabenplanung**:
- Drücke `Win + R`, gib `taskschd.msc` ein und drücke Enter
- Oder suche im Startmenü nach "Aufgabenplanung"
2. Klicke im rechten Bereich auf **Aufgabe erstellen...**
3. Im Tab **Allgemein**:
- Gib einen **Namen** ein (z.B. "Forgejo Issues Update")
- Optional: Füge eine Beschreibung hinzu
- Wähle **Mit höchsten Privilegien ausführen** (falls dein Benutzer über Administratorrechte verfügt)
- Wähle unter "Konfigurieren für:" dein Betriebssystem
4. Im Tab **Trigger**:
- Klicke auf **Neu...**
- Wähle unter "Beginnen" die Option **Nach einem Zeitplan**
- Stelle die Häufigkeit ein (z.B. **Täglich** um 3:00 Uhr)
- Aktiviere **Aktiviert**
- Klicke auf **OK**
5. Im Tab **Aktionen**:
- Klicke auf **Neu...**
- Aktion: **Programm starten**
- Programm/Skript: Gib den vollständigen Pfad zu `update_forgejo.bat` ein oder klicke auf **Durchsuchen...** um die Datei auszuwählen
- Starten in: Gib den Ordner ein, in dem sich das Skript befindet
- Klicke auf **OK**
6. Im Tab **Bedingungen**:
- Du kannst hier optionale Einstellungen vornehmen, z.B. nur ausführen, wenn der Computer am Netzwerk angeschlossen ist
7. Im Tab **Einstellungen**:
- Wähle **Aufgabe so bald wie möglich nach einem verpassten Start ausführen**
- Wähle **Bei Bedarf aufwecken**
- Klicke auf **OK**, um die Aufgabe zu erstellen
## Testen der geplanten Aufgabe
1. Finde deine neu erstellte Aufgabe in der Liste
2. Rechtsklick auf die Aufgabe und wähle **Ausführen**
3. Überprüfe, ob die Aufgabe erfolgreich ausgeführt wurde:
- Prüfe das Logfile (`forgejo_update.log`)
- Überprüfe, ob neue Dateien im Ausgabeordner erstellt wurden
## Fehlerbehebung
Falls die geplante Aufgabe nicht wie erwartet funktioniert:
1. **Problem**: Die Aufgabe wird gestartet, aber Python-Fehler treten auf
- **Lösung**: Überprüfe, ob alle erforderlichen Python-Pakete installiert sind (`pip install requests`)
2. **Problem**: Die Aufgabe wird gar nicht ausgeführt
- **Lösung**: Überprüfe die Ereignisanzeige (Event Viewer) auf Fehler
3. **Problem**: Das Skript kann nicht auf die Ausgabeordner zugreifen
- **Lösung**: Stelle sicher, dass der Benutzer, unter dem die Aufgabe ausgeführt wird, Schreibrechte für den Zielordner hat
4. **Problem**: Das Batch-Skript wird nicht gefunden
- **Lösung**: Verwende absolute Pfade im Task Scheduler anstelle von relativen Pfaden
## Alternative: Ausführen beim Windows-Start
Wenn du möchtest, dass das Skript bei jedem Windows-Start ausgeführt wird:
1. Erstelle eine Verknüpfung zu `update_forgejo.bat`
2. Drücke `Win + R`, gib `shell:startup` ein und drücke Enter
3. Kopiere die Verknüpfung in den geöffneten Ordner
Dies führt das Skript jedes Mal aus, wenn du dich bei Windows anmeldest.