notes
Werken aan de blogrepository
Een notitie over hoe ik deze Astro-repository omvormde tot een tweetalige blog en portfoliosite met een duidelijkere structuur.
Nadat de deploymentworkflow vorm kreeg, heb ik verder gewerkt aan de blogrepository zelf. Het doel was om weg te raken van een statisch experiment en toe te werken naar een site met plaats voor echte teksten, technische notities en portfoliowerk.
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 helder 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 huisvesten:
- korte technische notities,
- homelabdocumentatie,
- stukken over gamedevelopment en modding,
- portfoliopagina’s voor projecten,
- en referentiepagina’s die later verder kunnen groeien.
Daarom is de repository uitgekomen bij twee hoofdcollecties: posts en projects. Posts zijn gedateerde notities en updates. De items in projects zijn langere portfoliopagina’s die een stuk werk, de tools erachter en het resultaat beschrijven.
Tweetalige content als basis
De repository is bewust tweetalig. Engelse en Nederlandse teksten staan in aparte locale folders, en verwante pagina’s delen een translationKey.
Die gedeelde key is belangrijk omdat beide versies niet regel per regel identiek hoeven te zijn. Ze moeten dezelfde feiten bevatten en tegelijk natuurlijk lezen in hun eigen taal.
Posts en projecten
De scheiding tussen posts en projecten is nuttig omdat de pagina’s een andere taak hebben.
Een post mag smal zijn. Die kan een deploymentwijziging, ontwerpkeuze, 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 nu al bij het Ravenfield-materiaal. Reclamation Eden, het Warhammer 40K-werk en de bredere moddinggeschiedenis passen beter als projectpagina’s dan als gewone blogposts.
Search, RSS en browsen
Ik wilde ook dat de site bruikbaar blijft zodra de hoeveelheid materiaal groeit. RSS geeft posts een normale publicatievorm. Search maakt de site nuttiger als kleine kennisbank. Tags verbinden posts en projecten zonder meteen een zware taxonomie te maken.
Zulke systemen voeg je beter vroeg toe, voordat de site een grote achterstand aan materiaal heeft.
Resultaat
Deze fase maakte van de blog meer een onderhoudbaar publicatiesysteem. Ze gaf mij een duidelijkere plaats voor verschillende soorten tekst en legde de basis voor het latere werk: publicatiecontroles, visueel ontwerp, promptgestuurde contentworkflows en portfoliomedia.