Speciale bestanden en regels

Paginalinks

Een adres zonder bestandsextensie zoekt een HTML-bestand. Welk bestand dat is, stel je per website in (Instellingen → Gevarenzone → Paginalinks):

Adres	`contact.html` (standaard)	`contact/index.html`
`/`	`index.html`	`index.html`
`/contact`	`contact.html`	`contact/index.html`
`/over/`	`over/index.html`	`over/index.html`
`/logo.svg`	`logo.svg`	`logo.svg`

Kies de instelling die past bij hoe je framework bouwt (Astro en Next.js-export maken vaak mappen met index.html).

⚠️

Wijzig je deze instelling bij een bestaande site, dan geven links naar pagina's die op de andere manier zijn gebouwd een 404.

Eigen foutpagina: `_errors/404.html`

Zet een bestand _errors/404.html in je build voor een eigen "pagina niet gevonden". Dat bestand wordt getoond bij elk adres dat niet bestaat, met status 404.

Zonder dit bestand krijgt de site een nette standaardpagina van Reuzenpanda.
Bestanden in _errors/ zijn zelf niet op te vragen: /_errors/404.html openen geeft gewoon de 404-pagina.
Gebruik in de foutpagina root-paden (/assets/…), want hij wordt op elk adres getoond.

Gereserveerde namen

Pad	Waarom
`/_gp/`	De API van de site (bezoekers, toestemming, configurators). Gebruik deze map niet in je build.
`/_errors/`	Foutpagina's, zie hierboven. Niet direct op te vragen.
`_draft`	Intern gebruikt door de editor in Hub. Gebruik deze naam niet als map in de root.

Bestanden die worden overgeslagen

.DS_Store, Thumbs.db en desktop.ini worden bij het uploaden genegeerd. Bestandspaden zijn relatief, met /, zonder . of .. als onderdeel en maximaal 512 tekens.

Cache

De site staat op een wereldwijd netwerk. Hoe lang browsers een bestand bewaren, hangt af van de naam:

Bestand	Cache
`.html`	60 seconden
Bestanden met een hash in de naam (`app-3f9c2a1e.js`, `logo.a1b2c3d4.svg`; 8 of meer tekens) — `js`, `css`, `mjs`, lettertypen, `png`, `jpg`, `webp`, `avif`, `svg`	Een jaar (verandert nooit)
Al het andere	5 minuten

Gebruik daarom een build die bestandsnamen met een hash maakt (Vite, Astro en Next.js doen dat standaard). Een afbeelding die je vervangt onder dezelfde naam, is pas na een paar minuten overal nieuw.

Bestandstypen

HTML, CSS, JavaScript (.js, .mjs), JSON, XML, SVG, afbeeldingen (png, jpg, gif, webp, avif, ico), lettertypen (woff, woff2, ttf, otf), video en audio (mp4, webm, mp3), pdf, 3D (glb, gltf, bin), wasm, webmanifest, txt, md, yaml en zip krijgen het juiste type. Andere bestanden worden als download (application/octet-stream) geserveerd.

robots.txt en sitemap.xml

Zet ze zelf in de root van je build:

# robots.txt
User-agent: *
Allow: /
Sitemap: https://www.jouwbedrijf.nl/sitemap.xml

Gebruik in sitemap.xml en in canonical het definitieve domein, niet het sites.giantpanda.site-adres.

Nog niet ondersteund

_redirects- en _headers-bestanden (zoals bij Netlify) werken nog niet. Doorverwijzingen en eigen headers staan gepland en komen in de instellingen van de website.

Een website bouwen Configurator en /_gp