# The Ryder Theme

> A barebones Hugo theme built with TailwindCSS, Alpine.js, and Font Awesome. Practical defaults, no bloat.

## Docs

- [Affiliate Marketing Tools](https://arts-link.github.io/ryder/docs/affiliate-marketing-tools/): Amazon affiliate link shortcodes: a single-product buy button and an interactive ASIN link builder.
- [Alerts](https://arts-link.github.io/ryder/docs/alerts/): Add dismissable alert boxes via shortcode, partial, or site-wide hugo.toml params.
- [All About Hugo](https://arts-link.github.io/ryder/docs/about-hugo/): Hugo, the world's fastest framework for building websites
- [Analytics](https://arts-link.github.io/ryder/docs/analytics/)
- [Breadcrumbs](https://arts-link.github.io/ryder/docs/breadcrumbs/): How the breadcrumb trail decides what to render — and why a top-level page shows none at all.
- [CSS Overrides and Visual Customization](https://arts-link.github.io/ryder/docs/css-overrides/): Customize the header, footer, card colors, and border accents from hugo.toml without editing theme files.
- [Cta Button](https://arts-link.github.io/ryder/docs/cta-button/): Add styled call-to-action buttons to any page using the cta-button shortcode.
- [Custom navClass](https://arts-link.github.io/ryder/docs/custom-navclass/): Restyle the nav on a single page with navClass, without forking header.html into a new headerType variant.
- [Design System](https://arts-link.github.io/ryder/docs/design-system/): Ryder’s colour tokens, type scale, spacing, and components — documented by the live theme rather than a screenshot of it.
- [Emoji Support](https://arts-link.github.io/ryder/docs/emoji-support/): Guide to emoji usage in Hugo
- [Empty Section](https://arts-link.github.io/ryder/docs/empty-section/): A section with no pages in it — demonstrates the empty state that layouts/_default/list.html renders instead of a blank grid and a dead pager.
- [Featured Content](https://arts-link.github.io/ryder/docs/featured-content/): Pin posts to the featured grid on the home page using the homeFeature front matter param.
- [Forms](https://arts-link.github.io/ryder/docs/forms/)
- [Highlight Github](https://arts-link.github.io/ryder/docs/highlight-github/): Embed syntax-highlighted code directly from GitHub repositories using the highlight-github shortcode.
- [Home Feed Filtering and Colorization](https://arts-link.github.io/ryder/docs/home-feed-filtering/): Filter the home page feed by section, category, or tag, and colorize cards with category-based gradients.
- [How the recipe shortcodes work](https://arts-link.github.io/ryder/docs/recipe-lemon-chia-granola/): Use recipe schema shortcodes to publish SEO-friendly recipe pages with schema.org JSON-LD structured data.
- [Leaflet Maps](https://arts-link.github.io/ryder/docs/leaflet-maps/): Embed interactive Leaflet maps powered by OpenStreetMap using the leaflet shortcode.
- [List Layouts](https://arts-link.github.io/ryder/docs/list-layouts/): A feed-less list layout for data-driven singleton sections, and the empty-data idiom partial that goes with it.
- [Logo Configuration](https://arts-link.github.io/ryder/docs/logo-configuration/): Configure the Ryder theme logo as a text mark or custom image, all from hugo.toml — no template edits needed.
- [Maintenance Page](https://arts-link.github.io/ryder/docs/maintenance-page/): Use the hidden-home layout to put up a focused maintenance or coming-soon page.
- [Markdown Syntax Guide](https://arts-link.github.io/ryder/docs/markdown-syntax/): Sample article showcasing basic Markdown syntax and formatting for HTML elements.
- [Media Embeds](https://arts-link.github.io/ryder/docs/rich-content/): Embed YouTube, Vimeo, and SoundCloud using built-in and theme shortcodes
- [Menus](https://arts-link.github.io/ryder/docs/menus/): Configure navigation menus in Ryder, including parent items, submenu triggers, and footer links.
- [Releases](https://arts-link.github.io/ryder/docs/releases/): Ryder's tagged releases, sourced from data/releases.json — demonstrates layout = "list-plain", the utils/data-items.html partial, and a menu entry gated with hideIfEmptyData.
- [SEO & GEO — Structured Data & Search Optimization](https://arts-link.github.io/ryder/docs/seo-and-geo/): Built-in SEO and GEO support with OpenGraph, schema.org JSON-LD, and structured data — zero plugins required.
- [Showcase](https://arts-link.github.io/ryder/docs/showcase/): An intentionally empty data-driven section — demonstrates emptyDataMessage, the counterpart to a menu entry gated with hideIfEmptyData.
- [Table of Contents](https://arts-link.github.io/ryder/docs/table-of-contents/): Use the built-in aside table of contents on longer pages with a clear heading structure.
- [Using Font Awesome Icons](https://arts-link.github.io/ryder/docs/font-awesome-icons/): How to use Font Awesome icons in the Ryder theme, including adding new icons to the tree-shaken JS bundle.

## Pages

- [About Ryder](https://arts-link.github.io/ryder/about/): The Ryder Hugo theme: v0.3.0 release notes, new configuration parameters, breaking changes, and upgrade path.
- [Contact](https://arts-link.github.io/ryder/contact/): Get in touch with the Ryder theme team via email or GitHub.
- [Maintenance Page](https://arts-link.github.io/ryder/maintenance-page/): Example of the hidden-home layout for maintenance or coming-soon pages with a full-screen background.