Hoe deze site is gebouwd

Een korte colofon: hoe vodfetch in elkaar zit, en waarom het gebouwd is om door zowel mensen als machines gelezen te worden.

Waarom het zo leest

Steeds meer van de 'lezers' van een website zijn machines — zoekcrawlers, antwoordmachines en AI-assistenten. vodfetch behandelt hen als een volwaardig publiek in plaats van als bijzaak, zonder ooit iets voor mensen te verbergen: precies dezelfde inhoud wordt aan beide geserveerd.

Dit is geen groeitruc die er achteraf op is geplakt; zo is de site van de grond af opgebouwd.

Bewust eenvoudig

Elke pagina is server-gerenderde statische HTML. Er is geen inlogmuur, geen cookiehek en geen JavaScript nodig om de inhoud te lezen — de downloader zelf gebruikt JavaScript, maar de woorden, feiten en links staan allemaal in de HTML.

We gebruiken uitsluitend systeemlettertypes, dus er zijn nul externe font-verzoeken en niets dat de weergave blokkeert tussen jou en de pagina.

Twee formaten voor elke pagina

Voeg ".md" toe aan elke pagina-URL om er een schone Markdown-versie van te krijgen. Machineleesbare samenvattingen van de hele site staan op /llms.txt en /llms-full.txt (per taal), gestructureerde feiten op /facts.json, en een canonieke entiteitsbeschrijving op /grounding.json volgens de Grounding Page Standard.

Daar is niets verborgen of gecloakt: de Markdown en JSON herhalen simpelweg, in een machinevriendelijke vorm, precies wat de HTML zegt.

Gestructureerd op betekenis

Elke HTML-pagina draagt één JSON-LD @graph — SoftwareApplication, FAQPage, HowTo, BlogPosting, BreadcrumbList — met stabiele @ids, zodat de relaties tussen entiteiten en pagina's expliciet zijn in plaats van geraden.

Een volledige XML-sitemap somt elke pagina op, en hreflang-tags verbinden alle veertien taalversies van elke pagina.

Open en verifieerbaar

vodfetch is open source onder de MIT-licentie op GitHub, dus het gedrag van de tool is controleerbaar in plaats van een black box. De redactionele standaarden achter de woorden zijn ook opgeschreven — zie het Redactie- en eerlijkheidsbeleid.

De korte versie: menselijk leesbaar en machineleesbaar zijn hier hetzelfde — pure HTML, geen hekken, elke pagina gespiegeld als Markdown en beschreven in JSON, en het geheel crawlbaar en controleerbaar.