Documentation on Retro Dispatch

Installation

Mon, 01 Jan 0001 00:00:00 +0000

As a Hugo module

hugo mod init github.com/you/your-site
hugo mod get github.com/PhantomPixelDev/hugo-theme-retrocss

As a submodule

git submodule add https://github.com/PhantomPixelDev/hugo-theme-retrocss themes/hugo-theme-retrocss

Configuration

Mon, 01 Jan 0001 00:00:00 +0000

Accent hue

Set params.accentHue to any RetroCSS hue and the whole site follows, in both themes.

Corners

params.borderRadius is the framework’s single radius token. 0 keeps the Windows 95 squares.

Titles and credit

params.tagline is appended to the site title in the home page’s <title>, so a search result says what the site is rather than only what it is called.

Shortcodes

Mon, 01 Jan 0001 00:00:00 +0000

The theme ships one shortcode per interactive component. None of them add CSS — each is a thin wrapper over markup the framework already styles.

Alerts

Heads up

Alerts take type (primary, success, warning, danger, info) and an optional title.

A warning with no header.

Cards

System Properties

Cards take header, footer, image and imageAlt.

Badges and buttons

Shipped Beta Default

Theming

Mon, 01 Jan 0001 00:00:00 +0000

Everything visual routes through RetroCSS tokens, so a site re-themes itself from configuration rather than from CSS overrides.

Accent hue

[params]
 accentHue = "teal"

Any of the framework’s hues works: primary, success, danger, warning, info, teal, tan, pink, lime, cyan, orange, brown, violet, gray, maroon, gold, navy, olive, silver. The theme aliases the four --retro-primary* tiers plus -rgb onto that hue, and because the dark palette redefines every hue, the accent follows into dark mode with its contrast intact.

Right-to-left

Mon, 01 Jan 0001 00:00:00 +0000

[languages.ar]
 languageName = "العربية"
 direction = "rtl"
 weight = 2

The theme emits dir on <html>, and RetroCSS positions everything with logical properties, so spacing, alignment and start/end positioning mirror with nothing to import.

What does not mirror

The bevels. In the Win9x visual language the light source is fixed at the top-left, and Windows keeps it there in RTL; flipping the raised and sunken edges would make every button read as sunken on the wrong side. Only the semantic accents move — an alert’s stripe, a blockquote’s rule — because those mark where a line of text begins.

Deploying

Mon, 01 Jan 0001 00:00:00 +0000

Build

hugo --minify --gc

The theme has no Node step and no Sass step. The framework’s CSS and JavaScript are vendored into the theme and served through Hugo Pipes, which means the standard Hugo binary is enough — you do not need the extended build.

What ships

One concatenated, fingerprinted stylesheet with a Subresource Integrity hash, one deferred script, and a search index built as a page resource. Nothing is fetched from a CDN at runtime, so the site works offline and behind a strict content security policy.

Documentation on Retro Dispatch

Installation

As a Hugo module #

As a submodule #

Configuration

Accent hue #

Corners #

Titles and credit #

Shortcodes

Alerts #

Cards #

Badges and buttons #

Theming

Accent hue #

Right-to-left

What does not mirror #

Deploying

Build #

What ships #

As a Hugo module

As a submodule

Accent hue

Corners

Titles and credit

Alerts

Cards

Badges and buttons

Accent hue

What does not mirror

Build

What ships