notes
Werken aan de blogrepository
Een notitie over hoe ik deze Astro-repository omvormde tot een tweetalige blog en portfoliosite met duidelijkere contentstructuur.
Nadat de deployment workflow vorm kreeg, heb ik verder gewerkt aan de blogrepository zelf. Het doel was om weg te bewegen van een statisch experiment en richting een site te gaan die echte teksten, technische notities en portfoliowerk kan dragen.
De stack blijft bewust bescheiden: Astro, Markdown/MDX content collections, Engelse en Nederlandse routes, RSS, search en een kleine set layoutcomponenten. Dat is genoeg structuur voor een persoonlijke site, zolang het contentmodel duidelijk blijft.
Wat de repository moest worden
Ik wil niet dat deze blog alleen een feed met posts is. De site moet verschillende soorten materiaal kunnen dragen:
- korte technische notities,
- homelabdocumentatie,
- game development- en moddingwriteups,
- portfolio project pages,
- en referentiepagina’s die later verder kunnen groeien.
Daarom is de repository gericht op twee hoofdcollecties: posts en projects. Posts zijn gedateerde notities en updates. Projects zijn langere portfolio entries die een stuk werk, de tools erachter en het resultaat beschrijven.
Tweetalige content als basis
De repository is bewust tweetalig. Engelse en Nederlandse content staan in aparte locale folders, en gerelateerde entries delen een translationKey.
Die gedeelde key is belangrijk omdat beide versies niet regel per regel identiek moeten zijn. Ze moeten dezelfde feiten bevatten en tegelijk natuurlijk lezen in hun eigen taal.
Posts en projecten
De scheiding tussen posts en projects is nuttig omdat de pagina’s ander werk doen.
Een post mag smal zijn. Hij kan een deploymentwijziging, designbeslissing, refactor of statusupdate uitleggen. Een projectpagina moet vollediger zijn. Die hoort context, rol, tools, links, resultaat en de betekenis van het werk te beschrijven.
Die scheiding helpt al bij het Ravenfield-materiaal. Reclamation Eden, het Warhammer 40K-werk en de bredere moddinggeschiedenis passen beter als project entries dan als gewone blogposts.
Search, RSS en browsen
Ik wilde ook dat de site bruikbaar blijft zodra de content groeit. RSS geeft posts een normale publicatievorm. Search maakt de site nuttiger als kleine kennisbank. Tags verbinden posts en projects zonder meteen een zware taxonomie te maken.
Die systemen voeg je beter vroeg toe, voordat de site een grote backlog aan content heeft.
Resultaat
Deze fase maakte van de blog meer een onderhoudbaar publicatiesysteem. Ze gaf mij een duidelijkere plaats voor verschillende soorten tekst en zette de basis voor het latere werk: publishing controls, visueel ontwerp, prompt-based content workflows en portfolio media.