Preskočiť na obsah

Zásuvný modul Náhľad HTML

Plnohodnotný, živý náhľad aktívneho dokumentu HTML (a PHP) vykreslený skutočným prehliadačovým jadrom (QtWebEngine) v ukotviteľnom paneli. Na rozdiel od náhľadu Markdownu vykresľuje CSS, JavaScript, webové písma a všetko ostatné presne tak, ako by to urobil prehliadač.

Dostupnosť — nie je súčasťou každého balíka na stiahnutie

Náhľad HTML poháňa QtWebEngine, kompletné prehliadačové jadro, a je preto zodpovedajúco veľký. Je teda voliteľný a o tom, či ho máte, rozhoduje to, ktorý balík ste si stiahli.

  • macOS — OctoEdit sa vydáva ako dva balíky: jeden s náhľadom HTML a odľahčený bez neho. Stiahnite si ten, pri ktorom je uvedené, že náhľad HTML obsahuje, a náhľad tam bude hneď, ako editor spustíte. Neexistuje doplnok, ktorý by sa dal doinštalovať dodatočne: balík bez náhľadu ho už nezíska, takže si namiesto toho stiahnite ten druhý.
  • Windows — náhľad sa dá pridať aj do existujúcej inštalácie neskôr, a to ako samostatný balík s náhľadom HTML, ktorý rozbalíte do priečinka, kde je OctoEdit nainštalovaný, a potom editor reštartujete.

Ak v ponuke chýba Zobraziť ▸ Náhľad HTML, vaša kópia náhľad neobsahuje. Náhľad Markdownu žiadne prehliadačové jadro nepotrebuje a je dostupný vždy.

Zostavovanie zo zdrojových kódov: náhľad je za voľbou CMake MTE_ENABLE_HTML_PREVIEW — poznámky k balíčkovaniu a licenciám nájdete v BUILDING.md.

Kde ho nájdete

Zobraziť ▸ Náhľad HTML otvorí (alebo zatvorí) panel náhľadu pre aktuálnu kartu.

Ako sa správa

  • Živé vykresľovanie. Náhľad sa počas písania priebežne prekresľuje (s oneskorením; pri veľmi veľkých súboroch sa oneskorenie predlžuje).
  • Plná vernosť. Štýly, skripty, obrázky a ďalšie zdroje sa načítavajú relatívne k priečinku dokumentu, takže sa stránka zobrazí tak, ako by sa zobrazila v prehliadači.
  • Odkazy na priečinky. Kliknutím na odkaz smerujúci na lokálny priečinok sa namiesto výpisu priečinka načíta jeho indexový dokument (index.html / index.htm / index.xhtml).
  • Otvoriť v prehliadači. Panel nástrojov otvorí súbor na disku (alebo pri nižšie opísaných serverových režimoch PHP živú adresu URL) vo vašom predvolenom prehliadači.
  • Veľkosť panela. Náhľad si drží podiel okna, nie pevnú šírku, takže rastie a zmenšuje sa spolu s oknom — pozri Uložené rozloženie.

Jedno zablikanie pri vykresľovaní okna na CPU

Náhľad prináša do okna editora prehliadačové jadro a pri Vykresľovaní okna nastavenom na CPU sa okno musí vytvoriť znova, aby sa mu uvoľnilo miesto. Okno editora preto raz zablikne — pri prvom otvorení náhľadu HTML v danej relácii a už nikdy potom. Predvolené GPU tomu úplne predchádza; pozri Predvoľby ▸ Všeobecné ▸ Vykresľovanie okna.

Viditeľnosť náhľadu

Viditeľnosť náhľadu sa pamätá pre každý súbor zvlášť, počas relácie aj naprieč reštartmi:

  • Webové súbory (.html, .htm, .xhtml a .php / .phtml / .php3 / .php4) otvárajú náhľad automaticky pri prvom zobrazení.
  • Ostatné súbory nie — náhľad si však môžete otvoriť pri ktoromkoľvek súbore cez Zobraziť ▸ Náhľad HTML a daný súbor sa vykreslí ako HTML.
  • V rámci relácie sa vaša voľba pre kartu obnoví, keď sa na ňu vrátite.
  • Naprieč reštartmi sa pamätá vaša výslovná voľba pre daný súbor: ručne zatvorený náhľad ostane pri ďalšom otvorení súboru zatvorený a náhľad, ktorý ste otvorili pri súbore, kde by sa sám neotvoril, sa znova otvorí. Súbory, ktorých ste sa výslovne nikdy nedotkli, sa zakaždým riadia predvoleným automatickým otváraním.

Náhľad súborov PHP

PHP beží na serveri, takže ho QtWebEngine nedokáže spustiť priamo. V Predvoľby ▸ Zásuvné moduly ▸ Náhľad HTML zvoľte, ako sa majú súbory .php spracúvať:

Režim Čo robí Vhodné na
Vypnuté Zobrazí stránku s pokynmi; nikdy nič nespustí ani nestiahne. Vypnutie náhľadu PHP.
Spustiť pomocou PHP (príkazový riadok) Prepošle dokument cez lokálny binárny súbor php a vykreslí jeho výstup. Beží pod CLI SAPI jazyka PHP. Šablóny a samostatné súbory, ktoré vypisujú HTML.
Spustiť pomocou PHP (vstavaný server) Poskytne dokument cez vstavaný webový server PHP (php -S), ktorý editor za vás spúšťa a zastavuje. Beží pod webovým SAPI. Celé stránky — phpinfo(), $_SERVER, relácie, smerovanie.
Použiť vlastný server (URL) Namapuje otvorený súbor na adresu URL na serveri, ktorý prevádzkujete vy (Apache, nginx, Docker, php artisan serve, …). Existujúcu lokálnu vývojovú zostavu.

Cesta k spustiteľnému súboru PHP a voľba Aktualizovať automaticky počas písania platia pre režim príkazového riadka aj vstavaného servera. Ak cestu necháte prázdnu, prehľadá sa vaša premenná PATH a bežné miesta inštalácie (na macOS aplikácia spustená cez Finder nededí premennú PATH vášho shellu, takže nastavte úplnú cestu, napr. /opt/homebrew/bin/php).

Príkazový riadok verzus vstavaný server

Obidva tieto režimy spúšťajú lokálny binárny súbor php, ale v odlišných prostrediach (SAPI), a to mení, čo funguje:

  • Príkazový riadok (CLI SAPI). Rýchly a jednoduchý — jednoducho zobrazí to, čo skript vypíše. Lenže phpinfo() sa vykreslí ako obyčajný text a webové vlastnosti ako $_SERVER, relácie a smerovanie sú obmedzené alebo prázdne. Výborný pre súbory, ktoré prevažne vypisujú HTML.

  • Vstavaný server (webové SAPI). Editor spustí malý php -S 127.0.0.1:<port> s koreňom v priečinku vášho súboru a načíta stránku cez HTTP, takže sa vykreslí presne ako na skutočnom serveri: phpinfo() je naštýlovaná stránka HTML, $_SERVER je naplnené a relácie aj požiadavky na podriadené zdroje fungujú.

  • Server sa spustí, až keď v tomto režime prvýkrát zobrazíte náhľad súboru .php, znova sa použije pri ďalších vykresleniach, reštartuje sa, keď prejdete na súbor v inom priečinku, a zastaví sa, keď zatvoríte editor alebo z režimu odídete.

  • Počúva iba na 127.0.0.1, takže zo siete nie je nikdy dostupný.
  • Náhľad zobrazuje aj neuložené úpravy: váš živý buffer sa zapíše do dočasného súboru v priečinku dokumentu (aby sa __DIR__ a relatívne include/require vyhodnotili správne) a poskytuje sa práve on. Dočasný súbor sa pri každom vykreslení nahradí a pri ukončení či zmene režimu sa odstráni.

Tip

Ak sa stránka PHP zobrazí ako text namiesto vykreslenej stránky, prepnite z príkazového riadka na vstavaný server — je to rozdiel medzi CLI a webovým SAPI, nie chyba.

Použiť vlastný server (URL)

Ak už PHP prevádzkujete za webovým serverom, nasmerujte naň náhľad:

  • Základná URL — koreň vášho servera, napr. http://127.0.0.1:8000.
  • Koreň dokumentov — lokálny priečinok poskytovaný na tejto základnej adrese. Otvorený súbor sa namapuje na adresu URL pod ním. Ak ho necháte prázdny, súbor sa poskytne podľa názvu zo základnej adresy. Ak je súbor mimo koreňa dokumentov, náhľad to ohlási, aby ste mapovanie mohli opraviť.

Keď sa PHP nenájde

V režimoch príkazového riadka a vstavaného servera zobrazí náhľad krátku chybu s vysvetlením, ako nastaviť cestu alebo nainštalovať PHP, ak sa nepodarí nájsť žiadny binárny súbor php. Stránka s pokynmi v režime Vypnuté takisto odkazuje na súbory PHP na stiahnutie a ukazuje, ako server spustiť.

Pozri aj