PKR-Lab

Installation

Quelle: pkr-lab/pkr-lab-docs/DocFlowEngine/installation.md

Installation

Voraussetzungen

PowerShell installieren (nur für macOS/Linux nötig - optional)

Auf dem eigentlichen Zielsystem (Windows-Schulrechner) ist nichts zu installieren:
Windows PowerShell 5.1 ist auf jedem Windows bereits vorhanden, DocFlowEngine läuft
damit ohne jeden zusätzlichen Schritt. Die folgenden Befehle sind nur für alle, die
DocFlowEngine testweise unter macOS/Linux ausführen möchten (z. B. Entwicklung) -
PowerShell 5.1 selbst existiert dort nicht, PowerShell 7+ ist der Ersatz.

# macOS mit Homebrew (kein sudo nötig)
brew install powershell

# Linux (Ubuntu/Debian) - benötigt sudo/Admin-Rechte für die Paketinstallation;
# alternativ ganz ohne Admin-Rechte über das offizielle .tar.gz-Archiv
# (https://github.com/PowerShell/PowerShell/releases) in ein Benutzerverzeichnis entpacken
sudo apt-get install -y powershell

Setup

git clone https://github.com/pkr-lab/DocFlowEngine.git
cd DocFlowEngine

Erster Lauf

  1. Passe die Konfiguration in config/docflow-config.psd1 an. Pfade werden nur ganz oben im Block paths geändert, alle anderen Einträge verweisen per {name} darauf (siehe DocFlowEngine/konfiguration.md).
  2. Führe das Skript im DryRun-Modus aus, um die geplanten Aktionen zu prüfen:
    pwsh -NoProfile -ExecutionPolicy Bypass -File ./scripts/DocFlowEngine.ps1 -DryRun
    # oder mit Windows PowerShell 5.1:
    powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\DocFlowEngine.ps1 -DryRun
    
  3. Wenn alles passt, führe es ohne -DryRun aus:
    pwsh -NoProfile -ExecutionPolicy Bypass -File ./scripts/DocFlowEngine.ps1
    # oder mit Windows PowerShell 5.1:
    powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\DocFlowEngine.ps1
    

Fehlersuche

Symptom Ursache Lösung
Teilmodul '…' wurde nicht gefunden. Checkout unvollständig Repo vollständig auschecken
pwsh: command not found PowerShell 7 fehlt powershell.exe (5.1) nutzen oder PowerShell 7 installieren, beide funktionieren (Kompatibilität)
Skript wird blockiert Execution Policy -ExecutionPolicy Bypass (nur für den Prozess)

Weitere Fälle: Debugging und Fehlersuche.