SDL site

Hugo site (PaperMod theme) for the Software Development Lab courses, published to GitLab Pages. The whole repository is mounted as content — see the header comments in hugo.toml.

Section index pages: no cards, no generated listings

Section landing pages use plain markdown link lists, hand-written in _index.md. Do not generate card markup for them — no PaperMod post-entry card grids, no HTML/CSS card components, no shortcodes that render tiles, and no auto-generated child listings layered under a hand-written list.

This applies in particular to resources/_index.md and the root _index.md, whose contents are maintained by hand.

layouts/list.html overrides PaperMod’s card grid with a two-level title outline, and generates that outline only for pages with no body content of their own. Leave that gate in place: adding body content to an _index.md is the mechanism for taking over a section’s index by hand.

Editing content

  • Pages are markdown. Raw .html sources are excluded from the build on purpose (hugo.toml module mounts) — convert to markdown instead.
  • Internal links point at the page URL (ci/), not the source file (ci.md).