Documentatie

Publicatiehandleiding

Een praktische gids voor het publiceren van statische websites, het voorbereiden van framework-builds, het verbinden van domeinen en het bijwerken van projecten op DeployPages.

React-publicatieNext.js-exportDNS opzoekenSSL-checkMetagenerator

Snel beginnen

Publicatie betekent dat lokale websitebestanden worden omgezet in een URL die mensen kunnen openen. DeployPages is gebouwd voor statische uitvoer, zodat de eerste publicatie kan beginnen met een map in plaats van een serverconfiguratie.

Optie 1: publicatie via slepen en neerzetten

Het snelste pad voor statische projecten. Als de website al HTML, CSS, JavaScript of een voltooide build-map bevat, kunt u deze rechtstreeks uploaden.

Goede pasvorm voor

Landingspagina's, persoonlijke websites, cv's, prototypes, statische documentatie en andere browsernative frontend-uitvoer.
  • 1
    Bereid de projectmap voor

    Uw publiceerbare map moet in de root een index.html-bestand bevatten, plus alle stijlen, scripts en afbeeldingsassets waarvan de pagina afhankelijk is.

    Voorbeeld mapstructuur
    mijn-website/├── index.html├── styles.css├── script.js└── images/    ├── logo.png    └── hero.jpg

    Veelgemaakte fout

    Als index.html ontbreekt of verborgen is in een submap, zal de website na het uploaden niet correct worden omgezet.
  • 2
    Open het uploadgebied

    Gebruik het uploadgebied op DeployPages. U kunt een tijdelijk project eerst publiceren en u later aanmelden als u het wilt behouden.

  • 3
    Upload de map

    Sleep de volledige map naar het uploadgebied of kies deze uit de bestandskiezer. Voor frameworks uploadt u de uitvoermap build in plaats van de bronstructuur.

  • 4
    Open de gegenereerde URL

    Wanneer het uploaden is voltooid, retourneert DeployPages een live URL die u onmiddellijk kunt gebruiken om te testen of te delen.

Optie 2: CLI-proces

Handig wanneer dezelfde build herhaaldelijk wordt gepubliceerd en de publicatie thuishoort in een script, CI-taak of releasechecklist.

Gebruik dit wanneer het project herhaalbaar is geworden

Slepen en neerzetten is beter voor eenmalige voorbeelden. Een CLI-proces is zinvol wanneer een team elke keer dezelfde uitvoermap nodig heeft die op dezelfde manier wordt gepubliceerd.

Installeer de CLI

Gebruik uw pakketbeheerder naar keuze om de CLI wereldwijd te installeren.

npm install -g @deploypages/cli

Authenticeren

Voer de login-opdracht uit en voltooi de browsergebaseerde autorisatiestap.

deploypages login

Publiceer de huidige map

Voer de deploy-opdracht uit vanuit de build-uitvoermap.

deploypages deploy

Frameworkbuild-handleiding

Moderne frameworks hebben een build-stap nodig voordat ze worden geüpload. Het doel is altijd hetzelfde: gewone statische bestanden genereren die de browser direct kan openen.

Wat ‘bouwen’ betekent

Een build converteert framework-bronbestanden naar publiceerbare HTML, CSS, JavaScript en assets.

React / Vue / Vite

Command:npm run build
Output:dist/

Upload de map dist zelf, niet de hoofdmap van het project.

Next.js statische export

Command:npm run build
Output:out/

Stel output: 'export' in next.config.js in vóór het bouwen.

Gewoon HTML

Command:Geen build-stap vereist
Output:Uw bestaande map

Houd index.html gewoon in de root.

Hugo/Hexo

Command:hugo of hexo generate
Output:public/

Upload de gegenereerde map public.

Next.js-exportvoorbeeld

next.config.js
/** @type {import('next').NextConfig} */const nextConfig = {  output: 'export',  images: { unoptimized: true },};
module.exports = nextConfig;

Statische exportlimieten

Servergerenderde functies zoals API-routes, server-side props en middleware zijn niet beschikbaar in een statische exportbuild.

Eigen domeinen

DeployPages kan na de eerste publicatie uw eigen domein koppelen, zodat het project kan worden verplaatst van een systeem-URL naar een productieadres met uw merk.

Wat telt als een domein?

Elk domein dat u via een registrar beheert, kan werken, zolang u de DNS-records ervan maar kunt bewerken.

Stap 1: Voeg het domein toe in de console

Ga naar projectinstellingen, open het tabblad domeinen en voeg de hostnaam toe waarmee u verbinding wilt maken.

Stap 2: Configureer DNS

DeployPages levert de DNS-doelen die u nodig hebt voor eigendomsverificatie en verkeersroutering.

Stap 3: Wacht op verificatie

Wanneer DNS is gepropageerd, wordt de domeinstatus in orde en kan de inrichting van HTTPS worden voltooid.

TypeHostWaardeDoel
CNAMEwwwcname.deploypages.websiteWijs verkeer naar het platform
TXT_deploypages-challengedeploypages-verify=...Domeineigendom verifiëren

Het hostrecord kiezen

  • Gebruik www als u verbinding maakt met www.voorbeeld.com.
  • Gebruik @ bij het verbinden van het hoofddomein example.com.
  • Gebruik een subdomeinlabel zoals blog wanneer u verbinding maakt met blog.example.com.

Een website bijwerken

Hetzelfde proces, nieuwe versie

Een project bijwerken gebruikt dezelfde logica als de eerste publicatie: build de nieuwste uitvoer, upload deze en laat het platform de live versie vervangen.
  • 1
    Bewerk de bronbestanden

    Wijzig de tekst, stijlen, media of assets lokaal.

  • 2
    Herbouwen wanneer dat nodig is

    Als het project een framework gebruikt, genereer dan eerst een nieuwe build-uitvoermap.

  • 3
    Open de projectconsole

    Ga terug naar de projectpagina in DeployPages.

  • 4
    Upload de nieuwe versie

    Vervang de vorige build door de nieuwste map. Door de publicatiegeschiedenis is de nieuwere release traceerbaar.

Zodra het uploaden is voltooid, wordt de nieuwe build live en blijven vorige versies beschikbaar voor herstel.

Veelgestelde vragen

Kunnen niet-ontwikkelaars DeployPages gebruiken?
Ja. Als de website al als statische bestanden is geëxporteerd, is publicatie via slepen en neerzetten voldoende.
Waarom zie ik een 404 na de publicatie?
De meest voorkomende reden is een ontbrekend of zoekgeraakt index.html-bestand. Zorg ervoor dat het publiceerbare toegangspunt zich in de hoofdmap van de geüploade map bevindt.
Wat moet ik doen als de React- of Vue-routes bij vernieuwing worden verbroken?
DeployPages ondersteunt SPA-fallback-gedrag voor algemene statische frontend-setups, maar de build moet nog steeds correct worden geëxporteerd.
Kan ik video's of grotere items uploaden?
Ja, maar de prestaties zijn beter wanneer zeer grote media worden geoptimaliseerd of gehost via het juiste gespecialiseerde leveringskanaal.
Kan ik een website met een wachtwoord beveiligen?
Ja op abonnementen met wachtwoordbescherming. Gebruik het voor voorbeeldweergaven, interne documenten of gefaseerde lanceringen.
Ga naar Explore