Noridoc: content

Path: @/content

Overview

  • Contains all site content as markdown files with YAML frontmatter
  • Organized into two patterns: page bundles (folders) for papers, and standalone markdown files for simple pages (CV, Contact, Archive, Tags)

How it fits into the larger codebase

  • Hugo processes each markdown file here and pairs it with the matching template from @/layouts/ (or @/themes/PaperMod/layouts/ as fallback)
  • The papers/ section is the only “main section” (configured via mainSections in @/config.yml), so only papers appear in archive listings and post navigation
  • Frontmatter fields like editPost, tags, author, cover, and hidemeta control how @/layouts/partials/ renders metadata, journal links, and tag associations
  • Static assets co-located with page bundles (e.g., PDFs placed alongside index.md in a paper folder) are served at the same URL path

Core Implementation

  • Papers (@/content/papers/): Uses page bundles – each paper is a subfolder containing index.md. The _index.md file provides the section title/description. Paper pages have a structured body: Download links, Abstract, Citation (with BibTeX codeblock). The editPost.URL and editPost.Text frontmatter fields are used to link to the journal/DOI.
  • CV (@/content/cv.md): Single page with hidemeta: true to suppress date/author display. Links to a cv.pdf file (expected in @/static/ or co-located).
  • Contact (@/content/contact.md): Single page with hidemeta: true. Contains email and office location.
  • Archive (@/content/archive.md): Uses layout: "archives" to invoke @/layouts/_default/archives.html, which groups papers by year and month.
  • Tags (@/content/tags/_index.md): Section list page for the tags taxonomy. Tags are defined per-paper in frontmatter and rendered by @/layouts/_default/terms.html.

Things to Know

  • New papers should be created as page bundles (folder with index.md) using the archetype: hugo new content papers/paperN/index.md --kind paper
  • The archetype at @/archetypes/paper.md provides the full structure including Download, Abstract, Figures, Citation, and Related Material sections
  • A course archetype exists at @/archetypes/course.md for future use but no courses section currently exists in the content tree
  • Pages with hidemeta: true suppress the date/author/reading-time metadata line that normally appears below the title

Created and maintained by Nori.