Come è realizzato questo sito

Un breve colophon: come è messo insieme vodfetch e perché è costruito per essere letto sia dalle persone sia dalle macchine.

Perché si legge così

Sempre più spesso chi 'legge' un sito web è una macchina — crawler dei motori di ricerca, motori di risposta e assistenti IA. vodfetch li tratta come un pubblico di primo piano invece che come un ripensamento, senza mai nascondere nulla agli esseri umani: gli stessi identici contenuti vengono serviti a entrambi.

Non è un trucco di crescita aggiunto in un secondo momento; è il modo in cui il sito è costruito fin dalle fondamenta.

Semplice per scelta

Ogni pagina è HTML statico renderizzato sul server. Non c'è alcun muro di login, nessuna barriera di cookie e nessun JavaScript necessario per leggere i contenuti — il downloader in sé usa JavaScript, ma le parole, i fatti e i link vivono tutti nell'HTML.

Usiamo solo font di sistema, quindi non c'è alcuna richiesta di font esterni e nulla che blocchi il rendering tra te e la pagina.

Due formati per ogni pagina

Aggiungi ".md" all'URL di qualsiasi pagina per ottenerne una versione in Markdown pulita. Riepiloghi leggibili dalle macchine dell'intero sito si trovano in /llms.txt e /llms-full.txt (per lingua), fatti strutturati in /facts.json e una descrizione canonica dell'entità in /grounding.json secondo il Grounding Page Standard.

Nulla lì è nascosto o mascherato: il Markdown e il JSON si limitano a ribadire, in una forma adatta alle macchine, esattamente ciò che dice l'HTML.

Strutturato per il significato

Ogni pagina HTML contiene un singolo @graph JSON-LD — SoftwareApplication, FAQPage, HowTo, BlogPosting, BreadcrumbList — con @id stabili, così le relazioni tra entità e pagine sono esplicite invece di essere indovinate.

Una sitemap XML completa elenca ogni pagina, e i tag hreflang collegano tutte e quattordici le versioni linguistiche di ciascuna.

Aperto e verificabile

vodfetch è open source con licenza MIT su GitHub, così il comportamento dello strumento è verificabile invece di essere una scatola nera. Anche gli standard editoriali dietro le parole sono messi per iscritto — vedi la Politica editoriale e di onestà.

In breve: leggibile dagli esseri umani e leggibile dalle macchine sono la stessa cosa qui — HTML semplice, nessuna barriera, ogni pagina rispecchiata come Markdown e descritta in JSON, tutto quanto scansionabile e verificabile.