(Landings)webpagina's genereren

johan.groenen commented

2026-04-24 14:09:12 +00:00

Owner

Ik heb de huidige content van de landingspagina code.overheid.nl in de README.md gezet als Markdown.

Zou mooi zijn om hier meteen het eerste "Forgejo Pages" voorbeeld van te maken, dat wil zeggen: dat deze repository de landingspagina voor code.overheid.nl genereert, en dat ook andere repo's websites kunnen genereren (zoals Codeberg en Github Pages dat doen).

cc @annejan.brouwer en @Tilian hebben beide oplossingen hiervoor (Jekyll, Hugo en nog eentje geloof ik). Wat zullen we doen?

Ik heb de huidige content van de landingspagina code.overheid.nl in de README.md gezet als Markdown. Zou mooi zijn om hier meteen het eerste "Forgejo Pages" voorbeeld van te maken, dat wil zeggen: dat deze repository de landingspagina voor code.overheid.nl genereert, en dat ook andere repo's websites kunnen genereren (zoals Codeberg en Github Pages dat doen). cc @annejan.brouwer en @Tilian hebben beide oplossingen hiervoor (Jekyll, Hugo en nog eentje geloof ik). Wat zullen we doen?

👍 9

gina.plat added this to the Codeplatform kanban project

2026-04-26 07:25:05 +00:00

gina.plat added the

enhancement

question

labels

2026-05-03 20:19:58 +00:00

johan.groenen changed title from ~~Landingspagina genereren~~ to (Landings)pagina's genereren

2026-07-16 12:28:32 +00:00

johan.groenen changed title from ~~(Landings)pagina's genereren~~ to (Landings)webpagina's genereren

2026-07-16 12:30:37 +00:00

tim.lippe commented

2026-07-16 13:56:53 +00:00

Voor standaarden genereren we een index.html met wat bestanden in een media/ folder. Deze uploaden we naar een GitHub bucket die dan wordt gebruikt door GitHub Pages.

Bij de community call vandaag hadden we het er over dat we dit gebruiken voor zowel de werkversie van een standaard alsmede previews van een wijziging. Dit vereist dan een Pages-equivalent op deze instance, zodat we die previews kunnen behouden.

De implementatie van de previews staat hier (in GitHub taal dus): github.com/Logius-standaarden/Automatisering@64bd22d68f/.github/workflows/publish.yml (L34-L116)

Voor standaarden genereren we een `index.html` met wat bestanden in een `media/` folder. Deze uploaden we naar een GitHub bucket die dan wordt gebruikt door GitHub Pages. Bij de community call vandaag hadden we het er over dat we dit gebruiken voor zowel de werkversie van een standaard alsmede previews van een wijziging. Dit vereist dan een Pages-equivalent op deze instance, zodat we die previews kunnen behouden. De implementatie van de previews staat hier (in GitHub taal dus): https://github.com/Logius-standaarden/Automatisering/blob/64bd22d68fc10a285ac2674457603b78d6f67d42/.github/workflows/publish.yml#L34-L116

bovh commented

2026-07-16 14:08:38 +00:00

Owner

Op zowel GitHub als GitLab worden ook meerdere standaarden en specificaties beheerd. Zoals de standaarden van Logius. Deze worden vaak met tooling als Rspec gemanaged. Dat zou ook goed hier kunnen.

Op opencode.de hebben ze dit: https://opencode.de/en/consultation-processes

Op zowel GitHub als GitLab worden ook meerdere standaarden en specificaties beheerd. Zoals de standaarden van Logius. Deze worden vaak met tooling als Rspec gemanaged. Dat zou ook goed hier kunnen. Op opencode.de hebben ze dit: https://opencode.de/en/consultation-processes

Fairoesh.Nanhekhan commented

2026-08-28 13:09:53 +00:00

Als de pages-functionaliteit wordt gerealiseerd (i.c.m. ReSpec en Markdown) zou écht heel erg fijn zijn. Mochten jullie iemand nodig hebben om de pages-functionaliteit te testen op code.overheid.nl, dan kan ik eventueel helpen.

Toelichting
Momenteel maken wij gebruik van GitHub Pages om onze kennisproducten te publiceren. Deze kennisproducten bestaan uit HTML- en Markdown-bestanden die rechtstreeks vanuit een GitHub-repository als statische website worden gehost. Dit is voor ons een eenvoudige en efficiënte manier om documentatie en kennisproducten op een overzichtelijke en gestructureerde manier beschikbaar te maken.

Ter illustratie heb ik hieronder wat voorbeeld opgenomen van een aantal kennisproducten welke momenteel via GitHub Pages wordt gepubliceerd vanuit de Nationaal Archief GitHub repo’s:
https://nationaalarchief.github.io/MDTO-Metagegevensschema/
https://nationaalarchief.github.io/MDTO-Veelgestelde-vragen/
https://nationaalarchief.github.io/MDTO-TMLO-TMR/

Als de pages-functionaliteit wordt gerealiseerd (i.c.m. ReSpec en Markdown) zou écht heel erg fijn zijn. Mochten jullie iemand nodig hebben om de pages-functionaliteit te testen op code.overheid.nl, dan kan ik eventueel helpen. **Toelichting** Momenteel maken wij gebruik van GitHub Pages om onze kennisproducten te publiceren. Deze kennisproducten bestaan uit HTML- en Markdown-bestanden die rechtstreeks vanuit een GitHub-repository als statische website worden gehost. Dit is voor ons een eenvoudige en efficiënte manier om documentatie en kennisproducten op een overzichtelijke en gestructureerde manier beschikbaar te maken. Ter illustratie heb ik hieronder wat voorbeeld opgenomen van een aantal kennisproducten welke momenteel via GitHub Pages wordt gepubliceerd vanuit de Nationaal Archief GitHub repo’s: https://nationaalarchief.github.io/MDTO-Metagegevensschema/ https://nationaalarchief.github.io/MDTO-Veelgestelde-vragen/ https://nationaalarchief.github.io/MDTO-TMLO-TMR/

Rows
Columns

(Landings)webpagina's genereren #14