Static site generator
Markdown in, a hardened static site out.
ssg.tradik.com builds local Markdown, remote APIs, SQL and CMS databases into one static site — with WebP images, feeds, a search index, i18n and single-command deploys.
Guides
Documentation
Every guide below is built from this repository's own docs/
folder through content_sources — this site is its own
integration test.
-
Configuration reference
SSG can be configured with command-line flags or a YAML, TOML or JSON file. This guide explains the configuration model and advanced features. The exhaustive, copyable YAML template is…
-
Content guide
This document is the canonical reference for local Markdown content in SSG. For configuration keys, see CONFIGURATION.md. For values exposed to themes, see TEMPLATES.md.
-
Deployment guide
SSG can package a generated site, publish it directly, or run as a GitHub Action. Deployment always happens after generation and enabled post-processing, so providers receive the final output tree.
-
External sources
One unified system feeds templates with data from outside the content tree: local files, remote HTTP APIs, SQL databases and CMS databases (WordPress, Drupal, Movable Type) — all behind a single…
-
Internationalisation (i18n)
i18n is opt-in. Existing sites, including sites using the legacy compact languages option, keep their current behaviour until i18n.enabled is set.
-
Image Processing Helpers
Since v1.8.3. Build-time image manipulation callable from templates and shortcodes: resize, fit, fill-with-crop, explicit/anchor/focal crops, visual filters, format conversion with quality control…
-
SSG Installation Guide
This document provides installation instructions for SSG on all supported platforms.
-
SSG Style & Color Guidelines
This document describes the visual design tokens of the built-in themes. All text colors meet WCAG 2.2 AA contrast (≥4.5:1 for normal text) against their intended background (audit FE-002).
-
Dynamic taxonomies
Taxonomies classify posts into browsable archives. category, tag and series are built in and keep their historical URLs, templates and feeds; any number of additional taxonomies can be declared in…
-
Templates and themes
This guide describes theme layout, rendering contexts and supported engines. Go template helper signatures are in TEMPLATE_HELPERS.md; image functions are in IMAGES.md.
-
Template Collection & Conditional Helpers
Since v1.8.3. SSG's Go template engine ships a set of generic helpers for filtering, sorting, grouping, slicing and testing content — so a theme can build "recently updated guides", "related posts"…
Updates
Latest posts
-
Your hero image is your LCP score
Open any page that fails Core Web Vitals and there is a good chance the culprit is a single JPEG. The Largest Contentful Paint element — the thing Google times at 2.5 seconds for a passing grade…
-
SSG, and the case for boring websites
Most websites do not need a server. They need to answer a question that was already known when the page was written — what does this product cost, what did the release change, how do I install the…