Expand description
Post-processing plugins that fix staticdatagen output.
These plugins run in the after_compile phase to sanitise XML feeds,
sitemaps, manifests, and HTML output produced by the upstream
staticdatagen crate.
SitemapFixPlugin– Fixes 1, 2, 10: duplicate XML declarations, double-slash URLs, and per-page lastmod dates.NewsSitemapFixPlugin– Fix 3: populates news-sitemap entries from front-matter metadata.RssAggregatePlugin– Fix 4: aggregates per-page RSS items into the root feed.ManifestFixPlugin– Fix 8: word-boundary-safe description truncation.HtmlFixPlugin– Fix 9: repairs broken.class=image syntax and Fix 7: upgrades JSON-LD@contextfromhttptohttps.AtomFeedPlugin– Generates an Atom 1.0atom.xmlfeed from.meta.jsonsidecars.JsonFeedPlugin– Generates a JSON Feed 1.1feed.jsonfrom.meta.jsonsidecars (alongside the RSS/Atom feeds).EdgeHeadersPlugin– Emits PQC-aware platform header configs for Cloudflare Workers, Netlify, and Vercel (issue #550).
Modules§
- agentic_
discovery - Agentic discovery emitters (issue #552).
- edge_
headers - PQC-aware edge-runtime header emitter (issue #550).
Structs§
- Agent
Rule - A single
User-agent: …block foragents.txt. Mirrors therobots.txtgrammar but is also reachable from per-page frontmatter (via theagents:key on a.meta.jsonsidecar). - Agentic
Discovery Plugin - Coordinator plugin that fans out to the three agentic-discovery
emitters. Registered once in
register_default_pluginsand runs inafter_compile. - Agents
Config - The
[agents]section ofssg.toml. Every field is optional; absent values fall back to safe “off” defaults so that omitting the section produces no new files. - Atom
Feed Plugin - Generates an Atom 1.0
atom.xmlfeed from.meta.jsonsidecars. - Edge
Headers Plugin - Postprocess plugin that emits per-platform edge header config.
- Html
FixPlugin - Repairs HTML output:
- Json
Feed Plugin - Generates a JSON Feed 1.1
feed.jsonfrom.meta.jsonsidecars. - Manifest
FixPlugin - Fixes manifest.json description truncation by using full text or word-boundary-safe truncation at 200 characters.
- McpConfig
- MCP registry settings. Mirrors the JSON shape consumed by clients
(Claude Desktop, IDE integrations, …) but expressed in TOML so site
authors can edit it alongside the rest of
ssg.toml. - McpPrompt
Decl - Static MCP prompt declaration.
- McpResource
- One MCP
resourceentry. Public so integration tests can construct instances directly and so consumers of the library can fan their own resources in via post-emit hooks. - McpTool
Decl - Static MCP tool declaration. The emitter passes these through verbatim to the registry JSON — schema validation is the consumer’s problem.
- News
Sitemap FixPlugin - Repairs news-sitemap.xml by populating entries from front-matter metadata instead of using placeholder values.
- RssAggregate
Plugin - Aggregates per-page RSS items into the root
rss.xmlfeed. - Sbom
Plugin Deprecated - A post-processing plugin that generates a
CycloneDXv1.5 SBOM (sbom.cdx.json) for the built website. - Sitemap
FixPlugin - Repairs and canonicalises the generated
sitemap.xml.
Functions§
- build_
manifest - Pure-function manifest builder — split from
write_ai_plugin_jsonso unit tests can assert the JSON shape without touching the filesystem. - build_
registry - Pure-function registry builder, callable from tests without I/O.
- collect_
mcp_ resources - Walk
.meta.jsonsidecars underctx.site_dir(with the samebuild_dir/.metafallback used by RSS/Atom/JSON-Feed) and produce one MCP resource per public page. - render_
agents_ txt - Pure-function renderer kept separate from I/O so unit tests can assert the exact byte layout without touching the filesystem.
- write_
agents_ txt - Render and write the
agents.txtfile underctx.site_dir. - write_
ai_ plugin_ json - Render and write
.well-known/ai-plugin.jsonunderctx.site_dir. - write_
mcp_ registry - Render and write
.well-known/mcp.jsonunderctx.site_dir.