Reference

Use this page when you need the next layer of documentation beyond the hugo-styles guides.

Start here

• Creating a new lesson repository: hugo-styles-template
• Shared module onboarding: Quickstart
• Shared module authoring conventions: Authoring Guide
• Curated Hextra usage for particle-physics lessons: Hextra Features for Physics Lessons
• Downstream lesson update workflow: Updating Downstream Lessons
• Shared hugo-styles repository maintenance: hugo-styles Maintenance

Upstream docs

• Theme-level guidance and defaults: Hextra Getting Started
• Hextra tabs and shortcode behavior: Hextra Tabs
• Hextra deployment guidance: Hextra Deploy Site
• Install Hugo: Hugo Installation
• Understand module imports and overrides: Hugo Modules
• Built-in provider shortcodes such as YouTube: Hugo Embedded Shortcodes

Scope of this site

This site documents the hugo-styles layer:

• Carpentries-style pedagogy blocks
• lesson metadata expectations
• migration and validation tooling
• downstream update workflow

For generic Hextra theme behavior or deeper Hugo framework details, prefer the upstream docs above instead of duplicating that material here.