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
.htmlsources are excluded from the build on purpose (hugo.tomlmodule mounts) — convert to markdown instead. - Internal links point at the page URL (
ci/), not the source file (ci.md).