Markdown-Quellen für den Blog auf agentic.schule.
- Ein Ordner pro Artikel:
blog/YYYY-MM-slug/README.md+ Bild-Assets daneben. - Frontmatter wie bei
angular-schule/website-articles(gleicher Build-Stack, dasbuild/-Submodul zeigt aufangular-schule/website-articles-build). - Die GitHub Action baut bei jedem Push auf
maindasdist/und deployt es in dengh-pages-Branch dieses Repos:https://agentic-schule.github.io/website-articles
Der Zwei-Quellen-Merge lebt in der Website (agentic-schule-website,
BlogService): Sie lädt dieses Repo komplett UND zusätzlich die
list.json von angular-schule/website-articles, gefiltert auf Artikel
mit dem Keyword AI, bei denen Johannes Hoppe oder einer der
Team-Accounts (Co-)Autor ist (Details: BlogService in der Website). Dieses Repo baut also nur die eigenen Artikel.
Ein Artikel darf in zwei Sprachfassungen vorliegen. Dann enden die Ordnernamen mit Suffix, exakt in Großbuchstaben:
blog/2026-08-mein-artikel-DE/(deutsche Fassung,language: de)blog/2026-08-mein-artikel-EN/(englische Fassung,language: en)
Die Website zeigt im deutschen Build nur die -DE-Fassung, im englischen nur die -EN-Fassung. In der URL erscheint der Slug ohne Suffix, beide Sprachen teilen sich dieselbe Adresse. Bilder referenzieren wie immer relativ, sie liegen im jeweiligen Ordner (der echte Slug mit Suffix bleibt intern erhalten). Artikel ohne Suffix gelten für beide Sprachen.
Artikel-Header entstehen aus einer header.src.html (1200×675, Assets relativ
daneben) im jeweiligen Artikel-Ordner und werden zentral gerendert:
node tools/render-header.mjs blog/<artikel-ordner>Ergebnis ist header.jpg (2400×1350). Voraussetzung: einmalig cd tools && npm install
(holt playwright-core) und ein installierter Google Chrome. Achtung: Der Build kopiert Artikel-Ordner komplett nach dist/,
die Quelldateien werden also mit veröffentlicht (harmlos, aber gut zu wissen).
git submodule update --init --recursive
cd build && npm install && npm run build