Zum Inhalt

HTML-Vorschau-Plugin

Eine originalgetreue Live-Vorschau des aktiven HTML- (und PHP-) Dokuments, gerendert mit einer echten Browser-Engine (QtWebEngine) in einem andockbaren Panel. Anders als die Markdown-Vorschau rendert sie CSS, JavaScript, Webfonts und alles andere genau wie ein Browser.

Optionale Komponente

Die HTML-Vorschau linkt QtWebEngine, eine schwere Abhängigkeit. Sie ist ein Opt-in-Build (MTE_ENABLE_HTML_PREVIEW, standardmäßig ein) und nur vorhanden, wenn Qt WebEngine verfügbar ist. Ein Build ohne sie lässt dieses Plugin komplett weg und linkt kein QtWebEngine. Hinweise zu Paketierung und Lizenzen: BUILDING.md.

Wo Sie sie finden

Ansicht ▸ HTML-Vorschau öffnet (oder schließt) das Vorschau-Dock für den aktuellen Tab.

Verhalten

  • Live-Rendering. Die Vorschau rendert beim Tippen neu (entprellt; bei sehr großen Dateien lockert sich die Entprellung).
  • Volle Wiedergabetreue. Stylesheets, Skripte, Bilder und andere Ressourcen laden relativ zum Ordner des Dokuments, eine Seite erscheint also wie im Browser.
  • Links auf Ordner. Ein Klick auf einen Link zu einem lokalen Ordner lädt dessen Index-Dokument (index.html / index.htm / index.xhtml) statt einer Verzeichnisliste.
  • Im Browser öffnen. Die Werkzeugleiste öffnet die Datei auf der Festplatte (bzw. für die PHP-Server-Modi unten die Live-URL) in Ihrem Standardbrowser.

Vorschau-Sichtbarkeit

Die Sichtbarkeit der Vorschau wird pro Datei gemerkt, innerhalb einer Sitzung und über Neustarts hinweg:

  • Web-Dateien (.html, .htm, .xhtml sowie .php / .phtml / .php3 / .php4) öffnen die Vorschau automatisch, wenn Sie sie zum ersten Mal ansehen.
  • Andere Dateien nicht — aber Sie können die Vorschau mit Ansicht ▸ HTML-Vorschau auf jeder Datei öffnen; sie rendert die Datei dann als HTML.
  • Innerhalb einer Sitzung wird Ihre Wahl für einen Tab beim Zurückwechseln wiederhergestellt.
  • Über Neustarts hinweg wird Ihre ausdrückliche Wahl für eine Datei gemerkt: Ein manuelles Schließen bleibt beim nächsten Öffnen der Datei geschlossen, und eine Vorschau, die Sie auf einer nicht automatisch öffnenden Datei geöffnet haben, öffnet sich wieder. Nie ausdrücklich angefasste Dateien folgen jedes Mal dem Auto-Öffnen-Standard.

PHP-Vorschau

PHP läuft auf dem Server, QtWebEngine kann es also nicht direkt ausführen. Wählen Sie die Behandlung von .php-Dateien unter Einstellungen ▸ Plugins ▸ HTML-Vorschau:

Modus Wirkung Am besten für
Deaktiviert Zeigt eine Anleitungsseite; führt nichts aus und ruft nichts ab. PHP-Vorschau abschalten.
Mit PHP ausführen (Kommandozeile) Leitet das Dokument durch die lokale php-Binärdatei und rendert deren Ausgabe. Läuft unter PHPs CLI-SAPI. Templating / eigenständige Dateien, die HTML ausgeben.
Mit PHP ausführen (eingebauter Server) Serviert das Dokument über PHPs eingebauten Webserver (php -S), den der Editor für Sie startet und stoppt. Läuft unter der Web-SAPI. Volle Seiten — phpinfo(), $_SERVER, Sitzungen, Routing.
Einen von Ihnen betriebenen Server nutzen (URL) Bildet die offene Datei auf eine URL eines Servers ab, den Sie betreiben (Apache, nginx, Docker, php artisan serve, …). Einen bestehenden lokalen Dev-Stack.

Der Pfad zur PHP-Programmdatei und Beim Tippen automatisch aktualisieren gelten für beide Modi Kommandozeile und eingebauter Server. Lassen Sie den Pfad leer, um PATH und übliche Installationsorte zu durchsuchen (auf macOS erbt eine über den Finder gestartete App nicht den Shell-PATH — setzen Sie dort den vollen Pfad, z. B. /opt/homebrew/bin/php).

Kommandozeile vs. eingebauter Server

Beide Modi führen die lokale php-Binärdatei aus, aber in unterschiedlichen Umgebungen (SAPIs), und das ändert, was funktioniert:

  • Kommandozeile (CLI-SAPI). Schnell und einfach — sie zeigt schlicht, was das Skript ausgibt. Aber phpinfo() erscheint als reiner Text, und Web-Mechanismen wie $_SERVER, Sitzungen und Routing sind eingeschränkt oder leer. Ideal für Dateien, die überwiegend HTML ausgeben.

  • Eingebauter Server (Web-SAPI). Der Editor startet ein kleines php -S 127.0.0.1:<port> mit dem Ordner Ihrer Datei als Wurzel und lädt die Seite über HTTP — sie rendert genau wie auf einem echten Server: phpinfo() ist eine gestylte HTML-Seite, $_SERVER ist gefüllt, Sitzungen und Ressourcen-/Unterressourcen-Anfragen funktionieren.

  • Der Server startet erst bei der ersten Vorschau einer .php-Datei in diesem Modus, wird über Renderings hinweg wiederverwendet, bei einem Wechsel zu einer Datei in einem anderen Ordner neu gestartet und beim Schließen des Editors oder Verlassen des Modus gestoppt.

  • Er bindet nur an 127.0.0.1 und ist damit nie aus dem Netzwerk erreichbar.
  • Auch ungespeicherte Änderungen werden vorgeschaut: Ihr Live-Puffer wird in eine temporäre Datei im Ordner des Dokuments geschrieben (damit __DIR__ und relative include/require korrekt auflösen), und diese wird serviert. Die temporäre Datei wird bei jedem Rendern ersetzt und beim Beenden oder Moduswechsel entfernt.

Tip

Erscheint eine PHP-Seite als Text statt als gerenderte Seite, wechseln Sie von Kommandozeile auf eingebauter Server — das ist der CLI-vs.-Web-SAPI-Unterschied, kein Fehler.

Einen von Ihnen betriebenen Server nutzen (URL)

Läuft PHP bei Ihnen bereits hinter einem Webserver, richten Sie die Vorschau darauf:

  • Basis-URL — die Wurzel Ihres Servers, z. B. http://127.0.0.1:8000.
  • Dokumentwurzel — der lokale Ordner, der unter der Basis-URL serviert wird. Die offene Datei wird auf eine URL darunter abgebildet. Leer lassen, um die Datei namentlich von der Basis-URL zu servieren. Liegt die Datei außerhalb der Dokumentwurzel, meldet die Vorschau das, damit Sie die Zuordnung korrigieren können.

Wenn PHP nicht gefunden wird

Kann in den Modi Kommandozeile und eingebauter Server keine php-Binärdatei gefunden werden, zeigt die Vorschau einen kurzen Fehler mit Hinweisen, wie der Pfad zu setzen oder PHP zu installieren ist. Die Anleitungsseite des Modus Deaktiviert verlinkt ebenfalls PHP-Downloads und zeigt, wie ein Server gestartet wird.

Siehe auch