Web-Helper: Anwenderdokumentation#

Einsatzzweck#

Das Web-Helper Tool unterstützt Sie bei der Migration von Webinhalten aus dem Content-Management-System Plone in das System TYPO3. Das Tool automatisiert den Migrationsprozess, indem es JSON-Exportdateien aus Plone verarbeitet, die Inhalte strukturiert aufbereitet und mithilfe von Large Language Models (LLMs) eine Inhaltsanalyse sowie Textverbesserungsvorschläge generiert.

Das Grundprinzip besteht aus drei Schritten: Sie laden eine JSON-Datei mit Ihren Plone-Inhalten hoch, das Tool strukturiert diese automatisch und erstellt exportierbare Formate. Optional können Sie eine KI-gestützte Analyse durchführen lassen, die Ihre Inhalte bewertet und Verbesserungsvorschläge generiert.

Funktionsumfang#

Das Tool bietet folgende Kernfunktionen:

JSON-Import: Verarbeitung von Plone JSON-Export-Dateien bis zu einer Größe von 100 MB
Content-Strukturierung: Automatische Erkennung von Seitenhierarchien und verschiedenen Content-Typen
Markdown-Export: Generierung einer einzigen strukturierten Markdown-Datei mit allen Inhalten
ZIP-Export: Export als organisierte Dateistruktur mit separaten Markdown-Dateien pro Seite
LLM-Inhaltsanalyse: KI-gestützte Bewertung der Textqualität, Struktur und Lesbarkeit
Textverbesserungsvorschläge: Generierung überarbeiteter Inhalte basierend auf der Analyse
Download-Management: Automatische Bereitstellung aller Ergebnisse als herunterladbare Dateien

Bedienung#

Schritt 1: JSON-Datei hochladen#

Klicken Sie auf das Feld “Plone JSON-Datei hochladen” und wählen Sie Ihre Exportdatei aus. Alternativ können Sie mit dem Button “📋 Beispiel laden” eine Beispieldatei laden, um die Funktionsweise zu testen.

Schritt 2: JSON verarbeiten#

Klicken Sie auf “1. JSON verarbeiten”. Das Tool analysiert die Struktur Ihrer Inhalte und zeigt im Bereich “Statistiken” eine Übersicht über die gefundenen Seiten und Content-Typen an.

Schritt 3: Export erstellen (optional)#

Sie können nun entscheiden, in welchem Format Sie Ihre Inhalte exportieren möchten:

Markdown-Datei erzeugen: Erstellt eine einzelne Markdown-Datei mit allen Seiten
ZIP-Datei erzeugen: Erstellt eine ZIP-Datei mit separaten Markdown-Dateien für jede Seite, organisiert nach der ursprünglichen Hierarchie

Die Download-Links erscheinen automatisch nach der Generierung.

Schritt 4: LLM-Analyse starten (optional)#

Klicken Sie auf “2. LLM-Analyse starten”, um eine KI-gestützte Bewertung Ihrer Inhalte zu erhalten. Das Tool führt zwei Analysen durch:

Inhalts-Analyse: Bewertet Struktur, Qualität und Lesbarkeit der Texte
Textvorschläge: Generiert konkrete Verbesserungsvorschläge für Ihre Inhalte

Die Ergebnisse werden direkt im Interface angezeigt. Mit den Buttons “📄 Download erzeugen” können Sie die Analysen als separate Dateien herunterladen.

Wichtige Hinweise#

Das Tool unterstützt JSON-Dateien bis zu 100 MB Größe
Die LLM-Analyse benötigt eine konfigurierte API-Verbindung zu einem OpenAI-kompatiblen LLM-Dienst
Base64-kodierte Bilder werden automatisch durch Platzhalter ersetzt
Alle Exports sind UTF-8-kodiert

Anwendungsbeispiel#

Ausgangssituation: Sie betreiben eine universitäre Website auf Plone mit etwa 300 Seiten unterschiedlicher Content-Typen (Standardseiten, FAQ-Seiten, News-Artikel). Die Website soll zu TYPO3 migriert werden.

Schritt 1: Sie exportieren Ihre Plone-Inhalte als JSON-Datei (25 MB) und laden diese im Web-Helper hoch.

Schritt 2: Nach der Verarbeitung zeigt das Tool, dass 287 Seiten erkannt wurden: 180 Dokumente, 45 Ordner, 35 News-Artikel und 27 FAQ-Seiten.

Schritt 3: Sie erstellen einen ZIP-Export, um die Inhalte im nächsten Schritt einzeln in TYPO3 zu importieren. Die ZIP-Datei enthält die Seiten in ihrer ursprünglichen Ordnerstruktur.

Schritt 4: Sie starten die LLM-Analyse. Die Inhalts-Analyse zeigt, dass viele Seiten veraltete HTML-Strukturen enthalten und die Lesbarkeit verbessert werden könnte. Die Textvorschläge liefern konkrete Formulierungsalternativen für die kritischsten Seiten.

Ergebnis: Sie haben exportierbare Dateien und detaillierte Analysen, die Ihnen helfen, die Migration vorzubereiten und Schwachstellen in Ihren Inhalten vor dem Import in TYPO3 zu identifizieren.

Empfehlungen für die effiziente Nutzung#

Testen Sie das Tool zunächst mit der Beispieldatei, um die Funktionsweise zu verstehen
Prüfen Sie die Statistiken nach dem Import, um sicherzustellen, dass alle erwarteten Content-Typen erkannt wurden
Nutzen Sie den ZIP-Export, wenn Sie die Seiten einzeln weiterverarbeiten möchten
Verwenden Sie die Markdown-Datei, wenn Sie einen schnellen Gesamtüberblick über alle Inhalte benötigen
Führen Sie die LLM-Analyse nur durch, wenn eine entsprechende API konfiguriert ist
Laden Sie die Analyse-Ergebnisse herunter, bevor Sie eine neue JSON-Datei verarbeiten
Bei sehr großen Dateien (über 50 MB) sollten Sie längere Verarbeitungszeiten einplanen

Systemgrenzen#

Das Tool kann folgende Aufgaben nicht durchführen:

Direkter Import in TYPO3 (das Tool bereitet nur die Daten vor)
Automatische Migration von Berechtigungen und Zugriffsrechten
Verarbeitung von eingebetteten Medien wie Videos (nur Bilder werden erkannt)
Übersetzung von Inhalten (diese Funktion ist geplant, aber noch nicht implementiert)
Verarbeitung von Plone-Workflows oder Versionierungen
Duplikat-Erkennung über mehrere JSON-Dateien hinweg
Automatische Qualitätssicherung ohne manuelle Überprüfung

Die LLM-Analyse ist abhängig von einer externen API-Verbindung. Ohne konfigurierte LLM-API sind nur die Export-Funktionen nutzbar.

Zusammenfassung#

Das Web-Helper Tool ist ein Zwischenschritt im Migrationsprozess von Plone zu TYPO3. Es strukturiert Ihre exportierten Inhalte, macht sie lesbar und bietet optional eine KI-gestützte Bewertung. Das Tool übernimmt die zeitaufwendige Aufbereitung der Rohdaten und ermöglicht Ihnen, fundierte Entscheidungen über notwendige Inhaltsaktualisierungen zu treffen.

Sie bleiben in der Verantwortung für die finale Qualitätskontrolle und den Import in TYPO3. Das Tool unterstützt Sie durch Automatisierung und intelligente Analyse, ersetzt aber nicht die fachliche Bewertung durch Sie als Anwender.