Přeskočit obsah

Zásuvný modul Náhled HTML

Plnohodnotný živý náhled aktivního dokumentu HTML (a PHP), vykreslený skutečným prohlížečovým jádrem (QtWebEngine) v ukotvitelném panelu. Na rozdíl od náhledu Markdownu vykresluje CSS, JavaScript, webová písma a vše ostatní přesně tak, jak by to udělal prohlížeč.

Dostupnost — není v každém stažení

Náhled HTML pohání QtWebEngine, kompletní prohlížečové jádro, a je tomu úměrně velký. Je proto volitelný a o tom, zda jej máte, rozhoduje to, které stažení jste si vybrali.

  • macOS — OctoEdit je vydáván jako dva balíčky: jeden s náhledem HTML a jeden štíhlý bez něj. Vyberte si stažení, které uvádí, že náhled HTML obsahuje, a náhled tam bude hned, jakmile editor spustíte. Žádný doplněk k pozdější instalaci neexistuje: balíček bez náhledu jej později získat nemůže, proto si raději stáhněte ten druhý.
  • Windows — náhled lze do stávající instalace přidat i později, jako samostatné stažení náhledu HTML, které rozbalíte do složky, kde je OctoEdit nainstalován, a pak editor restartujete.

Pokud Zobrazit ▸ Náhled HTML v nabídce chybí, vaše kopie náhled neobsahuje. Náhled Markdownu žádné prohlížečové jádro nepotřebuje a je dostupný vždy.

Sestavení ze zdrojů: náhled stojí za volbou CMake MTE_ENABLE_HTML_PREVIEW — poznámky k balení a licencování najdete v BUILDING.md.

Kde to najdete

Zobrazit ▸ Náhled HTML otevře (nebo zavře) dok s náhledem pro aktuální kartu.

Jak se chová

  • Živé vykreslování. Náhled se překresluje při psaní (s prodlevou; u velmi velkých souborů se prodleva uvolní).
  • Plná věrnost. Styly, skripty, obrázky a další prostředky se načítají relativně ke složce dokumentu, takže se stránka zobrazí v náhledu jako v prohlížeči.
  • Odkazy na složky. Kliknutí na odkaz mířící na místní složku načte indexový dokument oné složky (index.html / index.htm / index.xhtml) místo výpisu adresáře.
  • Otevřít v prohlížeči. Lišta otevře soubor na disku (nebo u níže popsaných serverových režimů PHP živou adresu URL) ve vašem výchozím prohlížeči.
  • Velikost panelu. Náhled si drží podíl okna, ne pevnou šířku, takže roste a zmenšuje se s oknem — viz Uložené rozvržení.

Jedno zablikání při vykreslování okna na CPU

Náhled přináší do okna editoru prohlížečové jádro a při Vykreslování okna nastaveném na CPU se okno musí vytvořit znovu, aby se mu uvolnilo místo. Okno editoru proto jednou zablikne — při prvním otevření náhledu HTML v dané relaci a už nikdy potom. Výchozí GPU tomu předchází úplně; viz Předvolby ▸ Obecné ▸ Vykreslování okna.

Viditelnost náhledu

Viditelnost náhledu se pamatuje pro každý soubor zvlášť, jak během relace, tak napříč restarty:

  • Webové soubory (.html, .htm, .xhtml a .php / .phtml / .php3 / .php4) otevírají náhled automaticky, když si je poprvé zobrazíte.
  • Ostatní soubory ne — ale náhled můžete otevřít u libovolného souboru volbou Zobrazit ▸ Náhled HTML a onen soubor se vykreslí jako HTML.
  • V rámci relace se vaše volba pro kartu obnoví, když se na ni vrátíte.
  • Napříč restarty se pamatuje vaše výslovná volba pro daný soubor: ruční zavření zůstane zavřené, až soubor příště otevřete, a náhled, který jste otevřeli u souboru, jenž by se sám neotevřel, se znovu otevře. Soubory, kterých jste se výslovně nedotkli, se pokaždé řídí výchozí volbou automatického otevírání.

Náhled PHP

PHP běží na serveru, takže je QtWebEngine nemůže spustit přímo. Zvolte, jak se se soubory .php naloží, v Předvolby ▸ Zásuvné moduly ▸ Náhled HTML:

Režim Co dělá Nejvhodnější pro
Vypnuto Zobrazí stránku s pokyny; nikdy nic nespouští ani nestahuje. Vypnutí náhledu PHP.
Spustit pomocí PHP (příkazová řádka) Protáhne dokument místním programem php a vykreslí jeho výstup. Běží pod SAPI CLI v PHP. Šablony a samostatné soubory, které vypisují HTML.
Spustit pomocí PHP (vestavěný server) Poskytne dokument přes vestavěný webový server PHP (php -S), který editor spouští a zastavuje za vás. Běží pod webovým SAPI. Celé stránky — phpinfo(), $_SERVER, relace, směrování.
Použít vlastní server (URL) Namapuje otevřený soubor na adresu URL na serveru, který provozujete vy (Apache, nginx, Docker, php artisan serve, …). Existující místní vývojové prostředí.

Cesta ke spustitelnému souboru PHP a volba Aktualizovat automaticky během psaní platí pro režim příkazové řádky i vestavěného serveru. Ponecháte-li cestu prázdnou, prohledá se vaše PATH a obvyklá umístění instalace (na macOS aplikace spuštěná z Finderu vaši shellovou PATH nedědí, proto zadejte celou cestu, například /opt/homebrew/bin/php).

Příkazová řádka versus vestavěný server

Oba tyto režimy spouštějí místní program php, ale v odlišných prostředích (SAPI), a to mění, co funguje:

  • Příkazová řádka (SAPI CLI). Rychlé a jednoduché — prostě ukáže, co skript vypíše. Ale phpinfo() se vykreslí jako prostý text a webové funkce jako $_SERVER, relace a směrování jsou omezené či prázdné. Skvělé pro soubory, které převážně vypisují HTML.

  • Vestavěný server (webové SAPI). Editor spustí malý php -S 127.0.0.1:<port> ukotvený ve složce vašeho souboru a načte stránku přes HTTP, takže se vykreslí přesně jako na skutečném serveru: phpinfo() je stylovaná stránka HTML, $_SERVER je naplněné a relace i požadavky na prostředky a podzdroje fungují.

  • Server se spustí, teprve když v tomto režimu poprvé zobrazíte náhled souboru .php, používá se opakovaně napříč vykreslováními, restartuje se, přepnete-li na soubor v jiné složce, a zastaví se, když editor zavřete nebo režim opustíte.

  • Naslouchá pouze na 127.0.0.1, takže není nikdy dostupný ze sítě.
  • Náhled zobrazuje i neuložené úpravy: váš živý buffer se zapíše do dočasného souboru ve složce dokumentu (aby se __DIR__ a relativní include/require vyhodnotily správně) a poskytuje se právě ten. Dočasný soubor se při každém vykreslení nahradí a odstraní se, když skončíte nebo přepnete režim.

Tip

Pokud se stránka PHP zobrazí jako text místo vykreslené stránky, přepněte z příkazové řádky na vestavěný server — to je rozdíl mezi SAPI CLI a webovým SAPI, nikoli chyba.

Použít vlastní server (URL)

Pokud už PHP za webovým serverem provozujete, nasměrujte náhled na něj:

  • Základní URL — kořen vašeho serveru, například http://127.0.0.1:8000.
  • Kořen dokumentů — místní složka poskytovaná na této základní adrese URL. Otevřený soubor se namapuje na adresu URL pod ní. Ponecháte-li ji prázdnou, poskytuje se soubor podle názvu ze základní adresy URL. Je-li soubor mimo kořen dokumentů, náhled to ohlásí, abyste mohli mapování opravit.

Když se PHP nenajde

V režimu příkazové řádky a vestavěného serveru zobrazí náhled krátkou chybu vysvětlující, jak cestu nastavit nebo PHP nainstalovat, pokud se žádný program php najít nepodaří. Stránka s pokyny v režimu Vypnuto rovněž odkazuje na stažení PHP a ukazuje, jak server spustit.

Viz také