Gå til innhold

HTML-forhåndsvisning-programtillegget

En fulltro, løpende forhåndsvisning av det aktive HTML-dokumentet (og PHP-dokumentet), gjengitt med en virkelig nettlesermotor (QtWebEngine) i et dokkbart panel. I motsetning til Markdown-forhåndsvisningen gjengir denne CSS, JavaScript, nettskrifter og alt annet nøyaktig slik en nettleser ville gjort.

Tilgjengelighet — ikke hver nedlasting inneholder den

HTML-forhåndsvisningen drives av QtWebEngine, en fullstendig nettlesermotor, og er tilsvarende stor. Den er derfor valgfri, og hvilken nedlasting du har, avgjør om du får den.

  • macOS — OctoEdit utgis som to pakker: en med HTML-forhåndsvisningen og en slank en uten. Velg den nedlastingen som sier at den inneholder HTML-forhåndsvisningen, så er forhåndsvisningen der i det øyeblikket du starter redigereren. Det finnes ingen tilleggspakke å installere etterpå: en pakke uten forhåndsvisningen kan ikke få den senere, så last ned den andre i stedet.
  • Windows — forhåndsvisningen kan også legges til i en installasjon som alt finnes, som en egen nedlasting av HTML-forhåndsvisningen som du pakker ut i den mappen OctoEdit er installert i, og så starter du redigereren på nytt.

Mangler Vis ▸ HTML-forhåndsvisning i menyen, inneholder ikke din utgave forhåndsvisningen. Markdown-forhåndsvisningen krever ingen nettlesermotor og er alltid tilgjengelig.

Å bygge fra kildekoden: forhåndsvisningen ligger bak CMake-valget MTE_ENABLE_HTML_PREVIEW — se BUILDING.md for merknader om pakking og lisenser.

Hvor du finner det

Vis ▸ HTML-forhåndsvisning åpner (eller lukker) forhåndsvisningspanelet for den gjeldende fanen.

Slik oppfører den seg

  • Løpende gjengivelse. Forhåndsvisningen gjengis på nytt mens du skriver (med en forsinkelse som slakkes i svært store filer).
  • Fulltro. Stilark, skript, bilder og andre ressurser lastes inn i forhold til dokumentets mappe, så en side forhåndsvises slik den ville sett ut i en nettleser.
  • Lenker til mapper. Klikker du på en lenke som peker til en lokal mappe, lastes den mappens indeksdokument (index.html / index.htm / index.xhtml) inn i stedet for en mappeoversikt.
  • Åpne i nettleseren. Verktøylinjen åpner filen på disken (eller, i PHP-tjenermodusene nedenfor, den levende URL-en) i standardnettleseren din.
  • Panelstørrelse. Forhåndsvisningen holder en andel av vinduet i stedet for en fast bredde, så den vokser og krymper med vinduet — se Lagret oppsett.

Ett blink med vindusgjengivelse på CPU

Forhåndsvisningen tar en nettlesermotor inn i vinduet til editoren, og med Vindusgjengivelse satt til CPU må vinduet lages på nytt for å gi plass til den. Editorvinduet blinker derfor én gang — første gang du åpner HTML-forhåndsvisningen i en økt, og aldri mer etter det. Standardvalget, GPU, unngår det helt; se Innstillinger ▸ Generelt ▸ Vindusgjengivelse.

Forhåndsvisningens synlighet

Forhåndsvisningens synlighet huskes per fil, både i løpet av en økt og på tvers av omstarter:

  • Nettfiler (.html, .htm, .xhtml samt .php / .phtml / .php3 / .php4) åpner forhåndsvisningen av seg selv første gang du ser dem.
  • Andre filer gjør ikke det — men du kan åpne forhåndsvisningen på enhver fil med Vis ▸ HTML-forhåndsvisning, og den vil gjengi den filen som HTML.
  • Innenfor en økt gjenopprettes valget ditt for en fane når du kommer tilbake til den.
  • På tvers av omstarter huskes ditt uttrykkelige valg for en fil: en lukking du gjorde selv, blir stående lukket neste gang du åpner den filen, og en forhåndsvisning du åpnet på en fil som ikke ville åpnet den av seg selv, åpnes igjen. Filer du aldri uttrykkelig har rørt, følger standarden for automatisk åpning hver gang.

Å forhåndsvise PHP

PHP kjører på tjeneren, så QtWebEngine kan ikke kjøre det direkte. Velg hvordan .php-filer håndteres, under Innstillinger ▸ Programtillegg ▸ HTML-forhåndsvisning:

Modus Hva den gjør Best til
Av Viser en veiledningsside; kjører eller henter aldri noe. Å slå PHP-forhåndsvisningen av.
Kjør med PHP (kommandolinjen) Sender dokumentet gjennom det lokale php-programmet og gjengir utdataene. Kjører under PHPs CLI-SAPI. Maler og selvstendige filer som skriver ut HTML.
Kjør med PHP (innebygd tjener) Leverer dokumentet gjennom PHPs innebygde nettjener (php -S), som redigereren starter og stopper for deg. Kjører under nett-SAPI-en. Hele sider — phpinfo(), $_SERVER, økter, ruting.
Bruk en tjener du kjører selv (URL) Knytter den åpne filen til en URL på en tjener du kjører (Apache, nginx, Docker, php artisan serve …). Et lokalt utviklingsmiljø du alt har.

Stien under PHP-program og Oppdater automatisk mens du skriver gjelder både modusen kommandolinjen og innebygd tjener. La stien stå tom for å lete i PATH og på vanlige installasjonssteder (på macOS arver ikke et program som er startet fra Finder, PATH fra skallet ditt, så oppgi hele stien, for eksempel /opt/homebrew/bin/php).

Kommandolinjen mot innebygd tjener

Begge disse modusene kjører det lokale php-programmet, men i ulike miljøer (SAPI-er), og det endrer hva som virker:

  • Kommandolinjen (CLI-SAPI). Rask og enkel — den viser bare det skriptet skriver ut. Men phpinfo() gjengis som ren tekst, og nettfunksjoner som $_SERVER, økter og ruting er begrensede eller tomme. Glimrende til filer som for det meste sender ut HTML.

  • Innebygd tjener (nett-SAPI). Redigereren starter en liten php -S 127.0.0.1:<port> med rot i filens mappe og laster siden over HTTP, så den gjengis nøyaktig som på en virkelig tjener: phpinfo() er en formet HTML-side, $_SERVER er fylt ut, og økter og forespørsler etter ressurser og underressurser virker alle sammen.

  • Tjeneren startes først når du forhåndsviser en .php-fil i denne modusen, gjenbrukes på tvers av gjengivelser, startes på nytt hvis du bytter til en fil i en annen mappe, og stoppes når du lukker redigereren eller forlater modusen.

  • Den binder seg bare til 127.0.0.1, så den kan aldri nås fra nettverket.
  • Ulagrede endringer forhåndsvises også: den levende bufferen din skrives til en midlertidig fil i dokumentets mappe (så __DIR__ og relative include og require peker riktig), og det er den som leveres. Den midlertidige filen erstattes ved hver gjengivelse og fjernes når du avslutter eller bytter modus.

Tip

Vises en PHP-side som tekst i stedet for som en gjengitt side, så bytt fra kommandolinjen til innebygd tjener — det er forskjellen mellom CLI- og nett-SAPI og ikke en feil.

Bruk en tjener du kjører selv (URL)

Kjører du allerede PHP bak en nettjener, så pek forhåndsvisningen mot den:

  • Basis-URL — tjenerens rot, for eksempel http://127.0.0.1:8000.
  • Dokumentrot — den lokale mappen som leveres på den basis-URL-en. Den åpne filen knyttes til en URL under den. La den stå tom for å levere filen etter navn fra basis-URL-en. Ligger filen utenfor dokumentroten, melder forhåndsvisningen det, så du kan rette sammenhengen.

Når PHP ikke finnes

I modusene kommandolinjen og innebygd tjener viser forhåndsvisningen en kort feil som forklarer hvordan du angir stien eller installerer PHP, hvis det ikke kan finnes noe php-program. Veiledningssiden i modusen Av lenker også til PHP-nedlastinger og viser hvordan man starter en tjener.

Se også